BASENAME(3C)BASENAME(3C)NAMEbasename - return the last element of a path name
SYNOPSIS
#include <libgen.h>
char *basename(char *path);
DESCRIPTION
The basename() function takes the pathname pointed to by path and
returns a pointer to the final component of the pathname, deleting any
trailing '/' characters.
If the string consists entirely of the '/' character, basename()
returns a pointer to the string "/" .
If path is a null pointer or points to an empty string, basename()
returns a pointer to the string "." .
RETURN VALUES
The basename() function returns a pointer to the final component of
path.
USAGE
The basename() function may modify the string pointed to by path, and
may return a pointer to static storage that may then be overwritten by
a subsequent call to basename().
When compiling multithreaded applications, the _REENTRANT flag must be
defined on the compile line. This flag should only be used in multi‐
threaded applications.
EXAMPLES
Example 1 Examples for Input String and Output String
┌─────────────┬───────────────┐
│Input String │ Output String │
├─────────────┼───────────────┤
│"/usr/lib" │ "lib" │
├─────────────┼───────────────┤
│"/usr/" │ "usr" │
├─────────────┼───────────────┤
│"/" │ "/" │
└─────────────┴───────────────┘
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSObasename(1), dirname(3C), attributes(5), standards(5)
Jul 24, 2002 BASENAME(3C)