hw_GetText

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="/mambo/documentacion-manual_php-pagina-/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="/mambo/documentacion-manual_php-pagina-__/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()_