Linecon - Revision history

Gray at 13:25, 16 October 2023

2023-10-16T13:25:20Z

Gray at 12:25, 26 October 2011

2011-10-26T12:25:43Z

Gray at 07:15, 25 August 2011

2011-08-25T07:15:54Z

Gray at 22:48, 15 December 2010

2010-12-15T22:48:17Z

Gray: Initial revision

2010-12-15T15:37:28Z

Initial revision

New page

''Linecon'' is a Mailutils [[filter]] implementing a familiar UNIX line-continuation facility. It removes from the input stream any newline character immediately preceded by a backslash. This filter operates only in [[MU_FILTER_DECODE|decode mode]].

The creation sequence allows for the following [[filter option|option]]:

<tt>-i ''STR''</tt>

This option enables the [[line number information facility]]. This facility emits current input line number (prefixed with ''STR'') after each contiguous sequence of one or more removed newline characters. It is useful when used in conjunction with some parser which is supposed to identify eventual erroneous lines with their input line number. The following example creates a read-only instance of this filter with the line number information facility enabled:

<source lang="C">
int rc; /* Return code */
mu_stream_t flt; /* Filter stream */
mu_stream_t input; /* Input stream */
char *argv[] = { "linecon", "-i", "#line ", NULL },

initialize_input_stream (&stream);
rc = mu_filter_stream_create_args (&flt, input, argv[0], MU_FILTER_DECODE, MU_STREAM_READ, 3, argv);
</source>

[[Category:Filters]]

@@ Line 7: / Line 7: @@
 This option enables the [[line number information facility]].  This facility emits current input line number (prefixed with ''STR'') after each contiguous sequence of one or more removed newline characters.  It is useful for implementing parsers which are normally supposed to identify eventual erroneous lines with their input line numbers.  The following example creates a read-only instance of this filter with the line number information facility enabled:
-<source lang="C">
+<syntaxhighlight lang="C">
    int rc;          /* Return code */
    mu_stream_t flt; /* Filter stream */
@@ Line 15: / Line 15: @@
    initialize_input_stream (&stream);
    rc = mu_filter_create_args (&flt, input, argv[0], 3, argv, MU_FILTER_DECODE, MU_STREAM_READ);
-</source>
+</syntaxhighlight>
 [[Category:Filters]]
 [[Category:C API]]

← Older revision		Revision as of 12:25, 26 October 2011
Line 18:		Line 18:

	[[Category:Filters]]		[[Category:Filters]]
		+	[[Category:C API]]

@@ Line 5: / Line 5: @@
 <tt>-i ''STR''</tt>
-This option enables the [[line number information facility]].  This facility emits current input line number (prefixed with ''STR'') after each contiguous sequence of one or more removed newline characters.  It is useful when used in conjunction with some parser which is supposed to identify eventual erroneous lines with their input line number.  The following example creates a read-only instance of this filter with the line number information facility enabled:
+This option enables the [[line number information facility]].  This facility emits current input line number (prefixed with ''STR'') after each contiguous sequence of one or more removed newline characters.  It is useful for implementing parsers which are normally supposed to identify eventual erroneous lines with their input line numbers.  The following example creates a read-only instance of this filter with the line number information facility enabled:
 <source lang="C">