89 lines
2.4 KiB
C
89 lines
2.4 KiB
C
#ifndef __EVIL_LIBGEN_H__
|
|
#define __EVIL_LIBGEN_H__
|
|
|
|
|
|
/**
|
|
* @file evil_libgen.h
|
|
* @brief The file that provides functions ported from Unix in libgen.h.
|
|
* @defgroup Evil_Libgen_Group Libgen.h functions.
|
|
*
|
|
* This header provides functions ported from Unix in libgen.h.
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief Parse the base name component of a path.
|
|
*
|
|
* @param path The path to parse.
|
|
* @return The component following the final '/'.
|
|
*
|
|
* This function parses @p path and returns its component following
|
|
* the final '\'. Trailing '\' are not taken into account. On Windows
|
|
* XP, @p path must beginning by a drive letter followed by ':/' or
|
|
* ':\', otherwise "C:\" is returned. All characters '/' are replaced by '\'. On
|
|
* error (memory allocation failure), "C:\" is returned, otherwise the
|
|
* component following the final '\' is returned as a statically
|
|
* allocated memory. Hence the returns value must not be freed.
|
|
*
|
|
* Concatenating the string returned by dirname(), a "\", and the
|
|
* string returned by basename() yields a complete pathname.
|
|
*
|
|
* @see evil_dirname()
|
|
* @see dirname()
|
|
*
|
|
* Conformity: Non applicable.
|
|
*
|
|
* Supported OS: Windows XP.
|
|
*/
|
|
EAPI char *evil_basename(char *path);
|
|
|
|
/**
|
|
* @def basename(p)
|
|
*
|
|
* Wrapper around evil_basename().
|
|
*/
|
|
#define basename(p) evil_basename(p)
|
|
|
|
/**
|
|
* @brief Parse the dir name component of a path.
|
|
*
|
|
* @param path The path to parse.
|
|
* @return The component up to, but not including, the final '/'.
|
|
*
|
|
* This function parses @p path and returns its component up to, but
|
|
* not including, the final '/'. Trailing '\' are not taken into
|
|
* account. On Windows XP, @p path must beginning by a drive letter
|
|
* followed by ':/' or ':\', otherwise "C:\" is returned. All
|
|
* characters '/' are replaced by '\'. On error (memory allocation
|
|
* failure), "C:\" is returned, otherwise, the component up to, but
|
|
* not including, the final '/' is returned as a statically allocated
|
|
* memory. Hence the returns value must not be freed.
|
|
*
|
|
* Concatenating the string returned by dirname(), a "\", and the
|
|
* string returned by basename() yields a complete pathname.
|
|
*
|
|
* @see evil_basename()
|
|
* @see basename()
|
|
*
|
|
* Conformity: Non applicable.
|
|
*
|
|
* Supported OS: Windows XP.
|
|
*/
|
|
EAPI char *evil_dirname(char *path);
|
|
|
|
/**
|
|
* @def dirname(p)
|
|
*
|
|
* Wrapper around evil_dirname().
|
|
*/
|
|
#define dirname(p) evil_dirname(p)
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
|
|
#endif /* __EVIL_LIBGEN_H__ */
|