SYNOPSIS<\/a>
DESCRIPTION<\/a>
RETURN VALUE<\/a>
ATTRIBUTES<\/a>
CONFORMING TO<\/a>
NOTES<\/a>
BUGS<\/a>
EXAMPLES<\/a>
SEE ALSO<\/a>
COLOPHON<\/a> <\/p>\n
\n
NAME <\/a> <\/h2>\nbasename, dirname \u2212 parse pathname components<\/p>\n
SYNOPSIS <\/a> <\/h2>\n#include <\/b><\/p>\nchar *dirname(char *<\/b>path<\/i>);<\/b><\/p>\n
char *basename(char *<\/b>path<\/i>);<\/b><\/p>\nDESCRIPTION <\/a> <\/h2>\nWarning: there are two different functions basename<\/b>() – see below.<\/p>\n
The functions dirname<\/b>() and basename<\/b>() break a null-terminated pathname string into directory and filename components. In the usual case, dirname<\/b>() returns the string up to, but not including, the final ‘\/’, and basename<\/b>() returns the component following the final ‘\/’. Trailing ‘\/’ characters are not counted as part of the pathname.<\/p>\n
If path<\/i> does not contain a slash, dirname<\/b>() returns the string “.” while basename<\/b>() returns a copy of path<\/i>. If path<\/i> is the string “\/”, then both dirname<\/b>() and basename<\/b>() return the string “\/”. If path<\/i> is a null pointer or points to an empty string, then both dirname<\/b>() and basename<\/b>() return the string “.”.<\/p>\n
Concatenating the string returned by dirname<\/b>(), a “\/”, and the string returned by basename<\/b>() yields a complete pathname.<\/p>\n
Both dirname<\/b>() and basename<\/b>() may modify the contents of path<\/i>, so it may be desirable to pass a copy when calling one of these functions.<\/p>\n
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<\/i>, so that the string referred to by path<\/i> should not be modified or freed until the pointer returned by the function is no longer required.<\/p>\n
The following list of examples (taken from SUSv2) shows the strings returned by dirname<\/b>() and basename<\/b>() for different paths:<\/p>\n
#include char *dirname(char *<\/b>path<\/i>);<\/b><\/p>\n char *basename(char *<\/b>path<\/i>);<\/b><\/p>\n Warning: there are two different functions basename<\/b>() – see below.<\/p>\n The functions dirname<\/b>() and basename<\/b>() break a null-terminated pathname string into directory and filename components. In the usual case, dirname<\/b>() returns the string up to, but not including, the final ‘\/’, and basename<\/b>() returns the component following the final ‘\/’. Trailing ‘\/’ characters are not counted as part of the pathname.<\/p>\n If path<\/i> does not contain a slash, dirname<\/b>() returns the string “.” while basename<\/b>() returns a copy of path<\/i>. If path<\/i> is the string “\/”, then both dirname<\/b>() and basename<\/b>() return the string “\/”. If path<\/i> is a null pointer or points to an empty string, then both dirname<\/b>() and basename<\/b>() return the string “.”.<\/p>\n Concatenating the string returned by dirname<\/b>(), a “\/”, and the string returned by basename<\/b>() yields a complete pathname.<\/p>\n Both dirname<\/b>() and basename<\/b>() may modify the contents of path<\/i>, so it may be desirable to pass a copy when calling one of these functions.<\/p>\n 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<\/i>, so that the string referred to by path<\/i> should not be modified or freed until the pointer returned by the function is no longer required.<\/p>\n The following list of examples (taken from SUSv2) shows the strings returned by dirname<\/b>() and basename<\/b>() for different paths:<\/p>\nDESCRIPTION <\/a> <\/h2>\n
![\"Image](\"grohtml-1579731.png\")
<\/p>\n![\"Image](\"grohtml-1579732.png\")
<\/p>\n