Mercurial > pidgin
comparison libpurple/value.h @ 15822:32c366eeeb99
sed -ie 's/gaim/purple/g'
author | Sean Egan <seanegan@gmail.com> |
---|---|
date | Mon, 19 Mar 2007 07:01:17 +0000 |
parents | 5fe8042783c1 |
children | 391a79778f89 |
comparison
equal
deleted
inserted
replaced
15821:84b0f9b23ede | 15822:32c366eeeb99 |
---|---|
1 /** | 1 /** |
2 * @file value.h Value wrapper API | 2 * @file value.h Value wrapper API |
3 * @ingroup core | 3 * @ingroup core |
4 * | 4 * |
5 * gaim | 5 * purple |
6 * | 6 * |
7 * Gaim is the legal property of its developers, whose names are too numerous | 7 * Purple is the legal property of its developers, whose names are too numerous |
8 * to list here. Please refer to the COPYRIGHT file distributed with this | 8 * to list here. Please refer to the COPYRIGHT file distributed with this |
9 * source distribution. | 9 * source distribution. |
10 * | 10 * |
11 * This program is free software; you can redistribute it and/or modify | 11 * This program is free software; you can redistribute it and/or modify |
12 * it under the terms of the GNU General Public License as published by | 12 * it under the terms of the GNU General Public License as published by |
20 * | 20 * |
21 * You should have received a copy of the GNU General Public License | 21 * You should have received a copy of the GNU General Public License |
22 * along with this program; if not, write to the Free Software | 22 * along with this program; if not, write to the Free Software |
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | 23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
24 */ | 24 */ |
25 #ifndef _GAIM_VALUE_H_ | 25 #ifndef _PURPLE_VALUE_H_ |
26 #define _GAIM_VALUE_H_ | 26 #define _PURPLE_VALUE_H_ |
27 | 27 |
28 #include <glib.h> | 28 #include <glib.h> |
29 | 29 |
30 /** | 30 /** |
31 * Specific value types. | 31 * Specific value types. |
32 */ | 32 */ |
33 typedef enum | 33 typedef enum |
34 { | 34 { |
35 GAIM_TYPE_UNKNOWN = 0, /**< Unknown type. */ | 35 PURPLE_TYPE_UNKNOWN = 0, /**< Unknown type. */ |
36 GAIM_TYPE_SUBTYPE, /**< Subtype. */ | 36 PURPLE_TYPE_SUBTYPE, /**< Subtype. */ |
37 GAIM_TYPE_CHAR, /**< Character. */ | 37 PURPLE_TYPE_CHAR, /**< Character. */ |
38 GAIM_TYPE_UCHAR, /**< Unsigned character. */ | 38 PURPLE_TYPE_UCHAR, /**< Unsigned character. */ |
39 GAIM_TYPE_BOOLEAN, /**< Boolean. */ | 39 PURPLE_TYPE_BOOLEAN, /**< Boolean. */ |
40 GAIM_TYPE_SHORT, /**< Short integer. */ | 40 PURPLE_TYPE_SHORT, /**< Short integer. */ |
41 GAIM_TYPE_USHORT, /**< Unsigned short integer. */ | 41 PURPLE_TYPE_USHORT, /**< Unsigned short integer. */ |
42 GAIM_TYPE_INT, /**< Integer. */ | 42 PURPLE_TYPE_INT, /**< Integer. */ |
43 GAIM_TYPE_UINT, /**< Unsigned integer. */ | 43 PURPLE_TYPE_UINT, /**< Unsigned integer. */ |
44 GAIM_TYPE_LONG, /**< Long integer. */ | 44 PURPLE_TYPE_LONG, /**< Long integer. */ |
45 GAIM_TYPE_ULONG, /**< Unsigned long integer. */ | 45 PURPLE_TYPE_ULONG, /**< Unsigned long integer. */ |
46 GAIM_TYPE_INT64, /**< 64-bit integer. */ | 46 PURPLE_TYPE_INT64, /**< 64-bit integer. */ |
47 GAIM_TYPE_UINT64, /**< 64-bit unsigned integer. */ | 47 PURPLE_TYPE_UINT64, /**< 64-bit unsigned integer. */ |
48 GAIM_TYPE_STRING, /**< String. */ | 48 PURPLE_TYPE_STRING, /**< String. */ |
49 GAIM_TYPE_OBJECT, /**< Object pointer. */ | 49 PURPLE_TYPE_OBJECT, /**< Object pointer. */ |
50 GAIM_TYPE_POINTER, /**< Generic pointer. */ | 50 PURPLE_TYPE_POINTER, /**< Generic pointer. */ |
51 GAIM_TYPE_ENUM, /**< Enum. */ | 51 PURPLE_TYPE_ENUM, /**< Enum. */ |
52 GAIM_TYPE_BOXED /**< Boxed pointer with specific type. */ | 52 PURPLE_TYPE_BOXED /**< Boxed pointer with specific type. */ |
53 | 53 |
54 } GaimType; | 54 } PurpleType; |
55 | 55 |
56 | 56 |
57 /** | 57 /** |
58 * Gaim-specific subtype values. | 58 * Purple-specific subtype values. |
59 */ | 59 */ |
60 typedef enum | 60 typedef enum |
61 { | 61 { |
62 GAIM_SUBTYPE_UNKNOWN = 0, | 62 PURPLE_SUBTYPE_UNKNOWN = 0, |
63 GAIM_SUBTYPE_ACCOUNT, | 63 PURPLE_SUBTYPE_ACCOUNT, |
64 GAIM_SUBTYPE_BLIST, | 64 PURPLE_SUBTYPE_BLIST, |
65 GAIM_SUBTYPE_BLIST_BUDDY, | 65 PURPLE_SUBTYPE_BLIST_BUDDY, |
66 GAIM_SUBTYPE_BLIST_GROUP, | 66 PURPLE_SUBTYPE_BLIST_GROUP, |
67 GAIM_SUBTYPE_BLIST_CHAT, | 67 PURPLE_SUBTYPE_BLIST_CHAT, |
68 GAIM_SUBTYPE_BUDDY_ICON, | 68 PURPLE_SUBTYPE_BUDDY_ICON, |
69 GAIM_SUBTYPE_CONNECTION, | 69 PURPLE_SUBTYPE_CONNECTION, |
70 GAIM_SUBTYPE_CONVERSATION, | 70 PURPLE_SUBTYPE_CONVERSATION, |
71 GAIM_SUBTYPE_PLUGIN, | 71 PURPLE_SUBTYPE_PLUGIN, |
72 GAIM_SUBTYPE_BLIST_NODE, | 72 PURPLE_SUBTYPE_BLIST_NODE, |
73 GAIM_SUBTYPE_CIPHER, | 73 PURPLE_SUBTYPE_CIPHER, |
74 GAIM_SUBTYPE_STATUS, | 74 PURPLE_SUBTYPE_STATUS, |
75 GAIM_SUBTYPE_LOG, | 75 PURPLE_SUBTYPE_LOG, |
76 GAIM_SUBTYPE_XFER, | 76 PURPLE_SUBTYPE_XFER, |
77 GAIM_SUBTYPE_SAVEDSTATUS, | 77 PURPLE_SUBTYPE_SAVEDSTATUS, |
78 GAIM_SUBTYPE_XMLNODE, | 78 PURPLE_SUBTYPE_XMLNODE, |
79 GAIM_SUBTYPE_USERINFO | 79 PURPLE_SUBTYPE_USERINFO |
80 } GaimSubType; | 80 } PurpleSubType; |
81 | 81 |
82 /** | 82 /** |
83 * A wrapper for a type, subtype, and specific type of value. | 83 * A wrapper for a type, subtype, and specific type of value. |
84 */ | 84 */ |
85 typedef struct | 85 typedef struct |
86 { | 86 { |
87 GaimType type; | 87 PurpleType type; |
88 unsigned short flags; | 88 unsigned short flags; |
89 | 89 |
90 union | 90 union |
91 { | 91 { |
92 char char_data; | 92 char char_data; |
113 unsigned int subtype; | 113 unsigned int subtype; |
114 char *specific_type; | 114 char *specific_type; |
115 | 115 |
116 } u; | 116 } u; |
117 | 117 |
118 } GaimValue; | 118 } PurpleValue; |
119 | 119 |
120 #ifdef __cplusplus | 120 #ifdef __cplusplus |
121 extern "C" { | 121 extern "C" { |
122 #endif | 122 #endif |
123 | 123 |
124 /** | 124 /** |
125 * Creates a new GaimValue. | 125 * Creates a new PurpleValue. |
126 * | 126 * |
127 * This function takes a type and, depending on that type, a sub-type | 127 * This function takes a type and, depending on that type, a sub-type |
128 * or specific type. | 128 * or specific type. |
129 * | 129 * |
130 * If @a type is GAIM_TYPE_BOXED, the next parameter must be a | 130 * If @a type is PURPLE_TYPE_BOXED, the next parameter must be a |
131 * string representing the specific type. | 131 * string representing the specific type. |
132 * | 132 * |
133 * If @a type is GAIM_TYPE_SUBTYPE, the next parameter must be a | 133 * If @a type is PURPLE_TYPE_SUBTYPE, the next parameter must be a |
134 * integer or enum representing the sub-type. | 134 * integer or enum representing the sub-type. |
135 * | 135 * |
136 * If the subtype or specific type is not set when required, random | 136 * If the subtype or specific type is not set when required, random |
137 * errors may occur. You have been warned. | 137 * errors may occur. You have been warned. |
138 * | 138 * |
139 * @param type The type. | 139 * @param type The type. |
140 * | 140 * |
141 * @return The new value. | 141 * @return The new value. |
142 */ | 142 */ |
143 GaimValue *gaim_value_new(GaimType type, ...); | 143 PurpleValue *purple_value_new(PurpleType type, ...); |
144 | 144 |
145 /** | 145 /** |
146 * Creates a new outgoing GaimValue. If a value is an "outgoing" value | 146 * Creates a new outgoing PurpleValue. If a value is an "outgoing" value |
147 * it means the value can be modified by plugins and scripts. | 147 * it means the value can be modified by plugins and scripts. |
148 * | 148 * |
149 * This function takes a type and, depending on that type, a sub-type | 149 * This function takes a type and, depending on that type, a sub-type |
150 * or specific type. | 150 * or specific type. |
151 * | 151 * |
152 * If @a type is GAIM_TYPE_BOXED, the next parameter must be a | 152 * If @a type is PURPLE_TYPE_BOXED, the next parameter must be a |
153 * string representing the specific type. | 153 * string representing the specific type. |
154 * | 154 * |
155 * If @a type is GAIM_TYPE_SUBTYPE, the next parameter must be a | 155 * If @a type is PURPLE_TYPE_SUBTYPE, the next parameter must be a |
156 * integer or enum representing the sub-type. | 156 * integer or enum representing the sub-type. |
157 * | 157 * |
158 * If the sub-type or specific type is not set when required, random | 158 * If the sub-type or specific type is not set when required, random |
159 * errors may occur. You have been warned. | 159 * errors may occur. You have been warned. |
160 * | 160 * |
161 * @param type The type. | 161 * @param type The type. |
162 * | 162 * |
163 * @return The new value. | 163 * @return The new value. |
164 */ | 164 */ |
165 GaimValue *gaim_value_new_outgoing(GaimType type, ...); | 165 PurpleValue *purple_value_new_outgoing(PurpleType type, ...); |
166 | 166 |
167 /** | 167 /** |
168 * Destroys a GaimValue. | 168 * Destroys a PurpleValue. |
169 * | 169 * |
170 * @param value The value to destroy. | 170 * @param value The value to destroy. |
171 */ | 171 */ |
172 void gaim_value_destroy(GaimValue *value); | 172 void purple_value_destroy(PurpleValue *value); |
173 | 173 |
174 /** | 174 /** |
175 * Duplicated a GaimValue. | 175 * Duplicated a PurpleValue. |
176 * | 176 * |
177 * @param value The value to duplicate. | 177 * @param value The value to duplicate. |
178 * | 178 * |
179 * @return The duplicate value. | 179 * @return The duplicate value. |
180 */ | 180 */ |
181 GaimValue *gaim_value_dup(const GaimValue *value); | 181 PurpleValue *purple_value_dup(const PurpleValue *value); |
182 | 182 |
183 /** | 183 /** |
184 * Returns a value's type. | 184 * Returns a value's type. |
185 * | 185 * |
186 * @param value The value whose type you want. | 186 * @param value The value whose type you want. |
187 * | 187 * |
188 * @return The value's type. | 188 * @return The value's type. |
189 */ | 189 */ |
190 GaimType gaim_value_get_type(const GaimValue *value); | 190 PurpleType purple_value_get_type(const PurpleValue *value); |
191 | 191 |
192 /** | 192 /** |
193 * Returns a value's subtype. | 193 * Returns a value's subtype. |
194 * | 194 * |
195 * If the value's type is not GAIM_TYPE_SUBTYPE, this will return 0. | 195 * If the value's type is not PURPLE_TYPE_SUBTYPE, this will return 0. |
196 * Subtypes should never have a subtype of 0. | 196 * Subtypes should never have a subtype of 0. |
197 * | 197 * |
198 * @param value The value whose subtype you want. | 198 * @param value The value whose subtype you want. |
199 * | 199 * |
200 * @return The value's subtype, or 0 if @a type is not GAIM_TYPE_SUBTYPE. | 200 * @return The value's subtype, or 0 if @a type is not PURPLE_TYPE_SUBTYPE. |
201 */ | 201 */ |
202 unsigned int gaim_value_get_subtype(const GaimValue *value); | 202 unsigned int purple_value_get_subtype(const PurpleValue *value); |
203 | 203 |
204 /** | 204 /** |
205 * Returns a value's specific type. | 205 * Returns a value's specific type. |
206 * | 206 * |
207 * If the value's type is not GAIM_TYPE_BOXED, this will return @c NULL. | 207 * If the value's type is not PURPLE_TYPE_BOXED, this will return @c NULL. |
208 * | 208 * |
209 * @param value The value whose specific type you want. | 209 * @param value The value whose specific type you want. |
210 * | 210 * |
211 * @return The value's specific type, or @a NULL if not GAIM_TYPE_BOXED. | 211 * @return The value's specific type, or @a NULL if not PURPLE_TYPE_BOXED. |
212 */ | 212 */ |
213 const char *gaim_value_get_specific_type(const GaimValue *value); | 213 const char *purple_value_get_specific_type(const PurpleValue *value); |
214 | 214 |
215 /** | 215 /** |
216 * Returns whether or not the value is an outgoing value. | 216 * Returns whether or not the value is an outgoing value. |
217 * | 217 * |
218 * @param value The value. | 218 * @param value The value. |
219 * | 219 * |
220 * @return TRUE if the value is outgoing, or FALSE otherwise. | 220 * @return TRUE if the value is outgoing, or FALSE otherwise. |
221 */ | 221 */ |
222 gboolean gaim_value_is_outgoing(const GaimValue *value); | 222 gboolean purple_value_is_outgoing(const PurpleValue *value); |
223 | 223 |
224 /** | 224 /** |
225 * Sets the value's character data. | 225 * Sets the value's character data. |
226 * | 226 * |
227 * @param value The value. | 227 * @param value The value. |
228 * @param data The character data. | 228 * @param data The character data. |
229 */ | 229 */ |
230 void gaim_value_set_char(GaimValue *value, char data); | 230 void purple_value_set_char(PurpleValue *value, char data); |
231 | 231 |
232 /** | 232 /** |
233 * Sets the value's unsigned character data. | 233 * Sets the value's unsigned character data. |
234 * | 234 * |
235 * @param value The value. | 235 * @param value The value. |
236 * @param data The unsigned character data. | 236 * @param data The unsigned character data. |
237 */ | 237 */ |
238 void gaim_value_set_uchar(GaimValue *value, unsigned char data); | 238 void purple_value_set_uchar(PurpleValue *value, unsigned char data); |
239 | 239 |
240 /** | 240 /** |
241 * Sets the value's boolean data. | 241 * Sets the value's boolean data. |
242 * | 242 * |
243 * @param value The value. | 243 * @param value The value. |
244 * @param data The boolean data. | 244 * @param data The boolean data. |
245 */ | 245 */ |
246 void gaim_value_set_boolean(GaimValue *value, gboolean data); | 246 void purple_value_set_boolean(PurpleValue *value, gboolean data); |
247 | 247 |
248 /** | 248 /** |
249 * Sets the value's short integer data. | 249 * Sets the value's short integer data. |
250 * | 250 * |
251 * @param value The value. | 251 * @param value The value. |
252 * @param data The short integer data. | 252 * @param data The short integer data. |
253 */ | 253 */ |
254 void gaim_value_set_short(GaimValue *value, short data); | 254 void purple_value_set_short(PurpleValue *value, short data); |
255 | 255 |
256 /** | 256 /** |
257 * Sets the value's unsigned short integer data. | 257 * Sets the value's unsigned short integer data. |
258 * | 258 * |
259 * @param value The value. | 259 * @param value The value. |
260 * @param data The unsigned short integer data. | 260 * @param data The unsigned short integer data. |
261 */ | 261 */ |
262 void gaim_value_set_ushort(GaimValue *value, unsigned short data); | 262 void purple_value_set_ushort(PurpleValue *value, unsigned short data); |
263 | 263 |
264 /** | 264 /** |
265 * Sets the value's integer data. | 265 * Sets the value's integer data. |
266 * | 266 * |
267 * @param value The value. | 267 * @param value The value. |
268 * @param data The integer data. | 268 * @param data The integer data. |
269 */ | 269 */ |
270 void gaim_value_set_int(GaimValue *value, int data); | 270 void purple_value_set_int(PurpleValue *value, int data); |
271 | 271 |
272 /** | 272 /** |
273 * Sets the value's unsigned integer data. | 273 * Sets the value's unsigned integer data. |
274 * | 274 * |
275 * @param value The value. | 275 * @param value The value. |
276 * @param data The unsigned integer data. | 276 * @param data The unsigned integer data. |
277 */ | 277 */ |
278 void gaim_value_set_uint(GaimValue *value, unsigned int data); | 278 void purple_value_set_uint(PurpleValue *value, unsigned int data); |
279 | 279 |
280 /** | 280 /** |
281 * Sets the value's long integer data. | 281 * Sets the value's long integer data. |
282 * | 282 * |
283 * @param value The value. | 283 * @param value The value. |
284 * @param data The long integer data. | 284 * @param data The long integer data. |
285 */ | 285 */ |
286 void gaim_value_set_long(GaimValue *value, long data); | 286 void purple_value_set_long(PurpleValue *value, long data); |
287 | 287 |
288 /** | 288 /** |
289 * Sets the value's unsigned long integer data. | 289 * Sets the value's unsigned long integer data. |
290 * | 290 * |
291 * @param value The value. | 291 * @param value The value. |
292 * @param data The unsigned long integer data. | 292 * @param data The unsigned long integer data. |
293 */ | 293 */ |
294 void gaim_value_set_ulong(GaimValue *value, unsigned long data); | 294 void purple_value_set_ulong(PurpleValue *value, unsigned long data); |
295 | 295 |
296 /** | 296 /** |
297 * Sets the value's 64-bit integer data. | 297 * Sets the value's 64-bit integer data. |
298 * | 298 * |
299 * @param value The value. | 299 * @param value The value. |
300 * @param data The 64-bit integer data. | 300 * @param data The 64-bit integer data. |
301 */ | 301 */ |
302 void gaim_value_set_int64(GaimValue *value, gint64 data); | 302 void purple_value_set_int64(PurpleValue *value, gint64 data); |
303 | 303 |
304 /** | 304 /** |
305 * Sets the value's unsigned 64-bit integer data. | 305 * Sets the value's unsigned 64-bit integer data. |
306 * | 306 * |
307 * @param value The value. | 307 * @param value The value. |
308 * @param data The unsigned 64-bit integer data. | 308 * @param data The unsigned 64-bit integer data. |
309 */ | 309 */ |
310 void gaim_value_set_uint64(GaimValue *value, guint64 data); | 310 void purple_value_set_uint64(PurpleValue *value, guint64 data); |
311 | 311 |
312 /** | 312 /** |
313 * Sets the value's string data. | 313 * Sets the value's string data. |
314 * | 314 * |
315 * @param value The value. | 315 * @param value The value. |
316 * @param data The string data. | 316 * @param data The string data. |
317 */ | 317 */ |
318 void gaim_value_set_string(GaimValue *value, const char *data); | 318 void purple_value_set_string(PurpleValue *value, const char *data); |
319 | 319 |
320 /** | 320 /** |
321 * Sets the value's object data. | 321 * Sets the value's object data. |
322 * | 322 * |
323 * @param value The value. | 323 * @param value The value. |
324 * @param data The object data. | 324 * @param data The object data. |
325 */ | 325 */ |
326 void gaim_value_set_object(GaimValue *value, void *data); | 326 void purple_value_set_object(PurpleValue *value, void *data); |
327 | 327 |
328 /** | 328 /** |
329 * Sets the value's pointer data. | 329 * Sets the value's pointer data. |
330 * | 330 * |
331 * @param value The value. | 331 * @param value The value. |
332 * @param data The pointer data. | 332 * @param data The pointer data. |
333 */ | 333 */ |
334 void gaim_value_set_pointer(GaimValue *value, void *data); | 334 void purple_value_set_pointer(PurpleValue *value, void *data); |
335 | 335 |
336 /** | 336 /** |
337 * Sets the value's enum data. | 337 * Sets the value's enum data. |
338 * | 338 * |
339 * @param value The value. | 339 * @param value The value. |
340 * @param data The enum data. | 340 * @param data The enum data. |
341 */ | 341 */ |
342 void gaim_value_set_enum(GaimValue *value, int data); | 342 void purple_value_set_enum(PurpleValue *value, int data); |
343 | 343 |
344 /** | 344 /** |
345 * Sets the value's boxed data. | 345 * Sets the value's boxed data. |
346 * | 346 * |
347 * @param value The value. | 347 * @param value The value. |
348 * @param data The boxed data. | 348 * @param data The boxed data. |
349 */ | 349 */ |
350 void gaim_value_set_boxed(GaimValue *value, void *data); | 350 void purple_value_set_boxed(PurpleValue *value, void *data); |
351 | 351 |
352 /** | 352 /** |
353 * Returns the value's character data. | 353 * Returns the value's character data. |
354 * | 354 * |
355 * @param value The value. | 355 * @param value The value. |
356 * | 356 * |
357 * @return The character data. | 357 * @return The character data. |
358 */ | 358 */ |
359 char gaim_value_get_char(const GaimValue *value); | 359 char purple_value_get_char(const PurpleValue *value); |
360 | 360 |
361 /** | 361 /** |
362 * Returns the value's unsigned character data. | 362 * Returns the value's unsigned character data. |
363 * | 363 * |
364 * @param value The value. | 364 * @param value The value. |
365 * | 365 * |
366 * @return The unsigned character data. | 366 * @return The unsigned character data. |
367 */ | 367 */ |
368 unsigned char gaim_value_get_uchar(const GaimValue *value); | 368 unsigned char purple_value_get_uchar(const PurpleValue *value); |
369 | 369 |
370 /** | 370 /** |
371 * Returns the value's boolean data. | 371 * Returns the value's boolean data. |
372 * | 372 * |
373 * @param value The value. | 373 * @param value The value. |
374 * | 374 * |
375 * @return The boolean data. | 375 * @return The boolean data. |
376 */ | 376 */ |
377 gboolean gaim_value_get_boolean(const GaimValue *value); | 377 gboolean purple_value_get_boolean(const PurpleValue *value); |
378 | 378 |
379 /** | 379 /** |
380 * Returns the value's short integer data. | 380 * Returns the value's short integer data. |
381 * | 381 * |
382 * @param value The value. | 382 * @param value The value. |
383 * | 383 * |
384 * @return The short integer data. | 384 * @return The short integer data. |
385 */ | 385 */ |
386 short gaim_value_get_short(const GaimValue *value); | 386 short purple_value_get_short(const PurpleValue *value); |
387 | 387 |
388 /** | 388 /** |
389 * Returns the value's unsigned short integer data. | 389 * Returns the value's unsigned short integer data. |
390 * | 390 * |
391 * @param value The value. | 391 * @param value The value. |
392 * | 392 * |
393 * @return The unsigned short integer data. | 393 * @return The unsigned short integer data. |
394 */ | 394 */ |
395 unsigned short gaim_value_get_ushort(const GaimValue *value); | 395 unsigned short purple_value_get_ushort(const PurpleValue *value); |
396 | 396 |
397 /** | 397 /** |
398 * Returns the value's integer data. | 398 * Returns the value's integer data. |
399 * | 399 * |
400 * @param value The value. | 400 * @param value The value. |
401 * | 401 * |
402 * @return The integer data. | 402 * @return The integer data. |
403 */ | 403 */ |
404 int gaim_value_get_int(const GaimValue *value); | 404 int purple_value_get_int(const PurpleValue *value); |
405 | 405 |
406 /** | 406 /** |
407 * Returns the value's unsigned integer data. | 407 * Returns the value's unsigned integer data. |
408 * | 408 * |
409 * @param value The value. | 409 * @param value The value. |
410 * | 410 * |
411 * @return The unsigned integer data. | 411 * @return The unsigned integer data. |
412 */ | 412 */ |
413 unsigned int gaim_value_get_uint(const GaimValue *value); | 413 unsigned int purple_value_get_uint(const PurpleValue *value); |
414 | 414 |
415 /** | 415 /** |
416 * Returns the value's long integer data. | 416 * Returns the value's long integer data. |
417 * | 417 * |
418 * @param value The value. | 418 * @param value The value. |
419 * | 419 * |
420 * @return The long integer data. | 420 * @return The long integer data. |
421 */ | 421 */ |
422 long gaim_value_get_long(const GaimValue *value); | 422 long purple_value_get_long(const PurpleValue *value); |
423 | 423 |
424 /** | 424 /** |
425 * Returns the value's unsigned long integer data. | 425 * Returns the value's unsigned long integer data. |
426 * | 426 * |
427 * @param value The value. | 427 * @param value The value. |
428 * | 428 * |
429 * @return The unsigned long integer data. | 429 * @return The unsigned long integer data. |
430 */ | 430 */ |
431 unsigned long gaim_value_get_ulong(const GaimValue *value); | 431 unsigned long purple_value_get_ulong(const PurpleValue *value); |
432 | 432 |
433 /** | 433 /** |
434 * Returns the value's 64-bit integer data. | 434 * Returns the value's 64-bit integer data. |
435 * | 435 * |
436 * @param value The value. | 436 * @param value The value. |
437 * | 437 * |
438 * @return The 64-bit integer data. | 438 * @return The 64-bit integer data. |
439 */ | 439 */ |
440 gint64 gaim_value_get_int64(const GaimValue *value); | 440 gint64 purple_value_get_int64(const PurpleValue *value); |
441 | 441 |
442 /** | 442 /** |
443 * Returns the value's unsigned 64-bit integer data. | 443 * Returns the value's unsigned 64-bit integer data. |
444 * | 444 * |
445 * @param value The value. | 445 * @param value The value. |
446 * | 446 * |
447 * @return The unsigned 64-bit integer data. | 447 * @return The unsigned 64-bit integer data. |
448 */ | 448 */ |
449 guint64 gaim_value_get_uint64(const GaimValue *value); | 449 guint64 purple_value_get_uint64(const PurpleValue *value); |
450 | 450 |
451 /** | 451 /** |
452 * Returns the value's string data. | 452 * Returns the value's string data. |
453 * | 453 * |
454 * @param value The value. | 454 * @param value The value. |
455 * | 455 * |
456 * @return The string data. | 456 * @return The string data. |
457 */ | 457 */ |
458 const char *gaim_value_get_string(const GaimValue *value); | 458 const char *purple_value_get_string(const PurpleValue *value); |
459 | 459 |
460 /** | 460 /** |
461 * Returns the value's object data. | 461 * Returns the value's object data. |
462 * | 462 * |
463 * @param value The value. | 463 * @param value The value. |
464 * | 464 * |
465 * @return The object data. | 465 * @return The object data. |
466 */ | 466 */ |
467 void *gaim_value_get_object(const GaimValue *value); | 467 void *purple_value_get_object(const PurpleValue *value); |
468 | 468 |
469 /** | 469 /** |
470 * Returns the value's pointer data. | 470 * Returns the value's pointer data. |
471 * | 471 * |
472 * @param value The value. | 472 * @param value The value. |
473 * | 473 * |
474 * @return The pointer data. | 474 * @return The pointer data. |
475 */ | 475 */ |
476 void *gaim_value_get_pointer(const GaimValue *value); | 476 void *purple_value_get_pointer(const PurpleValue *value); |
477 | 477 |
478 /** | 478 /** |
479 * Returns the value's enum data. | 479 * Returns the value's enum data. |
480 * | 480 * |
481 * @param value The value. | 481 * @param value The value. |
482 * | 482 * |
483 * @return The enum data. | 483 * @return The enum data. |
484 */ | 484 */ |
485 int gaim_value_get_enum(const GaimValue *value); | 485 int purple_value_get_enum(const PurpleValue *value); |
486 | 486 |
487 /** | 487 /** |
488 * Returns the value's boxed data. | 488 * Returns the value's boxed data. |
489 * | 489 * |
490 * @param value The value. | 490 * @param value The value. |
491 * | 491 * |
492 * @return The boxed data. | 492 * @return The boxed data. |
493 */ | 493 */ |
494 void *gaim_value_get_boxed(const GaimValue *value); | 494 void *purple_value_get_boxed(const PurpleValue *value); |
495 | 495 |
496 #ifdef __cplusplus | 496 #ifdef __cplusplus |
497 } | 497 } |
498 #endif | 498 #endif |
499 | 499 |
500 #endif /* _GAIM_VALUE_H_ */ | 500 #endif /* _PURPLE_VALUE_H_ */ |