PRSTOK (JANUS DEFINE parameter)

From m204wiki
Jump to navigation Jump to search

PRSTOK [AMBIG|]hexstr1|hexstr2|... | NONE — parse token for input strings

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

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 the value PRSTOK 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 for a discussion of using ambiguous PRSTOK separator strings.

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

Valid only for CLSOCK and SRVSOCK ports.

See also