annotate lib/dirname-lgpl.c @ 40203:30d91797009f

autoupdate
author Karl Berry <karl@freefriends.org>
date Fri, 01 Mar 2019 08:42:42 -0800
parents b06060465f09
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
1 /* dirname.c -- return all but the last element in a file name
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
2
40057
b06060465f09 maint: Run 'make update-copyright'
Paul Eggert <eggert@cs.ucla.edu>
parents: 19484
diff changeset
3 Copyright (C) 1990, 1998, 2000-2001, 2003-2006, 2009-2019 Free Software
12518
b5e42ef33b49 update nearly all FSF copyright year lists to include 2009
Jim Meyering <meyering@redhat.com>
parents: 12212
diff changeset
4 Foundation, Inc.
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
5
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
6 This program is free software: you can redistribute it and/or modify
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
8 the Free Software Foundation; either version 3 of the License, or
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
9 (at your option) any later version.
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
10
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
14 GNU General Public License for more details.
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
15
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
19190
9759915b2aca all: prefer https: URLs
Paul Eggert <eggert@cs.ucla.edu>
parents: 18626
diff changeset
17 along with this program. If not, see <https://www.gnu.org/licenses/>. */
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
18
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
19 #include <config.h>
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
20
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
21 #include "dirname.h"
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
22
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
23 #include <stdlib.h>
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
24 #include <string.h>
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
25
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
26 /* Return the length of the prefix of FILE that will be used by
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
27 dir_name. If FILE is in the working directory, this returns zero
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
28 even though 'dir_name (FILE)' will return ".". Works properly even
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
29 if there are trailing slashes (by effectively ignoring them). */
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
30
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
31 size_t
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
32 dir_len (char const *file)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
33 {
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
34 size_t prefix_length = FILE_SYSTEM_PREFIX_LEN (file);
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
35 size_t length;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
36
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
37 /* Advance prefix_length beyond important leading slashes. */
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
38 prefix_length += (prefix_length != 0
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
39 ? (FILE_SYSTEM_DRIVE_PREFIX_CAN_BE_RELATIVE
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
40 && ISSLASH (file[prefix_length]))
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
41 : (ISSLASH (file[0])
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
42 ? ((DOUBLE_SLASH_IS_DISTINCT_ROOT
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
43 && ISSLASH (file[1]) && ! ISSLASH (file[2])
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
44 ? 2 : 1))
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
45 : 0));
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
46
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
47 /* Strip the basename and any redundant slashes before it. */
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
48 for (length = last_component (file) - file;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
49 prefix_length < length; length--)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
50 if (! ISSLASH (file[length - 1]))
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
51 break;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
52 return length;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
53 }
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
54
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
55
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
56 /* In general, we can't use the builtin 'dirname' function if available,
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
57 since it has different meanings in different environments.
16235
18a38c9615f0 In commentary, do not use ` to quote.
Paul Eggert <eggert@cs.ucla.edu>
parents: 16201
diff changeset
58 In some environments the builtin 'dirname' modifies its argument.
12212
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
59
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
60 Return the leading directories part of FILE, allocated with malloc.
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
61 Works properly even if there are trailing slashes (by effectively
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
62 ignoring them). Return NULL on failure.
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
63
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
64 If lstat (FILE) would succeed, then { chdir (dir_name (FILE));
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
65 lstat (base_name (FILE)); } will access the same file. Likewise,
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
66 if the sequence { chdir (dir_name (FILE));
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
67 rename (base_name (FILE), "foo"); } succeeds, you have renamed FILE
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
68 to "foo" in the same directory FILE was in. */
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
69
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
70 char *
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
71 mdir_name (char const *file)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
72 {
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
73 size_t length = dir_len (file);
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
74 bool append_dot = (length == 0
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
75 || (FILE_SYSTEM_DRIVE_PREFIX_CAN_BE_RELATIVE
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
76 && length == FILE_SYSTEM_PREFIX_LEN (file)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
77 && file[2] != '\0' && ! ISSLASH (file[2])));
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
78 char *dir = malloc (length + append_dot + 1);
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
79 if (!dir)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
80 return NULL;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
81 memcpy (dir, file, length);
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
82 if (append_dot)
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
83 dir[length++] = '.';
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
84 dir[length] = '\0';
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
85 return dir;
8bf6ff9a34bd dirname: split into dirname-lgpl
Eric Blake <ebb9@byu.net>
parents:
diff changeset
86 }