strlwr, _strlwr, _fstrlwr

convert a string to lowercase

Synopsis:

#include <string.h>
char *strlwr( char *s1 );
char *_strlwr( char *s1 );
char __far *_fstrlwr( char __far *s1 );

Description:

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

The _strlwr() function is identical to strlwr(). Use _strlwr() for ANSI naming conventions.

The _fstrlwr() function is a data-model-independent form of the strlwr() function. It accepts far pointer arguments, and returns a far pointer. It is most useful in mixed memory model applications.

Returns:

the address of the original string s1

See also:

strupr()

Examples:

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

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

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

produces the output:

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

Classification:

WATCOM

_strlwr() conforms to ANSI naming conventions.

Systems:

strlwr()

All (except DOS/PM)

_strlwr()

All (except DOS/PM)

_fstrlwr()

All (except Netware, DOS/PM)