cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : C Library : cstring (string.h) : strrchr
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
C Library
cassert (assert.h)
cctype (ctype.h)
cerrno (errno.h)
cfloat (float.h)
climits (limits.h)
clocale (locale.h)
cmath (math.h)
csetjmp (setjmp.h)
csignal (signal.h)
cstdarg (stdarg.h)
cstddef (stddef.h)
cstdio (stdio.h)
cstdlib (stdlib.h)
cstring (string.h)
ctime (time.h)
cstring (string.h)
functions:
· memchr
· memcmp
· memcpy
· memmove
· memset
· strcat
· strchr
· strcmp
· strcoll
· strcpy
· strcspn
· strerror
· strlen
· strncat
· strncmp
· strncpy
· strpbrk
· strrchr
· strspn
· strstr
· strtok
· strxfrm
macros:
· NULL
types:
· size_t

-

strrchr function
const char * strrchr ( const char * str, int character );
      char * strrchr (       char * str, int character );
<cstring>

Locate last occurrence of character in string

Returns a pointer to the last occurrence of character in the C string str.

The terminating null-character is considered part of the C string. Therefore, it can also be located to retrieve a pointer to the end of a string.

Parameters

str
C string.
character
Character to be located. It is passed as its int promotion, but it is internally converted back to char.

Return Value

A pointer to the last occurrence of character in str.
If the value is not found, the function returns a null pointer.

Portability

In C, this function is declared as:

char * strrchr ( const char *, int );

instead of the two overloaded versions provided in C++.

Example

/* strrchr example */
#include <stdio.h>
#include <string.h>

int main ()
{
  char str[] = "This is a sample string";
  char * pch;
  pch=strrchr(str,'s');
  printf ("Last occurence of 's' found at %d \n",pch-str+1);
  return 0;
}

Output:


Last occurrence of 's' found at 18

See also

strchr Locate first occurrence of character in string (function)
memchr Locate character in block of memory (function)
strpbrk Locate character in string (function)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us