GnuCash  5.6-150-g038405b370+
gncAddress.h
Go to the documentation of this file.
1 /********************************************************************\
2  * gncAddress.h -- an Address object *
3  * *
4  * This program is free software; you can redistribute it and/or *
5  * modify it under the terms of the GNU General Public License as *
6  * published by the Free Software Foundation; either version 2 of *
7  * the License, or (at your option) any later version. *
8  * *
9  * This program is distributed in the hope that it will be useful, *
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12  * GNU General Public License for more details. *
13  * *
14  * You should have received a copy of the GNU General Public License*
15  * along with this program; if not, contact: *
16  * *
17  * Free Software Foundation Voice: +1-617-542-5942 *
18  * 51 Franklin Street, Fifth Floor Fax: +1-617-542-2652 *
19  * Boston, MA 02110-1301, USA gnu@gnu.org *
20  * *
21 \********************************************************************/
57 #ifndef GNC_ADDRESS_H_
58 #define GNC_ADDRESS_H_
59 
60 #include "qof.h"
61 #include "gncBusiness.h"
62 
63 #ifdef __cplusplus
64 extern "C" {
65 #endif
66 
67 #define GNC_ADDRESS_MODULE_NAME "gncAddress"
68 #define GNC_ID_ADDRESS GNC_ADDRESS_MODULE_NAME
69 
84 typedef struct _gncAddress GncAddress;
85 typedef struct _gncAddressClass GncAddressClass;
86 
87 /* --- type macros --- */
88 #define GNC_TYPE_ADDRESS (gnc_address_get_type ())
89 #define GNC_ADDRESS(o) \
90  (G_TYPE_CHECK_INSTANCE_CAST ((o), GNC_TYPE_ADDRESS, GncAddress))
91 #define GNC_ADDRESS_CLASS(k) \
92  (G_TYPE_CHECK_CLASS_CAST((k), GNC_TYPE_ADDRESS, GncAddressClass))
93 #define GNC_IS_ADDRESS(o) \
94  (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNC_TYPE_ADDRESS))
95 #define GNC_IS_ADDRESS_CLASS(k) \
96  (G_TYPE_CHECK_CLASS_TYPE ((k), GNC_TYPE_ADDRESS))
97 #define GNC_ADDRESS_GET_CLASS(o) \
98  (G_TYPE_INSTANCE_GET_CLASS ((o), GNC_TYPE_ADDRESS, GncAddressClass))
99 GType gnc_address_get_type(void);
100 
103 GncAddress *gncAddressCreate (QofBook *book, QofInstance *parent);
104 void gncAddressDestroy (GncAddress *addr);
105 void gncAddressBeginEdit (GncAddress *addr);
106 void gncAddressCommitEdit (GncAddress *addr);
107 
113 void gncAddressSetName (GncAddress *addr, const char *name);
114 void gncAddressSetAddr1 (GncAddress *addr, const char *addr1);
115 void gncAddressSetAddr2 (GncAddress *addr, const char *addr2);
116 void gncAddressSetAddr3 (GncAddress *addr, const char *addr3);
117 void gncAddressSetAddr4 (GncAddress *addr, const char *addr4);
118 void gncAddressSetPhone (GncAddress *addr, const char *phone);
119 void gncAddressSetFax (GncAddress *addr, const char *fax);
120 void gncAddressSetEmail (GncAddress *addr, const char *email);
121 void gncAddressClearDirty (GncAddress *address);
127 const char * gncAddressGetName (const GncAddress *addr);
128 const char * gncAddressGetAddr1 (const GncAddress *addr);
129 const char * gncAddressGetAddr2 (const GncAddress *addr);
130 const char * gncAddressGetAddr3 (const GncAddress *addr);
131 const char * gncAddressGetAddr4 (const GncAddress *addr);
132 const char * gncAddressGetPhone (const GncAddress *addr);
133 const char * gncAddressGetFax (const GncAddress *addr);
134 const char * gncAddressGetEmail (const GncAddress *addr);
137 gboolean gncAddressIsDirty (const GncAddress *addr);
138 
144 int gncAddressCompare (const GncAddress *a, const GncAddress *b);
145 
150 gboolean gncAddressEqual(const GncAddress *a, const GncAddress *b);
151 
152 #define ADDRESS_NAME "name"
153 #define ADDRESS_ONE "number"
154 #define ADDRESS_TWO "street"
155 #define ADDRESS_THREE "locality"
156 #define ADDRESS_FOUR "city"
157 #define ADDRESS_PHONE "phone"
158 #define ADDRESS_FAX "fax"
159 #define ADDRESS_EMAIL "email"
160 #define ADDRESS_OWNER "owner"
161 
162 #ifdef __cplusplus
163 }
164 #endif
165 
166 #endif /* GNC_ADDRESS_H_ */
167 
int gncAddressCompare(const GncAddress *a, const GncAddress *b)
compare two addresses
Definition: gncAddress.c:567
– Business Helper Functions
gboolean gncAddressEqual(const GncAddress *a, const GncAddress *b)
Deeply compare two addresses.
Definition: gncAddress.c:577