hw_GetText

hw_GetText -- obtiene un documento de texto

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( ) .