2 * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 2001-2007 Match Grun and the Claws Mail team
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 * General primitive address item objects.
34 * Create new email address item.
35 * \return Initialized email item.
37 ItemEMail *addritem_create_item_email( void ) {
39 item = g_new0( ItemEMail, 1 );
40 ADDRITEM_TYPE(item) = ITEMTYPE_EMAIL;
41 ADDRITEM_ID(item) = NULL;
42 ADDRITEM_NAME(item) = NULL;
43 ADDRITEM_PARENT(item) = NULL;
44 ADDRITEM_SUBTYPE(item) = 0;
51 * Create a shallow copy of specified email address item.
52 * \param item E-Mail to copy.
53 * \return Copy of email, or <i>NULL</i> if null argument supplied.
55 ItemEMail *addritem_copy_item_email( ItemEMail *item ) {
56 ItemEMail *itemNew = NULL;
58 itemNew = addritem_create_item_email();
59 ADDRITEM_NAME(itemNew) = g_strdup( ADDRITEM_NAME(item) );
60 itemNew->address = g_strdup( item->address );
61 itemNew->remarks = g_strdup( item->remarks );
67 * Create a full copy (deep copy) of specified email address item.
68 * \param item E-Mail to copy.
69 * \return Copy of email.
71 ItemEMail *addritem_copyfull_item_email( ItemEMail *item ) {
72 ItemEMail *itemNew = NULL;
74 itemNew = addritem_create_item_email();
75 ADDRITEM_ID(itemNew) = g_strdup( ADDRITEM_ID(item) );
76 ADDRITEM_NAME(itemNew) = g_strdup( ADDRITEM_NAME(item) );
77 ADDRITEM_PARENT(itemNew) = ADDRITEM_PARENT(item);
78 itemNew->address = g_strdup( item->address );
79 itemNew->remarks = g_strdup( item->remarks );
85 * Specify alias for email.
86 * \param email E-Mail item.
89 void addritem_email_set_alias( ItemEMail *email, const gchar *value ) {
90 ADDRITEM_NAME(email) = mgu_replace_string( ADDRITEM_NAME(email), value );
94 * Specify address for email.
95 * \param email E-Mail item.
96 * \param value Address.
98 void addritem_email_set_address( ItemEMail *email, const gchar *value ) {
99 email->address = mgu_replace_string( email->address, value );
103 * Specify remarks for email.
104 * \param email E-Mail item.
105 * \param value Remarks.
107 void addritem_email_set_remarks( ItemEMail *email, const gchar *value ) {
108 email->remarks = mgu_replace_string( email->remarks, value );
112 * Free address item email object.
113 * \param item E-Mail item to free.
115 void addritem_free_item_email( ItemEMail *item ) {
116 g_return_if_fail( item != NULL );
118 /* Free internal stuff */
119 g_free( ADDRITEM_ID(item) );
120 g_free( ADDRITEM_NAME(item) );
121 g_free( item->address );
122 g_free( item->remarks );
124 ADDRITEM_OBJECT(item)->type = ITEMTYPE_NONE;
125 ADDRITEM_ID(item) = NULL;
126 ADDRITEM_NAME(item) = NULL;
127 ADDRITEM_PARENT(item) = NULL;
128 ADDRITEM_SUBTYPE(item) = 0;
129 item->address = NULL;
130 item->remarks = NULL;
135 * Create new attribute object.
136 * \return Initialized attribute object.
138 UserAttribute *addritem_create_attribute( void ) {
140 item = g_new0( UserAttribute, 1 );
148 * Create copy (deep copy) of specified attribute.
149 * \param item Attribute to copy.
150 * \return Copy of attribute, or <i>NULL</i> if null argument supplied.
152 UserAttribute *addritem_copy_attribute( UserAttribute *item ) {
153 UserAttribute *itemNew = NULL;
155 itemNew = addritem_create_attribute();
156 itemNew->uid = g_strdup( item->uid );
157 itemNew->name = g_strdup( item->name );
158 itemNew->value = g_strdup( item->value );
164 * Specify ID for attribute.
165 * \param item Attribute object.
168 void addritem_attrib_set_id( UserAttribute *item, const gchar *value ) {
169 g_return_if_fail( item != NULL );
170 item->uid = mgu_replace_string( item->uid, value );
174 * Specify name for attribute.
175 * \param item Attribute object.
178 void addritem_attrib_set_name( UserAttribute *item, const gchar *value ) {
179 g_return_if_fail( item != NULL );
180 item->name = mgu_replace_string( item->name, value );
184 * Specify value for attribute.
185 * \param item Attribute object.
186 * \param value Value.
188 void addritem_attrib_set_value( UserAttribute *item, const gchar *value ) {
189 g_return_if_fail( item != NULL );
190 item->value = mgu_replace_string( item->value, value );
194 * Free user attribute.
195 * \param item Attribute object to free.
197 void addritem_free_attribute( UserAttribute *item ) {
198 g_return_if_fail( item != NULL );
200 g_free( item->name );
201 g_free( item->value );
209 * Create new address book person.
210 * \return Initialized person object.
212 ItemPerson *addritem_create_item_person( void ) {
214 person = g_new0( ItemPerson, 1 );
215 ADDRITEM_TYPE(person) = ITEMTYPE_PERSON;
216 ADDRITEM_ID(person) = NULL;
217 ADDRITEM_NAME(person) = NULL;
218 ADDRITEM_PARENT(person) = NULL;
219 ADDRITEM_SUBTYPE(person) = 0;
220 person->firstName = NULL;
221 person->lastName = NULL;
222 person->nickName = NULL;
223 person->listEMail = NULL;
224 person->listAttrib = NULL;
225 person->externalID = NULL;
226 person->isOpened = FALSE;
231 * Create a shallow copy of address book person object.
232 * \param item Person to copy.
233 * \return Copy of person, or <i>NULL</i> if null argument supplied.
235 ItemPerson *addritem_copy_item_person( ItemPerson *item ) {
240 itemNew = addritem_create_item_person();
241 ADDRITEM_NAME(itemNew) = g_strdup( ADDRITEM_NAME(item) );
242 itemNew->firstName = g_strdup( item->firstName );
243 itemNew->lastName = g_strdup( item->lastName );
244 itemNew->nickName = g_strdup( item->nickName );
245 itemNew->externalID = g_strdup( item->externalID );
251 * Specify first name for person object.
252 * \param person Person object.
255 void addritem_person_set_first_name( ItemPerson *person, const gchar *value ) {
256 if (!value || g_utf8_validate(value, -1, NULL))
257 person->firstName = mgu_replace_string( person->firstName, value );
259 gchar *out = conv_codeset_strdup(value,
260 conv_get_locale_charset_str_no_utf8(),
263 person->firstName = mgu_replace_string( person->firstName, out );
269 * Specify last name for person object.
270 * \param person Person object.
273 void addritem_person_set_last_name( ItemPerson *person, const gchar *value ) {
274 if (!value || g_utf8_validate(value, -1, NULL))
275 person->lastName = mgu_replace_string( person->lastName, value );
277 gchar *out = conv_codeset_strdup(value,
278 conv_get_locale_charset_str_no_utf8(),
281 person->lastName = mgu_replace_string( person->lastName, out );
287 * Specify nick name for person object.
288 * \param person Person object.
291 void addritem_person_set_nick_name( ItemPerson *person, const gchar *value ) {
292 if (!value || g_utf8_validate(value, -1, NULL))
293 person->nickName = mgu_replace_string( person->nickName, value );
295 gchar *out = conv_codeset_strdup(value,
296 conv_get_locale_charset_str_no_utf8(),
299 person->nickName = mgu_replace_string( person->nickName, out );
305 * Specify common name for person object.
306 * \param person Person object.
309 void addritem_person_set_common_name( ItemPerson *person, const gchar *value ) {
310 if (!value || g_utf8_validate(value, -1, NULL))
311 ADDRITEM_NAME(person) = mgu_replace_string( ADDRITEM_NAME(person), value );
313 gchar *out = conv_codeset_strdup(value,
314 conv_get_locale_charset_str_no_utf8(),
317 ADDRITEM_NAME(person) = mgu_replace_string( ADDRITEM_NAME(person), out );
323 * Specify external ID for person object.
324 * \param person Person object.
327 void addritem_person_set_external_id( ItemPerson *person, const gchar *value ) {
328 person->externalID = mgu_replace_string( person->externalID, value );
332 * Specify value of open indicator for person object. This is typically used to
333 * simplify open/close folders in the address book GUI.
334 * \param person Person object.
335 * \param value Value for indicator. Set to <i>TRUE</i> if opened.
337 void addritem_person_set_opened( ItemPerson *person, const gboolean value ) {
338 person->isOpened = value;
342 * Test whether person's data is empty.
343 * \param person Person to test.
344 * \return <i>TRUE</i> if empty.
346 gboolean addritem_person_empty( ItemPerson *person ) {
349 if( person == NULL ) return FALSE;
351 t = ADDRITEM_NAME(person);
352 if( t != NULL && strlen( t ) > 0 ) return FALSE;
354 t = person->firstName;
355 if( t != NULL && strlen( t ) > 0 ) return FALSE;
357 t = person->lastName;
358 if( t != NULL && strlen( t ) > 0 ) return FALSE;
360 t = person->nickName;
361 if( t != NULL && strlen( t ) > 0 ) return FALSE;
363 if( person->listEMail != NULL ) return FALSE;
364 if( person->listAttrib != NULL ) return FALSE;
370 * Free linked list of item addresses; both addresses and the list are freed.
371 * It is assumed that addresses are *NOT* contained within some other
373 * \param list List of addresses to be freed.
375 void addritem_free_list_email( GList *list ) {
378 ItemEMail *email = node->data;
380 addritem_free_item_email( email );
382 node = g_list_next( node );
389 * Free linked list of attributes; both attributes and the list are freed.
390 * It is assumed that attributes are *NOT* contained within some other
392 * \param list List of attributes to be freed.
394 void addritem_free_list_attribute( GList *list ) {
397 addritem_free_attribute( node->data );
399 node = g_list_next( node );
405 * Free address person object.
406 * \param person Person object to free.
408 void addritem_free_item_person( ItemPerson *person ) {
409 g_return_if_fail( person != NULL );
411 /* Free internal stuff */
412 g_free( ADDRITEM_ID(person) );
413 g_free( ADDRITEM_NAME(person) );
414 g_free( person->firstName );
415 g_free( person->lastName );
416 g_free( person->nickName );
417 g_free( person->externalID );
418 g_list_free( person->listEMail );
419 addritem_free_list_attribute( person->listAttrib );
421 ADDRITEM_OBJECT(person)->type = ITEMTYPE_NONE;
422 ADDRITEM_ID(person) = NULL;
423 ADDRITEM_NAME(person) = NULL;
424 ADDRITEM_PARENT(person) = NULL;
425 ADDRITEM_SUBTYPE(person) = 0;
426 person->firstName = NULL;
427 person->lastName = NULL;
428 person->nickName = NULL;
429 person->externalID = NULL;
430 person->listEMail = NULL;
431 person->listAttrib = NULL;
437 * Print E-Mail address object for debug.
438 * \param item Item to print.
439 * \param stream Output stream.
441 void addritem_print_item_email( ItemEMail *item, FILE *stream ) {
442 g_return_if_fail( item != NULL );
443 fprintf( stream, "\t\tt/id: %d : '%s'\n", ADDRITEM_TYPE(item), ADDRITEM_ID(item) );
444 fprintf( stream, "\t\tsubty: %d\n", ADDRITEM_SUBTYPE(item) );
445 fprintf( stream, "\t\talis: '%s'\n", ADDRITEM_NAME(item) );
446 fprintf( stream, "\t\taddr: '%s'\n", item->address );
447 fprintf( stream, "\t\trems: '%s'\n", item->remarks );
448 fprintf( stream, "\t\t---\n" );
452 * Print user attribute object for debug.
453 * \param item Attribute to print.
454 * \param stream Output stream.
456 static void addritem_print_attribute( UserAttribute *item, FILE *stream ) {
457 g_return_if_fail( item != NULL );
458 fprintf( stream, "\t\tuid : '%s'\n", item->uid );
459 fprintf( stream, "\t\tname : '%s'\n", item->name );
460 fprintf( stream, "\t\tvalue: '%s'\n", item->value );
461 fprintf( stream, "\t\t---\n" );
465 * Print person item for debug.
466 * \param person Person to print.
467 * \param stream Output stream.
469 void addritem_print_item_person( ItemPerson *person, FILE *stream ) {
471 g_return_if_fail( person != NULL );
472 fprintf( stream, "Person:\n" );
473 fprintf( stream, "\tt/uid: %d : '%s'\n", ADDRITEM_TYPE(person), ADDRITEM_ID(person) );
474 fprintf( stream, "\tsubty: %d\n", ADDRITEM_SUBTYPE(person) );
475 fprintf( stream, "\tcommn: '%s'\n", ADDRITEM_NAME(person) );
476 fprintf( stream, "\tfirst: '%s'\n", person->firstName );
477 fprintf( stream, "\tlast : '%s'\n", person->lastName );
478 fprintf( stream, "\tnick : '%s'\n", person->nickName );
479 fprintf( stream, "\textID: '%s'\n", person->externalID );
480 fprintf( stream, "\teMail:\n" );
481 fprintf( stream, "\t---\n" );
482 node = person->listEMail;
484 addritem_print_item_email( node->data, stream );
485 node = g_list_next( node );
487 fprintf( stream, "\tuAttr:\n" );
488 fprintf( stream, "\t---\n" );
489 node = person->listAttrib;
491 addritem_print_attribute( node->data, stream );
492 node = g_list_next( node );
494 fprintf( stream, "\t===\n" );
498 * Add E-Mail address object to person.
499 * \param person Person.
500 * \param email E-Mail object to add.
501 * \return <i>TRUE</i> if E-Mail added.
503 gboolean addritem_person_add_email( ItemPerson *person, ItemEMail *email ) {
506 g_return_val_if_fail( person != NULL, FALSE );
507 g_return_val_if_fail( email != NULL, FALSE );
509 node = person->listEMail;
511 if( node->data == email ) return FALSE;
512 node = g_list_next( node );
514 person->listEMail = g_list_append( person->listEMail, email );
515 ADDRITEM_PARENT(email) = ADDRITEM_OBJECT(person);
520 * Remove email address for specified person.
521 * \param person Person.
522 * \param email EMail to remove.
523 * \return EMail object, or <i>NULL</i> if not found. Note that object should
524 * still be freed after calling this method.
526 ItemEMail *addritem_person_remove_email( ItemPerson *person, ItemEMail *email ) {
527 gboolean found = FALSE;
530 g_return_val_if_fail( person != NULL, NULL );
531 if( email == NULL ) return NULL;
534 node = person->listEMail;
536 if( node-> data == email ) {
540 node = g_list_next( node );
544 /* Remove email from person's address list */
545 if( person->listEMail ) {
546 person->listEMail = g_list_remove( person->listEMail, email );
548 /* Unlink reference to person. */
549 ADDRITEM_PARENT(email) = NULL;
556 * Add user attribute to specified person.
557 * \param person Person.
558 * \param attrib Attribute to add.
559 * \return <i>TRUE</i> if item added.
561 void addritem_person_add_attribute(
562 ItemPerson *person, UserAttribute *attrib )
564 g_return_if_fail( person != NULL );
565 person->listAttrib = g_list_append( person->listAttrib, attrib );
569 * Remove attribute with specified ID from person.
570 * \param person Person object.
571 * \param aid Attribute ID to remove.
572 * \return UserAttribute object, or <i>NULL</i> if not found. Note that
573 * attribute object should still be freed after calling this method.
575 UserAttribute *addritem_person_remove_attrib_id(
576 ItemPerson *person, const gchar *aid )
578 UserAttribute *attrib = NULL;
581 g_return_val_if_fail( person != NULL, NULL );
582 if( aid == NULL || *aid == '\0' ) return NULL;
584 /* Look for attribute */
585 node = person->listAttrib;
587 UserAttribute *attr = node->data;
588 gchar *ida = attr->uid;
590 if( strcmp( ida, aid ) == 0 ) {
594 node = g_list_next( node );
597 /* Remove email from person's address list */
598 if( person->listAttrib ) {
599 person->listAttrib = g_list_remove( person->listAttrib, attrib );
605 * Remove attribute from person.
606 * \param person Person.
607 * \param attrib Attribute to remove.
608 * \return UserAttribute object to remove. Note that attribute object should
611 UserAttribute *addritem_person_remove_attribute(
612 ItemPerson *person, UserAttribute *attrib )
614 gboolean found = FALSE;
617 g_return_val_if_fail( person != NULL, NULL );
618 if( attrib == NULL ) return NULL;
620 /* Look for attribute */
621 node = person->listAttrib;
623 if( node-> data == attrib ) {
627 node = g_list_next( node );
631 /* Remove attribute */
632 if( person->listAttrib ) {
633 person->listAttrib = g_list_remove( person->listAttrib, attrib );
640 * Create new address book group object.
641 * \return Initialized group object.
643 ItemGroup *addritem_create_item_group( void ) {
646 group = g_new0( ItemGroup, 1 );
647 ADDRITEM_TYPE(group) = ITEMTYPE_GROUP;
648 ADDRITEM_ID(group) = NULL;
649 ADDRITEM_NAME(group) = NULL;
650 ADDRITEM_PARENT(group) = NULL;
651 ADDRITEM_SUBTYPE(group) = 0;
652 group->remarks = NULL;
653 group->listEMail = NULL;
658 * Copy (deep copy) address book group.
659 * \param item Group to copy.
660 * \return Copy of the group object, or <i>NULL</i> if null argument supplied.
662 ItemGroup *addritem_copy_item_group( ItemGroup *item ) {
665 itemNew = g_new0( ItemGroup, 1 );
667 itemNew = addritem_create_item_group();
668 ADDRITEM_NAME(itemNew) = g_strdup( ADDRITEM_NAME(item) );
669 itemNew->remarks = g_strdup( item->remarks );
675 * Specify name to be used for group.
676 * \param group Group object.
677 * \param value Name of group.
679 void addritem_group_set_name( ItemGroup *group, const gchar *value ) {
680 ADDRITEM_NAME(group) = mgu_replace_string( ADDRITEM_NAME(group), value );
684 * Free address group object.
685 * \param group Group to free.
687 void addritem_free_item_group( ItemGroup *group ) {
688 g_return_if_fail( group != NULL );
690 /* Free internal stuff */
691 g_free( ADDRITEM_ID(group) );
692 g_free( ADDRITEM_NAME(group) );
693 g_free( group->remarks );
694 mgu_clear_list( group->listEMail );
695 g_list_free( group->listEMail );
697 ADDRITEM_TYPE(group) = ITEMTYPE_NONE;
698 ADDRITEM_ID(group) = NULL;
699 ADDRITEM_NAME(group) = NULL;
700 ADDRITEM_PARENT(group) = NULL;
701 ADDRITEM_SUBTYPE(group) = 0;
702 group->remarks = NULL;
703 group->listEMail = NULL;
709 * Add EMail address to group. Note that a reference to an E-Mail item is
710 * added to a group. A person object is the only container that for an
712 * \param group Group.
713 * \param email E-Mail object.
714 * \return <i>TRUE</i> if email item added.
716 gboolean addritem_group_add_email( ItemGroup *group, ItemEMail *email ) {
719 g_return_val_if_fail( group != NULL, FALSE );
720 g_return_val_if_fail( email != NULL, FALSE );
722 node = group->listEMail;
724 if( node->data == email ) return FALSE;
725 node = g_list_next( node );
727 group->listEMail = g_list_append( group->listEMail, email );
732 * Remove person object for specified group.
733 * \param group Group from which to remove address.
734 * \param email EMail to remove
735 * \return EMail object, or <i>NULL if email not found in group. Note that
736 * this object is referenced (linked) to a group and should *NOT*
737 * be freed. An E-Mail object object should only be freed after
738 * removing from a person.
740 ItemPerson *addritem_folder_remove_person( ItemFolder *group, ItemPerson *person ) {
741 if( group && person ) {
742 GList *node = group->listPerson;
744 if( node->data == person ) {
745 group->listPerson = g_list_remove( group->listPerson, person );
748 node = g_list_next( node );
755 * Print address group item for debug.
756 * \param group Group to print.
757 * \param stream Output stream.
759 void addritem_print_item_group( ItemGroup *group, FILE *stream ) {
763 g_return_if_fail( group != NULL );
764 fprintf( stream, "Group:\n" );
765 fprintf( stream, "\tt/u: %d : '%s'\n", ADDRITEM_TYPE(group), ADDRITEM_ID(group) );
766 fprintf( stream, "\tsub: %d\n", ADDRITEM_SUBTYPE(group) );
767 fprintf( stream, "\tgrp: '%s'\n", ADDRITEM_NAME(group) );
768 fprintf( stream, "\trem: '%s'\n", group->remarks );
769 fprintf( stream, "\t---\n" );
770 node = group->listEMail;
773 person = ( ItemPerson * ) ADDRITEM_PARENT(item);
775 fprintf( stream, "\t\tpid : '%s'\n", ADDRITEM_ID(person) );
776 fprintf( stream, "\t\tcomn: '%s'\n", ADDRITEM_NAME(person) );
779 fprintf( stream, "\t\tpid : ???\n" );
780 fprintf( stream, "\t\tcomn: ???\n" );
782 addritem_print_item_email( item, stream );
783 node = g_list_next( node );
785 fprintf( stream, "\t***\n" );
789 * Create new address folder.
790 * \return Initialized address folder object.
792 ItemFolder *addritem_create_item_folder( void ) {
794 folder = g_new0( ItemFolder, 1 );
795 ADDRITEM_TYPE(folder) = ITEMTYPE_FOLDER;
796 ADDRITEM_ID(folder) = NULL;
797 ADDRITEM_NAME(folder) = NULL;
798 ADDRITEM_PARENT(folder) = NULL;
799 ADDRITEM_SUBTYPE(folder) = 0;
800 folder->remarks = NULL;
801 folder->isRoot = FALSE;
802 folder->listItems = NULL;
803 folder->listFolder = NULL;
804 folder->listPerson = NULL;
805 folder->listGroup = NULL;
806 folder->folderType = ADDRFOLDER_NONE;
807 folder->folderData = NULL;
808 folder->isHidden = FALSE;
813 * Copy address book folder. Note that only the folder and not its contents are
815 * \param item Folder to copy.
816 * \return A copy of the folder, or <i>NULL</i> if null argument supplied.
818 ItemFolder *addritem_copy_item_folder( ItemFolder *item ) {
821 itemNew = g_new0( ItemFolder, 1 );
823 itemNew = addritem_create_item_folder();
824 ADDRITEM_NAME(itemNew) = g_strdup( ADDRITEM_NAME(item) );
825 itemNew->folderType = item->folderType;
831 * Specify name to be used for folder.
832 * \param folder Folder.
835 void addritem_folder_set_name( ItemFolder *folder, const gchar *value ) {
836 ADDRITEM_NAME(folder) = mgu_replace_string( ADDRITEM_NAME(folder), value );
840 * Specify remarks to be used for folder.
841 * \param folder Folder.
842 * \param value Remarks.
844 void addritem_folder_set_remarks( ItemFolder *folder, const gchar *value ) {
845 folder->remarks = mgu_replace_string( folder->remarks, value );
849 * Specify visibility of folder.
850 * \param folder Folder.
851 * \param value Set to <code>TRUE</code> to hide folder.
853 void addritem_folder_set_hidden( ItemFolder *folder, const gboolean value ) {
854 folder->isHidden = value;
858 * Free address folder. Note: this does not free up the lists of children
859 * (folders, groups and person). This should be done prior to calling this
861 * \param folder Folder to free.
863 void addritem_free_item_folder( ItemFolder *folder ) {
864 g_return_if_fail( folder != NULL );
866 /* Free internal stuff */
867 g_free( ADDRITEM_ID(folder) );
868 g_free( ADDRITEM_NAME(folder) );
869 g_free( folder->remarks );
870 mgu_clear_list( folder->listItems );
871 g_list_free( folder->listItems );
873 ADDRITEM_TYPE(folder) = ITEMTYPE_NONE;
874 ADDRITEM_ID(folder) = NULL;
875 ADDRITEM_NAME(folder) = NULL;
876 ADDRITEM_PARENT(folder) = NULL;
877 ADDRITEM_SUBTYPE(folder) = 0;
878 folder->isRoot = FALSE;
879 folder->remarks = NULL;
880 folder->listItems = NULL;
881 folder->listFolder = NULL;
882 folder->listGroup = NULL;
883 folder->listPerson = NULL;
884 folder->folderType = ADDRFOLDER_NONE;
885 folder->folderData = NULL;
886 folder->isHidden = FALSE;
892 * Free up folders recursively. Note: this only frees up the lists of
893 * children and *NOT* the children objects (folders, groups and person).
894 * This should be done prior to calling this function.
895 * \param parent Parent folder object to be processed.
897 static void addritem_free_item_folder_recurse( ItemFolder *parent ) {
898 GList *node = parent->listFolder;
901 ItemFolder *folder = node->data;
902 addritem_free_item_folder_recurse( folder );
903 node = g_list_next( node );
905 g_list_free( parent->listPerson );
906 g_list_free( parent->listGroup );
907 g_list_free( parent->listFolder );
908 parent->listPerson = NULL;
909 parent->listGroup = NULL;
910 parent->listFolder = NULL;
914 * Add person into folder.
915 * \param folder Folder.
916 * \param item Person to add.
917 * \return <i>TRUE</i> if person added.
919 gboolean addritem_folder_add_person( ItemFolder *folder, ItemPerson *item ) {
920 g_return_val_if_fail( folder != NULL, FALSE );
921 g_return_val_if_fail( item != NULL, FALSE );
923 folder->listPerson = g_list_append( folder->listPerson, item );
924 ADDRITEM_PARENT(item) = ADDRITEM_OBJECT(folder);
929 * Add folder into folder.
930 * \param folder Folder.
931 * \param item Folder to add.
932 * \return <i>TRUE</i> if folder added.
934 gboolean addritem_folder_add_folder( ItemFolder *folder, ItemFolder *item ) {
935 g_return_val_if_fail( folder != NULL, FALSE );
936 g_return_val_if_fail( item != NULL, FALSE );
938 folder->listFolder = g_list_append( folder->listFolder, item );
939 ADDRITEM_PARENT(item) = ADDRITEM_OBJECT(folder);
944 * Add group into folder.
945 * \param folder Folder.
946 * \param item Group to add.
947 * \return <i>TRUE</i> if group added.
949 gboolean addritem_folder_add_group( ItemFolder *folder, ItemGroup *item ) {
950 g_return_val_if_fail( folder != NULL, FALSE );
951 g_return_val_if_fail( item != NULL, FALSE );
953 folder->listGroup = g_list_append( folder->listGroup, item );
954 ADDRITEM_PARENT(item) = ADDRITEM_OBJECT(folder);
959 * Print address folder item contents for debug.
960 * \param folder Folder to process.
961 * \param stream Output stream.
963 void addritem_print_item_folder( ItemFolder *folder, FILE *stream ) {
965 /* ItemPerson *person; */
968 g_return_if_fail( folder != NULL );
970 fprintf( stream, "Folder:\n" );
971 fprintf( stream, "\tt/u: %d : '%s'\n", ADDRITEM_TYPE(folder), ADDRITEM_ID(folder) );
972 fprintf( stream, "\tsub: %d\n", ADDRITEM_SUBTYPE(folder) );
973 fprintf( stream, "\tnam: '%s'\n", ADDRITEM_NAME(folder) );
974 fprintf( stream, "\trem: '%s'\n", folder->remarks );
975 fprintf( stream, "\ttyp: %d\n", folder->folderType );
976 fprintf( stream, "\thid: %s\n", folder->isHidden ? "hidden" : "visible" );
977 fprintf( stream, "\t---\n" );
978 parent = ( ItemFolder * ) ADDRITEM_PARENT(folder);
980 fprintf( stream, "\tpar: %s : %s\n", ADDRITEM_ID(parent), ADDRITEM_NAME(parent) );
983 fprintf( stream, "\tpar: NULL\n" );
985 node = folder->listFolder;
987 AddrItemObject *aio = node->data;
989 if( aio->type == ITEMTYPE_FOLDER ) {
990 ItemFolder *item = ( ItemFolder * ) aio;
991 addritem_print_item_folder( item, stream );
995 fprintf( stream, "\t\tpid : ???\n" );
998 node = g_list_next( node );
1001 node = folder->listPerson;
1003 AddrItemObject *aio = node->data;
1005 if( aio->type == ITEMTYPE_PERSON ) {
1006 ItemPerson *item = ( ItemPerson * ) aio;
1007 addritem_print_item_person( item, stream );
1011 fprintf( stream, "\t\tpid : ???\n" );
1014 node = g_list_next( node );
1017 node = folder->listGroup;
1019 AddrItemObject *aio = node->data;
1021 if( aio->type == ITEMTYPE_GROUP ) {
1022 ItemGroup *item = ( ItemGroup * ) aio;
1023 addritem_print_item_group( item, stream );
1027 fprintf( stream, "\t\tpid : ???\n" );
1029 node = g_list_next( node );
1031 fprintf( stream, "\t###\n" );
1035 * Return link list of persons for specified folder. Note that the list contains
1036 * references to items and should be g_free() when done. Do *NOT* attempt to use the
1037 * addritem_free_xxx() functions... this will destroy the addressbook data!
1039 * \param folder Folder to process.
1040 * \return List of items, or <i>NULL</i> if none.
1042 GList *addritem_folder_get_person_list( ItemFolder *folder ) {
1046 g_return_val_if_fail( folder != NULL, NULL );
1048 node = folder->listPerson;
1050 ItemPerson *person = node->data;
1051 list = g_list_append( list, person );
1052 node = g_list_next( node );
1058 * Return link list of groups for specified folder. Note that the list contains
1059 * references to items and should be g_free() when done. Do *NOT* attempt to use the
1060 * addritem_free_xxx() functions... this will destroy the addressbook data!
1062 * \param folder Folder to process.
1063 * \return List of items, or <i>NULL</i> if none.
1065 GList *addritem_folder_get_group_list( ItemFolder *folder ) {
1069 g_return_val_if_fail( folder != NULL, NULL );
1071 node = folder->listGroup;
1073 ItemGroup *group = node->data;
1074 list = g_list_append( list, group );
1075 node = g_list_next( node );
1081 * Move person's email item.
1082 * \param person Person.
1083 * \param itemMove Item to move.
1084 * \param itemTarget Target item before which to move item.
1085 * \return Reference to item that was moved, or <i>NULL</i> if null arguments
1089 ItemEMail *addritem_move_email_before(
1090 ItemPerson *person, ItemEMail *itemMove, ItemEMail *itemTarget )
1094 g_return_val_if_fail( person != NULL, NULL );
1096 if( itemTarget == NULL ) return NULL;
1097 if( itemMove == NULL ) return NULL;
1098 if( itemMove == itemTarget ) return itemMove;
1100 posT = g_list_index( person->listEMail, itemTarget );
1101 if( posT < 0 ) return NULL;
1102 posM = g_list_index( person->listEMail, itemMove );
1103 if( posM < 0 ) return NULL;
1104 person->listEMail = g_list_remove( person->listEMail, itemMove );
1105 person->listEMail = g_list_insert( person->listEMail, itemMove, posT );
1110 * Move person's email item.
1111 * \param person Person.
1112 * \param itemMove Item to move.
1113 * \param itemTarget Target item after which to move item.
1114 * \return Reference to item that was moved, or <i>NULL</i> if null arguments
1117 ItemEMail *addritem_move_email_after(
1118 ItemPerson *person, ItemEMail *itemMove, ItemEMail *itemTarget )
1122 g_return_val_if_fail( person != NULL, NULL );
1124 if( itemTarget == NULL ) return NULL;
1125 if( itemMove == NULL ) return NULL;
1126 if( itemMove == itemTarget ) return itemMove;
1128 posT = g_list_index( person->listEMail, itemTarget );
1129 if( posT < 0 ) return NULL;
1130 posM = g_list_index( person->listEMail, itemMove );
1131 if( posM < 0 ) return NULL;
1132 person->listEMail = g_list_remove( person->listEMail, itemMove );
1133 person->listEMail = g_list_insert( person->listEMail, itemMove, 1+posT );
1138 * Parse first and last names for person from common name.
1139 * \param person Person to process.
1141 void addritem_parse_first_last( ItemPerson *person ) {
1143 gchar *fName, *lName;
1147 g_return_if_fail( person != NULL );
1149 name = ADDRITEM_NAME(person);
1150 if( name == NULL ) return;
1154 p = strchr( name, ',' );
1156 len = ( size_t ) ( p - name );
1157 lName = g_strndup( name, len );
1158 fName = g_strdup( p + 1 );
1161 /* Other way around */
1164 if( name[i] == ' ' ) {
1165 fName = g_strndup( name, i );
1166 lName = g_strdup( &name[i] );
1171 if( fName == NULL ) {
1172 fName = g_strdup( name );
1176 g_free( person->firstName );
1177 person->firstName = fName;
1178 if( person->firstName )
1179 g_strstrip( person->firstName );
1181 g_free( person->lastName );
1182 person->lastName = lName;
1183 if( person->lastName )
1184 g_strstrip( person->lastName );
1188 * Build a path of all ancestor folders for specified folder.
1189 * \param folder Folder.
1190 * \param seq Path sequence, FALSE top down, TRUE bottom up.
1191 * \return List of folders from the top down.
1193 GList *addritem_folder_path( const ItemFolder *folder, const gboolean seq ) {
1195 AddrItemObject *item;
1198 item = ( AddrItemObject * ) folder;
1201 list = g_list_prepend( list, item );
1202 item = ADDRITEM_PARENT( item );
1207 list = g_list_append( list, item );
1208 item = ADDRITEM_PARENT( item );
1215 * Format E-Mail address.
1216 * \param email EMail item to format.
1217 * \return Formatted string. Should be freed after use.
1219 gchar *addritem_format_email( ItemEMail *email ) {
1226 if( ADDRITEM_NAME( email ) ) {
1227 if( strlen( ADDRITEM_NAME( email ) ) ) {
1228 name = ADDRITEM_NAME( email );
1232 person = ( ItemPerson * ) ADDRITEM_PARENT( email );
1233 name = ADDRITEM_NAME( person );
1237 if( strchr_with_skip_quote( name, '"', ',' ) ) {
1238 address = g_strdup_printf( "\"%s\" <%s>", name, email->address );
1241 address = g_strdup_printf( "%s <%s>", name, email->address );
1245 address = g_strdup_printf( "%s", email->address );