ToBeReviewed/STRING/
getwrd.pro
Return the n'th word from a text string.
getwrd
String
result = getwrd(txtstr, nth[, mth], HELP=HELP, LOCATION=LOCATION, DELIMITER=DELIMITER, NOTRIM=NOTRIM, LAST=LAST, NWORDS=NWORDS)
Return value
wrd = returned word or words.
Parameters
txtstr
in
required
type: string or array of strings
text string to extract from.
The first element is used if txt is an array.
nth
in
required
type: integer
default: 0
word number to get (first = 0 = def)
mth
in
optional
type: integer
optional last word number to get.
Keywords
HELP
LOCATION
= l. Return word n string location.
DELIMITER
= d. Set word delimiter (def = space & tab).
NOTRIM
suppresses whitespace trimming on ends.
LAST
means n is offset from last word. So n=0 gives
last word, n=-1 gives next to last, ...
If n=-2 and m=0 then last 3 words are returned.
NWORDS
= n. Returns number of words in string.
Version history
Version
$Id: getwrd.pro 374 2008-08-08 15:12:27Z pinsard $
History
- Ray Sterner, 6 Jan, 1985.
- R. Sterner, Fall 1989 --- converted to SUN.
- R. Sterner, Jan 1990 --- added delimiter.
- R. Sterner, 18 Mar, 1990 --- added /LAST.
- R. Sterner, 31 Jan, 1991 --- added /NOTRIM.
- R. Sterner, 20 May, 1991 --- Added common and NULL string.
- R. Sterner, 13 Dec, 1992 --- Made tabs equivalent to spaces.
- R. Sterner, 4 Jan, 1993 --- Added NWORDS keyword.
- R. Sterner, 2001 Jan 15 --- Fixed to use first element if not a scalar.
Copyright (C) 1985, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.
Known issues
Restrictions
If a NULL string is given (txt="") then the last string
given is used. This saves finding the words again.
If m > n wrd will be a string of words from word n to
word m. If no m is given wrd will be a single word.
n<0 returns text starting at word abs(n) to string end
If n is out of range then a null string is returned.
See also nwrds.
Other attributes
Uses routines
getwrd_com
Common blocks used
getwrd_com
Produced by IDLdoc 2.0.