strlwr, _mbslwr, _wcslwr

Go Up to string.h Index

Header File

string.h, mbstring.h

Category

Conversion Routines, Memory and String Manipulation Routines

Prototype

char *strlwr(char *s);

wchar_t *_wcslwr(wchar_t *s);

unsigned char *_mbslwr(unsigned char *s);

Description

Converts uppercase letters in a string to lowercase.

strlwr converts uppercase letters in string s to lowercase according to the current locale's LC_CTYPE category. For the C locale, the conversion is from uppercase letters (A to Z) to lowercase letters (a to z). No other characters are changed.

Return Value

strlwr returns a pointer to the string s.

Example

#include <stdio.h>
#include <string.h>
int main(void)
{
   char *string = "CBuilder";
   printf("string prior to strlwr: %s\n", string);
   strlwr(string);
   printf("string after strlwr:    %s\n", string);
   return 0;
}

Portability

	POSIX	Win32	ANSI C	ANSI C++
strlwr		+
_mbslwr		+
_wcslwr		+