Programmer Guide/Command Reference/FIND: Difference between revisions

From STX Wiki
Jump to navigationJump to search
(initial import)
 
m (1 revision: Initial import)
(No difference)

Revision as of 17:31, 18 November 2010

FIND

The FIND command searches a table item for a particular entry and returns this entry's index (if found). The FIND command can only be used with simple tables or the extended table string/name fields.

#pos := FIND table entry field [mask tag case]

-> #pos = 'entryindex' or empty if not found

table
The name of the table item to search.
entry
* for all entries or the index from which to start searching.
field
Index or name of string/name field. This parameter is ignored for simple tables and should be set to *.
mask
The search mask (wildcards are possible).
tag
Search all (0) or tagged (1) fields. The default is 0.
case
Ignore (0) or respect (1) case. The default is 0.
[macro FindStringInTable]
#t := new table *
$#t * 'The big red apple was very juicy'
$#t * 'The blue waves were mesmerizing'
$#t * 'The green man said - "You are coming with me"'
$#t * 'The red dwarf star was a million miles away'
#searchStr := 'red'
do forever
    #i := find $#t '$#i' '*' '*$#searchStr*'
    if '$rc' != 0 break
    um 'The table entry $#i ($#t[$#i]) contains the word "$#searchStr"'
end
delete $#t
exit

Navigation menu

Personal tools