Manuals/calci/SEARCH

SEARCH(ftext, otext, snum)

where

• $ftext$ is the text to search in original string,
• $otext$ is the original string from which mentioned text is to be searched, and
• $snum$ is an optional argument that specifies the character position to start the search.

SEARCH() identifies the occurrence of specified text string from the original string and returns the starting position of the matched string.

Description

SEARCH(ftext, otext, snum)

For Example,

SEARCH("COME", "WELCOME",1) returns 4

• SEARCH function can be used to find text within a text. SEARCH counts 1 byte per character. SEARCH works with the languages that use 'Single Byte Character Set' (SBCS).
• $otext$ can be any string containing characters, numbers, symbols, blank spaces etc.
• $ftext$ and $otext$ when directly entered in the command, should be enclosed in double quotes (e.g. "Name").
• Argument $snum$ is optional. If omitted, Calci assumes to be 1.
• $snum$ should be an integer > 0, else Calci displays #NULL error message.
• If $snum$ > 'length of text', Calci displays #N/A error message.
• If string specified in $ftext$ is not a part of the reference string $otxt$, Calci returns #N/A error string.
• SEARCH function is not case sensitive.

Examples

SEARCH
Happy New Year!!!

=SEARCH("A", A1) : Returns 3 as output.
=SEARCH("New", A2) : Returns 7 as output. Space character is also counted.
=SEARCH("Year",A2,6) : Search is started from 6th position. Returns 11 as output. 
Space character is also counted.

Related Videos

SEARCH

See Also

• SEARCHB
• REPLACE
• REPT

References

• Find and Replace

• List of Main Z Functions

• Z3 home