Difference between revisions of "Manuals/calci/SEARCH"

From ZCubes Wiki
Jump to navigation Jump to search
Line 16: Line 16:
 
SEARCH("COME", "WELCOME",1) returns ''4''
 
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).
+
*SEARCH function can be used to find text within a text. SEARCH counts 1 byte per characters. SEARCH works with the languages that use 'Single Byte Character Set' (SBCS).
 
*<math>otext</math> can be any string containing characters, numbers, symbols, blank spaces etc.
 
*<math>otext</math> can be any string containing characters, numbers, symbols, blank spaces etc.
 
*<math>ftext</math> and <math>otext</math> when directly entered in the command, should be enclosed in double quotes (e.g. "Name").
 
*<math>ftext</math> and <math>otext</math> when directly entered in the command, should be enclosed in double quotes (e.g. "Name").
Line 23: Line 23:
 
*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>ftext</math> is not a part of the reference string <math>otxt</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.
 +
*SEARCH function is not case sensitive.
  
 
== Examples ==
 
== Examples ==

Revision as of 11:03, 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. SEARCH 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.
  • 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.

See Also

References