new file, from Paul Eggert
[gnulib.git] / lib / path-concat.c
1 /* path-concat.c -- concatenate two arbitrary pathnames
2    Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
17
18 /* Written by Jim Meyering.  */
19
20 #if HAVE_CONFIG_H
21 # include <config.h>
22 #endif
23
24 #ifndef HAVE_MEMPCPY
25 # define mempcpy(D, S, N) ((void *) ((char *) memcpy (D, S, N) + (N)))
26 #endif
27
28 #include <stdio.h>
29
30 #if HAVE_STRING_H
31 # if !STDC_HEADERS && HAVE_MEMORY_H
32 #  include <memory.h>
33 # endif
34 # include <string.h>
35 #else
36 # if HAVE_STRINGS_H
37 #  include <strings.h>
38 # endif
39 #endif
40 #if HAVE_STDLIB_H
41 # include <stdlib.h>
42 #endif
43 #if HAVE_UNISTD_H
44 # include <unistd.h>
45 #endif
46
47 #ifndef HAVE_DECL_MALLOC
48 "this configure-time declaration test was not run"
49 #endif
50 #if !HAVE_DECL_MALLOC
51 char *malloc ();
52 #endif
53
54 #ifndef strdup
55 char *strdup ();
56 #endif
57
58 #include "dirname.h"
59 #include "xalloc.h"
60 #include "path-concat.h"
61
62 /* Concatenate two pathname components, DIR and BASE, in
63    newly-allocated storage and return the result.  Return 0 if out of
64    memory.  Add a slash between DIR and BASE in the result if neither
65    would contribute one.  If each would contribute at least one, elide
66    one from the end of DIR.  Otherwise, simply concatenate DIR and
67    BASE.  In any case, if BASE_IN_RESULT is non-NULL, set
68    *BASE_IN_RESULT to point to the copy of BASE in the returned
69    concatenation.
70
71    DIR may be NULL, BASE must not be.
72
73    Return NULL if memory is exhausted.  */
74
75 char *
76 path_concat (const char *dir, const char *base, char **base_in_result)
77 {
78   char *p;
79   char *p_concat;
80   size_t baselen;
81   size_t dirlen;
82
83   if (!dir)
84     {
85       p_concat = strdup (base);
86       if (base_in_result)
87         *base_in_result = p_concat;
88       return p_concat;
89     }
90
91   /* DIR is not empty. */
92   baselen = base_len (base);
93   dirlen = strlen (dir);
94
95   p_concat = malloc (dirlen + baselen + 2);
96   if (!p_concat)
97     return 0;
98
99   p = mempcpy (p_concat, dir, dirlen);
100
101   if (FILESYSTEM_PREFIX_LEN (dir) < dirlen)
102     {
103       if (ISSLASH (*(p - 1)) && ISSLASH (*base))
104         --p;
105       else if (!ISSLASH (*(p - 1)) && !ISSLASH (*base))
106         *p++ = DIRECTORY_SEPARATOR;
107     }
108
109   if (base_in_result)
110     *base_in_result = p;
111
112   memcpy (p, base, baselen);
113   p[baselen] = '\0';
114
115   return p_concat;
116 }
117
118 /* Same, but die when memory is exhausted. */
119
120 char *
121 xpath_concat (const char *dir, const char *base, char **base_in_result)
122 {
123   char *res = path_concat (dir, base, base_in_result);
124   if (res)
125     return res;
126   xalloc_die ();
127 }