/usr/share/perl5/MARC/Spec/Field.pm is in libmarc-spec-perl 2.0.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | package MARC::Spec::Field;
use Moo;
use namespace::clean;
extends 'MARC::Spec::Structure';
our $VERSION = '2.0.3';
has tag => (
is => 'rw',
required => 1
);
sub BUILDARGS {
my ($class, @args) = @_;
if (@args % 2 == 1) { unshift @args, "tag" }
return { @args };
}
1;
__END__
=encoding utf-8
=head1 NAME
MARC::Spec::Field - field specification
=head1 SYNOPSIS
use MARC::Spec::Field;
my $field = MARC::Spec::Field->new('246');
say ref $field; # MARC::Spec::Field
say $field->tag; # 246
say $field->index_start; # 0
say $field->index_end; # '#'
=head1 DESCRIPTION
MARC::Spec::Field is the field specification of a L<MARC::Spec|MARC::Spec>.
See L<MARCspec - A common MARC record path language|http://marcspec.github.io/MARCspec/> for further
details on the syntax.
=head1 METHODS
Some methods are inherited from L<MARC::Spec::Structure|MARC::Spec::Structure>.
=head2 new(Str)
Create a new MARC::Spec::Field instance. Parameter must be a valid MARCspec field tag.
=head2 add_subspec(MARC::Spec::Subspec)
Appends a subspec to the array of the attribute subspecs. Parameter must be an instance of
L<MARC::Spec::Subspec|MARC::Spec::Subspec>.
=head2 add_subspecs(ArrayRef[MARC::Spec::Subspec])
Appends subspecs to the array of the attribute subspecs. Parameter must be an ArrayRef and
elements must be instances of L<MARC::Spec::Subspec|MARC::Spec::Subspec>.
=head2 to_string
Returns the spec as a string.
=head1 PREDICATES
Some predicates are inherited from L<MARC::Spec::Structure|MARC::Spec::Structure>.
=head2 has_char_start
True if attribute char_start has an value and false otherwise.
=head2 has_char_end
True if attribute char_end has an value and false otherwise.
=head2 has_char_pos
True if attribute char_pos has an value and false otherwise.
=head2 has_subspecs
Returns true if attribute subspecs has an value and false otherwise.
=head1 ATTRIBUTES
Some attributes are inherited from L<MARC::Spec::Structure|MARC::Spec::Structure>.
=head2 base
Obligatory. Scalar. The base Field spec without subspecs.
=head2 tag
Obligatory. The field tag.
=head2 char_pos
If defined, the character position or range. Only present if MARC::Spec::Field::$char_start is defined.
=head2 char_start
If defined, the beginning character position of a character position or range.
=head2 char_end
If defined, the ending character position of a character position or range.
Only present if MARC::Spec::Field::$char_start is defined.
=head2 char_length
The difference of MARC::Spec::Field::$char_start and MARC::Spec::Field::$char_end if both are numeric
(or else -1).
Only present if MARC::Spec::Field::$char_start is defined.
=head2 char_pos
If defined, the character position or range.
Only present if MARC::Spec::Field::$char_start is defined.
=head2 index_start
Obligatory. The beginning index of field repetitions. Maybe a positiv integer or the character '#'.
Default is 0.
=head2 index_end
Obligatory. The ending index of field repetitions. Maybe a positiv integer or the character '#'.
Default is '#'.
=head2 index_length
Obligatory. The difference of MARC::Spec::Field::$index_start and MARC::Spec::Field::$index_end if both are numeric.
Default is -1.
=head2 subspecs
Optional. An array of instances of L<MARC::Spec::Subspec|MARC::Spec::Subspec>, thus all subspecs in this
array MUST be validated as a combination with the boolean 'AND',
and/or an array of arrays (AoA) of instances of L<MARC::Spec::Subspec|MARC::Spec::Subspec>, thus all subspecs
in this AoA must be validated as a combination with the boolean 'OR'.
See L<MARC::Spec::Subspec|MARC::Spec::Subspec> for description of attributes of L<MARC::Spec::Subspec|MARC::Spec::Subspec>.
=head1 AUTHOR
Carsten Klee C<< <klee at cpan.org> >>
=head1 CONTRIBUTORS
=over
=item * Johann Rolschewski, C<< <jorol at cpan> >>
=back
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2016 by Carsten Klee.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=head1 BUGS
Please report any bugs to L<https://github.com/MARCspec/MARC-Spec/issues|https://github.com/MARCspec/MARC-Spec/issues>
=head1 SEE ALSO
=over
=item * L<MARC::Spec|MARC::Spec>
=item * L<MARC::Spec::Subfield|MARC::Spec::Subfield>
=item * L<MARC::Spec::Indicator|MARC::Spec::Indicator>
=item * L<MARC::Spec::Subspec|MARC::Spec::Subspec>
=item * L<MARC::Spec::Structure|MARC::Spec::Structure>
=item * L<MARC::Spec::Comparisonstring|MARC::Spec::Comparisonstring>
=item * L<MARC::Spec::Parser|MARC::Spec::Parser>
=back
=cut
|