| 7 As a rule of thumb, you _should not_ pass a character array of a UCX string structure to another API without explicitly |
7 As a rule of thumb, you _should not_ pass a character array of a UCX string structure to another API without explicitly |
| 8 ensuring that the string is zero-terminated. |
8 ensuring that the string is zero-terminated. |
| 9 |
9 |
| 10 ## Basics |
10 ## Basics |
| 11 |
11 |
| |
12 The following listing shows basic string functions. |
| |
13 |
| 12 > To simplify documentation, we introduce the pseudo-type `AnyStr` with the meaning that |
14 > To simplify documentation, we introduce the pseudo-type `AnyStr` with the meaning that |
| 13 > both `cxstring` and `cxmutstr` are accepted for that argument. |
15 > any UCX string and any C string are supported. |
| 14 > The implementation is actually hidden behind a macro which uses `cx_strcast()` to guarantee compatibility. |
16 > The implementation is actually hidden behind a macro which uses `cx_strcast()` to guarantee compatibility. |
| 15 {style="note"} |
17 {style="note"} |
| 16 |
18 |
| 17 ```C |
19 ```C |
| 18 #include <cx/string.h> |
20 #include <cx/string.h> |