PRSTOK (JANUS DEFINE parameter)

From m204wiki
Revision as of 21:59, 8 March 2011 by Admin (talk | contribs) (1 revision)
Jump to navigation Jump to search

<section begin="desc" />[AMBIG|]hexstr1|hexstr2|... | NONE<section end="desc" />

PRSTOK is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.


This parameter specifies the hex values of strings that are used to separate input strings using the $SOCK_RECVPRS function.

The default is PRSTOK NONE, which means that a PRSTOK value must be set with $SOCK_SET before the $SOCK_RECVPRS function is called. See the description of $SOCK_RECVPRS for a description of its parsing algorithm.

Note that the specified string is used untranslated, regardless of the CHAR or BINARY setting of the socket. For example, the following specifies that input strings are delimited by the byte pair which is ASCII carriage return and linefeed:

PRSTOK 0D0A


Specify "AMBIG|" at the start of the PRSTOK string if you are using any separator string which is the prefix of another. If you specify "AMBIG|", at least one of your separator strings must be the prefix of another. For example, the following setting is rejected because the string "0D" (ASCII carriage return) is a prefix of "0D0A" (carriage return and linefeed):

PRSTOK 0D0A|0D|0A


Also, the following setting is rejected because neither of the strings "0D0A" (ASCII carriage return and linefeed) nor "0D09" (carriage return and horizontal tab) is a prefix of the other:

PRSTOK AMBIG|0D0A|0D09


See the description of the $SOCK_RECVPRS function in the Janus Sockets Reference Manual for a discussion of using ambiguous PRSTOK separator strings. .el .do See :hdref refid=ambsep..

The PRSTOK value for a socket can be changed using $SOCK_SET.

Valid only for CLSOCK and SRVSOCK ports.

References

See: List of Janus commands | List of JANUS DEFINE parameters.