function
<cstring>
strchr
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 in order 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 for the comparison.
Return Value
A pointer to the first occurrence of character in str.
If the character is not found, the function returns a null pointer.
Portability
In C, this function is only 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 characters in string (function)