search..
No manual entry for -- in section 3
basename(3)		    Library Functions Manual		    basename(3)

NAME
       basename, dirname - parse pathname components

LIBRARY
       Standard C library (libc, -lc)

SYNOPSIS
       #include <libgen.h>

       char *dirname(char *path);
       char *basename(char *path);

DESCRIPTION
       Warning: there are two different functions basename(); see below.

       The  functions dirname() and basename() break a null-terminated pathname
       string into directory and  filename  components.	  In  the  usual  case,
       dirname()  returns  the	string up to, but not including, the final '/',
       and basename() returns the component following the final '/'.   Trailing
       '/' characters are not counted as part of the pathname.

       If path does not contain a slash, dirname() returns the string "." while
       basename() returns a copy of path.  If path is the string "/", then both
       dirname()  and  basename()  return  the	string	"/".  If path is a null
       pointer or points to an empty string, then both dirname() and basename()
       return the string ".".

       Concatenating the string returned by dirname(), a "/",  and  the	 string
       returned by basename() yields a complete pathname.

       Both dirname() and basename() may modify the contents of path, so it may
       be desirable to pass a copy when calling one of these functions.

       These functions may return pointers to statically allocated memory which
       may  be overwritten by subsequent calls.	 Alternatively, they may return
       a pointer to some part of path, so that the string referred to  by  path
       should  not be modified or freed until the pointer returned by the func-
       tion is no longer required.

       The following list of examples (taken from SUSv2) shows the strings  re-
       turned by dirname() and basename() for different paths:
	      path	 dirname   basename
	      /usr/lib	 /usr	   lib
	      /usr/	 /	   usr
	      usr	 .	   usr
	      /		 /	   /
	      .		 .	   .
	      ..	 .	   ..

RETURN VALUE
       Both   dirname()	 and  basename()  return  pointers  to	null-terminated
       strings.	 (Do not pass these pointers to free(3).)

ATTRIBUTES
       For an explanation of the terms used in this section, see attributes(7).
       +--------------------------------------------+---------------+---------+
       | Interface				    | Attribute	    | Value   |
       +--------------------------------------------+---------------+---------+
       | basename(), dirname()			    | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+

VERSIONS
       There are two different versions of basename() - the POSIX  version  de-
       scribed above, and the GNU version, which one gets after

	       #define _GNU_SOURCE	   /* See feature_test_macros(7) */
	       #include <string.h>

       The  GNU	 version  never	 modifies  its	argument, and returns the empty
       string when path has a trailing slash, and in particular also when it is
       "/".  There is no GNU version of dirname().

       With glibc, one gets the POSIX version of basename() when <libgen.h>  is
       included, and the GNU version otherwise.

STANDARDS
       POSIX.1-2008.

HISTORY
       POSIX.1-2001.

BUGS
       In  the glibc implementation, the POSIX versions of these functions mod-
       ify the path argument, and segfault when called	with  a	 static	 string
       such as "/usr/".

       Before  glibc  2.2.1,  the  glibc version of dirname() did not correctly
       handle pathnames with trailing '/' characters, and generated a  segfault
       if given a NULL argument.

EXAMPLES
       The  following  code  snippet  demonstrates  the	 use  of basename() and
       dirname():
	   char *dirc, *basec, *bname, *dname;
	   char *path = "/etc/passwd";

	   dirc = strdup(path);
	   basec = strdup(path);
	   dname = dirname(dirc);
	   bname = basename(basec);
	   printf("dirname=%s, basename=%s\n", dname, bname);

SEE ALSO
       basename(1), dirname(1)

Linux man-pages 6.9.1		   2024-06-15			    basename(3)