cwk_path_get_previous_segment.md (1769B)
1 --- 2 title: cwk_path_get_previous_segment 3 description: Moves to the previous segment. 4 --- 5 6 _(since v1.0.0)_ 7 Moves to the previous segment. 8 9 ## Description 10 ```c 11 bool cwk_path_get_previous_segment(struct cwk_segment *segment); 12 ``` 13 14 This function moves the current segment to the previous segment. If the current segment is the first one, 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 moved to the previous one. 18 19 ## Return Value 20 Returns ``true`` if there is a segment before this one 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_last_segment("/my/funny/test/path.txt", &segment)) { 34 printf("Path doesn't have any segments.\n"); 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_previous_segment(&segment)); 41 42 return EXIT_SUCCESS; 43 } 44 ``` 45 46 Ouput: 47 ``` 48 Current segment is 'path.txt'. 49 Current segment is 'test'. 50 Current segment is 'funny'. 51 Current segment is 'my'. 52 ``` 53 54 ## Changelog 55 56 | Version | Description | 57 |------------|--------------------------------------------------------| 58 | **v1.2.4** | Bugfix for single char segments. | 59 | **v1.0.0** | The function is introduced. |