This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

strchr()

Find the first occurrence of a character in a string

Synopsis:

#include <string.h>

char* strchr(char* s, 
              int c );

Arguments:

s: The string that you want to search.
c: The character that you're looking for.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The strchr() function finds the first occurrence of c (converted to a char) in the string pointed to by s. The terminating NUL character is considered to be part of the string.

Returns:

A pointer to the located character, or NULL if c doesn't occur in the string.

Examples:

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

int main( void )
{
    char buffer[80];
    char* where;

    strcpy( buffer, "video x-rays" );

    where = strchr( buffer, 'x' );

    if( where == NULL ) {
        printf( "'x' not found\n" );
    } else {
        printf( "'x' found: %s\n", where );
    }

    return EXIT_SUCCESS;
}

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes