find   Description Syntax Examples Argument Types How do I contact the AIS team?

The find function returns the location of a match string found in a target string. The find function is case sensitive (upper and lower case letters do not match). If the match string is not found, the Boolean value false is returned. The find function may also be supplied with a vector of match strings instead of just a single match string (up to 256 match strings are supported). If a vector of match strings is supplied, then the find function returns the location of the first match string found, and sets the cdr of the match vector to the index of the match string found.

(find matchstr targetstr startpos)

Here are a number of links to Lambda coding examples which contain this instruction in various use cases.

Example_String_find_001

This example shows the find function operating on two sets of string or text. The find function compares the first string argument with the second string argument. If the first string argument matches the second string argument, then the position of the first argument string in the second string argument is returned. The user may also specify the position in the second string argument where the search will begin using an optional integer argument. If there is no match found, then the Boolean value false is returned by the function.

Virtual Machine instructions may be used to implement the find function for better execution speed. In the findString function, the input matchString and targetString may be Text, String, Symbol, or ByteVector arguments. Between the lines (vmregRunInHardware startNoLoad:) and (vmregRunInHardware stopNoSave:), the matchString and targetString are directly placed in the registers through the use of CharPointers as register variables. Searching of matchString in the targetString is through the use of the equivalent assembler register code for each character evaluated.

Here are the links to the data types of the function arguments.

Here are also a number of links to functions having arguments with any of these data types.

How do I contact the AIS team? You can always talk with the AIS at aiserver.sourceforge.net.