mirror of
https://git.proxmox.com/git/libgit2
synced 2025-05-29 15:10:02 +00:00
bb742ede3d
1. The license header is technically not valid if it doesn't have a copyright signature. 2. The COPYING file has been updated with the different licenses used in the project. 3. The full GPLv2 header in each file annoys me.
85 lines
2.7 KiB
C
85 lines
2.7 KiB
C
/*
|
|
* Copyright (C) 2009-2011 the libgit2 contributors
|
|
*
|
|
* This file is part of libgit2, distributed under the GNU GPL v2 with
|
|
* a Linking Exception. For full terms see the included COPYING file.
|
|
*/
|
|
#ifndef INCLUDE_path_h__
|
|
#define INCLUDE_path_h__
|
|
|
|
#include "common.h"
|
|
|
|
/*
|
|
* The dirname() function shall take a pointer to a character string
|
|
* that contains a pathname, and return a pointer to a string that is a
|
|
* pathname of the parent directory of that file. Trailing '/' characters
|
|
* in the path are not counted as part of the path.
|
|
*
|
|
* If path does not contain a '/', then dirname() shall return a pointer to
|
|
* the string ".". If path is a null pointer or points to an empty string,
|
|
* dirname() shall return a pointer to the string "." .
|
|
*
|
|
* The `git_path_dirname` implementation is thread safe. The returned
|
|
* string must be manually free'd.
|
|
*
|
|
* The `git_path_dirname_r` implementation expects a string allocated
|
|
* by the user with big enough size.
|
|
*/
|
|
extern char *git_path_dirname(const char *path);
|
|
extern int git_path_dirname_r(char *buffer, size_t bufflen, const char *path);
|
|
|
|
/*
|
|
* This function returns the basename of the file, which is the last
|
|
* part of its full name given by fname, with the drive letter and
|
|
* leading directories stripped off. For example, the basename of
|
|
* c:/foo/bar/file.ext is file.ext, and the basename of a:foo is foo.
|
|
*
|
|
* Trailing slashes and backslashes are significant: the basename of
|
|
* c:/foo/bar/ is an empty string after the rightmost slash.
|
|
*
|
|
* The `git_path_basename` implementation is thread safe. The returned
|
|
* string must be manually free'd.
|
|
*
|
|
* The `git_path_basename_r` implementation expects a string allocated
|
|
* by the user with big enough size.
|
|
*/
|
|
extern char *git_path_basename(const char *path);
|
|
extern int git_path_basename_r(char *buffer, size_t bufflen, const char *path);
|
|
|
|
extern const char *git_path_topdir(const char *path);
|
|
|
|
/**
|
|
* Join two paths together. Takes care of properly fixing the
|
|
* middle slashes and everything
|
|
*
|
|
* The paths are joined together into buffer_out; this is expected
|
|
* to be an user allocated buffer of `GIT_PATH_MAX` size
|
|
*/
|
|
extern void git_path_join_n(char *buffer_out, int npath, ...);
|
|
|
|
GIT_INLINE(void) git_path_join(char *buffer_out, const char *path_a, const char *path_b)
|
|
{
|
|
git_path_join_n(buffer_out, 2, path_a, path_b);
|
|
}
|
|
|
|
int git_path_root(const char *path);
|
|
|
|
int git_path_prettify(char *path_out, const char *path, const char *base);
|
|
int git_path_prettify_dir(char *path_out, const char *path, const char *base);
|
|
|
|
#ifdef GIT_WIN32
|
|
GIT_INLINE(void) git_path_mkposix(char *path)
|
|
{
|
|
while (*path) {
|
|
if (*path == '\\')
|
|
*path = '/';
|
|
|
|
path++;
|
|
}
|
|
}
|
|
#else
|
|
# define git_path_mkposix(p) /* blank */
|
|
#endif
|
|
|
|
#endif
|