XML::Smart::DTD(3pm)

💖 NAME 💖

Hey bestie, welcome to XML::Smart::DTD(3pm) from the User Contributed Perl Documentation. She's a DTD parser for XML::Smart, and this page is literally all about her. 💅

XML::Smart::DTD — DTD parser for XML::Smart.

---

✨ DESCRIPTION ✨

Okay so this parses DTD and gives you methods to access the info stored in the DTD. That's the whole serve. Periodt. ✨

🌸 USAGE 🌸

use XML::Smart::DTD ;

my $dtd = XML::Smart::DTD->new('some.dtd') ;

if ( $dtd->child_exists('tag1','subtag1') ) {
...
}

use Data::Dumper ;
print Dumper( $dtd->tree ) ;

🌱 new 🌱

The page just drops new here, so we're keeping it exactly like that. No extra lore, bestie. 🫶

💅 METHODS 💅

🎀 attr_exists ( TAG , ATTR ) 🎀

Returns TRUE if the attribute exists in the element TAG. Slay.

🎀 child_exists ( TAG , CHILD ) 🎀

Returns TRUE if the child exists in the element TAG.

🎀 elem_exists ( TAG ) 🎀

Returns TRUE if the element TAG exists.

🎀 error 🎀

Returns the error list. Errors, but make it accessible.

🎀 get_attr_def ( TAG , ATTR ) 🎀

Returns the default value of an attribute.

🎀 get_attr_type ( TAG , ATTR ) 🎀

Returns the attribute type.

🎀 get_attr_values ( TAG , ATTR ) 🎀

Returns the defined values of an attribute.

🎀 get_attrs ( TAG ) 🎀

Returns the attribute list of an element.

🎀 get_attrs_req ( TAG ) 🎀

Returns the required attribute list of an element.

🎀 get_childs ( TAG ) 🎀

Returns the child list of an element.

🎀 get_childs_req ( TAG ) 🎀

Returns the required child list of an element.

🎀 get_elem_opt ( TAG ) 🎀

Returns the occurrence option of an element:

!  REQUIRED AND ONLY ONE MATCH
+  1 or more
*  0 or more
?  0 or 1

🎀 get_elem_child_opt ( TAG , CHILD ) 🎀

Same as get_elem_opt(), but for this element as a child of an element. iykyk.

🎀 is_attr_fix ( TAG , ATTR ) 🎀

Returns TRUE if an attribute is FIXED.

🎀 is_attr_req ( TAG , ATTR ) 🎀

Returns TRUE if an attribute is REQUIRED.

🎀 is_elem_any ( TAG ) 🎀

Returns TRUE if an element is ANY.

🎀 is_elem_child_multi ( TAG , CHILD ) 🎀

Returns TRUE if an element can have multiple occurrences as a child of TAG.

🎀 is_elem_child_opt ( TAG , CHILD ) 🎀

Returns TRUE if an element is optional as a child of TAG.

🎀 is_elem_child_req ( TAG , CHILD ) 🎀

Returns TRUE if an element is optional as a child of TAG.

⚠️ Heads up: the page literally says “optional” for is_elem_child_req, not “required.” I'm just the messenger, bestie. 💀

🎀 is_elem_child_uniq ( TAG , CHILD ) 🎀

Returns TRUE if an element is required and unique as a child of TAG.

🎀 is_elem_pcdata ( TAG ) 🎀

Returns TRUE if an element is PCDATA (has content).

🎀 is_elem_empty ( TAG ) 🎀

Returns TRUE if an element is EMPTY (doesn't have attributes, content or children). No cap.

🎀 is_elem_multi ( TAG ) 🎀

Returns TRUE if an element can have multiple occurrences globally.

🎀 is_elem_opt ( TAG ) 🎀

Returns TRUE if an element is optional globally.

🎀 is_elem_parent ( TAG , @PARENTS ) 🎀

Returns TRUE if the list of @PARENTS can be parent of element TAG.

🎀 is_elem_req 🎀

Returns TRUE if an element is required globally.

🎀 is_elem_uniq 🎀

Returns TRUE if an element is unique and required globally.

🎀 root 🎀

Returns the root name of the DTD.

🎀 tree 🎀

Returns the HASH tree of the DTD. Main character data structure energy.

🌈 SEE ALSO 🌈

XML::Smart, XML::DTDParser. Go look, bestie. 💖

🫶 AUTHOR 🫶

Graciliano M. P. <gm@virtuasites.com.br> wrote this. He says: “I will appreciate any type of feedback (include your opinions and/or suggestions). ;-P” Feedback is love, feedback is life.

🎀 THANKS 🎀

Thanks to Jenda@Krynicky.cz http://Jenda.Krynicky.cz — that's the author of XML::DTDParser. 🫶

👑 COPYRIGHT 👑

The DTD parser was based on XML-DTDParser-1.7 by Jenda@Krynicky.cz http://Jenda.Krynicky.cz.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

This page is XML::Smart::DTD(3pm) from the User Contributed Perl Documentation, and the footer says perl v5.36.0 + 2022-11-19. Bye bestie, slay your DTDs 💖✨