rindex(3c) [opensolaris man page]

index(3C)						   Standard C Library Functions 						 index(3C)

NAME

       index, rindex - string operations

SYNOPSIS

       #include <strings.h>

       char *index(const char *s, int c);

       char *rindex(const char *s, int c);

DESCRIPTION

       The index() and rindex() functions operate on null-terminated strings.

       The index() function returns a pointer to the first occurrence of character c in string s.

       The rindex() function returns a pointer to the last occurrence of character c in string s.

       Both  index()  and  rindex() return a null pointer if c does not occur in the string. The null character terminating a string is considered
       to be part of the string.

USAGE

       On most modern computer systems, you can not use a null pointer to indicate a null string.  A null pointer is an error and  results  in	an
       abort  of  the  program.   If  you  wish to indicate a null string, you must use a pointer that points to an explicit null string.  On some
       machines and with some implementations of the C programming language, a null pointer, if dereferenced, would yield a null  string.   Though
       often  used,  this  practice  is not always portable. Programmers using a null pointer to represent an empty string should be aware of this
       portability issue.  Even on machines where dereferencing a null pointer does not cause an abort of the program,	it  does  not  necessarily
       yield a null string.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |ATTRIBUTE TYPE		     |ATTRIBUTE VALUE		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       bstring(3C), malloc(3C), string(3C), attributes(5), standards(5)

SunOS 5.11							    24 Jul 2002 							 index(3C)

STRING(3)						     Library Functions Manual							 STRING(3)

NAME

       strcat, strncat, strcmp, strncmp, strcasecmp, strncasecmp, strcpy, strncpy, strlen, index, rindex - string operations

SYNOPSIS

       #include <strings.h>

       char *strcat(s, append)
       char *s, *append;

       char *strncat(s, append, count)
       char *s, *append;
       int count;

       strcmp(s1, s2)
       char *s1, *s2;

       strncmp(s1, s2, count)
       char *s1, *s2;
       int count;

       strcasecmp(s1, s2)
       char *s1, *s2;

       strncasecmp(s1, s2, count)
       char *s1, *s2;
       int count;

       char *strcpy(to, from)
       char *to, *from;

       char *strncpy(to, from, count)
       char *to, *from;
       int count;

       strlen(s)
       char *s;

       char *index(s, c)
       char *s, c;

       char *rindex(s, c)
       char *s, c;

DESCRIPTION

       These functions operate on null-terminated strings.  They do not check for overflow of any receiving string.

       Strcat appends a copy of string append to the end of string s. Strncat copies at most count characters.	Both return a pointer to the null-
       terminated result.

       Strcmp compares its arguments and returns an integer greater than, equal to, or less than 0, according as s1 is	lexicographically  greater
       than,  equal to, or less than s2.  Strncmp makes the same comparison but looks at at most count characters.  Strcasecmp and strncasecmp are
       identical in function, but are case insensitive.  The returned lexicographic difference reflects a conversion to lower-case.

       Strcpy copies string from to to, stopping after the null character has been moved.  Strncpy  copies  exactly  count  characters,  appending
       nulls  if from is less than count characters in length; the target may not be null-terminated if the length of from is count or more.  Both
       return to.

       Strlen returns the number of non-null characters in s.

       Index (rindex) returns a pointer to the first (last) occurrence of character c in string s or zero if c does not occur in the string.  Set-
       ting c to NULL works.

4th Berkeley Distribution					 October 22, 1987							 STRING(3)