Difference between revisions of "Manuals/calci/SEARCH"

From ZCubes Wiki
Jump to navigation Jump to search
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=SEARCH(ftext, otext, snum)=
+
<div style="font-size:30px">'''SEARCH (Find_Text,Within_Text,Start_Num) '''</div><br/>
 
 
 
where  
 
where  
*<math>ftext</math> is the text to search in original string,
+
*<math>Find-Text</math> is the text to search in original string,
*<math>otext</math> is the original string from which mentioned text is to be searched, and
+
*<math>Within-Text</math> is the original string from which mentioned text is to be searched, and
*<math>snum</math> is an optional argument that specifies the character position to start the search.
+
*<math>Start-Num</math> 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.
SEARCH() identifies the occurrence of specified text string from the original string and returns the starting position of the matched string.
 
  
 
== Description ==
 
== Description ==
  
SEARCH(ftext, otext, snum)
+
SEARCH (Find_Text,Within_Text,Start_Num)  
 
 
 
For Example,
 
For Example,
  
Line 17: Line 14:
  
 
*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).
 
*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).
*<math>otext</math> can be any string containing characters, numbers, symbols, blank spaces etc.
+
*<math>Within-Text</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>Find-Text</math> and <math>Within-Text</math> when directly entered in the command, should be enclosed in double quotes (e.g. "Name").
*Argument <math>snum</math> is optional. If omitted, Calci assumes to be 1.
+
*Argument <math>Start-Num</math> is optional. If omitted, Calci assumes to be 1.
*<math>snum</math> should be an integer &gt; 0, else Calci displays #NULL error message.
+
*<math>Start-Num</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>Start-Num</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>Find-Text</math> is not a part of the reference string <math>Within-Text</math>, Calci returns #N/A error string.
 
*SEARCH function is not case sensitive.
 
*SEARCH function is not case sensitive.
  
Line 57: Line 54:
 
== See Also ==
 
== See Also ==
  
 +
*[[Manuals/calci/SEARCHB | SEARCHB]]
 
*[[Manuals/calci/REPLACE | REPLACE]]
 
*[[Manuals/calci/REPLACE | REPLACE]]
 
*[[Manuals/calci/REPT | REPT]]
 
*[[Manuals/calci/REPT | REPT]]
Line 63: Line 61:
  
 
*[http://en.wikipedia.org/wiki/Autocorrection Find and Replace]
 
*[http://en.wikipedia.org/wiki/Autocorrection Find and Replace]
 +
 +
 +
 +
*[[Z_API_Functions | List of Main Z Functions]]
 +
 +
*[[ Z3 |  Z3 home ]]

Latest revision as of 17:49, 13 August 2018

SEARCH (Find_Text,Within_Text,Start_Num)


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 (Find_Text,Within_Text,Start_Num) 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).
  • 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.

Related Videos

SEARCH

See Also

References