File and Path Operations

int utime(const char *filename, const struct utimbuf *times);

int _utime(unsigned char *filename, struct _utimbuf *times);

int _wutime(wchar_t *filename, struct _utimbuf *times);

int _tutime(TCHAR *filename, struct _utimbuf *times);

Internationalization (I18n) Function Overview

These functions are used to modify the file times associated with the file named filename. If times is a NULL pointer, the modification time is set to the current local time.

_wutime is the wide-character version of the function; its parameters and return value are wide characters. _wutime is supported on Windows platforms only. There is no wide version on ANSI platforms.

_tutime is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _utime or _wutime.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

There is no ANSI wide character version of this function. The parameters will have to be converted to multibyte UTF-8 characters and then the utime function can be used.

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

Recommended Replacements*

ANSI UTF-8	utime
ANSI UTF-16	convert and use utime
	(See "I18n Issues" above)
Microsoft Windows MBCS	_utime
Microsoft Windows Unicode	_wutime
Microsoft Windows Generic	_tutime

File and Path Functions