strrchr()

Find the last occurrence of a character in a string

Synopsis:

#include <string.h>

const char* strrchr(const 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 strrchr() function locates the last occurrence of c (converted to a char) in the string pointed to by s. The terminating null character is considered to be part of the string.

Returns:

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

Examples:

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

int main( void )
  {
    printf( "%s\n", strrchr( "abcdeabcde", 'a' ) );
    if( strrchr( "abcdeabcde", 'x' ) == NULL )
      printf( "NULL\n" );
    return EXIT_SUCCESS;
  }

produces the output:

abcde
NULL

Classification:

ANSI, POSIX 1003.1

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