TutStrLwr

Name

TutStrLwr — convert a string to lowercase

Synopsis

T_STR TutStrLwr(dest, src) 
T_STR dest;  
T_STR src; 

Arguments

dest — converted string

src — original (source) string

Return Values

Pointer to the converted string.

Diagnostics

None

Description

TutStrLwr converts a character string from uppercase to lowercase. It takes two character pointers as arguments. The first pointer points to the pre-allocated array that should be large enough to hold the converted string. The second pointer points to the string to be converted to lowercase.

Caution

Always ensure that an array has been allocated and is large enough to hold the converted string, before calling TutStrLwr.

See Also

TutStrUpr

Examples

This example converts a string to lowercase:

T_CHAR strptr[80]; 
 
strcpy(strptr, "ThiS Is A MixeD CasE StrinG"); 
TutStrLwr(strptr, strptr); 
TutOut("%s\n", strptr); 
. 
. 
. 

The TutOut statement produces this output:

this is a mixed case string