2005-10-27 07:29:40 +00:00
|
|
|
/***********************************************************************
|
|
|
|
|
Comparison services for records
|
|
|
|
|
|
|
|
|
|
(c) 1994-2001 Innobase Oy
|
|
|
|
|
|
|
|
|
|
Created 7/1/1994 Heikki Tuuri
|
|
|
|
|
************************************************************************/
|
|
|
|
|
|
|
|
|
|
#ifndef rem0cmp_h
|
|
|
|
|
#define rem0cmp_h
|
|
|
|
|
|
|
|
|
|
#include "univ.i"
|
|
|
|
|
#include "data0data.h"
|
|
|
|
|
#include "data0type.h"
|
|
|
|
|
#include "dict0dict.h"
|
|
|
|
|
#include "rem0rec.h"
|
|
|
|
|
|
|
|
|
|
/*****************************************************************
|
dict_col_t: Copy the fields of "dtype_t type" directly to this structure,
so that all integer fields can be packed into 64 bits. (Bug #20877)
dtype_t: Change the type of all bit-fields to unsigned.
dict_table_get_nth_col(), dict_table_get_sys_col_noninline(),
dict_table_get_sys_col(), dict_field_get_col(): Return const
dict_col_t*, so that changes to dict_col_t can be detected more
easily. Add const to many dict_col_t* declarations.
dict_index_get_nth_type(): Replace with dict_index_get_nth_col().
dict_col_get_type(): Replace with dict_col_copy_type().
dict_col_get_min_size(), dict_col_get_max_size(), dict_col_get_fixed_size(),
dict_col_get_sql_null_size(): New functions.
dtype_get_at_most_n_mbchars(): Replace the parameter dtype
with the parameters prtype, mbminlen, mbmaxlen.
dtype_get_pad_char(), cmp_data_data(), cmp_data_data_slow(),
cmp_whole_field(): Replace the dtype_t* parameter with the ulint
parameters mtype, prtype.
dtype_copy(): Add a const qualifier to type2 (the one being copied from).
dtype_set_mblen(): Replaced with dtype_get_mblen().
dtype_get_fixed_size_low(), dtype_get_min_size_low(),
dtype_get_fixed_max_low(): Replace dtype_get_fixed_size(),
dtype_get_min_size(), and dtype_get_max_size(). These are used by the
dict_col_get_{fixed,min,max}_size() functions.
cmp_types_are_equal(): Replace with cmp_cols_are_equal().
dict_table_get_col_name(): Add a const qualifier parameter to the
parameter "table".
dtype_binary, dtype_binary_val: Remove.
dtype_is_fixed_size(): Remove.
2006-09-18 11:51:38 +00:00
|
|
|
Returns TRUE if two columns are equal for comparison purposes. */
|
2005-10-27 07:29:40 +00:00
|
|
|
|
|
|
|
|
ibool
|
dict_col_t: Copy the fields of "dtype_t type" directly to this structure,
so that all integer fields can be packed into 64 bits. (Bug #20877)
dtype_t: Change the type of all bit-fields to unsigned.
dict_table_get_nth_col(), dict_table_get_sys_col_noninline(),
dict_table_get_sys_col(), dict_field_get_col(): Return const
dict_col_t*, so that changes to dict_col_t can be detected more
easily. Add const to many dict_col_t* declarations.
dict_index_get_nth_type(): Replace with dict_index_get_nth_col().
dict_col_get_type(): Replace with dict_col_copy_type().
dict_col_get_min_size(), dict_col_get_max_size(), dict_col_get_fixed_size(),
dict_col_get_sql_null_size(): New functions.
dtype_get_at_most_n_mbchars(): Replace the parameter dtype
with the parameters prtype, mbminlen, mbmaxlen.
dtype_get_pad_char(), cmp_data_data(), cmp_data_data_slow(),
cmp_whole_field(): Replace the dtype_t* parameter with the ulint
parameters mtype, prtype.
dtype_copy(): Add a const qualifier to type2 (the one being copied from).
dtype_set_mblen(): Replaced with dtype_get_mblen().
dtype_get_fixed_size_low(), dtype_get_min_size_low(),
dtype_get_fixed_max_low(): Replace dtype_get_fixed_size(),
dtype_get_min_size(), and dtype_get_max_size(). These are used by the
dict_col_get_{fixed,min,max}_size() functions.
cmp_types_are_equal(): Replace with cmp_cols_are_equal().
dict_table_get_col_name(): Add a const qualifier parameter to the
parameter "table".
dtype_binary, dtype_binary_val: Remove.
dtype_is_fixed_size(): Remove.
2006-09-18 11:51:38 +00:00
|
|
|
cmp_cols_are_equal(
|
|
|
|
|
/*===============*/
|
|
|
|
|
/* out: TRUE if the columns are
|
|
|
|
|
considered equal in comparisons */
|
|
|
|
|
const dict_col_t* col1, /* in: column 1 */
|
|
|
|
|
const dict_col_t* col2, /* in: column 2 */
|
|
|
|
|
ibool check_charsets);
|
|
|
|
|
/* in: whether to check charsets */
|
2005-10-27 07:29:40 +00:00
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare two data fields for which we know the
|
|
|
|
|
data type. */
|
|
|
|
|
UNIV_INLINE
|
|
|
|
|
int
|
|
|
|
|
cmp_data_data(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*==========*/
|
|
|
|
|
/* out: 1, 0, -1, if data1 is greater, equal,
|
2005-10-27 07:29:40 +00:00
|
|
|
less than data2, respectively */
|
dict_col_t: Copy the fields of "dtype_t type" directly to this structure,
so that all integer fields can be packed into 64 bits. (Bug #20877)
dtype_t: Change the type of all bit-fields to unsigned.
dict_table_get_nth_col(), dict_table_get_sys_col_noninline(),
dict_table_get_sys_col(), dict_field_get_col(): Return const
dict_col_t*, so that changes to dict_col_t can be detected more
easily. Add const to many dict_col_t* declarations.
dict_index_get_nth_type(): Replace with dict_index_get_nth_col().
dict_col_get_type(): Replace with dict_col_copy_type().
dict_col_get_min_size(), dict_col_get_max_size(), dict_col_get_fixed_size(),
dict_col_get_sql_null_size(): New functions.
dtype_get_at_most_n_mbchars(): Replace the parameter dtype
with the parameters prtype, mbminlen, mbmaxlen.
dtype_get_pad_char(), cmp_data_data(), cmp_data_data_slow(),
cmp_whole_field(): Replace the dtype_t* parameter with the ulint
parameters mtype, prtype.
dtype_copy(): Add a const qualifier to type2 (the one being copied from).
dtype_set_mblen(): Replaced with dtype_get_mblen().
dtype_get_fixed_size_low(), dtype_get_min_size_low(),
dtype_get_fixed_max_low(): Replace dtype_get_fixed_size(),
dtype_get_min_size(), and dtype_get_max_size(). These are used by the
dict_col_get_{fixed,min,max}_size() functions.
cmp_types_are_equal(): Replace with cmp_cols_are_equal().
dict_table_get_col_name(): Add a const qualifier parameter to the
parameter "table".
dtype_binary, dtype_binary_val: Remove.
dtype_is_fixed_size(): Remove.
2006-09-18 11:51:38 +00:00
|
|
|
ulint mtype, /* in: main type */
|
|
|
|
|
ulint prtype, /* in: precise type */
|
2005-10-27 07:29:40 +00:00
|
|
|
byte* data1, /* in: data field (== a pointer to a memory
|
|
|
|
|
buffer) */
|
|
|
|
|
ulint len1, /* in: data field length or UNIV_SQL_NULL */
|
|
|
|
|
byte* data2, /* in: data field (== a pointer to a memory
|
|
|
|
|
buffer) */
|
|
|
|
|
ulint len2); /* in: data field length or UNIV_SQL_NULL */
|
|
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare two data fields for which we know the
|
|
|
|
|
data type. */
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
cmp_data_data_slow(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*===============*/
|
|
|
|
|
/* out: 1, 0, -1, if data1 is greater, equal,
|
2005-10-27 07:29:40 +00:00
|
|
|
less than data2, respectively */
|
dict_col_t: Copy the fields of "dtype_t type" directly to this structure,
so that all integer fields can be packed into 64 bits. (Bug #20877)
dtype_t: Change the type of all bit-fields to unsigned.
dict_table_get_nth_col(), dict_table_get_sys_col_noninline(),
dict_table_get_sys_col(), dict_field_get_col(): Return const
dict_col_t*, so that changes to dict_col_t can be detected more
easily. Add const to many dict_col_t* declarations.
dict_index_get_nth_type(): Replace with dict_index_get_nth_col().
dict_col_get_type(): Replace with dict_col_copy_type().
dict_col_get_min_size(), dict_col_get_max_size(), dict_col_get_fixed_size(),
dict_col_get_sql_null_size(): New functions.
dtype_get_at_most_n_mbchars(): Replace the parameter dtype
with the parameters prtype, mbminlen, mbmaxlen.
dtype_get_pad_char(), cmp_data_data(), cmp_data_data_slow(),
cmp_whole_field(): Replace the dtype_t* parameter with the ulint
parameters mtype, prtype.
dtype_copy(): Add a const qualifier to type2 (the one being copied from).
dtype_set_mblen(): Replaced with dtype_get_mblen().
dtype_get_fixed_size_low(), dtype_get_min_size_low(),
dtype_get_fixed_max_low(): Replace dtype_get_fixed_size(),
dtype_get_min_size(), and dtype_get_max_size(). These are used by the
dict_col_get_{fixed,min,max}_size() functions.
cmp_types_are_equal(): Replace with cmp_cols_are_equal().
dict_table_get_col_name(): Add a const qualifier parameter to the
parameter "table".
dtype_binary, dtype_binary_val: Remove.
dtype_is_fixed_size(): Remove.
2006-09-18 11:51:38 +00:00
|
|
|
ulint mtype, /* in: main type */
|
|
|
|
|
ulint prtype, /* in: precise type */
|
2005-10-27 07:29:40 +00:00
|
|
|
byte* data1, /* in: data field (== a pointer to a memory
|
|
|
|
|
buffer) */
|
|
|
|
|
ulint len1, /* in: data field length or UNIV_SQL_NULL */
|
|
|
|
|
byte* data2, /* in: data field (== a pointer to a memory
|
|
|
|
|
buffer) */
|
|
|
|
|
ulint len2); /* in: data field length or UNIV_SQL_NULL */
|
|
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare two dfields where at least the first
|
|
|
|
|
has its data type field set. */
|
|
|
|
|
UNIV_INLINE
|
|
|
|
|
int
|
|
|
|
|
cmp_dfield_dfield(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*==============*/
|
|
|
|
|
/* out: 1, 0, -1, if dfield1 is greater, equal,
|
2005-10-27 07:29:40 +00:00
|
|
|
less than dfield2, respectively */
|
|
|
|
|
dfield_t* dfield1,/* in: data field; must have type field set */
|
|
|
|
|
dfield_t* dfield2);/* in: data field */
|
|
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare a data tuple to a physical record.
|
|
|
|
|
Only dtuple->n_fields_cmp first fields are taken into account for
|
|
|
|
|
the the data tuple! If we denote by n = n_fields_cmp, then rec must
|
|
|
|
|
have either m >= n fields, or it must differ from dtuple in some of
|
|
|
|
|
the m fields rec has. If rec has an externally stored field we do not
|
|
|
|
|
compare it but return with value 0 if such a comparison should be
|
|
|
|
|
made. */
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
cmp_dtuple_rec_with_match(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*======================*/
|
|
|
|
|
/* out: 1, 0, -1, if dtuple is greater, equal,
|
|
|
|
|
less than rec, respectively, when only the
|
2005-10-27 07:29:40 +00:00
|
|
|
common first fields are compared, or
|
|
|
|
|
until the first externally stored field in
|
|
|
|
|
rec */
|
|
|
|
|
dtuple_t* dtuple, /* in: data tuple */
|
|
|
|
|
rec_t* rec, /* in: physical record which differs from
|
|
|
|
|
dtuple in some of the common fields, or which
|
|
|
|
|
has an equal number or more fields than
|
|
|
|
|
dtuple */
|
|
|
|
|
const ulint* offsets,/* in: array returned by rec_get_offsets() */
|
2006-02-21 12:37:54 +00:00
|
|
|
ulint* matched_fields, /* in/out: number of already completely
|
2005-10-27 07:29:40 +00:00
|
|
|
matched fields; when function returns,
|
|
|
|
|
contains the value for current comparison */
|
2006-02-21 12:37:54 +00:00
|
|
|
ulint* matched_bytes); /* in/out: number of already matched
|
2005-10-27 07:29:40 +00:00
|
|
|
bytes within the first field not completely
|
|
|
|
|
matched; when function returns, contains the
|
|
|
|
|
value for current comparison */
|
|
|
|
|
/******************************************************************
|
|
|
|
|
Compares a data tuple to a physical record. */
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
cmp_dtuple_rec(
|
|
|
|
|
/*===========*/
|
2006-02-21 12:37:54 +00:00
|
|
|
/* out: 1, 0, -1, if dtuple is greater, equal,
|
2005-10-27 07:29:40 +00:00
|
|
|
less than rec, respectively; see the comments
|
|
|
|
|
for cmp_dtuple_rec_with_match */
|
2006-02-21 12:37:54 +00:00
|
|
|
dtuple_t* dtuple, /* in: data tuple */
|
2005-10-27 07:29:40 +00:00
|
|
|
rec_t* rec, /* in: physical record */
|
|
|
|
|
const ulint* offsets);/* in: array returned by rec_get_offsets() */
|
|
|
|
|
/******************************************************************
|
|
|
|
|
Checks if a dtuple is a prefix of a record. The last field in dtuple
|
|
|
|
|
is allowed to be a prefix of the corresponding field in the record. */
|
|
|
|
|
|
|
|
|
|
ibool
|
|
|
|
|
cmp_dtuple_is_prefix_of_rec(
|
|
|
|
|
/*========================*/
|
|
|
|
|
/* out: TRUE if prefix */
|
|
|
|
|
dtuple_t* dtuple, /* in: data tuple */
|
|
|
|
|
rec_t* rec, /* in: physical record */
|
|
|
|
|
const ulint* offsets);/* in: array returned by rec_get_offsets() */
|
|
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare two physical records. Only the common
|
|
|
|
|
first fields are compared, and if an externally stored field is
|
|
|
|
|
encountered, then 0 is returned. */
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
cmp_rec_rec_with_match(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*===================*/
|
2005-10-27 07:29:40 +00:00
|
|
|
/* out: 1, 0 , -1 if rec1 is greater, equal,
|
|
|
|
|
less, respectively, than rec2; only the common
|
|
|
|
|
first fields are compared */
|
|
|
|
|
rec_t* rec1, /* in: physical record */
|
|
|
|
|
rec_t* rec2, /* in: physical record */
|
|
|
|
|
const ulint* offsets1,/* in: rec_get_offsets(rec1, index) */
|
|
|
|
|
const ulint* offsets2,/* in: rec_get_offsets(rec2, index) */
|
|
|
|
|
dict_index_t* index, /* in: data dictionary index */
|
2006-02-21 12:37:54 +00:00
|
|
|
ulint* matched_fields, /* in/out: number of already completely
|
2005-10-27 07:29:40 +00:00
|
|
|
matched fields; when the function returns,
|
|
|
|
|
contains the value the for current
|
|
|
|
|
comparison */
|
2006-02-21 12:37:54 +00:00
|
|
|
ulint* matched_bytes);/* in/out: number of already matched
|
2005-10-27 07:29:40 +00:00
|
|
|
bytes within the first field not completely
|
|
|
|
|
matched; when the function returns, contains
|
|
|
|
|
the value for the current comparison */
|
|
|
|
|
/*****************************************************************
|
|
|
|
|
This function is used to compare two physical records. Only the common
|
|
|
|
|
first fields are compared. */
|
|
|
|
|
UNIV_INLINE
|
|
|
|
|
int
|
|
|
|
|
cmp_rec_rec(
|
2006-02-21 12:37:54 +00:00
|
|
|
/*========*/
|
2005-10-27 07:29:40 +00:00
|
|
|
/* out: 1, 0 , -1 if rec1 is greater, equal,
|
|
|
|
|
less, respectively, than rec2; only the common
|
|
|
|
|
first fields are compared */
|
|
|
|
|
rec_t* rec1, /* in: physical record */
|
|
|
|
|
rec_t* rec2, /* in: physical record */
|
|
|
|
|
const ulint* offsets1,/* in: rec_get_offsets(rec1, index) */
|
|
|
|
|
const ulint* offsets2,/* in: rec_get_offsets(rec2, index) */
|
|
|
|
|
dict_index_t* index); /* in: data dictionary index */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef UNIV_NONINL
|
|
|
|
|
#include "rem0cmp.ic"
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif
|