(PHP 4)
hw_GetText — Recuperar documentos de texto
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.
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.
Devuelve el documento de texto.