ToBeReviewed/STRING/
strtok.pro
Retrieve portion of string up to token.
strtok
String
result = strtok(string, token, TRIM=TRIM, HELP=HELP)
Return value
new -- portion of string up to token. out
old -- portion of old after token. out, in
Parameters
string
in
required
String to be split. Contains text after in, out
token on output.
token
in
required
Token to use in splitting old.
Keywords
TRIM
set to remove leading blanks from old
before returning.
HELP
print useful message and exit.
Examples
If old is 'foo44 bar', then strtok( old, '44' ) would return
'foo', and upon return, old will be left with ' bar'. If /TRIM
were set, old would be 'bar' on return.
If old='xyz', then new=strtok(old,'a') would return with
new='xyz' and old=''.
Version history
Version
$Id: strtok.pro 157 2006-08-21 09:01:50Z navarro $
History
$Log: strtok.pro,v $
Revision 1.3 1996/06/14 20:00:27 mcraig
Updated Copyright info.
Revision 1.2 1996/05/09 00:22:17 mcraig
Added built in help.
Revision 1.1 1996/01/31 18:47:37 mcraig
Initial revision
Thanks:
To D. Linder who wrote GETTOK, part of the goddard library,
upon which this is based.
Release:
$Name: Rel_1_2 $
Copyright:
Copyright (C) 1996 The Regents of the University of California, All
Rights Reserved. Written by Matthew W. Craig.
See the file COPYRIGHT for restrictions on distrubting this code.
This code comes with absolutely NO warranty; see DISCLAIMER for details.
Known issues
Restrictions
Input parameter old is modified.
Token may be one or more characters.
if token is not found, returns old and sets old to ''.
Produced by IDLdoc 2.0 on Tue Aug 29 14:50:32 2006.