return itemNew;
}
-/**
- * Specify ID for email.
- * \param email E-Mail item.
- * \param value ID.
- */
-void addritem_email_set_id( ItemEMail *email, const gchar *value ) {
- ADDRITEM_ID(email) = mgu_replace_string( ADDRITEM_ID(email), value );
-}
-
/**
* Specify alias for email.
* \param email E-Mail item.
return itemNew;
}
-/**
- * Specify ID for person object.
- * \param person Person object.
- * \param value ID.
- */
-void addritem_person_set_id( ItemPerson *person, const gchar *value ) {
- ADDRITEM_ID(person) = mgu_replace_string( ADDRITEM_ID(person), value );
-}
-
/**
* Specify first name for person object.
* \param person Person object.
* \param item Attribute to print.
* \param stream Output stream.
*/
-void addritem_print_attribute( UserAttribute *item, FILE *stream ) {
+static void addritem_print_attribute( UserAttribute *item, FILE *stream ) {
g_return_if_fail( item != NULL );
fprintf( stream, "\t\tuid : '%s'\n", item->uid );
fprintf( stream, "\t\tname : '%s'\n", item->name );
return TRUE;
}
-/**
- * Return email object with specified ID for specified person.
- * \param person Person object.
- * \param eid EMail ID.
- * \return EMail object, or <i>NULL</i> if not found.
- */
-ItemEMail *addritem_person_get_email( ItemPerson *person, const gchar *eid ) {
- ItemEMail *email = NULL;
- GList *node;
-
- g_return_val_if_fail( person != NULL, NULL );
- if( eid == NULL || *eid == '\0' ) return NULL;
-
- /* Look for email */
- node = person->listEMail;
- while( node ) {
- AddrItemObject *objE = node->data;
- gchar *ide = ADDRITEM_ID(objE);
- if( ide ) {
- if( strcmp( ide, eid ) == 0 ) {
- email = ( ItemEMail * ) objE;
- }
- }
- node = g_list_next( node );
- }
- return email;
-}
-
-/**
- * Remove email address with specified ID for specified person.
- * \param person Person object.
- * \param eid EMail ID.
- * \return EMail object, or <i>NULL</i> if not found. Note that object should
- * still be freed after calling this function.
- */
-ItemEMail *addritem_person_remove_email_id( ItemPerson *person, const gchar *eid ) {
- ItemEMail *email = NULL;
- GList *node;
-
- g_return_val_if_fail( person != NULL, NULL );
- if( eid == NULL || *eid == '\0' ) return NULL;
-
- /* Look for email */
- node = person->listEMail;
- while( node ) {
- AddrItemObject *objE = node->data;
- gchar *ide = ADDRITEM_ID(objE);
- if( ide ) {
- if( strcmp( ide, eid ) == 0 ) {
- email = ( ItemEMail * ) objE;
- }
- }
- node = g_list_next( node );
- }
-
- if( email ) {
- /* Remove email from person's address list */
- if( person->listEMail ) {
- person->listEMail = g_list_remove( person->listEMail, email );
- }
- /* Unlink reference to person. */
- ADDRITEM_PARENT(email) = NULL;
- }
- return email;
-}
-
/**
* Remove email address for specified person.
* \param person Person.
person->listAttrib = g_list_append( person->listAttrib, attrib );
}
-/**
- * Return attribute with specified ID for person.
- * \param person Person object.
- * \param aid Attribute ID.
- * \return Reference to UserAttribute object, or <i>NULL</i> if not found.
- */
-UserAttribute *addritem_person_get_attribute(
- ItemPerson *person, const gchar *aid )
-{
- UserAttribute *attrib = NULL;
- GList *node;
-
- g_return_val_if_fail( person != NULL, NULL );
- if( aid == NULL || *aid == '\0' ) return NULL;
-
- /* Look for attribute */
- node = person->listAttrib;
- while( node ) {
- UserAttribute *attr = node->data;
- gchar *ida = attr->uid;
- if( ida ) {
- if( strcmp( ida, aid ) == 0 ) {
- attrib = attr;
- }
- }
- node = g_list_next( node );
- }
- return attrib;
-}
-
/**
* Remove attribute with specified ID from person.
* \param person Person object.
return itemNew;
}
-/**
- * Specify ID to be used for group.
- * \param group Group object.
- * \param value ID of group.
- */
-void addritem_group_set_id( ItemGroup *group, const gchar *value ) {
- ADDRITEM_ID(group) = mgu_replace_string( ADDRITEM_ID(group), value );
-}
-
/**
* Specify name to be used for group.
* \param group Group object.
ADDRITEM_NAME(group) = mgu_replace_string( ADDRITEM_NAME(group), value );
}
-/**
- * Specify remarks to be used for group.
- * \param group Group object.
- * \param value Remarks for group.
- */
-void addritem_group_set_remarks( ItemGroup *group, const gchar *value ) {
- group->remarks = mgu_replace_string( group->remarks, value );
-}
-
/**
* Free address group object.
* \param group Group to free.
return TRUE;
}
-/**
- * Remove email address object for specified group.
- * \param group Group from which to remove address.
- * \param email EMail to remove
- * \return EMail object, or <i>NULL if email not found in group. Note that
- * this object is referenced (linked) to a group and should *NOT*
- * be freed. An E-Mail object object should only be freed after
- * removing from a person.
- */
-ItemEMail *addritem_group_remove_email( ItemGroup *group, ItemEMail *email ) {
- if( group && email ) {
- GList *node = group->listEMail;
- while( node ) {
- if( node->data == email ) {
- group->listEMail = g_list_remove( group->listEMail, email );
- return email;
- }
- node = g_list_next( node );
- }
- }
- return NULL;
-}
-
/**
* Remove person object for specified group.
* \param group Group from which to remove address.
return NULL;
}
-/**
- * Remove email address of specified ID for specified group.
- * \param group Group from which to remove address.
- * \param eid EMail ID.
- * \return EMail object, or <i>NULL</i> if email not found in group. Note that
- * this object is referenced (linked) to a group and should *NOT* be
- * freed. An E-Mail object should only be freed after removing from a
- * person.
- */
-ItemEMail *addritem_group_remove_email_id( ItemGroup *group, const gchar *eid ) {
- if( group ) {
- GList *node = group->listEMail;
- while( node ) {
- ItemEMail *email = ( ItemEMail * ) node->data;
- if( strcmp( ADDRITEM_ID( email ), eid ) == 0 ) {
- group->listEMail = g_list_remove( group->listEMail, email );
- return email;
- }
- node = g_list_next( node );
- }
- }
- return NULL;
-}
-
/**
* Print address group item for debug.
* \param group Group to print.
return itemNew;
}
-/**
- * Specify ID to be used for folder.
- * \param folder Folder.
- * \param value ID.
- */
-void addritem_folder_set_id( ItemFolder *folder, const gchar *value ) {
- ADDRITEM_ID(folder) = mgu_replace_string( ADDRITEM_ID(folder), value );
-}
-
/**
* Specify name to be used for folder.
* \param folder Folder.
* This should be done prior to calling this function.
* \param parent Parent folder object to be processed.
*/
-void addritem_free_item_folder_recurse( ItemFolder *parent ) {
+static void addritem_free_item_folder_recurse( ItemFolder *parent ) {
GList *node = parent->listFolder;
while( node ) {
parent->listFolder = NULL;
}
-/**
- * Free up list of person objects contained in specified folder.
- * \param folder Folder to process.
- */
-void addritem_folder_free_person( ItemFolder *folder ) {
- GList *node;
-
- g_return_if_fail( folder != NULL );
-
- /* Free up folder of persons. */
- node = folder->listPerson;
- while( node ) {
- ItemPerson *person = node->data;
- addritem_free_item_person( person );
- person = NULL;
- node = g_list_next( node );
- }
-}
-
/**
* Add person into folder.
* \param folder Folder.
fprintf( stream, "\t###\n" );
}
-/**
- * Print address item for debug.
- * \param aio Address item to format.
- * \param stream Output stream.
- */
-void addritem_print_item( AddrItemObject *aio, FILE *stream ) {
- g_return_if_fail( aio != NULL );
-
- if( aio->type == ITEMTYPE_PERSON ) {
- ItemPerson *item = ( ItemPerson * ) aio;
- addritem_print_item_person( item, stream );
- }
- else if( aio->type == ITEMTYPE_EMAIL ) {
- ItemEMail *item = ( ItemEMail * ) aio;
- addritem_print_item_email( item, stream );
- }
- else if( aio->type == ITEMTYPE_GROUP ) {
- ItemGroup *item = ( ItemGroup * ) aio;
- addritem_print_item_group( item, stream );
- }
- else if( aio->type == ITEMTYPE_FOLDER ) {
- ItemFolder *item = ( ItemFolder * ) aio;
- addritem_print_item_folder( item, stream );
- }
-}
-
/**
* Return link list of persons for specified folder. Note that the list contains
* references to items and should be g_free() when done. Do *NOT* attempt to use the
ItemEMail *addritem_create_item_email ( void );
ItemEMail *addritem_copy_item_email ( ItemEMail *item );
ItemEMail *addritem_copyfull_item_email ( ItemEMail *item );
-void addritem_email_set_id ( ItemEMail *email, const gchar *value );
void addritem_email_set_alias ( ItemEMail *email, const gchar *value );
void addritem_email_set_address ( ItemEMail *email, const gchar *value );
void addritem_email_set_remarks ( ItemEMail *email, const gchar *value );
ItemPerson *addritem_create_item_person ( void );
ItemPerson *addritem_copy_item_person ( ItemPerson *item );
-void addritem_person_set_id ( ItemPerson *person, const gchar *value );
void addritem_person_set_first_name ( ItemPerson *person, const gchar *value );
void addritem_person_set_last_name ( ItemPerson *person, const gchar *value );
void addritem_person_set_nick_name ( ItemPerson *person, const gchar *value );
ItemGroup *addritem_create_item_group ( void );
ItemGroup *addritem_copy_item_group ( ItemGroup *item );
void addritem_free_item_group ( ItemGroup *group );
-void addritem_group_set_id ( ItemGroup *group, const gchar *value );
void addritem_group_set_name ( ItemGroup *group, const gchar *value );
-void addritem_group_set_remarks ( ItemGroup *group, const gchar *value );
void addritem_print_item_email ( ItemEMail *item, FILE *stream );
-void addritem_print_attribute ( UserAttribute *item, FILE *stream );
void addritem_print_item_person ( ItemPerson *person, FILE *stream );
void addritem_print_item_group ( ItemGroup *group, FILE *stream );
void addritem_print_item_folder ( ItemFolder *folder, FILE *stream );
-void addritem_print_item ( AddrItemObject *aio, FILE *stream );
gboolean addritem_person_add_email ( ItemPerson *person, ItemEMail *email );
-ItemEMail *addritem_person_get_email ( ItemPerson *person, const gchar *eid );
-ItemEMail *addritem_person_remove_email_id ( ItemPerson *person, const gchar *eid );
ItemEMail *addritem_person_remove_email ( ItemPerson *person, ItemEMail *email );
void addritem_person_add_attribute ( ItemPerson *person, UserAttribute *attrib );
-UserAttribute *addritem_person_get_attribute ( ItemPerson *person, const gchar *aid );
UserAttribute *addritem_person_remove_attrib_id ( ItemPerson *person, const gchar *aid );
UserAttribute *addritem_person_remove_attribute ( ItemPerson *person, UserAttribute *attrib );
ItemFolder *addritem_create_item_folder ( void );
ItemFolder *addritem_copy_item_folder ( ItemFolder *item );
-void addritem_folder_set_id ( ItemFolder *folder, const gchar *value );
void addritem_folder_set_name ( ItemFolder *folder, const gchar *value );
void addritem_folder_set_remarks ( ItemFolder *folder, const gchar *value );
void addritem_folder_set_hidden ( ItemFolder *folder, const gboolean value );
void addritem_free_item_folder ( ItemFolder *folder );
-void addritem_free_item_folder_recurse ( ItemFolder *parent );
gboolean addritem_group_add_email ( ItemGroup *group, ItemEMail *email );
-ItemEMail *addritem_group_remove_email ( ItemGroup *group, ItemEMail *email );
-ItemEMail *addritem_group_remove_email_id( ItemGroup *group, const gchar *eid );
gboolean addritem_folder_add_person ( ItemFolder *folder, ItemPerson *item );
ItemPerson *addritem_folder_remove_person( ItemFolder *group, ItemPerson *person );
gboolean addritem_folder_add_folder ( ItemFolder *folder, ItemFolder *item );
gboolean addritem_folder_add_group ( ItemFolder *folder, ItemGroup *item );
-void addritem_folder_free_person ( ItemFolder *folder );
GList *addritem_folder_get_person_list ( ItemFolder *folder );
GList *addritem_folder_get_group_list ( ItemFolder *folder );