hw_getremotechildren(3) [php man page]

HW_GETREMOTECHILDREN(3) 						 1						   HW_GETREMOTECHILDREN(3)

hw_getremotechildren - Gets children of remote document

SYNOPSIS

       mixed hw_getremotechildren (int	$connection, string  $object_record)

DESCRIPTION

	Returns the children of a remote document. Children of a remote document are remote documents itself. This makes sense if a database query
       has to be narrowed and is explained in Hyperwave Programmers' Guide.

	If you want to use this function you should be very familiar with HGIs. You should also consider to use PHP instead of Hyperwave to access
       external sources. Adding database support by a Hyperwave gateway should be more difficult than doing it in PHP.

PARAMETERS

	      o $connection
		- The connection identifier.

	      o $object_record
		- The object record.

RETURN VALUES

	If  the  number  of  children is 1 the function will return the document itself formatted by the Hyperwave Gateway Interface (HGI). If the
       number of children is greater than 1 it will return an array of object record  with  each  maybe  the  input  value  for  another  call	to
       hw_getremotechildren(3).  Those	object	records  are  virtual and do not exist in the Hyperwave server, therefore they do not have a valid
       object ID. How exactly such an object record looks like is up to the HGI.

SEE ALSO

       hw_getremote(3).

PHP Documentation Group 												   HW_GETREMOTECHILDREN(3)

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)