domdocument.getelementbyid(3) [php man page]

DOMDOCUMENT.GETELEMENTBYID(3)						 1					     DOMDOCUMENT.GETELEMENTBYID(3)

DOMDocument::getElementById - Searches for an element with a certain id

SYNOPSIS

       public DOMElement DOMDocument::getElementById (string  $elementId)

DESCRIPTION

	This function is similar to "DOMDocument::getElementsByTagName" but searches for an element with a given id.

	For  this  function  to  work,	you will need either to set some ID attributes with "DOMElement::setIdAttribute" or a DTD which defines an
       attribute to be of type ID. In the later case, you will need to validate your document with "DOMDocument::validate" or  DOMDocument::$vali-
       dateOnParse before using this function.

PARAMETERS

	      o $elementId
		- The unique id value for an element.

RETURN VALUES

	Returns the DOMElement or NULL if the element is not found.

EXAMPLES

       Example #1

	      DOMDocument::getElementById() Example

	      The following examples use book.xml which contains the following:

	      <?xml version="1.0" encoding="UTF-8"?>
	      <!DOCTYPE books [
		<!ELEMENT books   (book+)>
		<!ELEMENT book	  (title, author+, xhtml:blurb?)>
		<!ELEMENT title   (#PCDATA)>
		<!ELEMENT blurb   (#PCDATA)>
		<!ELEMENT author  (#PCDATA)>
		<!ATTLIST books   xmlns        CDATA  #IMPLIED>
		<!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
		<!ATTLIST book	  id	       ID     #IMPLIED>
		<!ATTLIST author  email        CDATA  #IMPLIED>
	      ]>
	      <?xml-stylesheet type="text/xsl" href="style.xsl"?>
	      <books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
		<book id="php-basics">
		  <title>PHP Basics</title>
		  <author email="jim.smith@basics.php">Jim Smith</author>
		  <author email="jane.smith@basics.php">Jane Smith</author>
		  <xhtml:blurb><![CDATA[
	      <p><em>PHP Basics</em> provides an introduction to PHP.</p>
	      ]]></xhtml:blurb>
		</book>
		<book id="php-advanced">
		  <title>PHP Advanced Programming</title>
		  <author email="jon.doe@advanced.php">Jon Doe</author>
		</book>
	      </books>

	      <?php

	      $doc = new DomDocument;

	      // We need to validate our document before refering to the id
	      $doc->validateOnParse = true;
	      $doc->Load('book.xml');

	      echo "The element whose id is 'php-basics' is: " . $doc->getElementById('php-basics')->tagName . "
";

	      ?>

	      The above example will output:

	      The element whose id is 'php-basics' is: book

SEE ALSO

       DOMDocument::getElementsByTagName.

PHP Documentation Group 											     DOMDOCUMENT.GETELEMENTBYID(3)

Check Out this Related Man Page

DOMDOCUMENT.SAVEXML(3)							 1						    DOMDOCUMENT.SAVEXML(3)

DOMDocument::saveXML - Dumps the internal XML tree back into a string

SYNOPSIS

       public string DOMDocument::saveXML ([DOMNode  $node], [int  $options])

DESCRIPTION

	Creates  an XML document from the DOM representation. This function is usually called after building a new dom document from scratch as in
       the example below.

PARAMETERS

	      o $node
		- Use this parameter to output only a specific node without XML declaration rather than the entire document.

	      o $options
		- Additional Options. Currently only LIBXML_NOEMPTYTAG is supported.

RETURN VALUES

	Returns the XML, or FALSE if an error occurred.

ERRORS
/EXCEPTIONS
	      o DOM_WRONG_DOCUMENT_ERR - Raised if $node is from another document.

CHANGELOG

       +--------+-------------------------------+
       |Version |				|
       |	|				|
       |	|	   Description		|
       |	|				|
       +--------+-------------------------------+
       | 5.1.0	|				|
       |	|				|
       |	|  Added the $options parameter |
       |	|				|
       +--------+-------------------------------+
EXAMPLES

       Example #1

	      Saving a DOM tree into a string

	      <?php

	      $doc = new DOMDocument('1.0');
	      // we want a nice output
	      $doc->formatOutput = true;

	      $root = $doc->createElement('book');
	      $root = $doc->appendChild($root);

	      $title = $doc->createElement('title');
	      $title = $root->appendChild($title);

	      $text = $doc->createTextNode('This is the title');
	      $text = $title->appendChild($text);

	      echo "Saving all the document:
";
	      echo $doc->saveXML() . "
";

	      echo "Saving only the title part:
";
	      echo $doc->saveXML($title);

	      ?>

	      The above example will output:

	      Saving all the document:
	      <?xml version="1.0"?>
	      <book>
		<title>This is the title</title>
	      </book>

	      Saving only the title part:
	      <title>This is the title</title>

SEE ALSO

       DOMDocument::save, DOMDocument::load, DOMDocument::loadXML.

PHP Documentation Group 												    DOMDOCUMENT.SAVEXML(3)

Linux and UNIX Man Pages

domdocument.getelementbyid(3) [php man page]

Check Out this Related Man Page