110 lines
2.0 KiB
Plaintext
110 lines
2.0 KiB
Plaintext
=head1 NAME
|
|
|
|
XML::LibXML::Dtd - XML::LibXML DTD Handling
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
use XML::LibXML;
|
|
|
|
$dtd = XML::LibXML::Dtd->new($public_id, $system_id);
|
|
$dtd = XML::LibXML::Dtd->parse_string($dtd_str);
|
|
$publicId = $dtd->getName();
|
|
$publicId = $dtd->publicId();
|
|
$systemId = $dtd->systemId();
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This class holds a DTD. You may parse a DTD from either a string, or from an
|
|
external SYSTEM identifier.
|
|
|
|
No support is available as yet for parsing from a filehandle.
|
|
|
|
XML::LibXML::Dtd is a sub-class of L<<<<<< XML::LibXML::Node >>>>>>, so all the methods available to nodes (particularly toString()) are available
|
|
to Dtd objects.
|
|
|
|
|
|
=head1 METHODS
|
|
|
|
=over 4
|
|
|
|
=item new
|
|
|
|
$dtd = XML::LibXML::Dtd->new($public_id, $system_id);
|
|
|
|
Parse a DTD from the system identifier, and return a DTD object that you can
|
|
pass to $doc->is_valid() or $doc->validate().
|
|
|
|
|
|
|
|
my $dtd = XML::LibXML::Dtd->new(
|
|
"SOME // Public / ID / 1.0",
|
|
"test.dtd"
|
|
);
|
|
my $doc = XML::LibXML->new->parse_file("test.xml");
|
|
$doc->validate($dtd);
|
|
|
|
|
|
=item parse_string
|
|
|
|
$dtd = XML::LibXML::Dtd->parse_string($dtd_str);
|
|
|
|
The same as new() above, except you can parse a DTD from a string. Note that
|
|
parsing from string may fail if the DTD contains external parametric-entity
|
|
references with relative URLs.
|
|
|
|
|
|
=item getName
|
|
|
|
$publicId = $dtd->getName();
|
|
|
|
Returns the name of DTD; i.e., the name immediately following the DOCTYPE
|
|
keyword.
|
|
|
|
|
|
=item publicId
|
|
|
|
$publicId = $dtd->publicId();
|
|
|
|
Returns the public identifier of the external subset.
|
|
|
|
|
|
=item systemId
|
|
|
|
$systemId = $dtd->systemId();
|
|
|
|
Returns the system identifier of the external subset.
|
|
|
|
|
|
|
|
=back
|
|
|
|
=head1 AUTHORS
|
|
|
|
Matt Sergeant,
|
|
Christian Glahn,
|
|
Petr Pajas
|
|
|
|
|
|
=head1 VERSION
|
|
|
|
2.0207
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
2001-2007, AxKit.com Ltd.
|
|
|
|
2002-2006, Christian Glahn.
|
|
|
|
2006-2009, Petr Pajas.
|
|
|
|
=cut
|
|
|
|
|
|
=head1 LICENSE
|
|
|
|
This program is free software; you can redistribute it and/or modify it under
|
|
the same terms as Perl itself.
|
|
|