User Guide

getNetText() 335
getLength()
Usage
-- Lingo syntax
fileioObjRef.getLength()
// JavaScript syntax
fileioObjRef.getLength();
Description
Fileio method; Returns the length of an open file.
You must first open a file by calling
openFile() before using getLength() to return the length
of the file.
Parameters
None.
See also
Fileio, openFile()
getNetText()
Usage
getNetText(URL {, serverOSString} {, characterSet})
getNetText(URL, propertyList {, serverOSString} {, characterSet})
Description
Function; starts the retrieval of text from a file usually on an HTTP or FTP server, or initiates a
CGI query.
The first syntax shown starts the text retrieval. You can submit HTTP CGI queries this way and
must properly encode them in the URL. The second syntax includes a property list and submits a
CGI query, providing the proper URL encoding.
Use the optional parameter
propertyList to take a property list for CGI queries. The property
list is URL encoded and the URL sent is
(urlstring & "?" & encodedproplist).
Use the optional parameter serverOSString to encode any return characters in propertylist.
The value defaults to
UNIX but may be set to Win or Mac and translates any carriage returns in the
propertylist argument into those used on the server. For most applications, this setting is
unnecessary because line breaks are usually not used in form responses.
The optional parameter
characterSet applies only if the user is running Director on a
shift-JIS (Japanese) system. Possible character set settings are JIS, EUC, ASCII, and AUTO.
Lingo converts the retrieved data from
shift-JIS to the named character set. Using the AUTO
setting, character set tries to determine what character set the retrieved text is in and translate it to
the character set on the local machine. The default setting is ASCII.
Use
netDone to find out when the getNetText operation is complete, and netError to find out
if the operation was successful. Use netTextResult to return the text retrieved by getNetText.
The function works with relative URLs.