Difference between revisions of "Manuals/calci/SEARCHB"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left"> '''SEARCHB'''(Text,Within_text, Start_num) where, '''Text''' - is the text string to extract. '''Within_te...")
 
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left">
+
<div style="font-size:30px">'''SEARCHB (Find_Text,Within_Text,Start_Num) '''</div><br/>
  
−
'''SEARCHB'''(Text,Within_text, Start_num)
+
where
 +
*<math>Find-Text</math> is the text to search in original string,
 +
*<math>Within-Text</math> is the original string from which mentioned text is to be searched, and
 +
*<math>Start-Num</math> is an optional argument that specifies the character position to start the search.
 +
**SEARCHB(), finds one text value within another.SEARCHB is intended for use with languages that use the double-byte character set (DBCS).
  
−
where,
+
== Description ==
  
−
'''Text''' - is the text string to extract.
+
SEARCHB (Find_Text,Within_Text,Start_Num)
 +
For Example,
  
−
'''Within_text'''- represents the text, find from Text.
+
SEARCHB("C", "WELCOME",1) returns ''4''
  
−
'''Start_num''' - the character number in Within_text to start.
+
*SEARCHB function can be used to find text within a text. SEARCHB counts 2 bytes per character. SEARCHB is intended for languages that use double-byte character set (DBCS).
 +
*<math>Within-Text</math> can be any string containing characters, numbers, symbols, blank spaces etc.
 +
*<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>Start-Num</math> is optional. If omitted, Calci assumes to be 1.
 +
*<math>Start-Num</math> should be an integer &gt; 0, else Calci displays #NULL error message.
 +
*If <math>Start-Num</math> &gt; 'length of text', Calci displays #N/A error message.
 +
*If string specified in <math>Within-Text</math> is not a part of the reference string <math>Find-Text</math>, Calci returns #N/A error string.
 +
*SEARCHB function is not case sensitive.
  
−
</div>
+
== Examples ==
−
----
 
−
<div id="1SpaceContent" class="zcontent" align="left">
 
  
−
SEARCHB locate one text string within a second text string, and returns the number of the starting position of the first string from the first character of the second text string. SEARCHB is intended for use with languages that use the double-byte character set (DBCS).
+
<div id="6SpaceContent" class="zcontent" align="left">
  
−
</div>
+
{| id="TABLE3" class="SpreadSheet blue"
−
----
+
|- class="even"
−
<div id="7SpaceContent" class="zcontent" align="left">
+
| class="ssh1_f" |JOHN SMITH
 +
| class=" " |
 +
| class=" " |
  
−
If Start_num &lt; 0, SEARCHB returns #ERROR.
+
|- class="odd"
 +
| class="ssh1_f" |<#>!!!
 +
| class="  " |
 +
| class="  " |
  
−
If Start_num  &gt; length of Text, SEARCHB returns #ERROR.
+
|- class="even"
 +
| class="ssh1_f" |
 +
| class="  " |
 +
| class="  " |
  
−
If Within_text not found , it returns #ERROR.
+
|}
−
 
 
−
If Start_num  not defined then it returns the length of Text.
 
−
 
 
−
</div>
 
−
----
 
−
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
 
−
 
 
−
SEARCHB
 
  
−
</div></div>
+
=SEARCHB("I", A1) : Returns '''8''' as output.
−
----
+
=SEARCHB(">", A2) : Returns '''3''' as output.
−
<div id="8SpaceContent" class="zcontent" align="left">
 
  
−
Lets see an example in (Column1, Row2)
+
<font color ="Red">Need to give examples with characters/language supporting DBCS </font>
 +
==Related Videos==
  
−
<nowiki>=SEARCHB("S", R1C1, 3)</nowiki>
+
{{#ev:youtube|x8zquflNpnM|280|center|SEARCH}}
  
−
SEARCHB returns 6.
+
== See Also ==
  
−
Lets see an another example in (Column1,Row3)
+
*[[Manuals/calci/SEARCH | SEARCH]]
 +
*[[Manuals/calci/REPLACEB | REPLACEB]]
  
−
<nowiki>=SEARCHB("I",R1C1)</nowiki>
+
==References==
  
−
SEARCHB returns 8.
+
*[http://en.wikipedia.org/wiki/Autocorrection Find and Replace]
  
−
Consider an example in (Column1, Row4)
 
  
−
<nowiki>=SEARCHB("b",R1C1)</nowiki>
 
  
−
SEARCHB returns #ERROR(TEXT not found).
+
*[[Z_API_Functions | List of Main Z Functions]]
−
 
 
−
</div>
 
−
----
 
−
<div id="10SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Syntax </div><div class="ZEditBox"><center></center></div></div>
 
−
----
 
−
<div id="4SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Remarks </div></div>
 
−
----
 
−
<div id="3SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Examples </div></div>
 
−
----
 
−
<div id="11SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Description </div></div>
 
−
----
 
−
<div id="2SpaceContent" class="zcontent" align="left">
 
−
 
 
−
{| id="TABLE3" class="SpreadSheet blue"
 
−
|+ Default Calci
 
−
|- class="even"
 
−
| class=" " |
 
−
| Column1
 
−
| Column2
 
−
| Column3
 
−
| Column4
 
−
|- class="odd"
 
−
| class=" " | Row1
 
−
| class=" " | JOHN SMITH
 
−
| class=" " |
 
−
|
 
−
|
 
−
|- class="even"
 
−
| class="  " | Row2
 
−
| class="sshl_f" | 6
 
−
|
 
−
|
 
−
|
 
−
|- class="odd"
 
−
| Row3
 
−
| class="sshl_f      " | 8
 
−
|
 
−
|
 
−
|
 
−
|- class="even"
 
−
| Row4
 
−
| class="sshl_f" | #ERROR
 
−
|
 
−
|
 
−
|
 
−
|- class="odd"
 
−
| class=" " | Row5
 
−
| class="                    SelectTD1 ChangeBGColor SelectTD1" |
 
−
<div id="2Space_Handle" class="zhandles" title="Click and Drag to resize CALCI Column/Row/Cell. It is EZ!"></div><div id="2Space_Copy" class="zhandles" title="Click and Drag over to AutoFill other cells."></div><div id="2Space_Drag" class="zhandles" title="Click and Drag to Move/Copy Area.">[[Image:copy-cube.gif]]  </div>
 
−
|
 
−
|
 
−
|
 
−
|- class="even"
 
−
| Row6
 
−
|
 
−
|
 
−
|
 
−
|
 
−
|}
 
−
 
 
−
{| id="TABLE3_menu"
 
−
| align="right" | TABLE3
 
−
| <span align="left">[[Image:calci1.gif]]</span>
 
−
|
 
−
|
 
−
[[Image:bold.gif]]
 
−
|
 
−
[[Image:italic.gif]]
 
−
|
 
−
[[Image:normal.gif]]
 
−
|
 
−
[[Image:underline.gif]]
 
−
|
 
−
[[Image:border.gif]]
 
−
|
 
−
[[Image:numbers.gif]]
 
−
|
 
−
[[Image:sort.gif]]
 
−
|
 
−
[[Image:formatcells.gif]]
 
−
|
 
−
[[Image:graphs.gif]]
 
−
| $
 
−
|}
 
  
−
</div>
+
*[[ Z3 |  Z3 home ]]
−
----
 

Latest revision as of 17:55, 13 August 2018

SEARCHB (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.
    • SEARCHB(), finds one text value within another.SEARCHB is intended for use with languages that use the double-byte character set (DBCS).

Description

SEARCHB (Find_Text,Within_Text,Start_Num) For Example,

SEARCHB("C", "WELCOME",1) returns 4

  • SEARCHB function can be used to find text within a text. SEARCHB counts 2 bytes per character. SEARCHB is intended for languages that use double-byte character set (DBCS).
  • 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.
  • SEARCHB function is not case sensitive.

Examples

JOHN SMITH
<#>!!! 
=SEARCHB("I", A1) : Returns 8 as output.
=SEARCHB(">", A2) : Returns 3 as output.

Need to give examples with characters/language supporting DBCS

Related Videos

SEARCH

See Also

References


Retrieved from "http://wiki.zcubes.com/index.php?title=Manuals/calci/SEARCHB&oldid=211067"