Defined in header <string.h> | ||
---|---|---|
void* memchr( const void* ptr, int ch, size_t count ); |
Finds the first occurrence of ch
(after conversion to unsigned char
as if by (unsigned char)ch
) in the initial count
characters (each interpreted as unsigned char
) of the object pointed to by ptr
.
The behavior is undefined if access occurs beyond the end of the array searched. The behavior is undefined if ptr
is a null pointer.
This function behaves as if it reads the characters sequentially and stops as soon as a matching character is found: if the array pointed to by | (since C11) |
ptr | - | pointer to the object to be examined |
ch | - | character to search for |
count | - | max number of characters to examine |
Pointer to the location of the character, or NULL
if no such character is found.
#include <stdio.h> #include <string.h> int main(void) { char str[] = "ABCDEFG"; char *ps = memchr(str,'D',strlen(str)); if (ps != NULL) printf ("search character found: %s\n", ps); else printf ("search character not found\n"); return 0; }
Output:
search character found: DEFG
finds the first occurrence of a character (function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/c/string/byte/memchr