![]() |
![]() |
![]() |
GMime Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
struct GMimeFilterBest; enum GMimeBestEncoding; GMimeFilter * g_mime_filter_best_new (unsigned int flags
); const char * g_mime_filter_best_charset (GMimeFilterBest *best
); GMimePartEncodingType g_mime_filter_best_encoding (GMimeFilterBest *best
,GMimeBestEncoding required
);
A GMimeFilter which is meant to determine the best charset and/or transfer encoding suitable for the stream which is filtered through it.
typedef enum { GMIME_BEST_ENCODING_7BIT, GMIME_BEST_ENCODING_8BIT, GMIME_BEST_ENCODING_BINARY } GMimeBestEncoding;
GMimeFilter * g_mime_filter_best_new (unsigned int flags
);
Creates a new GMimeFilterBest filter. flags
are used to determine
which information to keep statistics of. If the
GMIME_FILTER_BEST_CHARSET bit is set, the filter will be able to
compute the best charset for encoding the stream of data
filtered. If the GMIME_FILTER_BEST_ENCODING bit is set, the filter
will be able to compute the best Content-Transfer-Encoding for use
with the stream being filtered.
Note: In order for the g_mime_filter_best_charset()
function to
work, the stream being filtered MUST already be encoded in UTF-8.
|
filter flags |
Returns : |
a new best filter with flags flags . |
const char * g_mime_filter_best_charset (GMimeFilterBest *best
);
Calculates the best charset for encoding the stream filtered
through the best
filter.
|
best filter |
Returns : |
a pointer to a string containing the name of the charset
best suited for the text filtered through best . |
GMimePartEncodingType g_mime_filter_best_encoding (GMimeFilterBest *best
,GMimeBestEncoding required
);
Calculates the best Content-Transfer-Encoding for the stream
filtered through best
that fits within the required
encoding.
|
best filter |
|
encoding that all data must fit within |
Returns : |
the best encoding for the stream filtered by best . |