.-
help for ^readtok^					       STB-29: ip12
.-

Break a string into a set of token variables
--------------------------------------------

        ^readtok^ string-var [^,^ ^f^ield^(^str^)^ ^p^refix^(^str^)^ ]


Description
-----------

^readtok^ splits each observation of ^string-var^ into tokens and generates
a set of new variables to hold the individual tokens.


Options
-------

^f^ield^(^str^)^ specifies the field separators, that is, the characters that
    delimit tokens.  By default, spaces are used.  If ^field()^ is specified,
    the characters specified are used in addition to spaces.

^p^refix^(^str^)^ specifies a prefix for the new variables.  By default, the
    prefix is ^_v^, and variables ^_v1^, ^_v2^, ..., and so on are generated.


Example
-------

 . ^readtok, field(|) prefix(x)^


Author
------

        Sean Becketti
        Stata Technical Bulletin
        stb@@stata.com


Also see
--------

    STB:  STB-29 ip12
 Manual:  [6a] parse
On-line:  help for @parse@