If you look at the API of
XML::Writer you will see that to create a tag, you make a call like this:
$writer->startTag('doc', 'version' => '1.0',
'status' => 'draft',
'topic' => 'AT&T');
Notice that you pass a single flat list, even though there are two semantic elements being passed - the tag name and the tag's attributes.
In XML::Writer::Nest, I decided to break with this convention (even though the current CPAN version honors it).
The reason why
- You get the tag name visually distinct from its attributes...
- Your API clearly separates arguments that are separate
- Passing an array reference is more efficient than pass by value? Help me out here..
- Easier to extend. If you decide you need an additional parameter to this sub, then one more positional parm is easy if each original parm is just a scalar. Otherwise, you have to start popping values off the end of @_ and other things to get at extra values.
So, with the soon-to-be-uploaded version of
XML::Writer::Nest, you will write:
{
my $nest = XML::Writer::Nest->(tag => 'level1');
{ $nest->nest(newlevel => [attr1 => 1, attr2 => 2]);
...
}
}
instead of
{
my $nest = XML::Writer::Nest->(tag => 'level1');
{ $nest->nest(newlevel , attr1 => 1, attr2 => 2);
...
}
}