| 354 * |
354 * |
| 355 * Entries are added to the map, possibly overwriting existing entries. |
355 * Entries are added to the map, possibly overwriting existing entries. |
| 356 * |
356 * |
| 357 * The map must either store pointers of type @c char*, or elements of type cxmutstr. |
357 * The map must either store pointers of type @c char*, or elements of type cxmutstr. |
| 358 * Any other configuration is not supported. |
358 * Any other configuration is not supported. |
| |
359 * |
| |
360 * @note When the parser finds an error, all successfully parsed keys before the error |
| |
361 * are added to the map nonetheless. |
| 359 * |
362 * |
| 360 * @param config the parser config |
363 * @param config the parser config |
| 361 * @param allocator the allocator for the values that will be stored in the map |
364 * @param allocator the allocator for the values that will be stored in the map |
| 362 * @param filename (any string) the absolute or relative path to the file |
365 * @param filename (any string) the absolute or relative path to the file |
| 363 * @param target (@c CxMap*) the map where the properties shall be added |
366 * @param target (@c CxMap*) the map where the properties shall be added |
| 380 * Entries are added to the map, possibly overwriting existing entries. |
383 * Entries are added to the map, possibly overwriting existing entries. |
| 381 * |
384 * |
| 382 * The map must either store pointers of type @c char*, or elements of type cxmutstr. |
385 * The map must either store pointers of type @c char*, or elements of type cxmutstr. |
| 383 * Any other configuration is not supported. |
386 * Any other configuration is not supported. |
| 384 * |
387 * |
| |
388 * @note When the parser finds an error, all successfully parsed keys before the error |
| |
389 * are added to the map nonetheless. |
| |
390 * |
| 385 * @param allocator the allocator for the values that will be stored in the map |
391 * @param allocator the allocator for the values that will be stored in the map |
| 386 * @param filename (any string) the absolute or relative path to the file |
392 * @param filename (any string) the absolute or relative path to the file |
| 387 * @param target (@c CxMap*) the map where the properties shall be added |
393 * @param target (@c CxMap*) the map where the properties shall be added |
| 388 * @retval CX_PROPERTIES_NO_ERROR (zero) at least one key/value pair was found |
394 * @retval CX_PROPERTIES_NO_ERROR (zero) at least one key/value pair was found |
| 389 * @retval CX_PROPERTIES_NO_DATA the file is syntactically OK, but does not contain properties |
395 * @retval CX_PROPERTIES_NO_DATA the file is syntactically OK, but does not contain properties |