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 <stdio.h>
    int rename( const char *old, const char *new );
    int _wrename( const wchar_t *old, const wchar_t *new );

Description:
    The rename function causes the file whose name is indicated by the
    string old to be renamed to the name given by the string new.  The
    _wrename function is identical to rename except that it accepts
    wide-character string arguments.

Returns:
    The rename function returns zero if the operation succeeds, a non-zero
    value if it fails.  When an error has occurred,  errno contains a value
    indicating the type of error that has been detected.

Example:
    #include <stdio.h>

    void main()
      {
        rename( "old.dat", "new.dat" );
      }

Classification:
    rename is ANSI, _wrename is not ANSI

Systems:
     rename - All, Netware

    _wrename - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson