hw_GetSrcByDestObj
hw_getusername
Fonctions Hyperwave
PHP Manual

# 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 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

hw_GetSrcByDestObj
hw_getusername
Fonctions Hyperwave
PHP Manual