[Previous] [Contents] [Index] [Next]

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

strlwr()

Convert a string to lowercase

Synopsis:

#include <string.h>

char* strlwr( char* s1 );

Arguments:

s1
The string that you want to convert to lowercase.

Library:

libc

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

Description:

The strlwr() function replaces the string s1 with lowercase characters, by invoking tolower() for each character in the string.

Returns:

The address of the string.

Examples:

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

char source[] = { "A mixed-case STRING" };

int main( void )
  {
    printf( "%s\n", source );
    printf( "%s\n", strlwr( source ) );
    printf( "%s\n", source );
    return EXIT_SUCCESS;
  }

produces the output:

A mixed-case STRING
a mixed-case string
a mixed-case string

Classification:

Unix

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

See also:

strupr(), tolower()


[Previous] [Contents] [Index] [Next]