InternetAddressGroup

## InternetAddressGroup InternetAddressGroup — rfc822 'group' address |

## Synopsis

    struct              InternetAddressGroup;
    InternetAddress *   internet_address_group_new          (const char *name);
    InternetAddressList * internet_address_group_get_members
                                                            (InternetAddressGroup *group);
    void                internet_address_group_set_members  (InternetAddressGroup *group,
                                                             InternetAddressList *members);
    int                 internet_address_group_add_member   (InternetAddressGroup *group,
                                                             InternetAddress *member);

## Description

An InternetAddressGroup represents an rfc822 'group' address.

## Details

### struct InternetAddressGroup

    struct InternetAddressGroup {
    	InternetAddress parent_object;

    	InternetAddressList *members;
    };

An RFC 2822 Group address.

InternetAddress `parent_object`; | parent InternetAddress
InternetAddressList *`members`; | a InternetAddressList of group members

### internet_address_group_new ()

    InternetAddress *   internet_address_group_new          (const char *name);

Creates a new InternetAddressGroup object with the specified `name`.

`name` : | group name
Returns : | a new InternetAddressGroup object. Note: The `name` string should be in UTF-8.

### internet_address_group_get_members ()

    InternetAddressList * internet_address_group_get_members
                                                            (InternetAddressGroup *group);

Gets the InternetAddressList containing the group members of an rfc822 group address.

`group` : | a InternetAddressGroup
Returns : | a InternetAddressList containing the members of `group`. [transfer none]

### internet_address_group_set_members ()

    void                internet_address_group_set_members  (InternetAddressGroup *group,
                                                             InternetAddressList *members);

Set the members of the internet address group.

`group` : | a InternetAddressGroup
`members` : | a InternetAddressList

### internet_address_group_add_member ()

    int                 internet_address_group_add_member   (InternetAddressGroup *group,
                                                             InternetAddress *member);

Add a contact to the internet address group.

`group` : | a InternetAddressGroup
`member` : | a InternetAddress
Returns : | the index of the newly added member.

## See Also

InternetAddress