strlwr()

Updated: April 19, 2023

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