path-util: document a few other special cases for last_path_component()

This commit is contained in:
Lennart Poettering 2018-04-05 18:00:39 +02:00
parent 342f6f80f5
commit 8460289f35
2 changed files with 15 additions and 4 deletions

View File

@ -715,16 +715,23 @@ char* dirname_malloc(const char *path) {
}
const char *last_path_component(const char *path) {
/* Finds the last component of the path, preserving the
* optional trailing slash that signifies a directory.
/* Finds the last component of the path, preserving the optional trailing slash that signifies a directory.
*
* a/b/c c
* a/b/c/ c/
* x x
* x/ x/
* /y y
* /y/ y/
* / /
* // → /
* /foo/a a
* /foo/a/ a/
* This is different than basename, which returns "" when
* a trailing slash is present.
*
* Also, the empty string is mapped to itself.
*
* This is different than basename(), which returns "" when a trailing slash is present.
*/
unsigned l, k;

View File

@ -399,6 +399,10 @@ static void test_last_path_component(void) {
assert_se(streq(last_path_component("/foo/a"), "a"));
assert_se(streq(last_path_component("/foo/a/"), "a/"));
assert_se(streq(last_path_component(""), ""));
assert_se(streq(last_path_component("a"), "a"));
assert_se(streq(last_path_component("a/"), "a/"));
assert_se(streq(last_path_component("/a"), "a"));
assert_se(streq(last_path_component("/a/"), "a/"));
}
static void test_filename_is_valid(void) {