![]() |
![]() |
![]() |
Camel Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
struct CamelInternetAddress; CamelInternetAddress* camel_internet_address_new (void); int camel_internet_address_add (CamelInternetAddress *addr, const char *name, const char *address); gboolean camel_internet_address_get (const CamelInternetAddress *addr, int index, const char **namep, const char **addressp); int camel_internet_address_find_name (CamelInternetAddress *addr, const char *name, const char **addressp); int camel_internet_address_find_address (CamelInternetAddress *addr, const char *address, const char **namep); char* camel_internet_address_encode_address (int *len, const char *name, const char *addr); char* camel_internet_address_format_address (const char *real, const char *addr);
struct CamelInternetAddress { CamelAddress parent; struct _CamelInternetAddressPrivate *priv; };
CamelInternetAddress* camel_internet_address_new (void);
Create a new CamelInternetAddress object.
Returns : |
a new CamelInternetAddress object |
int camel_internet_address_add (CamelInternetAddress *addr, const char *name, const char *address);
Add a new internet address to addr
.
|
a CamelInternetAddress object |
|
name associated with the new address |
|
routing address associated with the new address |
Returns : |
the index of added entry |
gboolean camel_internet_address_get (const CamelInternetAddress *addr, int index, const char **namep, const char **addressp);
Get the address at index
.
|
a CamelInternetAddress object |
|
address's array index |
|
holder for the returned name, or NULL , if not required.
|
|
holder for the returned address, or NULL , if not required.
|
Returns : |
%TRUE if such an address exists, or FALSE otherwise
|
int camel_internet_address_find_name (CamelInternetAddress *addr, const char *name, const char **addressp);
Find address by real name.
|
a CamelInternetAddress object |
|
name to lookup |
|
holder for address part, or NULL , if not required.
|
Returns : |
the index of the address matching the name, or -1 if no
match was found
|
int camel_internet_address_find_address (CamelInternetAddress *addr, const char *address, const char **namep);
Find an address by address.
|
a CamelInternetAddress object |
|
address to lookup |
|
holder for the matching name, or NULL , if not required.
|
Returns : |
the index of the address, or -1 if not found
|
char* camel_internet_address_encode_address (int *len, const char *name, const char *addr);
Encode a single address ready for internet usage. Header folding
as per rfc822 is also performed, based on the length *len
. If len
is NULL
, then no folding will occur.
Note: The value at *in
will be updated based on any linewrapping done
|
the length of the line the address is being appended to |
|
the unencoded real name associated with the address |
|
the routing address |
Returns : |
the encoded address |