CamelMimeFilterBestenc

CamelMimeFilterBestenc —

Synopsis




enum        CamelBestencRequired;
enum        CamelBestencEncoding;
            CamelMimeFilterBestenc;
CamelMimeFilterBestenc* camel_mime_filter_bestenc_new
                                            (unsigned int flags);
CamelTransferEncoding camel_mime_filter_bestenc_get_best_encoding
                                            (CamelMimeFilterBestenc *filter,
                                             CamelBestencEncoding required);
const char* camel_mime_filter_bestenc_get_best_charset
                                            (CamelMimeFilterBestenc *filter);
void        camel_mime_filter_bestenc_set_flags
                                            (CamelMimeFilterBestenc *filter,
                                             unsigned int flags);

Object Hierarchy


  CamelObject
   +----CamelMimeFilter
         +----CamelMimeFilterBestenc

Description

Details

enum CamelBestencRequired

typedef enum _CamelBestencRequired {
	CAMEL_BESTENC_GET_ENCODING = 1<<0,
	CAMEL_BESTENC_GET_CHARSET = 1<<1,

	/* do we treat 'lf' as if it were crlf? */
	CAMEL_BESTENC_LF_IS_CRLF = 1<<8,
	/* do we not allow "From " to appear at the start of a line in any part? */
	CAMEL_BESTENC_NO_FROM = 1<<9,
} CamelBestencRequired;


enum CamelBestencEncoding

typedef enum _CamelBestencEncoding {
	CAMEL_BESTENC_7BIT,
	CAMEL_BESTENC_8BIT,
	CAMEL_BESTENC_BINARY,
	
	/* is the content stream to be treated as text? */
	CAMEL_BESTENC_TEXT = 1<<8,
} CamelBestencEncoding;


CamelMimeFilterBestenc

typedef struct _CamelMimeFilterBestenc CamelMimeFilterBestenc;


camel_mime_filter_bestenc_new ()

CamelMimeFilterBestenc* camel_mime_filter_bestenc_new
                                            (unsigned int flags);

Create a new CamelMimeFilterBestenc object.

flags : a bitmask of data required.
Returns : a new CamelMimeFilterBestenc object

camel_mime_filter_bestenc_get_best_encoding ()

CamelTransferEncoding camel_mime_filter_bestenc_get_best_encoding
                                            (CamelMimeFilterBestenc *filter,
                                             CamelBestencEncoding required);

Get the best encoding, given specific constraints, that can be used to encode a stream of bytes.

filter : a CamelMimeFilterBestenc object
required : maximum level of output encoding allowed.
Returns : the best encoding to use

camel_mime_filter_bestenc_get_best_charset ()

const char* camel_mime_filter_bestenc_get_best_charset
                                            (CamelMimeFilterBestenc *filter);

Gets the best charset that can be used to contain this content.

filter : a CamelMimeFilterBestenc object
Returns : the name of the best charset to use to encode the input text filtered by filter

camel_mime_filter_bestenc_set_flags ()

void        camel_mime_filter_bestenc_set_flags
                                            (CamelMimeFilterBestenc *filter,
                                             unsigned int flags);

Set the flags for subsequent operations.

filter : a CamelMimeFilterBestenc object
flags : bestenc filter flags