MARC::...bfield(3pm)

✨ NAME ✨

okay bestie, first things first — this is the manual page for MARC::Spec::Subfield, and it's a subfield specification 💅. You pulled this up from the User Contributed Perl Documentation (the page header says MARC::...bfield(3pm), iykyk, the name just got truncated and honestly relatable 💀).

---

🦋 SYNOPSIS 🦋

the vibe check, in code:

use MARC::Spec;

my $ms = MARC::Spec->new('245$a/0-2);
say ref $ms->subfields;                     # ARRAY
say ref $ms->subfields->[0];                # MARC::Spec::Subfield

no cap, that's the whole flex 🔥

---

🌈 DESCRIPTION 🌈

MARC::Spec::Subfield is the subfield specification of a MARC::Spec. it's giving very specific, very structured, very much the main character of a subfield 🎀

for the full tea on the syntax, go read MARCspec - A common MARC record path language at http://marcspec.github.io/MARCspec/ — that's the source of truth, bestie.

---

💖 METHODS 💖

some methods are inherited from MARC::Spec::Structure — so when you see them here, just know they're visiting from the family, periodt 🫶

🌸 new

Create a new MARC::Spec::Subfield instance. brand new, fresh out the box, slay ✨

🌸 add_subspec(MARC::Spec::Subspec)

Appends a subspec to the array of the attribute subspecs. The parameter must be an instance of MARC::Spec::Subspec.

Inherited from MARC::Spec::Structure.

🌸 add_subspecs(ArrayRef[MARC::Spec::Subspec])

Appends subspecs to the array of the attribute subspecs. The parameter must be an ArrayRef, and every element must be an instance of MARC::Spec::Subspec.

Inherited from MARC::Spec::Structure.

🌸 to_string

Returns the spec as a string. it's literally the spec, but stringified 💅

Inherited from MARC::Spec::Structure.

---

🧚 PREDICATES 🧚

some predicates are inherited from MARC::Spec::Structure — we love a shared inheritance moment 💜

🦋 has_char_start

True if attribute char_start has an value and false otherwise.

🦋 has_char_end

True if attribute char_end has an value and false otherwise.

🦋 has_char_pos

True if attribute char_pos has an value and false otherwise.

🦋 has_subspecs

Returns true if attribute subspecs has an value and false otherwise.

---

👑 ATTRIBUTES 👑

some attributes are inherited from MARC::Spec::Structure — iconic behaviour honestly 💫

🌟 base

Obligatory. The base Subfield spec without subspecs.

🌟 code

Obligatory. The subfield code.

🌟 char_pos

If defined, the character position or range. Only present if MARC::Spec::Subfield::$char_start is defined.

🌟 char_start

If defined, the beginning character position of a character position or range.

🌟 char_end

If defined, the ending character position of a character position or range. Only present if MARC::Spec::Subfield::$char_start is defined.

🌟 char_length

The difference of MARC::Spec::Subfield::$char_start and MARC::Spec::Field::$char_end if both are numeric (or else -1). Only present if MARC::Spec::Subfield::$char_start is defined.

🌟 index_start

Obligatory. The beginning index of subfield repetitions. Maybe a positive integer or the character '#'. Default is 0.

🌟 index_end

Obligatory. The ending index of subfield repetitions. Maybe a positive integer or the character '#'. Default is '#'.

🌟 index_length

Obligatory. The difference of MARC::Spec::Subfield::$index_start and MARC::Spec::Subfield::$index_end if both are numeric. Default is -1.

🌟 subspecs

Optional: an array of instances of MARC::Spec::Subspec — and that means 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 MARC::Spec::Subspec, which means all subspecs in this AoA must be validated as a combination with the boolean 'OR'.

See MARC::Spec::Subspec for description of attributes of MARC::Spec::Subspec.

ok this one is the whole plot twist, read it twice bestie 😭

---

🫶 AUTHOR 🫶

Carsten Klee "<klee at cpan.org>"

---

🌸 CONTRIBUTORS 🌸

• Johann Rolschewski, "<jorol at cpan>"

---

🎀 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.

---

💀 BUGS 💀

Please report any bugs to https://github.com/MARCspec/MARC-Spec/issues — they're not gonna bite, fr fr 🙈

---

🌈 SEE ALSO 🌈

• MARC::Spec
• MARC::Spec::Field
• MARC::Spec::Indicator
• MARC::Spec::Subspec
• MARC::Spec::Structure
• MARC::Spec::Comparisonstring
• MARC::Spec::Parser

---

and that's the page, bestie 🦋💖 go forth and spec your subfields, you absolute icon 👑

sign-off: this was perl v5.34.0, dated 2022-06-15 — love that for us, no notes 💅✨