<HTML
><HEAD
><TITLE
>SEARCH</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="Gnumeric's user manual"
HREF="gnumeric.html"><LINK
REL="UP"
TITLE="Reference"
HREF="function-reference.html#AEN1187"><LINK
REL="PREVIOUS"
TITLE="TRANSPOSE"
HREF="r10389.html"><LINK
REL="NEXT"
TITLE="CONCATENATE"
HREF="r10435.html"></HEAD
><BODY
CLASS="REFENTRY"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Gnumeric's user manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="r10389.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="r10435.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="AEN10410"
><A
NAME="GNUMERIC-SEARCH"
></A
>SEARCH</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN10415"
></A
><H2
>Name</H2
>SEARCH&nbsp;--&nbsp;</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN10418"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>SEARCH(text,within[,start_num])</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10420"
></A
><H2
>Description</H2
><P
>SEARCH returns the location of a character or text string within another string.  @text is the string or character to be searched. @within is the string in which you want to search.  @start_num is the start position of the search in @within.  If @start_num is omitted, it is assumed to be one.  The search is not case sensitive. </P
><P
>@text can contain wildcard characters (*) and question marks (?) to control the search.  A question mark matches with any character and wildcard matches with any string including empty string.  If you want the actual wildcard or question mark to be searched, use tilde (~) before the character. </P
><P
>If @text is not found, SEARCH returns #VALUE! error. If @start_num is less than one or it is greater than the length of @within, SEARCH returns #VALUE! error. </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10425"
></A
><H2
>Examples</H2
><P
></P
><P
>SEARCH("c","Cancel") equals 1.</P
><P
>SEARCH("c","Cancel",2) equals 4.</P
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN10431"
></A
><H2
>See also</H2
><P
>        <A
HREF="r6074.html#GNUMERIC-FIND"
>FIND</A
>
      </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="r10389.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnumeric.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="r10435.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
NAME="GNUMERIC-TRANSPOSE"
></A
>TRANSPOSE</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="function-reference.html#AEN1187"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
NAME="GNUMERIC-CONCATENATE"
></A
>CONCATENATE</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>