File: function.hw-gettext.html

package info (click to toggle)
php3 3%3A3.0.18-31
links: PTS
area: main
in suites: sarge
size: 17,860 kB
ctags: 11,260
sloc: ansic: 108,487; sh: 2,439; php: 2,024; yacc: 1,887; makefile: 1,056; perl: 537; pascal: 238; awk: 90; cpp: 28; sql: 11
file content (252 lines) | stat: -rw-r--r-- 4,732 bytes
parent folder | download | duplicates (3)
<HTML
><HEAD
><TITLE
>hw_GetText</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="manual.html"><LINK
REL="UP"
TITLE="Hyperwave functions"
HREF="ref.hyperwave.html"><LINK
REL="PREVIOUS"
TITLE="hw_GetAndLock"
HREF="function.hw-getandlock.html"><LINK
REL="NEXT"
TITLE="hw_GetObjectByQuery"
HREF="function.hw-getobjectbyquery.html"><META
NAME="HTTP_EQUIV"
CONTENT="text/html; charset=ISO-8859-1"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.hw-getandlock.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.hw-getobjectbyquery.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.hw-gettext"
>hw_GetText</A
></H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN13857"
></A
><P
>    (PHP3 &#62;= 3.0.3, PHP4 )</P
>hw_GetText&nbsp;--&nbsp;retrieve text document</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN13860"
></A
><H2
>Description</H2
><DIV
CLASS="funcsynopsis"
><A
NAME="AEN13862"
></A
><P
></P
><P
><CODE
><CODE
CLASS="FUNCDEF"
>int <B
CLASS="function"
>hw_gettext</B
></CODE
> (int connection, int objectID [, mixed 
       rootID/prefix])</CODE
></P
><P
></P
></DIV
><P
>&#13;     Returns the document with object ID
     <TT
CLASS="parameter"
><I
>objectID</I
></TT
>. If the document
     has anchors which can be inserted, they will be inserted already.
     The optional parameter <TT
CLASS="parameter"
><I
>rootID/prefix</I
></TT
> can
     be a string or an integer. If it is an integer it determines
     how links are inserted
     into the document. The default is 0 and will result in links that
     are constructed from the name of the link's destination object. This
     is useful for web applications. If a link points to an object with
     name 'internet_movie' the HTML link will be
     &#60;A HREF="/internet_movie"&#62;. The actual location of the source and
     destination object in the document hierachy is disregarded. You
     will have to set up your web browser, to rewrite that URL to for
     example '/my_script.php3/internet_movie'. 'my_script.php3' will
     have to evaluate $PATH_INFO and retrieve the document.
     All links will have the prefix '/my_script.php3/'. If you do not
     want this you can set the optional parameter
     <TT
CLASS="parameter"
><I
>rootID/prefix</I
></TT
> to any prefix which
     is used instead. Is this case it has to be a string.</P
><P
>&#13;     If <TT
CLASS="parameter"
><I
>rootID/prefix</I
></TT
> is an integer and
     unequal to 0 the link is constructed from all the names
     starting at the object with the id <TT
CLASS="parameter"
><I
>rootID/prefix</I
></TT
>
     separated by a slash relative to the current object.
     If for example the above document 'internet_movie' is located
     at 'a-b-c-internet_movie' with '-' being the seperator between
     hierachy levels on the Hyperwave server and the source document is
     located at 'a-b-d-source' the resulting HTML link would be:
     &#60;A HREF="../c/internet_movie"&#62;. This is useful if you want
     to download the whole server content onto disk and map
     the document hierachy onto the file system.</P
><P
>&#13;     This function will only work for pure text documents. It will
     not open a special data connection and therefore blocks the
     control connection during the transfer.</P
><P
>&#13;     See also <B
CLASS="function"
>hw_PipeDocument()</B
>,
              <B
CLASS="function"
>hw_FreeDocument()</B
>,
              <B
CLASS="function"
>hw_DocumentBodyTag()</B
>,
              <B
CLASS="function"
>hw_DocumentSize()</B
>,
              <B
CLASS="function"
>hw_OutputDocument()</B
>.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.hw-getandlock.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="manual.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.hw-getobjectbyquery.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>hw_GetAndLock</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.hyperwave.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>hw_GetObjectByQuery</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>