PRSTOK (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 8: Line 8:
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.  
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 <var>[[BINARY (JANUS DEFINE parameter)|BINARY]]</var> 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:
Note that the specified string is used untranslated, regardless of the <var>[[CHAR (JANUS DEFINE parameter)|CHAR]]</var> or <var>[[BINARY (JANUS DEFINE parameter)|BINARY]]</var> 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:


<p class="code"> PRSTOK 0D0A
<p class="code"> PRSTOK 0D0A

Revision as of 18:05, 24 February 2012

<section begin="desc" />PRSTOK [AMBIG|]hexstr1|hexstr2|... | NONE -- parse token for input strings<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.