TutStrUpr

Name

TutStrUpr — convert a string to uppercase

Synopsis

T_STR TutStrUpr(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

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

Caution

Ensure that dest has been allocated and is large enough to hold the converted string before calling TutStrUpr.

See Also

TutStrLwr

Examples

This example converts a string to uppercase:

T_STR strptr; 
 
strptr = "ThiS Is A MixeD CasE StrinG" 
TutStrUpr(strptr, strptr); 
TutOut("%s\n", strptr); 
. 
. 
. 

The TutOut statement produces this output:

THIS IS A MIXED CASE STRING