Difference between revisions of "CRLF (filter)"
From Mailutils
Jump to navigationJump to searchm |
m |
||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
''CRLF'' is a Mailutils [[filter]] which converts line separators from LF (ASCII 10) to CRLF (ASCII 13 10) and vice-versa. | ''CRLF'' is a Mailutils [[filter]] which converts line separators from LF (ASCII 10) to CRLF (ASCII 13 10) and vice-versa. | ||
− | In [[MU_FILTER_DECODE|decode]] mode, | + | In [[MU_FILTER_DECODE|decode]] mode, translates each CRLF sequence to LF. Takes no arguments. |
− | In [[MU_FILTER_ENCODE|encode]] mode, | + | In [[MU_FILTER_ENCODE|encode]] mode, replaces each LF character with the CRLF sequence. If created with the <tt>-n</tt> option, the filter produces a "normalized" output, by preserving input CRLF untouched (by default they are translated to CR CR LF). |
The following object, declared in the header <tt>mailutils/filter.h</tt>, describes this filter: | The following object, declared in the header <tt>mailutils/filter.h</tt>, describes this filter: | ||
Line 11: | Line 11: | ||
</source> | </source> | ||
− | + | The example below shows how to create a <tt>CRLF</tt> filter instance in decode mode for reading: | |
<source lang="C"> | <source lang="C"> | ||
Line 19: | Line 19: | ||
initialize_input_stream (&stream); | initialize_input_stream (&stream); | ||
− | rc = | + | rc = mu_filter_create (&flt, input, "CRLF", MU_FILTER_DECODE, MU_STREAM_READ); |
</source> | </source> | ||
Line 28: | Line 28: | ||
[[Category:Filters]] | [[Category:Filters]] | ||
+ | [[Category:C API]] |
Revision as of 10:22, 9 July 2020
CRLF is a Mailutils filter which converts line separators from LF (ASCII 10) to CRLF (ASCII 13 10) and vice-versa.
In decode mode, translates each CRLF sequence to LF. Takes no arguments.
In encode mode, replaces each LF character with the CRLF sequence. If created with the -n option, the filter produces a "normalized" output, by preserving input CRLF untouched (by default they are translated to CR CR LF).
The following object, declared in the header mailutils/filter.h, describes this filter:
extern mu_filter_record_t mu_crlf_filter;
The example below shows how to create a CRLF filter instance in decode mode for reading:
int rc; /* Return code */
mu_stream_t flt; /* Filter stream */
mu_stream_t input; /* Input stream */
initialize_input_stream (&stream);
rc = mu_filter_create (&flt, input, "CRLF", MU_FILTER_DECODE, MU_STREAM_READ);
This filter is also available under the name RFC822, which is deprecated.