Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
C Library
cassert (assert.h)
cctype (ctype.h)
cerrno (errno.h)
cfloat (float.h)
ciso646 (iso646.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


strchr

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

Locate first occurrence of character in string

Returns a pointer to the first 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 first 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 * strchr ( const char *, int );
instead of the two overloaded versions provided in C++.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
/* strchr example */
#include <stdio.h>
#include <string.h>
int main ()
{
  char str[] = "This is a sample string";
  char * pch;
  printf ("Looking for the 's' character in \"%s\"...\n",str);
  pch=strchr(str,'s');
  while (pch!=NULL)
  {
    printf ("found at %d\n",pch-str+1);
    pch=strchr(pch+1,'s');
  }
  return 0;
}


Output:

Looking for the 's' character in "This is a sample string"...
found at 4
found at 7
found at 11
found at 18

See also

strrchr Locate last occurrence of character in string (function)
memchr Locate character in block of memory (function)
strpbrk Locate character in string (function)