Internationalization and localization tools


File and Path Function

int rename(const char *oldname, const char *newname);

int _wrename(const wchar_t *oldname, const wchar_t *newname);

int _trename(const TCHAR *oldname, const TCHAR *newname);

Internationalization (I18n) Function Overview

The rename function renames the file specified by oldname with the name specified by newname, and returns 0 if successful. In the event of an error, the function returns a non-zero value and sets the global variable errno with the error number.

On Windows platforms, _wrename is the wide-character version of rename; its arguments are wide-character strings. There is no ANSI wide-character equivalent.

_trename is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either rename or _wrename.

I18n Issues

Use the appropriate version of the function as required for internationalization support.

On ANSI UTF-16 platforms, use a conversion function to convert the wide-character string to a multibyte-character string and then call rename.

See Pathnames for a discussion of path and filename considerations in an internationalized application.

Recommended Replacements*

*If you're already using the recommended function, see I18n Issues for other reasons why Globalyzer is detecting the function.

File and Path Functions

 

Lingoport internationalization and localization services and software