Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <string.h>
    char *strlwr( char *s1 );
    char *_strlwr( char *s1 );
    char __far *_fstrlwr( char __far *s1 );
    #include <wchar.h>
    wchar_t *_wcslwr( wchar_t *s1 );
    #include <mbstring.h>
    unsigned char *_mbslwr( unsigned char *s1 );
    unsigned char __far *_fmbslwr( unsigned char __far *s1 );

Description:
    The strlwr function replaces 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/ISO
    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.

    The _wcslwr function is a wide-character version of strlwr that operates
    with wide-character strings.

    The _mbslwr function is a multibyte character version of strlwr that
    operates with multibyte character strings.

    The _fmbslwr function is a data model independent form of the _mbslwr
    function that accepts far pointer arguments.  It is most useful in mixed
    memory model applications.

Returns:
    The address of the original string s1 is returned.

Example:
    #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 following:

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

Classification:
    WATCOM

_strlwr conforms to ANSI/ISO naming conventions

Systems:
     strlwr - All, Netware

    _strlwr - All, Netware
    _fstrlwr - All
    _wcslwr - All
    _mbslwr - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32
    _fmbslwr - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    strupr