From a05e131c1753f5d203778d2f427feb50a820f388 Mon Sep 17 00:00:00 2001
From: Kevin Day <thekevinday@gmail.com>
Date: Thu, 9 Jul 2020 22:15:36 -0500
Subject: [PATCH] Feature: provide f_cell, f_cells, and f_cellss types.

The f_cell types are intended to represent a row and column position, just like with a table cell.
This is important for management arrays matrices and the like.
---
 level_0/f_type/c/type.h       | 19 +++++++++++
 level_0/f_type/c/type_array.h | 62 +++++++++++++++++++++++++++++++++++
 2 files changed, 81 insertions(+)

diff --git a/level_0/f_type/c/type.h b/level_0/f_type/c/type.h
index 782b99163..edb8cc946 100644
--- a/level_0/f_type/c/type.h
+++ b/level_0/f_type/c/type.h
@@ -201,6 +201,25 @@ extern "C" {
   #define f_array_length_size_max f_type_number_size_max_unsigned
 #endif // _di_f_array_
 
+/**
+ * A structure designating a row and column, just like a cell in a table.
+ *
+ * row:    the row position.
+ * column: the column position.
+ */
+#ifndef _di_f_cell_
+  typedef struct {
+    f_array_length row;
+    f_array_length column;
+  } f_cell;
+
+  #define f_cell_initialize { 0, 0 }
+
+  #define f_macro_cell_clear(cell) \
+    cell.row = 0; \
+    cell.column = 0;
+#endif // _di_f_cell_
+
 /**
  * GCC-specific features.
  *
diff --git a/level_0/f_type/c/type_array.h b/level_0/f_type/c/type_array.h
index 2043a1843..c44ab5552 100644
--- a/level_0/f_type/c/type_array.h
+++ b/level_0/f_type/c/type_array.h
@@ -82,6 +82,68 @@ extern "C" {
   #define f_macro_array_lengthss_adjust(status, lengths, new_length) f_macro_memory_structures_adjust(status, lengths, f_array_length, f_array_lengths, new_length, f_array_length)
 #endif // _di_f_array_lengthss_
 
+/**
+ * An array of f_cell.
+ *
+ * array: the array of f_cell.
+ * size: total amount of allocated space.
+ * used: total number of allocated spaces used.
+ */
+#ifndef _di_f_cells_
+  typedef struct {
+    f_cell *array;
+
+    f_array_length size;
+    f_array_length used;
+  } f_cells;
+
+  #define f_cells_initialize {0, 0, 0}
+
+  #define f_macro_cells_clear(ranges) f_macro_memory_structure_clear(ranges)
+
+  #define f_macro_cells_new(status, ranges, length) f_macro_memory_structure_new(status, ranges, f_cell, length)
+
+  #define f_macro_cells_delete(status, ranges)  f_macro_memory_structure_delete(status, ranges, f_cell)
+  #define f_macro_cells_destroy(status, ranges) f_macro_memory_structure_destroy(status, ranges, f_cell)
+
+  #define f_macro_cells_delete_simple(ranges)  f_macro_memory_structure_delete_simple(ranges, f_cell)
+  #define f_macro_cells_destroy_simple(ranges) f_macro_memory_structure_destroy_simple(ranges, f_cell)
+
+  #define f_macro_cells_resize(status, ranges, new_length) f_macro_memory_structure_resize(status, ranges, f_cell, new_length)
+  #define f_macro_cells_adjust(status, ranges, new_length) f_macro_memory_structure_adjust(status, ranges, f_cell, new_length)
+#endif // _di_f_cells_
+
+/**
+ * This holds an array of f_cells.
+ *
+ * array: The array of f_cell arrays.
+ * size:  Total amount of allocated space.
+ * used:  Total number of allocated spaces used.
+ */
+#ifndef _di_f_cellss_
+  typedef struct {
+    f_cells *array;
+
+    f_array_length size;
+    f_array_length used;
+  } f_cellss;
+
+  #define f_cellss_initialize { 0, 0, 0 }
+
+  #define f_macro_cellss_clear(rangess) f_macro_memory_structures_clear(rangess)
+
+  #define f_macro_cellss_new(status, rangess, length) f_macro_memory_structures_new(status, rangess, f_cells, length)
+
+  #define f_macro_cellss_delete(status, rangess)  f_macro_memory_structures_delete(status, rangess, f_cell, f_cells)
+  #define f_macro_cellss_destroy(status, rangess) f_macro_memory_structures_destroy(status, rangess, f_cell, f_cells)
+
+  #define f_macro_cellss_delete_simple(rangess)  f_macro_memory_structures_delete_simple(rangess, f_cell, f_cells)
+  #define f_macro_cellss_destroy_simple(rangess) f_macro_memory_structures_destroy_simple(rangess, f_cell, f_cells)
+
+  #define f_macro_cellss_resize(status, rangess, new_length) f_macro_memory_structures_resize(status, rangess, f_cell, f_cells, new_length, f_array_length)
+  #define f_macro_cellss_adjust(status, rangess, new_length) f_macro_memory_structures_adjust(status, rangess, f_cell, f_cells, new_length, f_array_length)
+#endif // _di_f_cellss_
+
 /**
  * An array of array int8_t.
  *
-- 
2.47.3