Funciones de Hyperwave
PHP Manual

hw_GetText

(PHP 4)

hw_GetTextRecuperar documentos de texto

Descripción

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

Devuelve el documento con el ID de objeto objectID. Si el documento tiene anclas que pueden ser insertadas, serán insertadas ya.

Esta función sólo funciona para documentos de texto puros. No abrirá una conexión de información especial y por lo tanto bloqueará la conexión de control durante la transferencia.

Parámetros

connection

El identificador de conexión.

objectID

El identificador del objeto.

rootID/prefix

El parámetro opcional rootID/prefix puede ser una cadena o un valor integer. Si es un integer determina cómo los enlaces son insertados en el documento. Lo predeterminado es 0 y resultará en enlaces que están construidos desde el nombre del objeto de destino del enlace. Esto es útil para aplicaciones web. Si un enlace apunta a un objeto con nombre 'película_internet' el enlace HTML será <A href="/película_internet">. La ubicación real del objeto fuente y el objeto destino en la jerarquía del documento son ignorados. Tendrá que configurar su navegador web para reescribir esta URL a, por ejemplo, '/mi_script.php/película_internet'. 'mi_script.php' tendrá que evaluar $PATH_INFO y recuperar el documento. Todos los enlaces tiene el prefijo '/mi_script.php/'. Si no desea esto puede establecer el parámetro opcional rootID/prefix a cualquier prefijo que se use en su lugar. En este caso tiene que ser una cadena.

Si rootID/prefix es un valor integer y no igual a 0, el enlace es construido desde todos los nombres que empiezan con el objeto con el id rootID/prefix separado por una barra relativo al objeto actual.

Si, por ejemplo, el documento de arriba, 'película_internet', está ubicado en 'a-b-c-película_internet', siendo '-' el serparador entre niveles de jerarquía en el servidor Hyperwave, y el documento fuente está ubicado en 'a-b-d-fuente', el enlace HTML resultante sería: <A HREF="../c/película_internet">. Esto es útil si quiere descargar el contenido completo del servidor al disco y mapear la jerarquía del documento en el sistema de ficheros.

Valores devueltos

Devuelve el documento de texto.

Ver también


Funciones de Hyperwave
PHP Manual