The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

basename - return the last component of a pathname

 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 "." .

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().

This interface need not be reentrant.

 RETURN VALUE

The basename() function returns a pointer to the final component of path.

 ERRORS

No errors are defined.

 EXAMPLES

Input String Output String
"/usr/lib" "lib"
"/usr/" "usr"
"/" "/"

 APPLICATION USAGE

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

dirname(), <libgen.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]