hw_gettext(3) [php man page]

HW_GETTEXT(3)								 1							     HW_GETTEXT(3)

hw_GetText - Retrieve text document

SYNOPSIS

       int hw_gettext (int  $connection, int  $objectID, [mixed  $rootID/prefix])

DESCRIPTION

	Returns the document with object ID $objectID. If the document has anchors which can be inserted, they will be inserted already.

	This  function will only work for pure text documents. It will not open a special data connection and therefore blocks the control connec-
       tion during the transfer.

PARAMETERS

	      o $connection
		- The connection identifier.

	      o $objectID
		- The object identifier.

	      o $rootID/prefix
		- The optional parameter $rootID/prefix can be a string or an integer. If it is an integer it determines how  links  are  inserted
		into  the document. The default is 0 and will result in links that are constructed from the name of the link's destination object.
		This is useful for web applications. If a link points  to  an  object  with  name  'internet_movie'  the  HTML	link  will  be	<A
		href="/internet_movie">.  The  actual  location of the source and destination object in the document hierarchy is disregarded. You
		will have to set up your web browser, to rewrite that URL to for  example  '/my_script.php/internet_movie'.  'my_script.php'  will
		have  to  evaluate $PATH_INFO and retrieve the document. All links will have the prefix '/my_script.php/'. If you do not want this
		you can set the optional parameter $rootID/prefix to any prefix which is used instead. Is this case it has to  be  a  string.	If
		$rootID/prefix	is  an	integer  and  unequal  to  0 the link is constructed from all the names starting at the object with the id
		$rootID/prefix separated by a slash relative to the current object.  If for example the above document 'internet_movie' is located
		at 'a-b-c-internet_movie' with '-' being the separator between hierarchy levels on the Hyperwave server and the source document is
		located at 'a-b-d-source' the resulting HTML link would be: <A HREF="../c/internet_movie">. This is useful if you want to download
		the whole server content onto disk and map the document hierarchy onto the file system.

RETURN VALUES

	Returns the text document.

SEE ALSO

       hw_pipedocument(3), hw_free_document(3), hw_document_bodytag(3), hw_document_size(3), hw_output_document(3).

PHP Documentation Group 													     HW_GETTEXT(3)

SIMPLEXML_LOAD_STRING(3)						 1						  SIMPLEXML_LOAD_STRING(3)

simplexml_load_string - Interprets a string of XML into an object

SYNOPSIS

       SimpleXMLElement  simplexml_load_string	(string   $data,  [string  $class_name = "SimpleXMLElement"], [int  $options], [string	$ns = ""],
       [bool  $is_prefix = false])

DESCRIPTION

	Takes a well-formed XML string and returns it as an object.

PARAMETERS

	      o $data
		- A well-formed XML string

	      o $class_name
		- You may use this optional parameter so that simplexml_load_string(3) will return an object of the specified  class.  That  class
		should extend the SimpleXMLElement class.

	      o $options
		- Since PHP 5.1.0 and Libxml 2.6.0, you may also use the $options parameter to specify additional Libxml parameters.

	      o $ns
		- Namespace prefix or URI.

	      o $is_prefix
		- TRUE if $ns is a prefix, FALSE if it's a URI; defaults to FALSE.

RETURN VALUES

	Returns an object of class SimpleXMLElement with properties containing the data held within the xml document, or FALSE on failure.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

ERRORS
/EXCEPTIONS
	Produces an E_WARNING error message for each error found in the XML data.

       Tip

	       Use libxml_use_internal_errors(3) to suppress all XML errors, and libxml_get_errors(3) to iterate over them afterwards.

EXAMPLES

       Example #1

	      Interpret an XML string

	      <?php
	      $string = <<<XML
	      <?xml version='1.0'?>
	      <document>
	       <title>Forty What?</title>
	       <from>Joe</from>
	       <to>Jane</to>
	       <body>
		I know that's the answer -- but what's the question?
	       </body>
	      </document>
	      XML;

	      $xml = simplexml_load_string($string);

	      print_r($xml);
	      ?>

	      The above example will output:

	      SimpleXMLElement Object
	      (
		[title] => Forty What?
		[from] => Joe
		[to] => Jane
		[body] =>
		 I know that's the answer -- but what's the question?
	      )

	       At this point, you can go about using $xml->body and such.

SEE ALSO

       simplexml_load_file(3), SimpleXMLElement::__construct, "Dealing with XML errors", libxml_use_internal_errors(3), "Basic SimpleXML usage".

PHP Documentation Group 												  SIMPLEXML_LOAD_STRING(3)