ucx/cx/properties.h

changeset 31
287484519844
parent 30
d33eaaec15da
--- a/ucx/cx/properties.h	Fri Dec 12 10:42:53 2025 +0100
+++ b/ucx/cx/properties.h	Fri Dec 19 17:22:03 2025 +0100
@@ -73,7 +73,7 @@
      */
     char comment3;
 
-    /*
+    /**
      * The character, when appearing at the end of a line, continues that line.
      * This is '\' by default.
      */
@@ -336,15 +336,15 @@
 /**
  * Internal function - use cxPropertiesLoad() instead.
  *
- * @param config the parser config
  * @param allocator the allocator for the values
  * @param filename the file name
  * @param target the target map
+ * @param config the parser config
  * @return status code
  */
-cx_attr_nonnull_arg(4)
-CX_EXPORT CxPropertiesStatus cx_properties_load(CxPropertiesConfig config,
-        const CxAllocator *allocator, cxstring filename, CxMap *target);
+cx_attr_nonnull_arg(3)
+CX_EXPORT CxPropertiesStatus cx_properties_load(const CxAllocator *allocator,
+        cxstring filename, CxMap *target, CxPropertiesConfig config);
 
 /**
  * Loads properties from a file and inserts them into a map.
@@ -357,10 +357,10 @@
  * @note When the parser finds an error, all successfully parsed keys before the error
  * are added to the map nonetheless.
  *
- * @param config the parser config
  * @param allocator the allocator for the values that will be stored in the map
  * @param filename (any string) the absolute or relative path to the file
  * @param target (@c CxMap*) the map where the properties shall be added
+ * @param config the parser config
  * @retval CX_PROPERTIES_NO_ERROR (zero) at least one key/value pair was found
  * @retval CX_PROPERTIES_NO_DATA the file is syntactically OK, but does not contain properties
  * @retval CX_PROPERTIES_INCOMPLETE_DATA unexpected end of file
@@ -371,8 +371,8 @@
  * @retval CX_PROPERTIES_MAP_ERROR storing a key/value pair in the map failed
  * @see cxPropertiesLoadDefault()
  */
-#define cxPropertiesLoad(config, allocator, filename, target) \
-    cx_properties_load(config, allocator, cx_strcast(filename), target)
+#define cxPropertiesLoad(allocator, filename, target, config) \
+    cx_properties_load(allocator, cx_strcast(filename), target, config)
 
 /**
  * Loads properties from a file and inserts them into a map with a default config.
@@ -399,7 +399,7 @@
  * @see cxPropertiesLoad()
  */
 #define cxPropertiesLoadDefault(allocator, filename, target) \
-    cx_properties_load(cx_properties_config_default, allocator, cx_strcast(filename), target)
+    cx_properties_load(allocator, cx_strcast(filename), target, cx_properties_config_default)
 
 
 #ifdef __cplusplus

mercurial