cwk_path_get_next_segment.md (1666B)
1 --- 2 title: cwk_path_get_next_segment 3 description: Advances to the next segment. 4 --- 5 6 _(since v1.0.0)_ 7 Advances to the next segment. 8 9 ## Description 10 ```c 11 bool cwk_path_get_next_segment(struct cwk_segment *segment); 12 ``` 13 14 This function advances the current segment to the next segment. If there are no more segments left, the submitted segment structure will stay unchanged and false is returned. The segment should be either initialized using **[cwk_path_get_first_segment]({{ site.baseurl }}{% link reference/cwk_path_get_first_segment.md %})** or **[cwk_path_get_last_segment]({{ site.baseurl }}{% link reference/cwk_path_get_last_segment.md %})**. 15 16 ## Parameters 17 * **segment**: The current segment which will be advanced to the next one. 18 19 ## Return Value 20 Returns ``true`` if another segment was found or ``false`` otherwise. 21 22 ## Example 23 ```c 24 #include <cwalk.h> 25 #include <stdio.h> 26 #include <stddef.h> 27 #include <stdlib.h> 28 29 int main(int argc, char *argv[]) 30 { 31 struct cwk_segment segment; 32 33 if(!cwk_path_get_first_segment("/my/funny/test/path.txt", &segment)) { 34 printf("Path doesn't have any segments."); 35 return EXIT_FAILURE; 36 } 37 38 do { 39 printf("Current segment is '%.*s'.\n", (int)segment.size, segment.begin); 40 } while(cwk_path_get_next_segment(&segment)); 41 42 return EXIT_SUCCESS; 43 } 44 ``` 45 46 Ouput: 47 ``` 48 Current segment is 'my'. 49 Current segment is 'funny'. 50 Current segment is 'test'. 51 Current segment is 'path.txt'. 52 ``` 53 54 ## Changelog 55 56 | Version | Description | 57 |------------|--------------------------------------------------------| 58 | **v1.0.0** | The function is introduced. |