- Documentation Library
- Table of Contents
- MySQL 5.0 Manual
- Table of Contents
- 24.2.7 Descripciones de funciones de sentencias preparadas de la API C
- 24.2.7.1 mysql_stmt_affected_rows()
- 24.2.7.2 mysql_stmt_attr_get()
- 24.2.7.3 mysql_stmt_attr_set()
- 24.2.7.4 mysql_stmt_bind_param()
- 24.2.7.5 mysql_stmt_bind_result()
- 24.2.7.6 mysql_stmt_close()
- 24.2.7.7 mysql_stmt_data_seek()
- 24.2.7.8 mysql_stmt_errno()
- 24.2.7.9 mysql_stmt_error()
- 24.2.7.10 mysql_stmt_execute()
- 24.2.7.11 mysql_stmt_free_result()
- 24.2.7.12 mysql_stmt_insert_id()
- 24.2.7.13 mysql_stmt_fetch()
- 24.2.7.14 mysql_stmt_fetch_column()
- 24.2.7.15 mysql_stmt_field_count()
- 24.2.7.16 mysql_stmt_init()
- 24.2.7.17 mysql_stmt_num_rows()
- 24.2.7.18 mysql_stmt_param_count()
- 24.2.7.19 mysql_stmt_param_metadata()
- 24.2.7.20 mysql_stmt_prepare()
- 24.2.7.21 mysql_stmt_reset()
- 24.2.7.22 mysql_stmt_result_metadata()
- 24.2.7.23 mysql_stmt_row_seek()
- 24.2.7.24 mysql_stmt_row_tell()
- 24.2.7.25 mysql_stmt_send_long_data()
- 24.2.7.26 mysql_stmt_sqlstate()
- 24.2.7.27 mysql_stmt_store_result()
int mysql_stmt_prepare(MYSQL_STMT *stmt, const char
*query, unsigned long length)
Description
Given the statement handle returned by
mysql_stmt_init(), prepares the SQL
statement pointed to by the string query
and returns a status value. The string length should be given
by the length argument. The string must
consist of a single SQL statement. You should not add a
terminating semicolon (';') or
\g to the statement.
The application can include one or more parameter markers in
the SQL statement by embedding question mark
('?') characters into the SQL string at the
appropriate positions.
The markers are legal only in certain places in SQL
statements. For example, they are allowed in the
VALUES() list of an
INSERT statement (to specify column values
for a row), or in a comparison with a column in a
WHERE clause to specify a comparison value.
However, they are not allowed for identifiers (such as table
or column names), or to specify both operands of a binary
operator such as the = equal sign. The
latter restriction is necessary because it would be impossible
to determine the parameter type. In general, parameters are
legal only in Data Manipulation Language (DML) statements, and
not in Data Definition Language (DDL) statements.
The parameter markers must be bound to application variables
using mysql_stmt_bind_param() before
executing the statement.
This function was added in MySQL 4.1.2.
Return Values
Zero if the statement was prepared successfully. Non-zero if an error occurred.
Errors
-
CR_COMMANDS_OUT_OF_SYNCCommands were executed in an improper order.
-
CR_OUT_OF_MEMORYOut of memory.
-
CR_SERVER_GONE_ERRORThe MySQL server has gone away.
-
CR_SERVER_LOSTThe connection to the server was lost during the query
-
CR_UNKNOWN_ERRORAn unknown error occurred.
If the prepare operation was unsuccessful (that is,
mysql_stmt_prepare() returns non-zero), the
error message can be obtained by calling
mysql_stmt_error().
Example
For the usage of mysql_stmt_prepare(),
refer to the Example from
Sección 24.2.7.10, “mysql_stmt_execute()”.
Ésta es una traducción del manual de referencia de MySQL, que puede encontrarse en dev.mysql.com. El manual de referencia original de MySQL está escrito en inglés, y esta traducción no necesariamente está tan actualizada como la versión original. Para cualquier sugerencia sobre la traducción y para señalar errores de cualquier tipo, no dude en dirigirse a mysql-es@vespito.com.
