From: Kevin Day <Kevin@kevux.org>
Date: Sun, 30 Mar 2025 01:38:52 +0000 (-0500)
Subject: Feature: Add fll_program function for printing unsupported parameter message.
X-Git-Url: https://git.kevux.org/?a=commitdiff_plain;h=45a2675d2716480c0cf9f0c40df95a34571f683c;p=fll

Feature: Add fll_program function for printing unsupported parameter message.
---

diff --git a/level_2/fll_program/c/program/print.c b/level_2/fll_program/c/program/print.c
index 0832ff5..8cf184c 100644
--- a/level_2/fll_program/c/program/print.c
+++ b/level_2/fll_program/c/program/print.c
@@ -472,6 +472,26 @@ extern "C" {
   }
 #endif // _di_fll_program_print_error_parameter_range_start_before_stop_
 
+#ifndef _di_fll_program_print_error_parameter_support_not_
+  f_status_t fll_program_print_error_parameter_support_not(fl_print_t * const print, const f_string_static_t symbol, const f_string_static_t name) {
+    #ifndef _di_level_2_parameter_checking_
+      if (!print) return F_status_set_error(F_parameter);
+    #endif // _di_level_2_parameter_checking_
+
+    if (print->verbosity < f_console_verbosity_error_e) return F_output_not;
+
+    f_file_stream_lock(print->to);
+
+    fl_print_format("%[%QThe parameter '%]", print->to, print->set->error, print->prefix, print->set->error);
+    fl_print_format(f_string_format_QQ_single_s.string, print->to, print->notable, symbol, name, print->notable);
+    fl_print_format("%[' is not supported.%]%r", print->to, print->set->error, print->set->error, f_string_eol_s);
+
+    f_file_stream_unlock(print->to);
+
+    return F_okay;
+  }
+#endif // _di_fll_program_print_error_parameter_support_not_
+
 #ifndef _di_fll_program_print_error_parameter_value_too_long_
   f_status_t fll_program_print_error_parameter_value_too_long(fl_print_t * const print, const f_string_static_t symbol, const f_string_static_t name) {
     #ifndef _di_level_2_parameter_checking_
diff --git a/level_2/fll_program/c/program/print.h b/level_2/fll_program/c/program/print.h
index 9d5acf8..90f86bf 100644
--- a/level_2/fll_program/c/program/print.h
+++ b/level_2/fll_program/c/program/print.h
@@ -689,6 +689,29 @@ extern "C" {
 #endif // _di_fll_program_print_error_parameter_range_start_before_stop_
 
 /**
+ * Print error message for when the parameter is not supported.
+ *
+ * @param print
+ *   The output structure.
+ *   This locks, uses, and unlocks the file stream.
+ * @param symbol
+ *   The symbol string prepended to the parameter.
+ *   This locks, uses, and unlocks the file stream.
+ *   This is usually f_console_symbol_long_normal_s.
+ * @param name
+ *   The parameter name.
+ *
+ * @return
+ *   F_okay on success.
+ *   F_output_not on success, but no printing is performed.
+ *
+ *   F_parameter (with error bit) if a parameter is invalid.
+ */
+#ifndef _di_fll_program_print_error_parameter_support_not_
+  extern f_status_t fll_program_print_error_parameter_support_not(fl_print_t * const print, const f_string_static_t symbol, const f_string_static_t name);
+#endif // _di_fll_program_print_error_parameter_support_not_
+
+/**
  * Print error message for when the parameter value is too long.
  *
  * @param print