cwk_path_guess_style.md (2559B)
1 --- 2 title: cwk_path_guess_style 3 description: Guesses the path style. 4 --- 5 6 _(since v1.2.0)_ 7 Guesses the path style. 8 9 ## Description 10 ```c 11 enum cwk_path_style cwk_path_guess_style(const char *path); 12 ``` 13 14 This function guesses the path style based on a submitted path-string. The guessing will look at the root and the type of slashes contained in the path and return the style which is more likely used in the path. 15 The algorithm checks the following: 16 1. If the root is longer than 1 character -> ``CWK_STYLE_WINDOWS`` 17 1. If the first separator is a backslash -> ``CWK_STYLE_WINDOWS`` 18 1. If the first separator is a slash -> ``CWK_STYLE_UNIX`` 19 1. If the last segment starts with a dot -> ``CWK_STYLE_UNIX`` 20 1. If the last segment contains a dot -> ``CWK_STYLE_WINDOWS`` 21 1. If nothing was found to determine the style -> ``CWK_STYLE_UNIX`` 22 23 ## Parameters 24 * **path**: The path which will be inspected. 25 26 ## Return Value 27 Returns the style which is most likely used for the path. 28 29 ## Outcomes 30 31 | Path | Result | 32 |-----------------------------|-----------------------| 33 | ``C:\\test`` | ``CWK_STYLE_WINDOWS`` | 34 | ``C:/test`` | ``CWK_STYLE_WINDOWS`` | 35 | ``C:test`` | ``CWK_STYLE_WINDOWS`` | 36 | ``C:/.test`` | ``CWK_STYLE_WINDOWS`` | 37 | ``C:/folder/.test`` | ``CWK_STYLE_WINDOWS`` | 38 | ``\directory\other`` | ``CWK_STYLE_WINDOWS`` | 39 | ``\directory\.other`` | ``CWK_STYLE_WINDOWS`` | 40 | ``myfile.txt`` | ``CWK_STYLE_WINDOWS`` | 41 | ``/directory`` | ``CWK_STYLE_UNIX`` | 42 | ``/directory/other`` | ``CWK_STYLE_UNIX`` | 43 | ``/directory/other.txt`` | ``CWK_STYLE_UNIX`` | 44 | ``.my_hidden_file`` | ``CWK_STYLE_UNIX`` | 45 | ``.my_hidden_file.txt`` | ``CWK_STYLE_UNIX`` | 46 | ``/a/directory/myfile.txt`` | ``CWK_STYLE_UNIX`` | 47 | ``myfile`` | ``CWK_STYLE_UNIX`` | 48 49 ## Example 50 ```c 51 #include <cwalk.h> 52 #include <stdio.h> 53 #include <stddef.h> 54 #include <stdlib.h> 55 56 int main(int argc, char *argv[]) 57 { 58 if (cwk_path_guess_style("C:\\myfile") == CWK_STYLE_UNIX) { 59 printf("UNIX."); 60 } else { 61 printf("WINDOWS."); 62 } 63 64 return EXIT_SUCCESS; 65 } 66 ``` 67 68 Ouput: 69 ``` 70 WINDOWS. 71 ``` 72 73 ## Changelog 74 75 | Version | Description | 76 |------------|--------------------------------------------------------| 77 | **v1.2.1** | Fixed crash on call with empty string. | 78 | **v1.2.0** | The function is introduced. |