subversion/include/svn_path.h

86 /** Join a base path (@a base) with a component (@a component), allocating
87  * the result in @a pool. @a component need not be a single component: it
90  * If either @a base or @a component is the empty path, then the other
94  * If the @a component is an absolute path, then it is copied and returned.
104  * for the separator. Further, an absolute path (for @a component) is
106  * @a component won't be detected. An absolute URI can only be used
115 svn_path_join(const char *base, const char *component, apr_pool_t *pool);
120  * If any component is the empty string, it will be ignored.
122  * If any component is an absolute path, then it resets the base and
141  * basename is defined as the last component of the path (ignoring any
194 /** Add a @a component (a NULL-terminated C-string) to the
195  * canonicalized @a path.  @a component is allowed to contain
199  * character, and then @a component.  If @a path is empty, simply set it to
200  * @a component; don't add any separator character.
205 svn_path_add_component(svn_stringbuf_t *path, const char *component);
207 /** Remove one component off the end of the canonicalized @a path. */
251  * directory -- that is, if prepending it as a component to an existing
319  * component, i.e. 'protocol://' is not a sufficient ancestor.
453  * absolute, the first component will be a lone dir separator (the
461  * the first component is a lone dir separator.
471 /** Test that @a name is a single path component, that is:
505  * (The remainder is the component which, added to @a path1, yields
588 /** Extend @a url by @a component, URI-encoding that @a component
590  * @a pool.  If @a component is @c NULL, just return a copy of @a url,
593  * @a component need not be a single path segment, but if it contains
594  * multiple segments, they must be separated by '/'.  @a component
600  * @note To add a component that is already URI-encoded, use
601  *       <tt>svn_path_join(url, component, pool)</tt> instead.
603  * @note gstein suggests this for when @a component begins with '/':
617                             const char *component,
628                            const char *component,