Descripción
int
hw_gettext ( int conexión, int IDobjeto [, mixed IDraiz/prefijo])
Devuelve el documento con ID de objeto
IDobjeto. Si el documento tiene
enlaces que pueden ser insertados, serán insertados ahora.
El parámetro opcional IDraiz/prefijo puede
ser una cadena o un entero. Si es un entero determina la forma en
que los enlaces se insertan en el documento. Por defecto es 0 y
los enlaces se crean a partir del nombre del objeto de destino de
los mismos. Esto es útil para aplicaciones web. Si un enlace apunta
a un objeto con nombre 'pelicula_internet' el enlace HTML será
<A HREF="/pelicula_internet">. La posición actual del objeto
de destino en la jerarquía de documentos es despreciada. Tendrá que
ajustar su navegador web para que reescriba dicho URL a, por ejemplo,
'/mi_script.php3/pelicula_internet'. 'mi_script.php3' deberá
evaluar $PATH_INFO y recuperar el documento.
Todos los enlaces tendrán el prefijo '/mi_script.php3'. Si no desea
este efecto puede fijar el parámetro opcional
IDraiz/prefijo al prefijo que desee
en su lugar. En este caso deberá ser una cadena.
Si el IDraiz/prefijo es un entero
distinto de 0, el enlace se construye con todos los nombres
de objeto comenzando con el objeto de id IDraiz/prefijo,
separado por una barra relativa al objeto actual.
Si por ejemplo el documento anterior 'pelicula_internet' está situado
en 'a-b-c-pelicula_internet' donde '-' es el separador entre niveles
jerárquicos en el servidor Hyperwave y el documento fuente está
situado en 'a-b-d-fuente', el enlace HTML resultante sería:
<A HREF="../c/pelicula_internet">. Esto es útil cuando desea
bajarse el contenido completo del servidor al disco y mapear
la jerarquía de documentos en el sistema de archivos.
Esta función sólo trabajará en documentos de texto puros. No
se abrirá una conexión de datos especial y por tanto bloqueará
la conexión de control durante la transferencia.
Vea también hw_PipeDocument(),
hw_FreeDocument(),
hw_DocumentBodyTag(),
hw_DocumentSize(),
hw_OutputDocument().
