[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Synopsis:
#include <string.h>
char *strupr( char *s );
char *_strupr( char *s );
char __far *_fstrupr( char __far *s );
#include <wchar.h>
wchar_t *_wcsupr( wchar_t *s );
#include <mbstring.h>
unsigned char *_mbsupr( unsigned char *s );
unsigned char __far *_fmbsupr( unsigned char __far *s );
Description:
The strupr function replaces the string s with uppercase characters by
invoking the toupper function for each character in the string.
The _strupr function is identical to strupr. Use _strupr for ANSI/ISO
naming conventions.
The _fstrupr function is a data model independent form of the strupr
function. It accepts far pointer arguments and returns a far pointer.
It is most useful in mixed memory model applications.
The _wcsupr function is a wide-character version of strupr that operates
with wide-character strings.
The _mbsupr function is a multibyte character version of strupr that
operates with multibyte character strings.
Returns:
The address of the original string s is returned.
Example:
#include <stdio.h>
#include <string.h>
char source[] = { "A mixed-case STRING" };
void main()
{
printf( "%s\n", source );
printf( "%s\n", strupr( source ) );
printf( "%s\n", source );
}
produces the following:
A mixed-case STRING
A MIXED-CASE STRING
A MIXED-CASE STRING
Classification:
WATCOM
_strupr conforms to ANSI/ISO naming conventions
Systems:
strupr - All, Netware
_strupr - All, Netware
_fstrupr - All
_wcsupr - All
_mbsupr - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32
_fmbsupr - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32
See Also:
strlwr
See Also:
Online resources provided by: http://www.ClipX.Net --- NG 2 HTML conversion by Dave Pearson