MirOS Manual: basename(3)

BASENAME(3)                BSD Programmer's Manual                 BASENAME(3)

NAME

     basename - extract the base portion of a pathname

SYNOPSIS

     #include <libgen.h>

     char *
     basename(const char *path);

DESCRIPTION

     The basename() function returns the last component from the pathname
     pointed to by path, deleting any trailing '/' characters. If path con-
     sists entirely of '/' characters, a pointer to the string "/" is re-
     turned. If path is a null pointer or the empty string, a pointer to the
     string "." is returned.

RETURN VALUES

     On successful completion, basename() returns a pointer to the last com-
     ponent of path.

     If basename() fails, a null pointer is returned and the global variable
     errno is set to indicate the error.

ERRORS

     The following error codes may be set in errno:

     [ENAMETOOLONG]
                   The path component to be returned was larger than
                   MAXPATHLEN.

WARNINGS

     basename() returns a pointer to internal static storage space that will
     be overwritten by subsequent calls.

SEE ALSO

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

STANDARDS

     The basename() function conforms to X/Open Portability Guide Issue 4.2
     ("XPG4.2").

HISTORY

     The basename() function first appeared in OpenBSD 2.2.

AUTHORS

     Todd C. Miller

MirOS BSD #10-current          August 17, 1997                               1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.