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)