Difference between revisions of "Documentation/How Tos/Calc: SEARCH function"
From Apache OpenOffice Wiki
< Documentation | How Tos
(Initial content) |
m |
||
(12 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
− | __NOTOC__ | + | {{DISPLAYTITLE:SEARCH function}} |
+ | {{Documentation/CalcFunc TextTOC | ||
+ | |ShowPrevNext=block | ||
+ | |PrevPage=Documentation/How_Tos/Calc:_ROMAN_function | ||
+ | |NextPage=Documentation/How_Tos/Calc:_SUBSTITUTE_function | ||
+ | }}__NOTOC__ | ||
== SEARCH == | == SEARCH == | ||
Line 15: | Line 20: | ||
: A failed search gives the <tt>'''#VALUE!'''</tt> error. | : A failed search gives the <tt>'''#VALUE!'''</tt> error. | ||
+ | |||
+ | : In {{menu|Tools|Options|OpenOffice Calc|Calculate}} the setting for <i>Search criteria = and <>must apply to whole cells</i> has no effect. | ||
=== Example: === | === Example: === | ||
Line 26: | Line 33: | ||
: returns <tt>'''3'''</tt>, if regular expressions are enabled. The "." stands for any single character in a regular expression, so <tt>'''"t.n"'''</tt> matches <tt>'''"ten"'''</tt>. | : returns <tt>'''3'''</tt>, if regular expressions are enabled. The "." stands for any single character in a regular expression, so <tt>'''"t.n"'''</tt> matches <tt>'''"ten"'''</tt>. | ||
− | + | <tt>'''SEARCH("xyz","abcdef",1)'''</tt> | |
− | '''[[Documentation/How_Tos/Calc: REPLACE function|REPLACE]] | + | : returns <tt>'''#VALUE!'''</tt>. |
− | + | : NOTE: This is an error condition, which must be 'handled' if used as the argument to another function. | |
− | + | : <tt>'''IF( SEARCH("xyz","abcdef",1) , "Substring Present", "ERR: Missing Substring" )'''</tt> | |
− | + | :: returns <tt>'''#VALUE!'''</tt> which is not very useful, therefore we could use either <tt>'''ISERROR()'''</tt> or <tt>'''ISNUMBER()'''</tt> for example: | |
+ | :: <tt>'''IF( ISERROR( SEARCH("xyz","abcdef",1) ) , "ERR: Missing Substring", "Substring Present" )'''</tt>. | ||
+ | ::: returns <tt>'''"ERR: Missing Substring"'''</tt> (... allowing the IF() to function, and not propagating the error from the SEARCH() function. | ||
+ | :: <tt>'''IF( ISNUMBER( SEARCH("xyz","abcdef",1) ) , "Substring Present", "ERR: Missing Substring" )'''</tt>. | ||
+ | ::: returns <tt>'''"ERR: Missing Substring"'''</tt> (... allowing the IF() to function, and not propagating the error from the SEARCH() function. | ||
+ | :: NOTE: In practice, it may be more maintainable to use ISNUMBER() to avoid negative logic, and it is more indicative of the evaluation desired: if the substring has a position, then ISNUMBER() is TRUE, else ISNUMBER() is FALSE. | ||
+ | |||
+ | |||
+ | {{SeeAlso|EN| | ||
+ | * [[Documentation/How_Tos/Calc: REPLACE function|REPLACE]] | ||
+ | * [[Documentation/How_Tos/Calc: FIND function|FIND]] | ||
+ | * [[Documentation/How_Tos/Calc: SUBSTITUTE function|SUBSTITUTE]] | ||
+ | * [[Documentation/How_Tos/Calc: EXACT function|EXACT]] | ||
+ | |||
+ | * [[Documentation/How_Tos/Regular Expressions in Calc|Regular Expressions in Calc]] | ||
− | + | * [[Documentation/How_Tos/Calc: Text functions|Text functions]] | |
− | + | * [[Documentation/How_Tos/Calc: Functions listed alphabetically|Functions listed alphabetically]] | |
+ | * [[Documentation/How_Tos/Calc: Functions listed by category|Functions listed by category]]}} | ||
+ | [[Category: Documentation/Reference/Calc/Text functions]] |