Lingo Dictionary > G-K > getNetText() |
![]() ![]() ![]() |
getNetText()
Syntax
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.
For a movie that plays back as an applet, the getNetText
command retrieves text only from the domain that contains the applet. This behavior differs from Shockwave and is necessary due to Java's security model.
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.
To see an example of getNextText()
used in a completed movie, see the Forms and Post movie in the Learning\Lingo Examples folder inside the Director application folder.
Note: Executing any network Lingo operations concurrently with a Shockwave Audio (SWA) stream can cause interruptions in the playback of the SWA stream.
Example
This script retrieves text from the URL http://BigServer.com/sample.txt and updates the field cast member the mouse is on when it's clicked:
property spriteNum property theNetID on mouseUp me theNetID = getNetText ("http://BigServer.com/sample.txt") end on exitFrame me if netDone(theNetID) then sprite(spriteNum).member.text = netTextResult(theNetID) end if end
Example
This example retrieves the results of a CGI query:
getNetText("http://www.yourserver.com/cgi-bin/query.cgi?name=Bill")
Example
This is the same as the previous example, but it uses a property list to submit a CGI query, and does the URL encoding for you.
getNetText("http://www.yourserver.com/cgi-bin/query.cgi", [#name:"Bill"])
See also
netDone()
, netError()
, netTextResult()
![]() ![]() ![]() |