Difference between revisions of "Xml (filter)"
From Mailutils
Jump to navigationJump to searchm |
|||
Line 7: | Line 7: | ||
The following object, declared in '''mailutils/filter.h''' describes the filter: | The following object, declared in '''mailutils/filter.h''' describes the filter: | ||
− | < | + | <syntaxhighlight lang="C"> |
extern mu_filter_record_t mu_xml_filter; | extern mu_filter_record_t mu_xml_filter; | ||
− | </ | + | </syntaxhighlight> |
The example below shows how to create an instance of this filter in encode mode for reading: | The example below shows how to create an instance of this filter in encode mode for reading: | ||
− | < | + | <syntaxhighlight lang="C"> |
int rc; /* Return code */ | int rc; /* Return code */ | ||
mu_stream_t flt; /* Filter stream */ | mu_stream_t flt; /* Filter stream */ | ||
Line 20: | Line 20: | ||
initialize_input_stream (&input); | initialize_input_stream (&input); | ||
rc = mu_filter_create (&flt, input, "xml", MU_FILTER_DECODE, MU_STREAM_READ); | rc = mu_filter_create (&flt, input, "xml", MU_FILTER_DECODE, MU_STREAM_READ); | ||
− | </ | + | </syntaxhighlight> |
== See also == | == See also == |
Latest revision as of 13:26, 16 October 2023
In encode mode, the xml filter converts input stream (which must contain valid UTF-8 characters) into a form suitable for inclusion into a XML or HTML document, i.e. it replaces <, >, and & with <, >, and &, correspondingly, and replaces invalid characters with their numeric character reference representation.
In decode mode, a reverse operation is performed.
The filter does not take arguments.
The following object, declared in mailutils/filter.h describes the filter:
extern mu_filter_record_t mu_xml_filter;
The example below shows how to create an instance of this filter in encode mode for reading:
int rc; /* Return code */
mu_stream_t flt; /* Filter stream */
mu_stream_t input; /* Input stream */
initialize_input_stream (&input);
rc = mu_filter_create (&flt, input, "xml", MU_FILTER_DECODE, MU_STREAM_READ);