X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/6ba5b855ebc737cc46cabfbe799b0c7706f437f4..fe36a7ee2f4304fd3797443d4f2f950d6dc2475d:/h/fmt_scan.h

diff --git a/h/fmt_scan.h b/h/fmt_scan.h
index 771d9fba..5f659d4c 100644
--- a/h/fmt_scan.h
+++ b/h/fmt_scan.h
@@ -49,8 +49,6 @@ struct comp {
 
 #define CF_BITS       "\020\01TRUE\02PARSED\03CF_DATEFAB\04TRIMMED"
 
-extern int fmt_norm;
-
 /*
  * This structure defines one formatting instruction.
  */
@@ -91,7 +89,7 @@ struct format {
 
 typedef char * (*formataddr_cb)(char *, char *);
 typedef char * (*concataddr_cb)(char *, char *);
-typedef void (*trace_cb)(void *, struct format *, int, char *, char *);
+typedef void (*trace_cb)(void *, struct format *, int, char *, const char *);
 
 struct fmt_callbacks {
     formataddr_cb	formataddr;
@@ -116,6 +114,12 @@ struct fmt_callbacks {
 
 char *new_fs (char *form, char *format, char *default_fs);
 
+/*
+ * Free memory allocated by new_fs().  It allocates to a static so
+ * no argument is necessary.
+ */
+void free_fs ();
+
 /*
  * Compile a format string into a set of format instructions.  Arguments are:
  *
@@ -140,11 +144,11 @@ int fmt_compile (char *fstring, struct format **fmt, int reset);
  * Interpret a sequence of compiled format instructions.  Arguments are:
  *
  * format	- Array of format instructions generated by fmt_compile()
- * scanl	- Passed-in character array that will contain the output
- *		  of the format instructions.  Is always terminated with
- *		  a newline (\n).
- * max		- Maximum number of bytes to be written to "scanl" (in other
- *		  words, the buffer size).  Includes the trailing NUL.
+ * scanl	- Passed-in charstring_t object (created with
+ *		  charstring_create() and later destroyed with
+ *		  charstring_free()) that will contain the output of the
+ *		  format instructions.  Is always terminated with a
+ *		  newline (\n).
  * width	- Maximum number of displayed characters.  Does not include
  *		  characters marked as nonprinting or (depending on the
  *		  encoding) bytes in a multibyte encoding that exceed the
@@ -171,8 +175,8 @@ int fmt_compile (char *fstring, struct format **fmt, int reset);
  * execute, which is currently always NULL.
  */
 
-struct format *fmt_scan (struct format *format, char *scanl, size_t max,
-			 int width, int *dat, struct fmt_callbacks *callbacks);
+struct format *fmt_scan (struct format *format, charstring_t scanl, int width,
+			 int *dat, struct fmt_callbacks *callbacks);
 
 /*
  * Free a format structure and/or component hash table.  Arguments are:
@@ -269,6 +273,25 @@ int fmt_addcomptext(char *component, char *text);
 
 void fmt_appendcomp(int bucket, char *component, char *text);
 
+/*
+ * Iterate over the complete hash table of component structures.
+ *
+ * Arguments are:
+ *
+ * comp		- Pointer to the current component structure.  The next
+ *		  component in the hash table after this component.  To
+ *		  start (or restart) the iteration of the hash table
+ *		  this argument should be NULL.
+ * bucket	- Pointer to hash bucket.  Will be managed by this function,
+ *		  the caller should not modify this value.
+ *
+ * Returns the next component in the hash table.  This value should be
+ * passed into the next call to fmt_nextcomp().  Returns NULL at the end
+ * of the hash table.
+ */
+
+struct comp *fmt_nextcomp(struct comp *comp, unsigned int *bucket);
+
 /*
  * The implementation of the %(formataddr) function.  This is available for
  * programs to provide their own local implementation if they wish to do