Update: the fss snatch and similar functions should also optionally get the index.

The index will be the index where the match was found.
The objects and contents will have the same index.

diff --git a/level_2/fll_fss/c/fss.c b/level_2/fll_fss/c/fss.c
index d5bb4f8ff84f503569d861b462e14ef7caac13fb..181841332c9a416787600e49e0cda72f10e1ba6f 100644 (file)
--- a/level_2/fll_fss/c/fss.c
+++ b/level_2/fll_fss/c/fss.c
@@ -46,10 +46,11 @@ extern "C" {
 #endif // _di_fll_fss_identify_file_
 
 #ifndef _di_fll_fss_snatch_
-  f_return_status fll_fss_snatch(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamic *values[]) {
+  f_return_status fll_fss_snatch(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamic *values[], f_array_length *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -84,6 +85,10 @@ extern "C" {
 
         status = fl_string_dynamic_partial_append_nulless(buffer, contents.array[i].array[0], values[j]);
         if (F_status_is_error(status)) return status;
+
+        if (indexs) {
+          *indexs[j] = i;
+        }
       } // for
     } // for
 
@@ -92,10 +97,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_
 
 #ifndef _di_fll_fss_snatch_apart_
-  f_return_status fll_fss_snatch_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamics *values[]) {
+  f_return_status fll_fss_snatch_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamics *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -129,8 +135,12 @@ extern "C" {
           }
 
           f_macro_string_dynamics_resize(status, (*value), (values[j]->used + content->used));
-
           if (F_status_is_error(status)) return status;
+
+          if (indexs) {
+            f_macro_array_lengths_resize(status, (*indexs[j]), (indexs[j]->used + content->used));
+            if (F_status_is_error(status)) return status;
+          }
         }
 
         for (k = 0; k < contents.array[i].used; k++) {
@@ -138,6 +148,11 @@ extern "C" {
           if (F_status_is_error(status)) return status;
 
           values[j]->used++;
+
+          if (indexs) {
+            indexs[j]->array[indexs[j]->used] = i;
+            indexs[j]->used++;
+          }
         } // for
       } // for
     } // for
@@ -147,10 +162,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_apart_
 
 #ifndef _di_fll_fss_snatch_map_
-  f_return_status fll_fss_snatch_map(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_maps *values[]) {
+  f_return_status fll_fss_snatch_map(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_maps *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -222,6 +238,11 @@ extern "C" {
               f_macro_string_dynamic_delete_simple(name);
               return status;
             }
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+              if (F_status_is_error(status)) return status;
+            }
           }
           else {
             f_macro_string_maps_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
@@ -229,6 +250,11 @@ extern "C" {
               f_macro_string_dynamic_delete_simple(name);
               return status;
             }
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+              if (F_status_is_error(status)) return status;
+            }
           }
         }
 
@@ -248,6 +274,11 @@ extern "C" {
 
         values[j]->used++;
 
+        if (indexs) {
+          indexs[j]->array[indexs[j]->used] = i;
+          indexs[j]->used++;
+        }
+
         f_macro_string_dynamic_clear(name);
       } // for
     } // for
@@ -258,10 +289,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_map_
 
 #ifndef _di_fll_fss_snatch_map_apart_
-  f_return_status fll_fss_snatch_map_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_map_multis *values[]) {
+  f_return_status fll_fss_snatch_map_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_map_multis *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -296,10 +328,20 @@ extern "C" {
 
             f_macro_string_map_multis_resize(status, (*values[j]), values[j]->used + 1);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+              if (F_status_is_error(status)) return status;
+            }
           }
           else {
             f_macro_string_map_multis_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+              if (F_status_is_error(status)) return status;
+            }
           }
         }
 
@@ -310,6 +352,11 @@ extern "C" {
 
         values[j]->used++;
 
+        if (indexs) {
+          indexs[j]->array[indexs[j]->used] = i;
+          indexs[j]->used++;
+        }
+
         if (contents.array[i].used > 1) {
           if (map_multi->value.used + contents.array[i].used - 1 > map_multi->value.size) {
             if (map_multi->value.used + contents.array[i].used - 1 > f_array_length_size) return F_status_set_error(F_buffer_too_large);
@@ -333,10 +380,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_map_apart_
 
 #ifndef _di_fll_fss_snatch_map_mash_
-  f_return_status fll_fss_snatch_map_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[]) {
+  f_return_status fll_fss_snatch_map_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -371,10 +419,20 @@ extern "C" {
 
             f_macro_string_maps_resize(status, (*values[j]), values[j]->used + 1);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+              if (F_status_is_error(status)) return status;
+            }
           }
           else {
             f_macro_string_maps_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+              if (F_status_is_error(status)) return status;
+            }
           }
         }
 
@@ -385,6 +443,11 @@ extern "C" {
 
         values[j]->used++;
 
+        if (indexs) {
+          indexs[j]->array[indexs[j]->used] = i;
+          indexs[j]->used++;
+        }
+
         if (contents.array[i].used > 1) {
           for (k = 1; k < contents.array[i].used; k++) {
             status = fl_string_dynamic_partial_mash_nulless(glue, glue_length, buffer, contents.array[i].array[k], &map->value);
@@ -399,10 +462,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_map_mash_
 
 #ifndef _di_fll_fss_snatch_map_mash_apart_
-  f_return_status fll_fss_snatch_map_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_map_multis *values[]) {
+  f_return_status fll_fss_snatch_map_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_map_multis *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -471,10 +535,20 @@ extern "C" {
 
               f_macro_string_map_multis_resize(status, (*values[j]), values[j]->used + 1);
               if (F_status_is_error(status)) return status;
+
+              if (indexs) {
+                f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+                if (F_status_is_error(status)) return status;
+              }
             }
             else {
               f_macro_string_map_multis_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
               if (F_status_is_error(status)) return status;
+
+              if (indexs) {
+                f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+                if (F_status_is_error(status)) return status;
+              }
             }
           }
 
@@ -485,6 +559,11 @@ extern "C" {
 
           values[j]->used++;
 
+          if (indexs) {
+            indexs[j]->array[indexs[j]->used] = i;
+            indexs[j]->used++;
+          }
+
           f_macro_string_dynamic_clear(name);
 
           if (contents.array[i].used == 1) continue;
@@ -514,10 +593,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_map_mash_apart_
 
 #ifndef _di_fll_fss_snatch_map_together_
-  f_return_status fll_fss_snatch_map_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[]) {
+  f_return_status fll_fss_snatch_map_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -590,6 +670,11 @@ extern "C" {
                 f_macro_string_dynamic_delete_simple(name);
                 return status;
               }
+
+              if (indexs) {
+                f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+                if (F_status_is_error(status)) return status;
+              }
             }
             else {
               f_macro_string_maps_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
@@ -597,6 +682,11 @@ extern "C" {
                 f_macro_string_dynamic_delete_simple(name);
                 return status;
               }
+
+              if (indexs) {
+                f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+                if (F_status_is_error(status)) return status;
+              }
             }
           }
 
@@ -608,6 +698,11 @@ extern "C" {
 
           values[j]->used++;
 
+          if (indexs) {
+            indexs[j]->array[indexs[j]->used] = i;
+            indexs[j]->used++;
+          }
+
           f_macro_string_dynamic_clear(name);
         }
 
@@ -627,10 +722,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_map_together_
 
 #ifndef _di_fll_fss_snatch_mash_
-  f_return_status fll_fss_snatch_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[]) {
+  f_return_status fll_fss_snatch_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[], f_array_length *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -665,6 +761,10 @@ extern "C" {
           status = fl_string_dynamic_partial_mash_nulless(glue, glue_length, buffer, contents.array[i].array[k], values[j]);
           if (F_status_is_error(status)) return status;
         } // for
+
+        if (indexs) {
+          *indexs[j] = i;
+        }
       } // for
     } // for
 
@@ -673,10 +773,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_mash_
 
 #ifndef _di_fll_fss_snatch_mash_apart_
-  f_return_status fll_fss_snatch_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamics *values[]) {
+  f_return_status fll_fss_snatch_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamics *values[], f_array_lengths *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -707,10 +808,20 @@ extern "C" {
 
             f_macro_string_dynamics_resize(status, (*values[j]), values[j]->used + 1);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + 1);
+              if (F_status_is_error(status)) return status;
+            }
           }
           else {
             f_macro_string_dynamics_resize(status, (*values[j]), values[j]->used + f_fss_default_allocation_step);
             if (F_status_is_error(status)) return status;
+
+            if (indexs) {
+              f_macro_array_lengths_resize(status, (*indexs[j]), indexs[j]->used + f_fss_default_allocation_step);
+              if (F_status_is_error(status)) return status;
+            }
           }
         }
 
@@ -720,6 +831,11 @@ extern "C" {
         } // for
 
         values[j]->used++;
+
+        if (indexs) {
+          indexs[j]->array[indexs[j]->used] = i;
+          indexs[j]->used++;
+        }
       } // for
     } // for
 
@@ -728,10 +844,11 @@ extern "C" {
 #endif // _di_fll_fss_snatch_mash_apart_
 
 #ifndef _di_fll_fss_snatch_together_
-  f_return_status fll_fss_snatch_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[]) {
+  f_return_status fll_fss_snatch_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[], f_array_length *indexs[]) {
     #ifndef _di_level_2_parameter_checking_
       if (size == 0) return F_status_set_error(F_parameter);
       if (objects.used != contents.used) return F_status_set_error(F_parameter);
+      if (values == 0) return F_status_set_error(F_parameter);
     #endif // _di_level_2_parameter_checking_
 
     if (buffer.used == 0) return F_data_not;
@@ -758,6 +875,10 @@ extern "C" {
           status = fl_string_dynamic_partial_mash_nulless(glue, glue_length, buffer, contents.array[i].array[k], values[j]);
           if (F_status_is_error(status)) return status;
         } // for
+
+        if (indexs) {
+          *indexs[j] = i;
+        }
       } // for
     } // for
 

diff --git a/level_2/fll_fss/c/fss.h b/level_2/fll_fss/c/fss.h
index 6ee9ce983987d31f4c59dd203495540bad2677b5..9b0fc1ab34de737fca58ff6f5e53b00251e6f533 100644 (file)
--- a/level_2/fll_fss/c/fss.h
+++ b/level_2/fll_fss/c/fss.h
@@ -102,6 +102,9 @@ extern "C" {
  *   The total size of the names, lengths, and values arrays.
  * @param values
  *   An array of values where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -115,7 +118,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_append_nulless()
  */
 #ifndef _di_fll_fss_snatch_
-  extern f_return_status fll_fss_snatch(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamic *values[]);
+  extern f_return_status fll_fss_snatch(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamic *values[], f_array_length *indexs[]);
 #endif // _di_fll_fss_snatch_
 
 /**
@@ -145,6 +148,9 @@ extern "C" {
  *   The total size of the names, lengths, and values arrays.
  * @param values
  *   An array of values where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -158,7 +164,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_append_nulless()
  */
 #ifndef _di_fll_fss_snatch_apart_
-  extern f_return_status fll_fss_snatch_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamics *values[]);
+  extern f_return_status fll_fss_snatch_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_dynamics *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_apart_
 
 /**
@@ -190,6 +196,9 @@ extern "C" {
  *   The total size of the names, lengths, and values arrays.
  * @param values
  *   An array of map arrays where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -203,7 +212,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_append_nulless()
  */
 #ifndef _di_fll_fss_snatch_map_
-  extern f_return_status fll_fss_snatch_map(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_maps *values[]);
+  extern f_return_status fll_fss_snatch_map(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_maps *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_map_
 
 /**
@@ -237,6 +246,9 @@ extern "C" {
  *   The total size of the names, lengths, and values arrays.
  * @param values
  *   An array of multi map arrays where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -250,7 +262,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_append_nulless()
  */
 #ifndef _di_fll_fss_snatch_map_apart_
-  extern f_return_status fll_fss_snatch_map_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_map_multis *values[]);
+  extern f_return_status fll_fss_snatch_map_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, f_string_map_multis *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_map_apart_
 
 /**
@@ -287,6 +299,9 @@ extern "C" {
  *   The length of the glue string
  * @param values
  *   An array of multi map value arrays where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -297,7 +312,7 @@ extern "C" {
  *   Errors from (with error bit): fl_string_dynamic_partial_mash_nulless().
  */
 #ifndef _di_fll_fss_snatch_map_mash_
-  extern f_return_status fll_fss_snatch_map_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[]);
+  extern f_return_status fll_fss_snatch_map_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_map_mash_
 
 /**
@@ -335,6 +350,9 @@ extern "C" {
  *   The length of the glue string
  * @param values
  *   An array of multi map value arrays where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -348,7 +366,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_mash_nulless()
  */
 #ifndef _di_fll_fss_snatch_map_mash_apart_
-  extern f_return_status fll_fss_snatch_map_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_map_multis *values[]);
+  extern f_return_status fll_fss_snatch_map_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_map_multis *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_map_mash_apart__
 
 /**
@@ -385,6 +403,9 @@ extern "C" {
  *   The length of the glue string
  * @param values
  *   An array of map arrays where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -398,7 +419,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_mash_nulless()
  */
 #ifndef _di_fll_fss_snatch_map_together_
-  extern f_return_status fll_fss_snatch_map_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[]);
+  extern f_return_status fll_fss_snatch_map_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_maps *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_map_together_
 
 /**
@@ -432,6 +453,9 @@ extern "C" {
  *   The length of the glue string.
  * @param values
  *   An array of values where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -442,7 +466,7 @@ extern "C" {
  *   Errors from (with error bit): fl_string_dynamic_partial_mash_nulless().
  */
 #ifndef _di_fll_fss_snatch_mash_
-  extern f_return_status fll_fss_snatch_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[]);
+  extern f_return_status fll_fss_snatch_mash(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[], f_array_length *indexs[]);
 #endif // _di_fll_fss_snatch_mash_
 
 /**
@@ -477,6 +501,9 @@ extern "C" {
  *   The length of the glue string
  * @param values
  *   An array of values where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -490,7 +517,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_mash_nulless()
  */
 #ifndef _di_fll_fss_snatch_mash_apart_
-  extern f_return_status fll_fss_snatch_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamics *values[]);
+  extern f_return_status fll_fss_snatch_mash_apart(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamics *values[], f_array_lengths *indexs[]);
 #endif // _di_fll_fss_snatch_mash_apart_
 
 /**
@@ -518,6 +545,9 @@ extern "C" {
  *   The total size of the names, lengths, and values arrays.
  * @param values
  *   An array of values where "snatched" content is stored.
+ * @param indexs
+ *   An array representing the index within the objects where the match was made.
+ *   Set the pointer address to 0 to disable.
  *
  * @return
  *   F_none on success.
@@ -531,7 +561,7 @@ extern "C" {
  * @see fl_string_dynamic_partial_append_nulless()
  */
 #ifndef _di_fll_fss_snatch_together_
-  extern f_return_status fll_fss_snatch_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[]);
+  extern f_return_status fll_fss_snatch_together(const f_string_static buffer, const f_fss_objects objects, const f_fss_contents contents, const f_string names[], const f_string_length lengths[], const f_string_length size, const f_string glue, const f_string_length glue_length, f_string_dynamic *values[], f_array_length *indexs[]);
 #endif // _di_fll_fss_snatch_together_
 
 #ifdef __cplusplus

diff --git a/level_3/fake/c/private-build.c b/level_3/fake/c/private-build.c
index 372ad9c1e93b9c85b4ac0c69e52ac55846144a6c..566e357cafb2220cc751eaa070749de4b1a23ac2 100644 (file)
--- a/level_3/fake/c/private-build.c
+++ b/level_3/fake/c/private-build.c
@@ -1454,7 +1454,7 @@ extern "C" {
 
     f_string function = "fll_fss_snatch_apart";
 
-    *status = fll_fss_snatch_apart(buffer, objects, contents, settings_name, settings_length, fake_build_setting_total, settings_value);
+    *status = fll_fss_snatch_apart(buffer, objects, contents, settings_name, settings_length, fake_build_setting_total, settings_value, 0);
 
     if (*status == F_none) {
       f_string_dynamic settings_mode_name_dynamic[fake_build_setting_total];
@@ -1518,7 +1518,7 @@ extern "C" {
         } // for
 
         if (*status == F_none) {
-          *status = fll_fss_snatch_apart(buffer, objects, contents, settings_mode_names, setting_mode_lengths, fake_build_setting_total, settings_value);
+          *status = fll_fss_snatch_apart(buffer, objects, contents, settings_mode_names, setting_mode_lengths, fake_build_setting_total, settings_value, 0);
 
           if (F_status_is_error(*status)) {
             function = "fll_fss_snatch_apart";

diff --git a/level_3/fake/c/private-make.c b/level_3/fake/c/private-make.c
index 1580347c2ade526e4bd25e8590f2301b5016c0e2..fc1649714a404e205da21dc1deeb04ba389daf79 100644 (file)
--- a/level_3/fake/c/private-make.c
+++ b/level_3/fake/c/private-make.c
@@ -205,7 +205,7 @@ extern "C" {
           &data_make->setting_make.parameter,
         };
 
-        *status = fll_fss_snatch_map_mash_apart(data_make->buffer, settings.objects, settings.contents, settings_name, settings_length, 2, " ", 1, settings_value);
+        *status = fll_fss_snatch_map_mash_apart(data_make->buffer, settings.objects, settings.contents, settings_name, settings_length, 2, " ", 1, settings_value, 0);
         if (F_status_is_error(*status)) {
           fake_print_error(data.context, data.verbosity, F_status_set_fine(*status), "fll_fss_snatch_map_mash_apart", F_true);