Parse:...e::Tag(3pm)

💖 NAME 💖

Parse::BBCode::Tag — the Tag Class for Parse::BBCode 🏷️✨ (it's a Perl module, bestie, from the User Contributed Perl Documentation collection 🫶)

---

🌸 DESCRIPTION 🌸

okay so picture this: you parse some bbcode with Parse::BBCode, and Parse::BBCode::parse hands you back a parse tree made entirely of Tag objects. that's it. that's the whole vibe. every little tag you ever wrote is now a lil object in a tree and it's giving very organized, very demure 🌈

---

✨ METHODS ✨

• add_content

$tag->add_content('string');

glues 'string' right onto the end of the tag content. like adding a bead to a bracelet 💅

$tag->add_content($another_tag);

same energy, but it appends $another_tag to the end of the tag content instead. tag-on-tag, no cap 🎀

• raw_text

my $bbcode = $tag->raw_text;

gives you the raw text of the parse tree — so every tag gets converted back into bbcode. it's the un-parsing. the reverse slay 🔥

• raw_content

my $bbcode = $tag->raw_content;

returns the raw content of the tag without the opening and closing tags. so if you have a tag that was parsed from

[i]italic and [bold]test[/b][/i]

you get back

italic and [bold]test[/b]

(yes the tags are messy in that example, that's literally the point, we're showing you the inside bits only 🙈)

• walk

utility to do a breadth first search ('bfs') over the parsed tree 🌳

$tag->walk('bfs', sub {
        # tag is in $_
        ...
        return 0;
    });

when the sub returns 1 it stops walking the tree. super useful for finding a certain tag — like a little scavenger hunt but make it code 🔍💖

---

👑 ACCESSORS 👑

the accessors of a tag are currently

name attr attr_raw content finished start end close class

you can call each accessor with get_* and set_* — so get it, set it, live your truth 💅

• name — the tag name. for [i]...[/i] it is i, the lowercase tag name.
• attr — TODO 🙈 (yes that's really what it says, we're not hiding anything from you, bestie)
• attr_raw — the raw text of the attribute.
• content — an arrayref of the content of the tag, and each element is either a string or a tag itself. nesting! iconic.
• finished — used during parsing, true if the end of the tag was found. like a little checkbox that goes ✅ when the closing tag shows up.
• start — the original start string, e.g. "[size=7]"
• end — the original end string, e.g. "[/size]"
• close — true if the tag needs a closing tag. a tag which doesn't need a closing tag is [*] for example, inside of [list] tags.
• class — 'block', 'inline' or 'url'
• single — if this tag does not have a closing tag and also no content, like [hr], for example, set this to true. default is 0.
• num — absolute number of tag with this name in the tree. useful if you want to number code tags and offer download links. 🧮
• level — level of tag.

for the tag [u] in the following bbcode

[b]bold [i]italic [u]underlined[/u][/i][/b]

it returns 3. deep in the stack, three levels down, main character energy 🫶

---

quick vibe check: everything above is exactly what the module does — no invented features, no extra tips, just the facts wearing a cuter outfit ✨

---

and that's a wrap, bestie!! this page came from the User Contributed Perl Documentation for perl v5.34.0, dated 2022-06-16 — shoutout to that version and that date for making all of this possible 🎀🦋💖 mwah, go parse something gorgeous 💅