Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionsbasename(3C)


NAME

 basename - 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 multithreaded applications.

EXAMPLES

 Example 1. Examples for Input String and Output String
 
Input StringOutput String
"/usr/lib""lib"
"/usr/""usr"
"/""/"

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe

SEE ALSO

 

basename(1), dirname(3C), attributes(5)


SunOS 5.9Go To TopLast Changed 29 Dec 1996

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.