cwk_path_intersection.md (2642B)
1 --- 2 title: cwk_path_get_intersection 3 description: Finds common portions in two paths. 4 --- 5 6 _(since v1.0.0)_ 7 Finds common portions in two paths. 8 9 ## Signature 10 ```c 11 size_t cwk_path_get_intersection(const char *path_base, const char *path_other); 12 ``` 13 14 ## Description 15 This function finds common portions in two paths and returns the number characters from the beginning of the base path which are equal to the other path. 16 17 ## Parameters 18 * **path_base**: The base path which will be compared with the other path. 19 * **path_other**: The other path which will compared with the base path. 20 21 ## Return Value 22 Returns the number of characters which are common in the base path. 23 24 ## Outcomes 25 26 | Style | Base | Other | Ret. | Result | 27 |-------------|--------------------------|--------------------------|--------|----------------------| 28 | ``UNIX`` | ``/test/abc/../foo/bar`` | ``/test/foo/har`` | 16 | ``/test/abc/../foo`` | 29 | ``UNIX`` | ``/test/foo/har`` | ``/test/abc/../foo/bar`` | 9 | ``/test/foo`` | 30 | ``UNIX`` | ``/test/abc.txt`` | ``test/abc.txt`` | 0 | `` `` | 31 | ``UNIX`` | ``/`` | `` `` | 0 | `` `` | 32 | ``UNIX`` | ``/this///is/a//test`` | ``/this//is/a///file`` | 12 | ``/this///is/a`` | 33 | ``UNIX`` | ``/this/is/a/test`` | ``/this/is/a/`` | 10 | ``/this/is/a`` | 34 | ``UNIX`` | ``/this/is/a/test`` | ``/this/is/a`` | 10 | ``/this/is/a`` | 35 | ``UNIX`` | ``/this/is/a/test`` | ``/this/is/a/string`` | 10 | ``/this/is/a`` | 36 | ``WINDOWS`` | ``C:/abc/test.txt`` | ``C:/`` | 3 | ``C:/`` | 37 | ``WINDOWS`` | ``C:/abc/test.txt`` | ``C:/def/test.txt`` | 3 | ``C:/`` | 38 | ``WINDOWS`` | ``C:/test/abc.txt`` | ``D:/test/abc.txt`` | 0 | `` `` | 39 40 ## Example 41 ```c 42 #include <cwalk.h> 43 #include <stdio.h> 44 #include <stddef.h> 45 #include <stdlib.h> 46 47 int main(int argc, char *argv[]) 48 { 49 const char *path; 50 size_t length; 51 52 path = "/this/is/a/test"; 53 length = cwk_path_get_intersection(path, "/this/is/a/string"); 54 printf("The common portion is: '%.*s'", length, path); 55 56 return EXIT_SUCCESS; 57 } 58 ``` 59 60 Ouput: 61 ``` 62 The common portion is: '/this/is/a' 63 ``` 64 65 ## Changelog 66 67 | Version | Description | 68 |------------|--------------------------------------------------------| 69 | **v1.0.0** | The function is introduced. |