Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Watcom C Library Reference - <u>synopsis:</u> http://www.X-Hacker.org [<<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.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson