collations.h

/*
 * Copyright (c) 2016, 2024, Oracle and/or its affiliates.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2.0, as
 * published by the Free Software Foundation.
 *
 * This program is designed to work with certain software (including
 * but not limited to OpenSSL) that is licensed under separate terms, as
 * designated in a particular file or component or in included license
 * documentation. The authors of MySQL hereby grant you an additional
 * permission to link the program and your derivative works with the
 * separately licensed software that they have either included with
 * the program or referenced in the documentation.
 *
 * Without limiting anything contained in the foregoing, this file,
 * which is part of Connector/C++, is also subject to the
 * Universal FOSS Exception, version 1.0, a copy of which can be found at
 * https://oss.oracle.com/licenses/universal-foss-exception.
 *
 * 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, version 2.0, 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
 */
 
#ifndef MYSQLX_COLLATIONS_H
#define MYSQLX_COLLATIONS_H
 
#include "common.h"
 
/*
  Import Lists of built-in character sets and collations supported by MySQL
  Server.
*/
 
#include "mysql_charsets.h"
#include "mysql_collations.h"
 
 
namespace mysqlx {
MYSQLX_ABI_BEGIN(2,0)
 
/*
  Enumeration of known character sets. For each character set CS listed
  in CDK_CS_LIST() macro, there is CharacterSet::CS constant in this
  enumeration.
*/
 
 
enum class CharacterSet : unsigned short
{
  #undef CS
  #define CS_ENUM(CS)  CS,
  CDK_CS_LIST(CS_ENUM)
};
 
 
#define CS_NAME_SWITCH(CS)  case CharacterSet::CS: return #CS;
 
inline
const char* characterSetName(CharacterSet id)
{
  switch (id)
  {
    CDK_CS_LIST(CS_NAME_SWITCH)
  default:
    THROW("Unknown character set id");
  }
}
 
 
struct CollationInfo
{
 
  unsigned id() const { return m_id; }
 
 
  const char *getName() const { return m_name; }
 
 
  CharacterSet getCharacterSet() const { return m_cs; }
 
  bool  isCaseSensitive() const { return m_case != case_ci; }
 
 
  bool  isBinary() const { return m_case == case_bin; }
 
 
  bool  operator==(const CollationInfo &other) const
  {
    return m_id == other.m_id;
  }
 
  bool  operator!=(const CollationInfo &other) const
  {
    return !operator==(other);
  }
 
private:
 
  enum coll_case { case_bin, case_ci, case_cs };
 
  CharacterSet m_cs;
  unsigned m_id;
  coll_case m_case;
  const char *m_name;
 
public:
 
  struct Access;
  friend Access;
};
 
 
template <CharacterSet CS> struct Collation;
 
 
/*
  The Collation<CS>::COLL constants are generated from information provided by
  COLLATION_XXX() macros.Each line X(CS, ID, COLL, CASE) in the expansion of
  a COLLATION_XXX() macro declares collation with name COLL for character set
  CS. ID is the MySQL id number for the collation. CASE is one of ci, cs or bin
  and indicates whether it is case insensitive, sensitive or binary collation,
  respectively.
*/
 
/*
  Generate declarations of Collation<CS>::COLL constants using
  COLLATINS_XXX() macros. The list CS_LIST() is processed using
  COLL_DECL() macro, which for each character set CS declares
  specialization Collation<CS> of the Collation<> template and
  declares collation constants within this specialization.
 
  The collation constant declarations are generated by processing
  COLLATIONS_CS() list with COLL_CONST() macro. The name of each
  constant is generated by COLL_CONST_NAME() macro. The convention
  used is that case insensitive and case sensitive collations get
  a _ci or _cs suffix, respectively, while binary collation constant
  have no suffix to the collation name.
 
  Collation constants declared here are defined in file result.cc.
*/
 
#define COLL_DECL(CS) \
template<> struct Collation<CharacterSet::CS> \
{ COLLATIONS_##CS(COLL_CONST) }; \
 
#define COLL_CONST(CS,ID,COLL,CASE) \
static PUBLIC_API const CollationInfo COLL_CONST_NAME(COLL,CASE);
 
#define COLL_CONST_NAME(COLL,CASE) COLL_CONST_NAME_##CASE(COLL)
 
#define COLL_CONST_NAME_bin(COLL)   COLL
#define COLL_CONST_NAME_ci(COLL)    COLL##_ci
#define COLL_CONST_NAME_ai_ci(COLL) COLL##_ai_ci
#define COLL_CONST_NAME_cs(COLL)    COLL##_cs
#define COLL_CONST_NAME_as_cs(COLL) COLL##_as_cs
#define COLL_CONST_NAME_as_ci(COLL) COLL##_as_ci
#define COLL_CONST_NAME_as_cs_ks(COLL) COLL##_as_cs_ks
 
// Add utf8mb4 alias for bin collation for compatibility
 
#undef  COLLATIONS_utf8mb4_EXTRA
#define COLLATIONS_utf8mb4_EXTRA \
static PUBLIC_API const CollationInfo utf8mb4;
 
CDK_CS_LIST(COLL_DECL)
 
#undef  COLLATIONS_utf8mb4_EXTRA
#define COLLATIONS_utf8mb4_EXTRA
 
 
MYSQLX_ABI_END(2,0)
}  // mysqlx
 
#endif