hw_GetText

(PHP 4)

hw_GetText — Récupère un document texte

Description

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

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 connexion.

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