StrToTokN Function (ROM Call 0x7B)

vat.h

ESI StrToTokN (const char *src, unsigned char *dest);

Converts a C string to a token.

StrToTokN converts a symbol name pointed to by src, which is an ordinary ANSI C string, into a tokenized symbol name. See SYMSTR for more info about symbol names. dest must point to a buffer of 20 bytes (which is the maximum length of the expanded file name). The tokenized name is stored there starting at the end of the buffer. StrToTokN returns a pointer to the terminating zero byte of the converted name, exactly as expected in most routines from vat.h.

Note: This routine merely converts a name into tokenized format; it does not handle reserved names or check for the validity of the name passed to it. For this reason, TokenizeSymName should be used in general to tokenize symbol names.


Uses: strlen, CTypeTable
Used by: EX_stoBCD, VarNew, VarOpen, VarSaveAs, handleVarLinkKey, MO_digestOptions, FFindFirst, LIO_Receive, OSLinkCmd


See also: TokToStrN, SYMSTR