hw_GetText
(PHP 4)
hw_GetText — R�cup�re un document texte
Description
Retourne le document de l'objet objectID . Si le document poss�de des ancrages qui peuvent �tre ins�r�s, ils le seront d�j�.
hw_gettext() n'est op�rationnelle qu'avec des documents de pur texte. Elle n'ouvrira pas de canal sp�cial de transfert et, ainsi, bloquera le script le temps du transfert.
Liste de param�tres
- connection
-
L'identifiant de connection.
- objectID
-
L'identifiant de l'objet.
- rootID/prefix
-
L'option rootID/prefix peut �tre une cha�ne ou un entier. Si c'est un entier, il d�termine la m�thode d'insertion des liens dans le document. Par d�faut, il vaut 0 et les liens seront construits en fonction du nom de l'objet cible. Cela sert beaucoup dans les applications web. Si un lien pointe sur un objet avec le nom 'film_internet' le lien HTML sera <A HREF="/film_internet">. La position r�elle de la source et de la cible dans la hi�rarchie seront ignor�s. Vous devrez modificer votre site web pour qu'il r��crive les URL, comme '/mon_script.php3/film_internet'. 'mon_script.php3' devra analyser $PATH_INFO et savoir rechercher le document '/mon_script.php3/film_internet'. Si vous ne voulez pas de ce comportement, vous pouvez affecter � rootID/prefix n'importe quel prefixe. Dans ce cas, ce sera une cha�ne.
Si rootID/prefix est un entier diff�rent de 0 le lien sera construit avec tous les noms de la hi�rarchie, en commen�ant � l'objet d'identifiant rootID/prefix , et s�par� par des slash.
Si, par exemple, le document 'film_internet' est situ� � 'a-b-c-film_internet' et '-' qui sert de s�parateur hi�rarchique de niveau sur le serveur Hyperwave et le document source est situ� dans 'a-b-d-source' alors, le lien HTML sera : <A HREF="../c/film_internet">. Cela est tr�s pratique si vous voulez t�l�charger tout le contenu d'un serveur sur un disque, et faire une carte du syst�me sur votre disque.
Valeurs de retour
Retourne le document texte.
Voir aussi
- hw_pipedocument() - R�cup�re un document
- hw_free_document() - Lib�re la m�moire
- hw_document_bodytag() - Balise de corps d'un document
- hw_document_size() - Taille d'un document
- hw_output_document() - Affiche le document hw_document