Manual Page Result
0
Command: basename | Section: 3 | Source: NetBSD | File: basename.3
BASENAME(3) FreeBSD Library Functions Manual BASENAME(3)
NAME
basename - return the last component of a pathname
LIBRARY
Standard C Library (libc, -lc)
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 path consists entirely of `/' characters, 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.
SEE ALSO
basename(1), dirname(3)
STANDARDS
o X/Open Portability Guide Issue 4, Version 2 ("XPG4.2")
o IEEE Std 1003.1-2001 ("POSIX.1")
BUGS
If the length of the result is longer than PATH_MAX bytes (including the
terminating nul), the result will be truncated.
The basename() function returns a pointer to static storage that may be
overwritten by subsequent calls to basename(). This is not strictly a
bug; it is explicitly allowed by IEEE Std 1003.1-2001 ("POSIX.1").
FreeBSD 14.1-RELEASE-p8 May 10, 2008 FreeBSD 14.1-RELEASE-p8