™.. XML::Grove::Factory - Online Linux Manual PageSection : 3
Updated : 1999-09-03
Source : perl v5.10.1
Note : User Contributed Perl Documentation
NAMEXML::Grove::Factory − simplify creation of XML::Grove objects
SYNOPSIS​ use XML::Grove::Factory; ​ ​ ### An object that creates Grove objects directly ​ my $gf = XML::Grove::Factory−>grove_factory; ​ ​ $grove = $gf−>document( CONTENTS ); ​ $element = $gf−>element( $name, { ATTRIBUTES }, CONTENTS ); ​ $pi = $gf−>pi( $target, $data ); ​ $comment = $gf−>comment( $data ); ​ ​ ### An object that creates elements by method name ​ my $ef = XML::Grove::Factory−>element_factory(); ​ ​ $element = $ef−>NAME( { ATTRIBUTES }, CONTENTS); ​ ​ ### Similar to `element_factory', but creates functions in the ​ ### current package ​ XML::Grove::Factory−>element_functions( PREFIX, ELEMENTS ); ​ ​ $element = NAME( { ATTRIBUTES }, CONTENTS );
DESCRIPTION​\*(C`XML::Grove::Factory\*(C'\fR provides objects or defines functions that let you simply and quickly create the most commonly used XML::Grove objects. \*(C`XML::Grove::Factory\*(C'\fR supports three types of object creation. The first type is to create raw XML::Grove objects. The second type creates XML elements by element name. The third type is like the second, but defines local functions for you to call instead of using an object, which might save typing in some cases. The three types of factories can be mixed. For example, you can use local functions for all element names that don't conflict with your own sub names or contain special characters, and then use a `\*(C`grove_factory()\*(C'\fR' object for those elements that do conflict. In the examples that follow, each example is creating an XML instance similar to the following, assuming it's pretty printed: ​ <?xml version="1.0"?> ​ <HTML> ​ <HEAD> ​ <TITLE>Some Title</TITLE> ​ </HEAD> ​ <BODY bgcolor="#FFFFFF"> ​ <P>A paragraph.</P> ​ </BODY> ​ </HTML>
GROVE FACTORY$gf = XML::Grove::Factory−>grove_factory() Creates a new grove factory object that creates raw XML::Grove objects. $gf−>document( CONTENTS ); Creates an XML::Grove::Document object. CONTENTS may contain processing instructions, strings containing only whitespace characters, and a single element object (but note that there is no checking). Strings are converted to XML::Grove::Characters objects. $gf−>element($name, CONTENTS); $gf−>element($name, { ATTRIBUTES }, CONTENTS); Creates an XML::Grove::Element object with the name `$name'. If the argument following `$name' is an anonymous hash, ATTRIBUTES, then they will be copied to the elements attributes. CONTENTS will be stored in the element's content (note that there is no validity checking). Strings in CONTENTS are converted to XML::Grove::Characters objects. $gf−>pi( TARGET, DATA) $gf−>pi( DATA ) Create an XML::Grove::PI object with TARGET and DATA. $gf−>comment( DATA ) Create an XML::Grove::Comment object with DATA.
GROVE FACTORY EXAMPLE​ use XML::Grove::Factory; ​ ​ $gf = XML::Grove::Factory−>grove_factory; ​ ​ $element = ​ $gf−>element('HTML', ​ $gf−>element('HEAD', ​ $gf−>element('TITLE', 'Some Title')), ​ $gf−>element('BODY', { bgcolor => '#FFFFFF' }, ​ $gf−>element('P', 'A paragraph.')));
ELEMENT FACTORY$ef = XML::Grove::Factory−>element_factory() Creates a new element factory object for creating elements. `\*(C`element_factory()\*(C'\fR' objects work by creating an element for any name used to call the object. $ef−>NAME( CONTENTS ) $ef−>NAME( { ATTRIBUTES }, CONTENTS) Creates an XML::Grove::Element object with the given NAME, ​ATTRIBUTES, and CONTENTS. The hash containing ATTRIBUTES is optional if this element doesn't need attributes. Strings in ​CONTENTS are converted to XML::Grove::Characters objects.
ELEMENT FACTORY EXAMPLE​ use XML::Grove::Factory; ​ ​ $ef = XML::Grove::Factory−>element_factory(); ​ ​ $element = ​ $ef−>HTML( ​ $ef−>HEAD( ​ $ef−>TITLE('Some Title')), ​ $ef−>BODY({ bgcolor => '#FFFFFF' }, ​ $ef−>P('A paragraph.')));
ELEMENT FUNCTIONSXML::Grove::Factory−>element_functions (PREFIX, ELEMENTS) Creates functions in the current package for creating elements with the names provided in the list ELEMENTS. PREFIX will be prepended to every function name, or PREFIX can be an empty string ('') if you're confident that there won't be any conflicts with functions in your package. NAME( CONTENTS ) NAME( { ATTRIBUTES }, CONTENTS ) PREFIXNAME( CONTENTS ) PREFIXNAME( { ATTRIBUTES }, CONTENTS ) Functions created for `\*(C`\f(CINAME\f(CW\*(C'\fR' or `\f(CW\*(C`\f(CIPREFIX\f(CW\f(CINAME\f(CW\*(C'\fR' can be called to create XML::Grove::Element objects with the given NAME, ​ATTRIBUTES, and CONTENT. The hash containing ATTRIBUTES is optional if this element doesn't need attributes. Strings in ​CONTENT are converted to XML::Grove::Characters objects.
ELEMENT FACTORY EXAMPLE​ use XML::Grove::Factory; ​ ​ XML::Grove::Factory−>element_functions('', qw{ HTML HEAD TITLE BODY P }); ​ ​ $element = ​ HTML( ​ HEAD( ​ TITLE('Some Title')), ​ BODY({ bgcolor => '#FFFFFF' }, ​ P('A paragraph.')));
AUTHORKen MacLeod, ken@bitsko.slc.ut.us Inspired by the HTML::AsSubs module by Gisle Aas.
SEE ALSO​perl (1), XML::Grove (3). Extensible Markup Language (XML) <http://www.w3c.org/XML>
POD ERRORSHey! The above document had some coding errors, which are explained below: Around line 307: You forgot a '=back' before '=head2' 0
Johanes Gumabo
Data Size   :   27,727 byte
man-XML::Grove::Factory.3pmBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 236,770
Visitor ID   :     :  
Visitor IP   :   3.12.34.211   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding :         (parse_manual_page_|249|XML::Grove::Factory.3pm|36/37|el══─{─══.|.el══─{─══. ds -- \|\(em\| )         (htmlprn|149|XML::Grove::Factory.3pm|36/37|.el══─{─══. ds --  —  |.el══─{─══. ds -- \|\(em\| )         (parse_manual_page_|249|XML::Grove::Factory.3pm|41|br══─}─══|'br══─}─══ )         (htmlprn|149|XML::Grove::Factory.3pm|41|'br══─}─══ |'br══─}─══ )         (rof_nr_x|149|XML::Grove::Factory.3pm|51/52|\nF|.ie \nF ══─{─══. de IX )         (rof_unit_scale_px|41|XML::Grove::Factory.3pm|51/52|F|.ie \nF ══─{─══. de IX )         (rof_if|19|XML::Grove::Factory.3pm|51/52|\nF|.ie \nF ══─{─══. de IX )         (htmlprn|149|XML::Grove::Factory.3pm|51/52|.ie \nF ══─{─══. de IX|.ie \nF ══─{─══. de IX )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|53|\$1\t\\n%\t"\\$2" |. tm Index:\\$1\t\\n%\t"\\$2" )         (parse_manual_page_|249|XML::Grove::Factory.3pm|57|══─}─══|.══─}─══ )         (htmlprn|149|XML::Grove::Factory.3pm|57|.══─}─══ |.══─}─══ )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|160|\*(C`XML::Grove::Factory\*(C'\fR provides objects or defines functions that let |\&\f(CW\*(C`XML::Grove::Factory\*(C'\fR provides objects or defines functions that let )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|162|\*(C`XML::Grove::Factory\*(C'\fR supports three types of object |objects. \f(CW\*(C`XML::Grove::Factory\*(C'\fR supports three types of object )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|171|\*(C`grove_factory()\*(C'\fR' object for those elements that do conflict. |`\f(CW\*(C`grove_factory()\*(C'\fR' object for those elements that do conflict. )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|248|\*(C`element_factory()\*(C'\fR' objects work by creating an element for any |`\f(CW\*(C`element_factory()\*(C'\fR' objects work by creating an element for any )         (rof_escape_sequence|91|XML::Grove::Factory.3pm|295|\*(C`\f(CINAME\f(CW\*(C'\fR' or `\f(CW\*(C`\f(CIPREFIX\f(CW\f(CINAME\f(CW\*(C'\fR' can be |Functions created for `\f(CW\*(C`\f(CINAME\f(CW\*(C'\fR' or `\f(CW\*(C`\f(CIPREFIX\f(CW\f(CINAME\f(CW\*(C'\fR' can be )