_fixpath

Syntax

#include <sys/stat.h> void _fixpath(const char *in_path, char *out_path);

Description

This function canonicalizes the input path in_path and stores the result in the buffer pointed to by out_path.

The path is fixed by removing consecutive and trailing slashes, making the path absolute if it's relative by prepending the current drive letter and working directory, removing "." components, collapsing ".." components, adding a drive specifier if needed, and converting all slashes to '/'. DOS-style 8+3 names of directories which are part of the pathname, as well as its final filename part, are returned lower-cased in out_path, but long filenames are left intact. See section _preserve_fncase, for more details on letter-case conversions in filenames.

Since the returned path name can be longer than the original one, the caller should ensure there is enough space in the buffer pointed to by out_path. Using ANSI-standard constant FILENAME_MAX (defined on `stdio.h') or Posix-standard constant PATH_MAX (defined on `limits.h') is recommended.

Return Value

None. If the length of the returned path name exceeds FILENAME_MAX, errno is set to ENAMETOOLONG.

Portability

ANSI/ISO C	No
POSIX	No

Example

char oldpath[100], newpath[FILENAME_MAX]; scanf("%s", oldpath); _fixpath(oldpath, newpath); printf("that really is %s\n", newpath);