STRFIND Name
STRFIND Purpose
Find and list substrings in a string array.
Category
Calling Sequence
strfind, txt, str Inputs
txt = Text array to search. in
str = string to find. in
Keyword Parameters
Keywords
OUT=txt2 Returned matched text.
/INVERSE means find elements without str.
COUNT=cnt Number of matches found.
/QUIET do not list lines.
INDEX=ind Returned array of indices (-1=not found).
ICOUNT=icnt Number of non-matches found.
IINDEX=iind Array of indices of non-matches.
The last two keywords apply if /INVERSE is not given.
If /INVERSE is given then COUNT and INDEX return the
inverse values. This is for backward compatibility.
Outputs
Common Blocks
Notes
Notes: Ignores case. Lists lines that contain the
text to find, also the index into the text array.
Uses stregex so allows regular expressions.
See help for IDL stregex for more details.
Modification History
R. Sterner, 2002 Apr 22
R. Sterner, 2002 Apr 24 --- Added INDEX=in and /QUIET.
R. Sterner, 2002 Dec 23 --- Added /INVERSE.
R. Sterner, 2006 Oct 18 --- Added IINDEX=iind, ICOUNT=icnt.
R. Sterner, 2008 Jan 30 --- Added OUT=txt2.
R. Sterner, 2010 Apr 29 --- Converted arrays from () to [].
Copyright (C) 2002, 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.