iframe-proxy | Sunbelt Computer Software

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

This program is free software; you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation; version 2 of the License.

This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License

along with this program; if not, write to the Free Software

Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */

/* Functions to create an item. Used by sql/sql_yacc.yy */

#ifndef ITEM_CREATE_H

#define ITEM_CREATE_H

typedef struct st_udf_func udf_func;

/**

Public function builder interface.

The parser (sql/sql_yacc.yy) uses a factory / builder pattern to

construct an <code>Item</code> object for each function call.

All the concrete function builders implements this interface,

either directly or indirectly with some adapter helpers.

Keeping the function creation separated from the bison grammar allows

to simplify the parser, and avoid the need to introduce a new token

for each function, which has undesirable side effects in the grammar.

class Create_func

{

public:

/**

The builder create method.

Given the function name and list or arguments, this method creates

an <code>Item</code> that represents the function call.

In case or errors, a NULL item is returned, and an error is reported.

Note that the <code>thd</code> object may be modified by the builder.

In particular, the following members/methods can be set/called,

depending on the function called and the function possible side effects.

<ul>

<li><code>thd->lex->binlog_row_based_if_mixed</code></li>

<li><code>thd->lex->current_context()</code></li>

<li><code>thd->lex->safe_to_cache_query</code></li>

<li><code>thd->lex->uncacheable(UNCACHEABLE_SIDEEFFECT)</code></li>

<li><code>thd->lex->uncacheable(UNCACHEABLE_RAND)</code></li>

<li><code>thd->lex->add_time_zone_tables_to_query_tables(thd)</code></li>

</ul>

@param thd The current thread

@param name The function name

@param item_list The list of arguments to the function, can be NULL

@return An item representing the parsed function call, or NULL

virtual Item *create_func(THD *thd, LEX_STRING name, List<Item> *item_list) = 0;

protected:

/** Constructor */

Create_func() {}

/** Destructor */

virtual ~Create_func() {}

};

/**

Function builder for qualified functions.

This builder is used with functions call using a qualified function name

syntax, as in <code>db.func(expr, expr, ...)</code>.

class Create_qfunc : public Create_func

{

public:

/**

The builder create method, for unqualified functions.

This builder will use the current database for the database name.

@param thd The current thread

@param name The function name

@param item_list The list of arguments to the function, can be NULL

@return An item representing the parsed function call

virtual Item *create_func(THD *thd, LEX_STRING name, List<Item> *item_list);

/**

The builder create method, for qualified functions.

@param thd The current thread

@param db The database name

@param name The function name

@param use_explicit_name Should the function be represented as 'db.name'?

@param item_list The list of arguments to the function, can be NULL

@return An item representing the parsed function call

virtual Item* create(THD *thd, LEX_STRING db, LEX_STRING name,

bool use_explicit_name, List<Item> *item_list) = 0;

protected:

/** Constructor. */

Create_qfunc() {}

/** Destructor. */

virtual ~Create_qfunc() {}

};

/**

Find the native function builder associated with a given function name.

@param thd The current thread

@param name The native function name

@return The native function builder associated with the name, or NULL

extern Create_func * find_native_function_builder(THD *thd, LEX_STRING name);

/**

Find the function builder for qualified functions.

@param thd The current thread

@return A function builder for qualified functions

extern Create_qfunc * find_qualified_function_builder(THD *thd);

#ifdef HAVE_DLOPEN

/**

Function builder for User Defined Functions.

class Create_udf_func : public Create_func

{

public:

virtual Item *create_func(THD *thd, LEX_STRING name, List<Item> *item_list);

/**

The builder create method, for User Defined Functions.

@param thd The current thread

@param fct The User Defined Function metadata

@param item_list The list of arguments to the function, can be NULL

@return An item representing the parsed function call

Item *create(THD *thd, udf_func *fct, List<Item> *item_list);

/** Singleton. */

static Create_udf_func s_singleton;

protected:

/** Constructor. */

Create_udf_func() {}

/** Destructor. */

virtual ~Create_udf_func() {}

};

#endif

/**

Builder for cast expressions.

@param thd The current thread

@param a The item to cast

@param cast_type the type casted into

@param len TODO

@param dec TODO

@param cs The character set

Item *

create_func_cast(THD *thd, Item *a, Cast_target cast_type,

const char *len, const char *dec,

const CHARSET_INFO *cs);

Item *create_temporal_literal(THD *thd,

const char *str, uint length,

const CHARSET_INFO *cs,

enum_field_types type, bool send_error);

int item_create_init();

void item_create_cleanup();

#endif

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Repository navigation

item_create.h

item_create.h

Sunbelt Computer Software

PL/B Language Development and Support

FilesExpand file tree

item_create.h

Latest commit

History

item_create.h

File metadata and controls