/usr/include/mysql/server/private
NameSizeModeActions
atomic/-0755rm
data/-0755rm
providers/-0755rm
aligned.h11360644editdlrm
aria_backup.h17870644editdlrm
assume_aligned.h23500644editdlrm
authors.h101940644editdlrm
backup.h17030644editdlrm
bounded_queue.h60930644editdlrm
client_settings.h19350644editdlrm
compat56.h22800644editdlrm
config.h143510644editdlrm
contributors.h49310644editdlrm
create_options.h41930644editdlrm
create_tmp_table.h28080644editdlrm
cset_narrowing.h39680644editdlrm
custom_conf.h10820644editdlrm
datadict.h17000644editdlrm
ddl_log.h128070644editdlrm
debug.h12340644editdlrm
debug_sync.h20460644editdlrm
derived_handler.h23790644editdlrm
derror.h9800644editdlrm
des_key_file.h12360644editdlrm
discover.h15700644editdlrm
dur_prop.h10820644editdlrm
embedded_priv.h17330644editdlrm
events.h47040644editdlrm
event_data_objects.h41870644editdlrm
event_db_repository.h36480644editdlrm
event_parse_data.h28990644editdlrm
event_queue.h34380644editdlrm
event_scheduler.h32900644editdlrm
field.h2224140644editdlrm
field_comp.h11740644editdlrm
filesort.h72830644editdlrm
filesort_utils.h81950644editdlrm
ft_global.h31130644editdlrm
gcalc_slicescan.h173300644editdlrm
gcalc_tools.h119000644editdlrm
grant.h27580644editdlrm
group_by_handler.h35340644editdlrm
gstream.h24370644editdlrm
handler.h1998570644editdlrm
handle_connections_win.h8840644editdlrm
hash.h44520644editdlrm
hash_filo.h55990644editdlrm
ha_handler_stats.h23350644editdlrm
ha_partition.h646960644editdlrm
ha_sequence.h62450644editdlrm
heap.h94870644editdlrm
hostname.h54190644editdlrm
ilist.h72370644editdlrm
init.h8520644editdlrm
innodb_priv.h13190644editdlrm
item.h2854580644editdlrm
item_cmpfunc.h1352180644editdlrm
item_create.h115080644editdlrm
item_func.h1386830644editdlrm
item_geofunc.h396120644editdlrm
item_jsonfunc.h254290644editdlrm
item_row.h52290644editdlrm
item_strfunc.h752650644editdlrm
item_subselect.h590870644editdlrm
item_sum.h726950644editdlrm
item_timefunc.h658960644editdlrm
item_vers.h44130644editdlrm
item_windowfunc.h350890644editdlrm
item_xmlfunc.h46500644editdlrm
json_table.h96670644editdlrm
key.h21320644editdlrm
keycaches.h19950644editdlrm
lex.h298400644editdlrm
lex_charset.h243130644editdlrm
lex_hash.h1431080644editdlrm
lex_ident.h21220644editdlrm
lex_string.h40770644editdlrm
lex_symbol.h13230644editdlrm
lex_token.h426410644editdlrm
lf.h64620644editdlrm
lock.h22200644editdlrm
log.h464620644editdlrm
log_event.h1894670644editdlrm
log_event_data_type.h18900644editdlrm
log_event_old.h198300644editdlrm
log_slow.h24420644editdlrm
maria.h58720644editdlrm
mariadb.h12770644editdlrm
mdl.h388930644editdlrm
mem_root_array.h71060644editdlrm
message.h11950644editdlrm
multi_range_read.h231790644editdlrm
myisam.h175060644editdlrm
myisamchk.h47340644editdlrm
myisammrg.h48970644editdlrm
myisampack.h149290644editdlrm
mysqld.h412250644editdlrm
mysqld_default_groups.h2040644editdlrm
mysqld_suffix.h12010644editdlrm
mysys_err.h30220644editdlrm
my_alarm.h24290644editdlrm
my_apc.h47470644editdlrm
my_atomic.h72810644editdlrm
my_atomic_wrapper.h30510644editdlrm
my_base.h277500644editdlrm
my_bit.h61960644editdlrm
my_bitmap.h55020644editdlrm
my_check_opt.h26180644editdlrm
my_compare.h111940644editdlrm
my_counter.h17210644editdlrm
my_cpu.h48850644editdlrm
my_crypt.h9040644editdlrm
my_decimal.h145040644editdlrm
my_default.h18800644editdlrm
my_handler_errors.h48820644editdlrm
my_json_writer.h187060644editdlrm
my_libwrap.h11830644editdlrm
my_md5.h14860644editdlrm
my_minidump.h8480644editdlrm
my_nosys.h14380644editdlrm
my_rdtsc.h101190644editdlrm
my_rnd.h10140644editdlrm
my_service_manager.h20870644editdlrm
my_stacktrace.h32150644editdlrm
my_stack_alloc.h64930644editdlrm
my_time.h104140644editdlrm
my_tree.h39910644editdlrm
my_uctype.h695280644editdlrm
my_user.h11260644editdlrm
my_virtual_mem.h12550644editdlrm
opt_histogram_json.h46380644editdlrm
opt_range.h659030644editdlrm
opt_subselect.h145450644editdlrm
opt_trace.h95050644editdlrm
opt_trace_context.h32910644editdlrm
parse_file.h44240644editdlrm
partition_element.h54280644editdlrm
partition_info.h198640644editdlrm
password.h16210644editdlrm
pfs_file_provider.h31530644editdlrm
pfs_idle_provider.h13850644editdlrm
pfs_memory_provider.h16260644editdlrm
pfs_metadata_provider.h18980644editdlrm
pfs_socket_provider.h22580644editdlrm
pfs_stage_provider.h15560644editdlrm
pfs_statement_provider.h43470644editdlrm
pfs_table_provider.h26250644editdlrm
pfs_thread_provider.h55600644editdlrm
pfs_transaction_provider.h28460644editdlrm
privilege.h288530644editdlrm
probes_mysql.h9730644editdlrm
probes_mysql_nodtrace.h60870644editdlrm
procedure.h68190644editdlrm
protocol.h125370644editdlrm
proxy_protocol.h5480644editdlrm
queues.h34770644editdlrm
records.h31470644editdlrm
replication.h161300644editdlrm
repl_failsafe.h15850644editdlrm
rijndael.h17110644editdlrm
rowid_filter.h154740644editdlrm
rpl_constants.h33570644editdlrm
rpl_filter.h47740644editdlrm
rpl_gtid.h299850644editdlrm
rpl_injector.h96210644editdlrm
rpl_mi.h166360644editdlrm
rpl_parallel.h182280644editdlrm
rpl_record.h15850644editdlrm
rpl_record_old.h14070644editdlrm
rpl_reporting.h37130644editdlrm
rpl_rli.h360700644editdlrm
rpl_tblmap.h31770644editdlrm
rpl_utility.h98000644editdlrm
scheduler.h31990644editdlrm
scope.h43930644editdlrm
select_handler.h22280644editdlrm
semisync.h22870644editdlrm
semisync_master.h257640644editdlrm
semisync_master_ack_receiver.h87090644editdlrm
semisync_slave.h37360644editdlrm
service_versions.h22850644editdlrm
session_tracker.h142750644editdlrm
set_var.h173310644editdlrm
slave.h123920644editdlrm
socketpair.h8420644editdlrm
source_revision.h670644editdlrm
sp.h225880644editdlrm
span.h39310644editdlrm
spatial.h226980644editdlrm
sp_cache.h20370644editdlrm
sp_head.h649170644editdlrm
sp_pcontext.h254270644editdlrm
sp_rcontext.h144410644editdlrm
sql_acl.h141670644editdlrm
sql_admin.h29150644editdlrm
sql_alloc.h17320644editdlrm
sql_alter.h153950644editdlrm
sql_analyse.h110520644editdlrm
sql_analyze_stmt.h126830644editdlrm
sql_array.h68580644editdlrm
sql_audit.h141620644editdlrm
sql_base.h260500644editdlrm
sql_basic_types.h95230644editdlrm
sql_binlog.h8950644editdlrm
sql_bitmap.h78420644editdlrm
sql_bootstrap.h18120644editdlrm
sql_cache.h216760644editdlrm
sql_callback.h15420644editdlrm
sql_class.h2718360644editdlrm
sql_cmd.h59620644editdlrm
sql_command.h48000644editdlrm
sql_connect.h40870644editdlrm
sql_const.h116300644editdlrm
sql_crypt.h14370644editdlrm
sql_cte.h164940644editdlrm
sql_cursor.h44280644editdlrm
sql_db.h24380644editdlrm
sql_debug.h57270644editdlrm
sql_delete.h13430644editdlrm
sql_derived.h12890644editdlrm
sql_digest.h38190644editdlrm
sql_digest_stream.h15670644editdlrm
sql_do.h9540644editdlrm
sql_error.h398430644editdlrm
sql_explain.h303190644editdlrm
sql_expression_cache.h43590644editdlrm
sql_get_diagnostics.h78830644editdlrm
sql_handler.h29100644editdlrm
sql_help.h9950644editdlrm
sql_hset.h34010644editdlrm
sql_insert.h51730644editdlrm
sql_i_s.h84870644editdlrm
sql_join_cache.h486590644editdlrm
sql_lex.h1749310644editdlrm
sql_lifo_buffer.h96850644editdlrm
sql_limit.h31870644editdlrm
sql_list.h223910644editdlrm
sql_load.h12760644editdlrm
sql_locale.h27010644editdlrm
sql_manager.h9600644editdlrm
sql_mode.h67350644editdlrm
sql_parse.h89700644editdlrm
sql_partition.h126740644editdlrm
sql_partition_admin.h59400644editdlrm
sql_plist.h77110644editdlrm
sql_plugin.h75770644editdlrm
sql_plugin_compat.h22370644editdlrm
sql_prepare.h114090644editdlrm
sql_priv.h185280644editdlrm
sql_profile.h78160644editdlrm
sql_reload.h10360644editdlrm
sql_rename.h9820644editdlrm
sql_repl.h30450644editdlrm
sql_schema.h33030644editdlrm
sql_select.h897430644editdlrm
sql_sequence.h51770644editdlrm
sql_servers.h17770644editdlrm
sql_show.h98190644editdlrm
sql_signal.h33620644editdlrm
sql_sort.h219640644editdlrm
sql_statistics.h165040644editdlrm
sql_string.h390090644editdlrm
sql_table.h98120644editdlrm
sql_test.h26650644editdlrm
sql_time.h85050644editdlrm
sql_trigger.h123320644editdlrm
sql_truncate.h20790644editdlrm
sql_tvc.h24180644editdlrm
sql_type.h2972720644editdlrm
sql_type_fixedbin.h655780644editdlrm
sql_type_fixedbin_storage.h54670644editdlrm
sql_type_geom.h190390644editdlrm
sql_type_int.h100010644editdlrm
sql_type_json.h61550644editdlrm
sql_type_real.h12570644editdlrm
sql_type_string.h16290644editdlrm
sql_udf.h48500644editdlrm
sql_union.h10680644editdlrm
sql_update.h19230644editdlrm
sql_view.h24700644editdlrm
sql_window.h68140644editdlrm
ssl_compat.h33800644editdlrm
strfunc.h25490644editdlrm
structs.h294570644editdlrm
sys_vars_shared.h27290644editdlrm
table.h1190090644editdlrm
table_cache.h42320644editdlrm
threadpool.h48100644editdlrm
threadpool_generic.h39690644editdlrm
threadpool_winsockets.h22900644editdlrm
thread_cache.h59050644editdlrm
thr_alarm.h29320644editdlrm
thr_lock.h73500644editdlrm
thr_malloc.h12020644editdlrm
thr_timer.h15630644editdlrm
transaction.h14660644editdlrm
tzfile.h50140644editdlrm
tztime.h33970644editdlrm
t_ctype.h56390644editdlrm
uniques.h42170644editdlrm
unireg.h77220644editdlrm
vers_string.h25430644editdlrm
violite.h99560644editdlrm
waiting_threads.h45320644editdlrm
welcome_copyright_notice.h12180644editdlrm
winservice.h60190644editdlrm
win_tzname_data.h65060644editdlrm
wqueue.h15650644editdlrm
wsrep.h33080644editdlrm
wsrep_allowlist_service.h10350644editdlrm
wsrep_applier.h27030644editdlrm
wsrep_binlog.h35510644editdlrm
wsrep_client_service.h26020644editdlrm
wsrep_client_state.h15660644editdlrm
wsrep_condition_variable.h14840644editdlrm
wsrep_high_priority_service.h49120644editdlrm
wsrep_mutex.h12390644editdlrm
wsrep_mysqld.h220060644editdlrm
wsrep_mysqld_c.h12270644editdlrm
wsrep_on.h17180644editdlrm
wsrep_priv.h16340644editdlrm
wsrep_schema.h58860644editdlrm
wsrep_server_service.h36310644editdlrm
wsrep_server_state.h25290644editdlrm
wsrep_sst.h39510644editdlrm
wsrep_status.h18160644editdlrm
wsrep_storage_service.h18090644editdlrm
wsrep_thd.h114870644editdlrm
wsrep_trans_observer.h181740644editdlrm
wsrep_types.h11100644editdlrm
wsrep_utils.h102510644editdlrm
wsrep_var.h46120644editdlrm
wsrep_xid.h15090644editdlrm
xa.h18450644editdlrm
Edit: /usr/include/mysql/server/private/lex_charset.h (24313B)
/* Copyright (c) 2021, 2022, MariaDB Corporation. 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-1335 USA */ #ifndef LEX_CHARSET_INCLUDED #define LEX_CHARSET_INCLUDED /* An extention for Charset_loader_mysys, with server error and warning support. */ class Charset_loader_server: public Charset_loader_mysys { public: using Charset_loader_mysys::Charset_loader_mysys; void raise_unknown_collation_error(const char *name) const; void raise_not_applicable_error(const char *cs, const char *cl) const; /* Find an exact collation by name. Raise an error on a faulure. @param cs - the character set @param collation_name - the collation name, e.g. "utf8_bin" @param my_flags - my flags, e.g. MYF(WME) @returns - a NULL pointer in case of failure, or a CHARSET_INFO pointer on success. */ CHARSET_INFO * get_exact_collation_or_error(const char *name, myf my_flags= MYF(0)) { CHARSET_INFO *ci= get_exact_collation(name, my_flags); if (!ci) raise_unknown_collation_error(name); return ci; } /* Find an exact collation by a character set and a contextually typed collation name. Raise an error on in case of a faulure. @param cs - the character set @param context_cl_name - the context name, e.g. "uca1400_cs_ci" @param my_flags - my flags, e.g. MYF(WME) @returns - a NULL pointer in case of failure, or a CHARSET_INFO pointer on success. */ CHARSET_INFO * get_exact_collation_by_context_name_or_error(CHARSET_INFO *cs, const char *name, myf my_flags= MYF(0)) { CHARSET_INFO *ci= get_exact_collation_by_context_name(cs, name, my_flags); if (!ci) raise_not_applicable_error(cs->cs_name.str, name); return ci; } /* Find an abstract context collation by name. Raise an error on a faulure. The returned pointer needs to be resolved to a character set name. It should not be passed directly to the character set routines. @param cs - the character set @param context_cl_name - the context name, e.g. "uca1400_cs_ci" @param my_flags - my flags, e.g. MYF(WME) @returns - a NULL pointer in case of failure, or a CHARSET_INFO pointer on success. */ CHARSET_INFO * get_context_collation_or_error(const char *collation_name, myf my_flags= MYF(0)) { CHARSET_INFO *ci= get_context_collation(collation_name, my_flags); if (!ci) raise_unknown_collation_error(collation_name); return ci; } /* Find an exact binary collation in the given character set. Raise an error on a faulure. @param cs - the character set @param my_flags - my flags, e.g. MYF(WME) @returns - a NULL pointer in case of failure, or a CHARSET_INFO pointer on success. */ CHARSET_INFO * get_bin_collation_or_error(CHARSET_INFO *cs, myf my_flags= MYF(0)) { const char *cs_name= cs->cs_name.str; if (!(cs= get_bin_collation(cs, my_flags))) { char tmp[65]; strxnmov(tmp, sizeof(tmp)-1, cs_name, "_bin", NULL); raise_unknown_collation_error(tmp); } return cs; } /* Find an exact default collation in the given character set. This routine does not fail. Any character set must have a default collation. @param cs - the character set @param my_flags - my flags, e.g. MYF(WME) @returns - a CHARSET_INFO pointer */ CHARSET_INFO *get_default_collation(CHARSET_INFO *cs, myf my_flags= MYF(0)) { return Charset_loader_mysys::get_default_collation(cs, my_flags); } }; ///////////////////////////////////////////////////////////////////// /* An exact character set, e.g: CHARACTER SET latin1 */ class Lex_exact_charset { CHARSET_INFO *m_ci; public: explicit Lex_exact_charset(CHARSET_INFO *ci) :m_ci(ci) { DBUG_ASSERT(m_ci); DBUG_ASSERT(m_ci->state & MY_CS_PRIMARY); } CHARSET_INFO *charset_info() const { return m_ci; } bool raise_if_not_equal(const Lex_exact_charset &rhs) const; bool raise_if_not_applicable(const class Lex_exact_collation &cl) const; }; /* An optional contextually typed character set: [ CHARACTER SET DEFAULT ] */ class Lex_opt_context_charset_st { /* Currently we support only DEFAULT as a possible value. So "bool" is enough. */ bool m_had_charset_default; public: void init() { m_had_charset_default= false; } void merge_charset_default() { /* Ok to specify CHARACTER SET DEFAULT multiple times. No error raised here. */ m_had_charset_default= true; } bool is_empty() const { return !m_had_charset_default; } bool is_contextually_typed_charset_default() const { return m_had_charset_default; } }; /* A contextually typed collation, e.g.: COLLATE DEFAULT CHAR(10) BINARY */ class Lex_context_collation { CHARSET_INFO *m_ci; public: explicit Lex_context_collation(CHARSET_INFO *ci) :m_ci(ci) { DBUG_ASSERT(ci); } CHARSET_INFO *charset_info() const { return m_ci; } bool is_contextually_typed_collate_default() const { return m_ci == &my_collation_contextually_typed_default; } bool is_contextually_typed_binary_style() const { return m_ci == &my_collation_contextually_typed_binary; } bool raise_if_not_equal(const Lex_context_collation &cl) const; /* Skip the character set prefix, return the suffix. utf8mb4_uca1400_as_ci -> uca1400_as_ci */ LEX_CSTRING collation_name_context_suffix() const { return m_ci->get_collation_name(MY_COLLATION_NAME_MODE_CONTEXT); } LEX_CSTRING collation_name_for_show() const; }; /* An exact collation, e.g. COLLATE latin1_swedish_ci */ class Lex_exact_collation { CHARSET_INFO *m_ci; public: explicit Lex_exact_collation(CHARSET_INFO *ci) :m_ci(ci) { DBUG_ASSERT(ci); } CHARSET_INFO *charset_info() const { return m_ci; } // EXACT + EXACT bool raise_if_not_equal(const Lex_exact_collation &cl) const; // EXACT + CONTEXT // CONTEXT + EXACT bool raise_if_conflicts_with_context_collation(const Lex_context_collation &, bool reverse_order) const; }; /* Parse time COLLATE clause: COLLATE colation_name The collation can be either exact or contextual: COLLATE latin1_bin COLLATE DEFAULT */ class Lex_extended_collation_st { public: enum Type { TYPE_EXACT, TYPE_CONTEXTUALLY_TYPED }; protected: CHARSET_INFO *m_ci; Type m_type; public: void init(CHARSET_INFO *ci, Type type) { m_ci= ci; m_type= type; } CHARSET_INFO *charset_info() const { return m_ci; } Type type() const { return m_type; } LEX_CSTRING collation_name_for_show() const { switch (m_type) { case TYPE_CONTEXTUALLY_TYPED: return Lex_context_collation(m_ci).collation_name_for_show(); case TYPE_EXACT: return m_ci->coll_name; } DBUG_ASSERT(0); return m_ci->coll_name; } static Lex_extended_collation_st collate_default() { Lex_extended_collation_st res; res.set_collate_default(); return res; } void set_collate_default() { m_ci= &my_collation_contextually_typed_default; m_type= TYPE_CONTEXTUALLY_TYPED; } bool set_by_name(const char *name, myf my_flags); // e.g. MY_UTF8_IS_UTF8MB3 bool raise_if_conflicts_with_context_collation(const Lex_context_collation &) const; bool merge_exact_charset(const Lex_exact_charset &rhs); bool merge_exact_collation(const Lex_exact_collation &rhs); bool merge(const Lex_extended_collation_st &rhs); }; class Lex_extended_collation: public Lex_extended_collation_st { public: Lex_extended_collation(CHARSET_INFO *ci, Type type) { init(ci, type); } Lex_extended_collation(const Lex_exact_collation &rhs) { init(rhs.charset_info(), TYPE_EXACT); } Lex_extended_collation(const Lex_context_collation &rhs) { init(rhs.charset_info(), TYPE_CONTEXTUALLY_TYPED); } }; /* CHARACTER SET cs_exact [COLLATE cl_exact_or_context] */ class Lex_exact_charset_opt_extended_collate { CHARSET_INFO *m_ci; bool m_with_collate; public: Lex_exact_charset_opt_extended_collate(CHARSET_INFO *ci, bool with_collate) :m_ci(ci), m_with_collate(with_collate) { DBUG_ASSERT(m_ci); DBUG_ASSERT((m_ci->state & MY_CS_PRIMARY) || m_with_collate); } Lex_exact_charset_opt_extended_collate(const Lex_exact_charset &cs) :m_ci(cs.charset_info()), m_with_collate(false) { DBUG_ASSERT(m_ci); DBUG_ASSERT(m_ci->state & MY_CS_PRIMARY); } Lex_exact_charset_opt_extended_collate(const Lex_exact_collation &cl) :m_ci(cl.charset_info()), m_with_collate(true) { DBUG_ASSERT(m_ci); } bool with_collate() const { return m_with_collate; } CHARSET_INFO *find_bin_collation() const; CHARSET_INFO *find_default_collation() const; bool raise_if_charsets_differ(const Lex_exact_charset &cs) const; bool raise_if_not_applicable(const Lex_exact_collation &cl) const; /* Add another COLLATE clause (exact or context). So the full syntax looks like: CHARACTER SET cs [COLLATE cl] ... COLLATE cl2 */ bool merge_collation(const Lex_extended_collation_st &cl) { switch (cl.type()) { case Lex_extended_collation_st::TYPE_EXACT: return merge_exact_collation(Lex_exact_collation(cl.charset_info())); case Lex_extended_collation_st::TYPE_CONTEXTUALLY_TYPED: return merge_context_collation(Lex_context_collation(cl.charset_info())); } DBUG_ASSERT(0); return false; } bool merge_collation_override(const Lex_extended_collation_st &cl) { switch (cl.type()) { case Lex_extended_collation_st::TYPE_EXACT: return merge_exact_collation_override( Lex_exact_collation(cl.charset_info())); case Lex_extended_collation_st::TYPE_CONTEXTUALLY_TYPED: return merge_context_collation_override( Lex_context_collation(cl.charset_info())); } DBUG_ASSERT(0); return false; } /* Add a context collation: CHARACTER SET cs [COLLATE cl] ... COLLATE DEFAULT */ bool merge_context_collation(const Lex_context_collation &cl); bool merge_context_collation_override(const Lex_context_collation &cl); /* Add an exact collation: CHARACTER SET cs [COLLATE cl] ... COLLATE latin1_bin */ bool merge_exact_collation(const Lex_exact_collation &cl); bool merge_exact_collation_override(const Lex_exact_collation &cl); Lex_exact_collation collation() const { return Lex_exact_collation(m_ci); } Lex_exact_charset charset() const { if ((m_ci->state & MY_CS_PRIMARY)) return Lex_exact_charset(m_ci); return Lex_exact_charset(find_default_collation()); } }; /* Parse time character set and collation for: [CHARACTER SET cs_exact] [COLLATE cl_exact_or_context] Can be: 1. Empty (not specified on the column level): CREATE TABLE t1 (a CHAR(10)) CHARACTER SET latin2; -- (1a) CREATE TABLE t1 (a CHAR(10)); -- (1b) 2. Precisely typed: CREATE TABLE t1 (a CHAR(10) COLLATE latin1_bin); -- (2a) CREATE TABLE t1 ( a CHAR(10) CHARACTER SET latin1 COLLATE latin1_bin); -- (2b) 3. Contextually typed: CREATE TABLE t2 (a CHAR(10) BINARY) CHARACTER SET latin2; -- (3a) CREATE TABLE t2 (a CHAR(10) BINARY); -- (3b) CREATE TABLE t2 (a CHAR(10) COLLATE DEFAULT) CHARACER SET latin2 COLLATE latin2_bin; -- (3c) In case of an empty or a contextually typed collation, it is a subject to later resolution, when the context character set becomes known in the end of the CREATE statement: - either after the explicit table level CHARACTER SET, like in (1a,3a,3c) - or by the inhereted database level CHARACTER SET, like in (1b,3b) Resolution happens in Type_handler::Column_definition_prepare_stage1(). */ struct Lex_exact_charset_extended_collation_attrs_st { public: enum Type { TYPE_EMPTY= 0, TYPE_CHARACTER_SET= 1, TYPE_COLLATE_EXACT= 2, TYPE_CHARACTER_SET_COLLATE_EXACT= 3, TYPE_COLLATE_CONTEXTUALLY_TYPED= 4 }; // Number of bits required to store enum Type values #define LEX_CHARSET_COLLATION_TYPE_BITS 3 #define LEX_CHARSET_COLLATION_TYPE_MASK ((1<= TYPE_COLLATE_CONTEXTUALLY_TYPED, "Lex_exact_charset_extended_collation_attrs_st::Type bits"); protected: CHARSET_INFO *m_ci; Type m_type; protected: static Type type_from_lex_collation_type(Lex_extended_collation_st::Type type) { switch (type) { case Lex_extended_collation_st::TYPE_EXACT: return TYPE_COLLATE_EXACT; case Lex_extended_collation_st::TYPE_CONTEXTUALLY_TYPED: return TYPE_COLLATE_CONTEXTUALLY_TYPED; } DBUG_ASSERT(0); return TYPE_COLLATE_EXACT; } public: void init() { m_ci= NULL; m_type= TYPE_EMPTY; } void init(CHARSET_INFO *cs, Type type) { DBUG_ASSERT(cs || type == TYPE_EMPTY); m_ci= cs; m_type= type; } void init(const Lex_exact_charset &cs) { m_ci= cs.charset_info(); m_type= TYPE_CHARACTER_SET; } void init(const Lex_exact_collation &cs) { m_ci= cs.charset_info(); m_type= TYPE_COLLATE_EXACT; } void init(const Lex_exact_charset_opt_extended_collate &cscl) { if (cscl.with_collate()) init(cscl.collation().charset_info(), TYPE_CHARACTER_SET_COLLATE_EXACT); else init(cscl.charset()); } bool is_empty() const { return m_type == TYPE_EMPTY; } void set_charset(const Lex_exact_charset &cs) { m_ci= cs.charset_info(); m_type= TYPE_CHARACTER_SET; } bool set_charset_collate_default(const Lex_exact_charset &cs) { CHARSET_INFO *ci; if (!(ci= Lex_exact_charset_opt_extended_collate(cs). find_default_collation())) return true; m_ci= ci; m_type= TYPE_CHARACTER_SET_COLLATE_EXACT; return false; } bool set_charset_collate_binary(const Lex_exact_charset &cs) { CHARSET_INFO *ci; if (!(ci= Lex_exact_charset_opt_extended_collate(cs).find_bin_collation())) return true; m_ci= ci; m_type= TYPE_CHARACTER_SET_COLLATE_EXACT; return false; } void set_collate_default() { m_ci= &my_collation_contextually_typed_default; m_type= TYPE_COLLATE_CONTEXTUALLY_TYPED; } void set_contextually_typed_binary_style() { m_ci= &my_collation_contextually_typed_binary; m_type= TYPE_COLLATE_CONTEXTUALLY_TYPED; } bool is_contextually_typed_collate_default() const { return Lex_context_collation(m_ci).is_contextually_typed_collate_default(); } CHARSET_INFO *charset_info() const { return m_ci; } Type type() const { return m_type; } bool is_contextually_typed_collation() const { return m_type == TYPE_COLLATE_CONTEXTUALLY_TYPED; } CHARSET_INFO *resolved_to_character_set(CHARSET_INFO *cs) const; /* Merge the column CHARACTER SET clause to: - an exact collation name - a contextually typed collation "this" corresponds to `CHARACTER SET xxx [BINARY]` "cl" corresponds to the COLLATE clause */ bool merge_column_charset_clause_and_collate_clause( const Lex_exact_charset_extended_collation_attrs_st &cl) { switch (cl.type()) { case TYPE_EMPTY: return false; case TYPE_COLLATE_EXACT: return merge_exact_collation(Lex_exact_collation(cl.charset_info())); case TYPE_COLLATE_CONTEXTUALLY_TYPED: return merge_context_collation(Lex_context_collation(cl.charset_info())); case TYPE_CHARACTER_SET: case TYPE_CHARACTER_SET_COLLATE_EXACT: break; } DBUG_ASSERT(0); return false; } /* This method is used in the "attribute_list" rule to merge two independent COLLATE clauses (not belonging to a CHARACTER SET clause). "BINARY" and "COLLATE DEFAULT" are not possible in an independent COLLATE clause in a column attribute. */ bool merge_column_collate_clause_and_collate_clause( const Lex_exact_charset_extended_collation_attrs_st &cl) { DBUG_ASSERT(m_type != TYPE_CHARACTER_SET); switch (cl.type()) { case TYPE_EMPTY: return false; case TYPE_COLLATE_EXACT: return merge_exact_collation(Lex_exact_collation(cl.charset_info())); case TYPE_COLLATE_CONTEXTUALLY_TYPED: return merge_context_collation(Lex_context_collation(cl.charset_info())); case TYPE_CHARACTER_SET: case TYPE_CHARACTER_SET_COLLATE_EXACT: break; } DBUG_ASSERT(0); return false; } bool merge_exact_charset(const Lex_exact_charset &cs); bool merge_exact_collation(const Lex_exact_collation &cl); bool merge_context_collation(const Lex_context_collation &cl); bool merge_collation(const Lex_extended_collation_st &cl); }; class Charset_collation_context { /* Although the goal of m_charset_default is to store the meaning of CHARACTER SET DEFAULT, it does not necessarily point to a default collation of CHARACTER SET DEFAULT. It can point to its any arbitrary collation. For performance purposes we don't need to find the default collation at the instantiation time of "this", because: - m_charset_default may not be even needed during the resolution - when it's needed, in many cases it's passed to my_charset_same(), which does not need the default collation again. Note, m_charset_default and m_collate_default are not necessarily equal. - The default value for CHARACTER SET is taken from the upper level: CREATE DATABASE db1 CHARACTER SET DEFAULT; <-- @@character_set_server ALTER DATABASE db1 CHARACTER SET DEFAULT; <-- @@character_set_server - The default value for COLLATE is taken from the upper level for CREATE: CREATE DATABASE db1 COLLATE DEFAULT; <-- @@collation_server CREATE TABLE db1.t1 COLLATE DEFAULT; <-- character set of "db1" - The default value for COLLATE is taken from the same level for ALTER: ALTER DATABASE db1 COLLATE DEFAULT; <-- the default collation of the current db1 character set ALTER TABLE db1.t1 COLLATE DEFAULT; <-- the default collation of the current db1.t1 character set */ // comes from the upper level Lex_exact_charset_opt_extended_collate m_charset_default; // comes from the upper or the current level Lex_exact_collation m_collate_default; public: Charset_collation_context(CHARSET_INFO *charset_default, CHARSET_INFO *collate_default) :m_charset_default(charset_default, !(charset_default->state & MY_CS_PRIMARY)), m_collate_default(collate_default) { } const Lex_exact_charset_opt_extended_collate charset_default() const { return m_charset_default; } const Lex_exact_collation collate_default() const { return m_collate_default; } }; /* A universal container. It can store at the same time: - CHARACTER SET DEFAULT - CHARACTER SET cs_exact - COLLATE {cl_exact|cl_context} All three parts can co-exist. All three parts are optional. Parts can come in any arbitrary order, e.g: CHARACTER SET DEFAULT [CHARACTER SET latin1] COLLATE latin1_bin CHARACTER SET latin1 CHARACTER SET DEFAULT COLLATE latin1_bin COLLATE latin1_bin [CHARACTER SET latin1] CHARACTER SET DEFAULT COLLATE latin1_bin CHARACTER SET DEFAULT [CHARACTER SET latin1] */ class Lex_extended_charset_extended_collation_attrs_st: public Lex_opt_context_charset_st, public Lex_exact_charset_extended_collation_attrs_st { enum charset_type_t { CHARSET_TYPE_EMPTY, CHARSET_TYPE_CONTEXT, CHARSET_TYPE_EXACT }; /* Which part came first: - CHARACTER SET DEFAULT or - CHARACTER SET cs_exact e.g. to produce error messages preserving the user typed order of CHARACTER SET clauses in case of conflicts. */ charset_type_t m_charset_order; public: void init() { Lex_opt_context_charset_st::init(); Lex_exact_charset_extended_collation_attrs_st::init(); m_charset_order= CHARSET_TYPE_EMPTY; } void init(const Lex_exact_charset_opt_extended_collate &c) { Lex_opt_context_charset_st::init(); Lex_exact_charset_extended_collation_attrs_st::init(c); m_charset_order= CHARSET_TYPE_EXACT; } bool is_empty() const { return Lex_opt_context_charset_st::is_empty() && Lex_exact_charset_extended_collation_attrs_st::is_empty(); } bool raise_if_charset_conflicts_with_default( const Lex_exact_charset_opt_extended_collate &def) const; CHARSET_INFO *resolved_to_context(const Charset_collation_context &ctx) const; bool merge_charset_default(); bool merge_exact_charset(const Lex_exact_charset &cs); }; class Lex_exact_charset_extended_collation_attrs: public Lex_exact_charset_extended_collation_attrs_st { public: Lex_exact_charset_extended_collation_attrs() { init(); } Lex_exact_charset_extended_collation_attrs(CHARSET_INFO *collation, Type type) { init(collation, type); } explicit Lex_exact_charset_extended_collation_attrs(const Lex_exact_charset &cs) { init(cs.charset_info(), TYPE_CHARACTER_SET); } explicit Lex_exact_charset_extended_collation_attrs(const Lex_exact_collation &cl) { init(cl.charset_info(), TYPE_COLLATE_EXACT); } explicit Lex_exact_charset_extended_collation_attrs(const Lex_context_collation &cl) { init(cl.charset_info(), TYPE_COLLATE_CONTEXTUALLY_TYPED); } explicit Lex_exact_charset_extended_collation_attrs( const Lex_exact_charset_opt_extended_collate &cscl) { init(cscl); } explicit Lex_exact_charset_extended_collation_attrs(const Lex_extended_collation_st &cl) { init(cl.charset_info(), type_from_lex_collation_type(cl.type())); } static Lex_exact_charset_extended_collation_attrs national(bool bin_mod) { return bin_mod ? Lex_exact_charset_extended_collation_attrs(&my_charset_utf8mb3_bin, TYPE_COLLATE_EXACT) : Lex_exact_charset_extended_collation_attrs(&my_charset_utf8mb3_general_ci, TYPE_CHARACTER_SET); } }; class Lex_extended_charset_extended_collation_attrs: public Lex_extended_charset_extended_collation_attrs_st { public: Lex_extended_charset_extended_collation_attrs() { init(); } explicit Lex_extended_charset_extended_collation_attrs( const Lex_exact_charset_opt_extended_collate &c) { init(c); } }; using Lex_column_charset_collation_attrs_st = Lex_exact_charset_extended_collation_attrs_st; using Lex_column_charset_collation_attrs = Lex_exact_charset_extended_collation_attrs; using Lex_table_charset_collation_attrs_st = Lex_extended_charset_extended_collation_attrs_st; using Lex_table_charset_collation_attrs = Lex_extended_charset_extended_collation_attrs; #endif // LEX_CHARSET_INCLUDED