memchr - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# memchr

From cppreference.com
< c‎ | string‎ | byte

Defined in header `<string.h>` |  |
void* memchr( const void* ptr, int ch, size_t count ); |  |

Converts `ch` to unsigned char and locates the first occurrence of that value in the initial `count` characters (each interpreted as unsigned char) of the object pointed to by `ptr`.

### [edit] Parameters

ptr | - | pointer to the object to be examined
ch | - | character to search for
count | - | number of characters to examine

### [edit] Return value

Pointer to the location of the character, or NULL if no such character is found.

### [edit] Example

Run this code

    #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

### [edit] See also

strchr | finds the first occurrence of a character (function) [edit]
C++ documentation for memchr

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=c/string/byte/memchr&oldid=70115"