~drizzle-trunk/libdrizzle/jenkins-Libdrizzle-78

« back to all changes in this revision

Viewing changes to libdrizzle/conn_local.h

  • Committer: Andrew Hutchings
  • Date: 2012-09-03 18:38:34 UTC
  • Revision ID: git-v1:e936672f2f2e4af2b54de08ebf06d53ca1dc6872
The "it compiles!" version

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
 
2
 *
 
3
 * Drizzle Client & Protocol Library
 
4
 *
 
5
 * Copyright (C) 2008 Eric Day (eday@oddments.org)
 
6
 * All rights reserved.
 
7
 *
 
8
 * Redistribution and use in source and binary forms, with or without
 
9
 * modification, are permitted provided that the following conditions are
 
10
 * met:
 
11
 *
 
12
 *     * Redistributions of source code must retain the above copyright
 
13
 * notice, this list of conditions and the following disclaimer.
 
14
 *
 
15
 *     * Redistributions in binary form must reproduce the above
 
16
 * copyright notice, this list of conditions and the following disclaimer
 
17
 * in the documentation and/or other materials provided with the
 
18
 * distribution.
 
19
 *
 
20
 *     * The names of its contributors may not be used to endorse or
 
21
 * promote products derived from this software without specific prior
 
22
 * written permission.
 
23
 *
 
24
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 
25
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 
26
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 
27
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 
28
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 
29
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 
30
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 
31
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 
32
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 
33
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 
34
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
35
 *
 
36
 */
 
37
 
 
38
#pragma once
 
39
 
 
40
/**
 
41
 * @file
 
42
 * @brief Local Connection Declarations
 
43
 */
 
44
 
 
45
#ifdef __cplusplus
 
46
extern "C" {
 
47
#endif
 
48
 
 
49
/**
 
50
 * @addtogroup drizzle_con_local Local Connection Declarations
 
51
 * @ingroup drizzle_con
 
52
 * @{
 
53
 */
 
54
 
 
55
/**
 
56
 * Clear address info, freeing structs if needed.
 
57
 *
 
58
 * @param[in] con Connection structure previously initialized with
 
59
 *  drizzle_con_create(), drizzle_con_clone(), or related functions.
 
60
 */
 
61
DRIZZLE_LOCAL
 
62
void drizzle_con_reset_addrinfo(drizzle_con_st *con);
 
63
 
 
64
/**
 
65
 * Check if state stack is empty.
 
66
 *
 
67
 * @param[in] con Connection structure previously initialized with
 
68
 *  drizzle_con_create(), drizzle_con_clone(), or related functions.
 
69
 * @return True if empty, false if something is on the stack.
 
70
 */
 
71
static inline bool drizzle_state_none(drizzle_con_st *con)
 
72
{
 
73
  if (con == NULL)
 
74
  {
 
75
    return false;
 
76
  }
 
77
 
 
78
  return con->state_current == 0;
 
79
}
 
80
 
 
81
/**
 
82
 * Push a function onto the stack.
 
83
 *
 
84
 * @param[in] con Connection structure previously initialized with
 
85
 *  drizzle_con_create(), drizzle_con_clone(), or related functions.
 
86
 * @param[in] function Function to push.
 
87
 */
 
88
static inline void drizzle_state_push(drizzle_con_st *con,
 
89
                                      drizzle_state_fn *function)
 
90
{
 
91
  /* The maximum stack depth can be determined at compile time, so bump this
 
92
     constant if needed to avoid the dynamic memory management. */
 
93
  assert(con->state_current < DRIZZLE_STATE_STACK_SIZE);
 
94
  con->state_stack[con->state_current]= function;
 
95
  con->state_current++;
 
96
}
 
97
 
 
98
/**
 
99
 * Pop a function off of the stack.
 
100
 *
 
101
 * @param[in] con Connection structure previously initialized with
 
102
 *  drizzle_con_create(), drizzle_con_clone(), or related functions.
 
103
 */
 
104
static inline void drizzle_state_pop(drizzle_con_st *con)
 
105
{
 
106
  con->state_current--;
 
107
}
 
108
 
 
109
/**
 
110
 * Reset the stack so it is empty.
 
111
 *
 
112
 * @param[in] con Connection structure previously initialized with
 
113
 *  drizzle_con_create(), drizzle_con_clone(), or related functions.
 
114
 */
 
115
static inline void drizzle_state_reset(drizzle_con_st *con)
 
116
{
 
117
  con->state_current= 0;
 
118
}
 
119
 
 
120
/** @} */
 
121
 
 
122
#ifdef __cplusplus
 
123
}
 
124
#endif