cwk_path_get_dirname.md (1812B)
1 --- 2 title: cwk_path_get_dirname 3 description: Gets the dirname of a file path. 4 --- 5 6 _(since v1.0.0)_ 7 Gets the dirname of a file path. 8 9 ## Description 10 ```c 11 void cwk_path_get_dirname(const char *path, size_t *length); 12 ``` 13 14 This function determines the dirname of a file path and returns the length up to which character is considered to be part of it. The dirname is the part of the path up to the last segment. For instance, `/var/` is the dirname of `/var/logs`. If no dirname is found, the length will be set to zero. The beginning of the dirname is always equal to the submitted path pointer. 15 16 ## Parameters 17 * **path**: The path which will be inspected. 18 * **length**: The length of the dirname. 19 20 ## Outcomes 21 22 | Path | Basename | 23 |------------------------|---------------| 24 | ``/my/path.txt`` | ``/my/`` | 25 | ``/one/two/three.txt`` | ``/one/two/`` | 26 | ``../one/two.txt`` | ``../one/`` | 27 | `` `` | `` `` | 28 | ``/my/path.txt/`` | ``/my/`` | 29 | ``/my/path.txt////`` | ``/my/`` | 30 | ``file_name`` | `` `` | 31 | ``..`` | `` `` | 32 | ``.`` | `` `` | 33 | ``/`` | `` `` | 34 35 ## Example 36 ```c 37 #include <cwalk.h> 38 #include <stdio.h> 39 #include <stddef.h> 40 #include <stdlib.h> 41 42 int main(int argc, char *argv[]) 43 { 44 const char *path; 45 size_t length; 46 47 path = "/my/path.txt"; 48 cwk_path_get_dirname(path, &length); 49 printf("The dirname is: '%.*s'", length, path); 50 51 return EXIT_SUCCESS; 52 } 53 ``` 54 55 Ouput: 56 ``` 57 The dirname is: '/my/' 58 ``` 59 60 ## Changelog 61 62 | Version | Description | 63 |------------|--------------------------------------------------------| 64 | **v1.0.0** | The function is introduced. |