Note: Some incompatible changes were made in MySQL 4.1.2. See Sección 24.2.7, “Descripciones de funciones de sentencias preparadas de la API C” for details.
Prepared statements mainly use the
MYSQL_BIND data structures. A third
MYSQL_TIME, is used to transfer
This structure represents a prepared statement. A statement
is created by calling
which returns a statement handle, that is, a pointer to a
MYSQL_STMT. The handle is used for all
subsequent statement-related functions until you close it
MYSQL_STMT structure has no members
that are for application use. Also, you should not try to
make a copy of a
There is no guarantee that such a copy will be usable.
Multiple statement handles can be associated with a single connection. The limit on the number of handles depends on the available system resources.
This structure is used both for statement input (data values
sent to the server) and output (result values returned from
the server). For input, it is used with
mysql_stmt_bind_param() to bind parameter
data values to buffers for use by
mysql_stmt_execute(). For output, it is
bind result set buffers for use in fetching rows with
MYSQL_BIND structure contains the
following members for use by application programs. Each is
used both for input and for output, although sometimes for
different purposes depending on the direction of data
enum enum_field_types buffer_type
The type of the buffer. The allowable
buffer_type values are listed later
in this section. For input,
buffer_type indicates what type of
value you are binding to a statement parameter. For
output, it indicates what type of value you expect to
receive in a result buffer.
For input, this is a pointer to the buffer in which a
statement parameter's data value is stored. For output,
it is a pointer to the buffer in which to return a
result set column value. For numeric column types,
buffer should point to a variable of
the proper C type. (If you are associating the variable
with a column that has the
attribute, the variable should be an
unsigned C type. Indicate whether the
variable is signed or unsigned by using the
is_unsigned member, described later
in this list.) For date and time column types,
buffer should point to a
MYSQL_TIME structure. For character
and binary string column types,
buffer should point to a character
unsigned long buffer_length
The actual size of
*buffer in bytes.
This indicates the maximum amount of data that can be
stored in the buffer. For character and binary C data,
buffer_length value specifies the
*buffer when used with
mysql_stmt_bind_param(), or the
maximum number of data bytes that can be fetched into
the buffer when used with
unsigned long *length
A pointer to an
variable that indicates the actual number of bytes of
data stored in
length is used for character or
binary C data. For input parameter data binding,
length points to an
long variable that indicates the length of the
parameter value stored in
this is used by
For output value binding,
mysql_stmt_fetch() places the length
of the column value that is returned into the variable
length points to.
length is ignored for numeric and
temporal data types because the length of the data value
is determined by the
This member points to a
variable that is true if a value is
NULL, false if it is not
NULL. For input, set
*is_null to true to indicate that you
are passing a
NULL value as a
statement parameter. For output, this value is set to
true after you fetch a row if the result set column
value returned from the statement is
This member is used for integer types. (These correspond
MYSQL_TYPE_LONGLONG type codes.)
is_unsigned should be set to true for
unsigned types and false for signed types.
For output, this member is used output to report data
truncation errors. Truncation reporting must be enabled
mysql_options() with the
error is true in the
MYSQL_BIND structures for parameters
in which truncation occurred. Truncation indicates loss
of sign or significant digits, or that a string was too
long to fit in a column. The
member was added in MySQL 5.0.3.
To use a
MYSQL_BIND structure, you should
zero its contents to initialize it, and then set the members
just described appropriately. For example, to declare and
initialize an array of three
structures, use this code:
MYSQL_BIND bind; memset(bind, 0, sizeof(bind));
This structure is used to send and receive
TIMESTAMP data directly to and from the
server. This is done by setting the
buffer_type member of a
MYSQL_BIND structure to one of the
temporal types, and setting the
member to point to a
MYSQL_TIME structure contains the
unsigned int year
unsigned int month
The month of the year.
unsigned int day
The day of the month.
unsigned int hour
The hour of the day.
unsigned int minute
The minute of the hour.
unsigned int second
The second of the minute.
A boolean flag to indicate whether the time is negative.
unsigned long second_part
The fractional part of the second. This member currently is unused.
Only those parts of a
structure that apply to a given type of temporal value are
day elements are used for
TIMESTAMP values. The
second elements are used for
TIMESTAMP values. See
Sección 24.2.10, “Manejo de valores de fecha y hora por parte de la API C”.
The following table shows the allowable values that may be
specified in the
buffer_type member of
MYSQL_BIND structures. The table also shows
those SQL types that correspond most closely to each
buffer_type value, and, for numeric and
temporal types, the corresponding C type.
||SQL Type||C Type|
Implicit type conversion may be performed in both directions.
É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 firstname.lastname@example.org.