const char * strchr ( const char * str, int character );
      char * strchr (       char * str, int character );

<cstring>

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

Portability

char * strchr ( const char *, int );

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

Example

/* 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