NAME

XML::DTD - Perl module for parsing XML DTDs

SYNOPSIS

  use XML::DTD;

  my $dtd = new XML::DTD;
  open(FH,'<file.dtd');
  $dtd->fread(*FH);
  close(FH);
  $dtd->fwrite(*STDOUT);

ABSTRACT

  XML::DTD is a Perl module for parsing XML DTD files.

DESCRIPTION

  XML::DTD is a Perl module for parsing XML DTDs. The following
  methods are provided.

new

  $dtd = new XML::DTD [ ($val) ];

Constructs a new XML::DTD object.

Its parser will be validating, and hence will make parameter entity substitutions, if the argument $val is present and has a boolean value of true.

fread

  $dtd->fread(*FILEHANDLE [, $uri]);

Parse a DTD file. If the URI is passed, it is used as the URI for the document entity.

sread

  $dtd->sread($string [, $uri]);

Parse DTD text in a string. If the URI is passed, it is used as the URI for the document entity.

fwrite

  $dtd->fwrite(*FILEHANDLE);

Write the DTD to a file.

swrite

  $string = $dtd->swrite();

Return the DTD text as a string.

fwritexml

  $dtd->fwritexml(*FILEHANDLE);

Write an XML representation of the DTD to a file.

swritexml

  $string = $dtd->swritexml();

Return an XML representation of the DTD text as a string.

elementnames

  $elts = $dtd->elementnames;

Return an array of element names as an array reference.

element

  $eltobj = $dtd->element('elementname');

Return the element object (of type XML::DTD::Element) associated with the specified name.

attlist

  $attlistobj = $dtd->attlist('elementname');

Return the attribute list object (of type XML::DTD::AttList) associated with the specified name.

entman

  $entmanobj = $dtd->entman;

Return the associated entity manager object (of type XML::DTD::EntityManager).

SEE ALSO

XML::DTD::Parser, XML::DTD::Element, XML::DTD::Attlist, XML::DTD::EntityManager, The XML 1.0 W3C Recommendation at http://www.w3.org/TR/REC-xml/

AUTHOR

Brendt Wohlberg <wohl@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2004-2010 by Brendt Wohlberg

This library is available under the terms of the GNU General Public License (GPL), described in the GPL file included in this distribution.

ACKNOWLEDGMENTS

Peter Lamb <Peter.Lamb@csiro.au> added fetching of external entities and improved entity substitution.