cwk_path_get_last_segment.md (1534B)
1 --- 2 title: cwk_path_get_last_segment 3 description: Gets the last segment of the path. 4 --- 5 6 _(since v1.0.0)_ 7 Gets the last segment of the path. 8 9 ## Description 10 ```c 11 bool cwk_path_get_last_segment(const char *path, struct cwk_segment *segment); 12 ``` 13 14 This function gets the last segment of a path. This function may return false if the path doesn't contain any segments, in which case the submitted segment parameter is not modified. The position of the segment is set to the first character after the separator, and the length counts all characters until the end of the path (excluding the separator). 15 16 ## Parameters 17 * **path**: The path which will be inspected. 18 * **segment**: The segment which will be extracted. 19 20 ## Return Value 21 Returns ``true`` if there is a segment or ``false`` if there is none. 22 23 ## Example 24 ```c 25 #include <cwalk.h> 26 #include <stdio.h> 27 #include <stddef.h> 28 #include <stdlib.h> 29 30 int main(int argc, char *argv[]) 31 { 32 struct cwk_segment segment; 33 34 if(!cwk_path_get_last_segment("/my/test/path.txt", &segment)) { 35 printf("Path doesn't have any segments."); 36 } 37 38 printf("Segment length is '%zu'.\n", segment.size); 39 printf("The segment is '%.*s'.", (int)segment.size, segment.begin); 40 41 return EXIT_SUCCESS; 42 } 43 ``` 44 45 Ouput: 46 ``` 47 Segment length is '8'. 48 The segment is 'path.txt'. 49 ``` 50 51 ## Changelog 52 53 | Version | Description | 54 |------------|--------------------------------------------------------| 55 | **v1.0.0** | The function is introduced. |