Difference between revisions of "Manuals/calci/SEARCH"

From ZCubes Wiki
Jump to navigation Jump to search
Line 22: Line 22:
 
*<math>snum</math> should be an integer &gt; 0, else Calci displays #NULL error message.
 
*<math>snum</math> should be an integer &gt; 0, else Calci displays #NULL error message.
 
*If <math>snum</math> &gt; 'length of text', Calci displays #N/A error message.
 
*If <math>snum</math> &gt; 'length of text', Calci displays #N/A error message.
*If string specified in <math>otext</math> is not a part of the reference string <math>txt</math>, Calci returns #N/A error string.
+
*If string specified in <math>ftext</math> is not a part of the reference string <math>otxt</math>, Calci returns #N/A error string.
  
 
== Examples ==
 
== Examples ==

Revision as of 07:31, 11 February 2014

SEARCH(ftext, otext, snum)

where

  • is the text to search in original string,
  • is the original string from which mentioned text is to be searched, and
  • 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 characters. MID works with the languages that use 'Single Byte Character Set' (SBCS).
  • can be any string containing characters, numbers, symbols, blank spaces etc.
  • and when directly entered in the command, should be enclosed in double quotes (e.g. "Name").
  • Argument is optional. If omitted, Calci assumes to be 1.
  • should be an integer > 0, else Calci displays #NULL error message.
  • If > 'length of text', Calci displays #N/A error message.
  • If string specified in is not a part of the reference string , Calci returns #N/A error string.

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.

See Also

References