Merge in more updates for docs (we are just going to check them all in so that users...
[m6w6/libmemcached] / libmemcached / types.h
1 /* LibMemcached
2 * Copyright (C) 2006-2009 Brian Aker
3 * All rights reserved.
4 *
5 * Use and distribution licensed under the BSD license. See
6 * the COPYING file in the parent directory for full text.
7 *
8 * Summary: Types for libmemcached
9 *
10 */
11
12 #ifndef __LIBMEMCACHED_TYPES_H__
13 #define __LIBMEMCACHED_TYPES_H__
14
15 typedef struct memcached_st memcached_st;
16 typedef struct memcached_stat_st memcached_stat_st;
17 typedef struct memcached_analysis_st memcached_analysis_st;
18 typedef struct memcached_result_st memcached_result_st;
19 typedef struct memcached_array_st memcached_array_st;
20 typedef struct memcached_error_t memcached_error_t;
21
22 // All of the flavors of memcache_server_st
23 typedef struct memcached_server_st memcached_server_st;
24 typedef const struct memcached_server_st *memcached_server_instance_st;
25 typedef struct memcached_server_st *memcached_server_list_st;
26
27 typedef struct memcached_callback_st memcached_callback_st;
28
29 // The following two structures are internal, and never exposed to users.
30 typedef struct memcached_string_st memcached_string_st;
31 typedef struct memcached_string_t memcached_string_t;
32 typedef struct memcached_continuum_item_st memcached_continuum_item_st;
33
34
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38
39 typedef memcached_return_t (*memcached_clone_fn)(memcached_st *destination, const memcached_st *source);
40 typedef memcached_return_t (*memcached_cleanup_fn)(const memcached_st *ptr);
41
42 /**
43 Memory allocation functions.
44 */
45 typedef void (*memcached_free_fn)(const memcached_st *ptr, void *mem, void *context);
46 typedef void *(*memcached_malloc_fn)(const memcached_st *ptr, const size_t size, void *context);
47 typedef void *(*memcached_realloc_fn)(const memcached_st *ptr, void *mem, const size_t size, void *context);
48 typedef void *(*memcached_calloc_fn)(const memcached_st *ptr, size_t nelem, const size_t elsize, void *context);
49
50
51 typedef memcached_return_t (*memcached_execute_fn)(const memcached_st *ptr, memcached_result_st *result, void *context);
52 typedef memcached_return_t (*memcached_server_fn)(const memcached_st *ptr, memcached_server_instance_st server, void *context);
53 typedef memcached_return_t (*memcached_stat_fn)(memcached_server_instance_st server,
54 const char *key, size_t key_length,
55 const char *value, size_t value_length,
56 void *context);
57
58 /**
59 Trigger functions.
60 */
61 typedef memcached_return_t (*memcached_trigger_key_fn)(const memcached_st *ptr,
62 const char *key, size_t key_length,
63 memcached_result_st *result);
64 typedef memcached_return_t (*memcached_trigger_delete_key_fn)(const memcached_st *ptr,
65 const char *key, size_t key_length);
66
67 typedef memcached_return_t (*memcached_dump_fn)(const memcached_st *ptr,
68 const char *key,
69 size_t key_length,
70 void *context);
71
72 #ifdef __cplusplus
73 }
74 #endif
75
76 /**
77 @note The following definitions are just here for backwards compatibility.
78 */
79 typedef memcached_return_t memcached_return;
80 typedef memcached_server_distribution_t memcached_server_distribution;
81 typedef memcached_behavior_t memcached_behavior;
82 typedef memcached_callback_t memcached_callback;
83 typedef memcached_hash_t memcached_hash;
84 typedef memcached_connection_t memcached_connection;
85 typedef memcached_clone_fn memcached_clone_func;
86 typedef memcached_cleanup_fn memcached_cleanup_func;
87 typedef memcached_execute_fn memcached_execute_function;
88 typedef memcached_server_fn memcached_server_function;
89 typedef memcached_trigger_key_fn memcached_trigger_key;
90 typedef memcached_trigger_delete_key_fn memcached_trigger_delete_key;
91 typedef memcached_dump_fn memcached_dump_func;
92
93 #endif /* __LIBMEMCACHED_TYPES_H__ */