2 * paths.c - Path manipulation routines
6 * Copyright (C) 2012, 2013 Eric Biggers
8 * This file is part of wimlib, a library for working with WIM files.
10 * wimlib is free software; you can redistribute it and/or modify it under the
11 * terms of the GNU General Public License as published by the Free
12 * Software Foundation; either version 3 of the License, or (at your option)
15 * wimlib is distributed in the hope that it will be useful, but WITHOUT ANY
16 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
17 * A PARTICULAR PURPOSE. See the GNU General Public License for more
20 * You should have received a copy of the GNU General Public License
21 * along with wimlib; if not, see http://www.gnu.org/licenses/.
29 #include "wimlib/paths.h"
30 #include "wimlib/util.h"
34 /* Like the basename() function, but does not modify @path; it just returns a
35 * pointer to it. This assumes the path separator is the
36 * OS_PREFERRED_PATH_SEPARATOR. */
38 path_basename(const tchar *path)
40 return path_basename_with_len(path, tstrlen(path));
43 /* Like path_basename(), but take an explicit string length. */
45 path_basename_with_len(const tchar *path, size_t len)
47 const tchar *p = &path[len];
52 } while (*--p == OS_PREFERRED_PATH_SEPARATOR);
57 } while (*--p != OS_PREFERRED_PATH_SEPARATOR);
63 /* Returns a pointer to the part of @path following the first colon in the last
64 * path component, or NULL if the last path component does not contain a colon
65 * or has no characters following the first colon. */
67 path_stream_name(const tchar *path)
69 const tchar *base = path_basename(path);
70 const tchar *stream_name = tstrchr(base, T(':'));
71 if (stream_name == NULL || *(stream_name + 1) == T('\0'))
74 return stream_name + 1;
77 /* Duplicate a path; return empty string for NULL input. */
79 canonicalize_fs_path(const tchar *fs_path)
83 return TSTRDUP(fs_path);
86 /* Collapse and translate path separators, and strip trailing slashes. Doesn't
87 * add or delete a leading slash.
92 do_canonicalize_path(const tchar *in, tchar *out)
94 tchar *orig_out = out;
97 if (is_any_path_separator(*in)) {
98 /* Collapse multiple path separators into one */
99 *out++ = WIM_PATH_SEPARATOR;
102 } while (is_any_path_separator(*in));
104 /* Copy non-path-separator character */
109 /* Remove trailing slash if existent */
110 if (out - orig_out > 1 && *(out - 1) == WIM_PATH_SEPARATOR)
117 * canonicalize_wim_path() - Given a user-provided path to a file within a WIM
118 * image, translate it into a "canonical" path.
120 * - Translate both types of slash into a consistent type (WIM_PATH_SEPARATOR).
121 * - Collapse path separators.
122 * - Add leading slash if missing.
123 * - Strip trailing slashes.
125 * Examples (with WIM_PATH_SEPARATOR == '/'):
127 * => / [ either NULL or empty string ]
135 * /hello//1 => /hello/1
136 * \\hello\\1\\ => /hello/1
139 canonicalize_wim_path(const tchar *wim_path)
149 result = MALLOC((1 + tstrlen(in) + 1) * sizeof(result[0]));
155 /* Add leading slash if missing */
156 if (!is_any_path_separator(*in))
157 *out++ = WIM_PATH_SEPARATOR;
159 do_canonicalize_path(in, out);