GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
BASENAME(3) FreeBSD Library Functions Manual BASENAME(3)

basename
extract the base portion of a pathname

#include <libgen.h>

char *
basename(char *path);

The basename() function returns the last component from the pathname pointed to by path, deleting any trailing ‘/’ characters.

This implementation of basename() uses the buffer provided by the caller to store the resulting pathname component. Other vendor implementations may return a pointer to internal storage space instead. The advantage of the former approach is that it ensures thread-safety, while also placing no upper limit on the supported length of the pathname.

If path consists entirely of ‘/’ characters, a pointer to the string “/” is returned. If path is a null pointer or the empty string, a pointer to the string “.” is returned. Otherwise, it returns a pointer to the last component of path.

basename(1), dirname(1), dirname(3)

The basename() function conforms to X/Open Portability Guide Issue 4, Version 2 (“XPG4.2”).

The basename() function first appeared in OpenBSD 2.2 and FreeBSD 4.2.

In FreeBSD 12.0, this function was reimplemented to store its result in the provided input buffer. There is no longer any need to use the basename_r() function.

Nuxi, the Netherlands
May 22, 2017 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.