| 115 |
115 |
| 116 All the above operations are combined in the function `cxPropertiesLoad()`, |
116 All the above operations are combined in the function `cxPropertiesLoad()`, |
| 117 which opens the file designated by the `filename` and loads all properties from that file into the specified `CxMap`. |
117 which opens the file designated by the `filename` and loads all properties from that file into the specified `CxMap`. |
| 118 The convenience macro `cxPropertiesLoadDefault()` uses the default parser configuration for this. |
118 The convenience macro `cxPropertiesLoadDefault()` uses the default parser configuration for this. |
| 119 The target map must either store pointers of type `char*` or elements of type `cxmutstr`. |
119 The target map must either store pointers of type `char*` or elements of type `cxmutstr`. |
| 120 In either case, the specified `allocator` is used to allocate the memory for the value. |
120 In either case, the specified `allocator` is used to allocate the memory for the value. |
| |
121 If the function encounters an error, all properties that have been added to the map so far stay in the map; there is no rollback. |
| 121 |
122 |
| 122 > The stack buffers used by `cxPropertiesLoad()` can be changed when building UCX from sources |
123 > The stack buffers used by `cxPropertiesLoad()` can be changed when building UCX from sources |
| 123 > by setting the `CX_PROPERTIES_LOAD_FILL_SIZE` and `CX_PROPERTIES_LOAD_BUF_SIZE` macros |
124 > by setting the `CX_PROPERTIES_LOAD_FILL_SIZE` and `CX_PROPERTIES_LOAD_BUF_SIZE` macros |
| 124 > (see [](install.md#small-buffer-optimizations)). |
125 > (see [](install.md#small-buffer-optimizations)). |
| 125 |
126 |