swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
      Other Library Functions  
function  

tcp-get

 
 

Library: TCP/IP client and server support (OMTCP) legacy
Include: omtcp.xin
Return type: String

Returns:


Declaration

define external stream function tcp-get
                value tcp-connection Connection
           size value integer        MinRead    optional
    variable-to value integer        MaxRead    optional
        timeout value integer        ms         optional

Argument definitions

Connection
is a tcp-connection object representing an existing connection.
MinRead
is the minimum number of characters to read.
MaxRead
is the maximum number of characters to read.
ms
is how long the function will wait for at least one character, expressed in milliseconds.


Purpose

Use tcp-get to return characters received from a source on the TCP connection object.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omtcp.xin"

Connection must represent an existing connection (else external exception TCP05).

There must not be an active external source derived from Connection with tcp-source (else external exception TCP04).

If MinRead is specified, it must have a value of -1 or greater (else external exception TCP03).

If MaxRead is specified, it must have a value of -1 or greater (else external exception TCP03).

If both MinRead and MaxRead are specified, MinRead must have a value less than the value of MaxRead (else external exception TCP03).

Usage Notes

If an error occurs during the read, external exception TCP11 is thrown.

If the read operation times out, external exception TCP07 is thrown.

If neither MinRead nor MaxRead is specified the function reads as many characters as are available, as long as there is at least one character.

Specifying value of -1 for either MinRead or MaxRead indicates no limit. (This is the default value for both parameters.)

Sequential uses of tcp-get and tcp-source are allowed. It is also guaranteed that tcp-get will only ever read the characters it returns from a source. Any following characters are available to the next tcp-get or tcp-source.

Example #1


  local tcp-connection Connection-1
  
     set Connection-1 to tcp-connect on "localhost" at 5300
     output tcp-get Connection-1

Example #2


     output tcp-get tcp-connect on "localhost" at 5300
        size 10

        Other Library Functions
   tcp-accept-connection
   tcp-connect
   tcp-connection
   tcp-create-service
   tcp-destroy-service
   tcp-disconnect
   tcp-get
   tcp-has-characters
   tcp-is-connected
   tcp-is-version-compatible
   tcp-library-version
   tcp-peer-ip
   tcp-peer-name
   tcp-port
   tcp-put
   tcp-service
   tcp-set-buffering
   tcp-signal-source-end
   tcp-sink
   tcp-source
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.