>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  STRFIND

STRFIND

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 [].
      R. Sterner, 2014 Sep 03 --- Returned scalars if only 1 element.
  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.



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us