|  |  |  | Camel Reference Manual |  | 
|---|---|---|---|---|
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.
| addr: | a CamelInternetAddress object | 
| name: | name associated with the new address | 
| 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.
| addr: | a CamelInternetAddress object | 
| index: | address's array index | 
| namep: | holder for the returned name, or NULL, if not required. | 
| addressp: | holder for the returned address, or NULL, if not required. | 
| Returns : | TRUEif such an address exists, orFALSEotherwise | 
int camel_internet_address_find_name (CamelInternetAddress *addr, const char *name, const char **addressp);
Find address by real name.
| addr: | a CamelInternetAddress object | 
| name: | name to lookup | 
| addressp: | holder for address part, or NULL, if not required. | 
| Returns : | the index of the address matching the name, or -1if no
match was found | 
int camel_internet_address_find_address (CamelInternetAddress *addr, const char *address, const char **namep);
Find an address by address.
| addr: | a CamelInternetAddress object | 
| address: | address to lookup | 
| namep: | holder for the matching name, or NULL, if not required. | 
| Returns : | the index of the address, or -1if 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
| len: | the length of the line the address is being appended to | 
| name: | the unencoded real name associated with the address | 
| addr: | the routing address | 
| Returns : | the encoded address |