docs/Writerside/topics/properties.h.md

changeset 1560
f060ecd65575
parent 1557
03fbf1c99e73
equal deleted inserted replaced
1559:9e50f45f8736 1560:f060ecd65575
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

mercurial