sam-t2/devtools/amd64/html/python/lib/dom-documenttype-objects.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index' />
<link rel="first" href="lib.html" title='Python Library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="dom-document-objects.html" />
<link rel="prev" href="dom-nodelist-objects.html" />
<link rel="parent" href="node652.html" />
<link rel="next" href="dom-document-objects.html" />
<meta name='aesop' content='information' />
<title>13.6.2.4 DocumentType Objects </title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="13.6.2.3 NodeList Objects"
  href="dom-nodelist-objects.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="13.6.2 Objects in the"
  href="node652.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="13.6.2.5 Document Objects"
  href="dom-document-objects.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="dom-nodelist-objects.html">13.6.2.3 NodeList Objects</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node652.html">13.6.2 Objects in the</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="dom-document-objects.html">13.6.2.5 Document Objects</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H3><A NAME="SECTION0015624000000000000000"></A><A NAME="dom-documenttype-objects"></A>
<BR>
13.6.2.4 DocumentType Objects
</H3>

<P>
Information about the notations and entities declared by a document
(including the external subset if the parser uses it and can provide
the information) is available from a <tt class="class">DocumentType</tt> object.  The
<tt class="class">DocumentType</tt> for a document is available from the
<tt class="class">Document</tt> object's <tt class="member">doctype</tt> attribute; if there is no
<code>DOCTYPE</code> declaration for the document, the document's
<tt class="member">doctype</tt> attribute will be set to <code>None</code> instead of an
instance of this interface.

<P>
<tt class="class">DocumentType</tt> is a specialization of <tt class="class">Node</tt>, and adds the
following attributes:

<P>
<dl><dt><b><tt id='l2h-4387' xml:id='l2h-4387' class="member">publicId</tt></b></dt>
<dd>
  The public identifier for the external subset of the document type
  definition.  This will be a string or <code>None</code>.
</dl>

<P>
<dl><dt><b><tt id='l2h-4388' xml:id='l2h-4388' class="member">systemId</tt></b></dt>
<dd>
  The system identifier for the external subset of the document type
  definition.  This will be a URI as a string, or <code>None</code>.
</dl>

<P>
<dl><dt><b><tt id='l2h-4389' xml:id='l2h-4389' class="member">internalSubset</tt></b></dt>
<dd>
  A string giving the complete internal subset from the document.
  This does not include the brackets which enclose the subset.  If the
  document has no internal subset, this should be <code>None</code>.
</dl>

<P>
<dl><dt><b><tt id='l2h-4390' xml:id='l2h-4390' class="member">name</tt></b></dt>
<dd>
  The name of the root element as given in the <code>DOCTYPE</code>
  declaration, if present.
</dl>

<P>
<dl><dt><b><tt id='l2h-4391' xml:id='l2h-4391' class="member">entities</tt></b></dt>
<dd>
  This is a <tt class="class">NamedNodeMap</tt> giving the definitions of external
  entities.  For entity names defined more than once, only the first
  definition is provided (others are ignored as required by the XML
  recommendation).  This may be <code>None</code> if the information is not
  provided by the parser, or if no entities are defined.
</dl>

<P>
<dl><dt><b><tt id='l2h-4392' xml:id='l2h-4392' class="member">notations</tt></b></dt>
<dd>
  This is a <tt class="class">NamedNodeMap</tt> giving the definitions of notations.
  For notation names defined more than once, only the first definition
  is provided (others are ignored as required by the XML
  recommendation).  This may be <code>None</code> if the information is not
  provided by the parser, or if no notations are defined.
</dl>

<P>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="13.6.2.3 NodeList Objects"
  href="dom-nodelist-objects.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="13.6.2 Objects in the"
  href="node652.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="13.6.2.5 Document Objects"
  href="dom-document-objects.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="dom-nodelist-objects.html">13.6.2.3 NodeList Objects</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="node652.html">13.6.2 Objects in the</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="dom-document-objects.html">13.6.2.5 Document Objects</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>