Table 11.14. Cast Functions
| Name | Description |
|---|---|
BINARY | Cast a string to a binary string |
CAST() | Cast a value as a certain type |
Convert() | Cast a value as a certain type |
The
BINARYoperator casts the string following it to a binary string. This is an easy way to force a column comparison to be done byte by byte rather than character by character. This causes the comparison to be case sensitive even if the column is not defined asBINARYorBLOB.BINARYalso causes trailing spaces to be significant.mysql>
SELECT 'a' = 'A';-> 1 mysql>SELECT BINARY 'a' = 'A';-> 0 mysql>SELECT 'a' = 'a ';-> 1 mysql>SELECT BINARY 'a' = 'a ';-> 0In a comparison,
BINARYaffects the entire operation; it can be given before either operand with the same result.BINARYis shorthand forstrCAST(.strAS BINARY)Note that in some contexts, if you cast an indexed column to
BINARY, MySQL is not able to use the index efficiently.The
CAST()function takes a value of one type and produce a value of another type, similar toCONVERT(). See the description ofCONVERT()for more information.CONVERT(,expr,type)CONVERT(exprUSINGtranscoding_name)The
CONVERT()andCAST()functions take a value of one type and produce a value of another type.The
typecan be one of the following values:BINARYproduces a string with theBINARYdata type. See Section 10.4.2, “TheBINARYandVARBINARYTypes” for a description of how this affects comparisons. If the optional lengthNis given,BINARY(causes the cast to use no more thanN)Nbytes of the argument. Values shorter thanNbytes are padded with0x00bytes to a length ofN.CHAR(causes the cast to use no more thanN)Ncharacters of the argument.CAST()andCONVERT(... USING ...)are standard SQL syntax. The non-USINGform ofCONVERT()is ODBC syntax.CONVERT()withUSINGis used to convert data between different character sets. In MySQL, transcoding names are the same as the corresponding character set names. For example, this statement converts the string'abc'in the default character set to the corresponding string in theutf8character set:SELECT CONVERT('abc' USING utf8);
Normally, you cannot compare a BLOB
value or other binary string in case-insensitive fashion because
binary strings have no character set, and thus no concept of
lettercase. To perform a case-insensitive comparison, use the
CONVERT() function to convert the
value to a nonbinary string. Comparisons of the result use the
string collation. For example, if the character set of the result
has a case-insensitive collation, a
LIKE operation is not case sensitive:
SELECT 'A' LIKE CONVERT(blob_colUSING latin1) FROMtbl_name;
To use a different character set, substitute its name for
latin1 in the preceding statement. To specify a
particular collation for the converted string, use a
COLLATE clause following the
CONVERT() call, as described in
Section 9.1.9.2, “CONVERT() and
CAST()”. For example, to use
latin1_german1_ci:
SELECT 'A' LIKE CONVERT(blob_colUSING latin1) COLLATE latin1_german1_ci FROMtbl_name;
CONVERT() can be used more
generally for comparing strings that are represented in different
character sets.
LOWER() (and
UPPER()) are ineffective when
applied to binary strings (BINARY,
VARBINARY,
BLOB). To perform lettercase
conversion, convert the string to a nonbinary string:
mysql>SET @str = BINARY 'New York';mysql>SELECT LOWER(@str), LOWER(CONVERT(@str USING latin1));+-------------+-----------------------------------+ | LOWER(@str) | LOWER(CONVERT(@str USING latin1)) | +-------------+-----------------------------------+ | New York | new york | +-------------+-----------------------------------+
The cast functions are useful when you want to create a column
with a specific type in a
CREATE TABLE ...
SELECT statement:
CREATE TABLE new_table SELECT CAST('2000-01-01' AS DATE);
The functions also can be useful for sorting
ENUM columns in lexical order.
Normally, sorting of ENUM columns
occurs using the internal numeric values. Casting the values to
CHAR results in a lexical sort:
SELECTenum_colFROMtbl_nameORDER BY CAST(enum_colAS CHAR);
CAST( is the same thing as
str AS
BINARY)BINARY
.
strCAST( treats the expression as a string with the default
character set.
expr AS
CHAR)
CAST() also changes the result if
you use it as part of a more complex expression such as
CONCAT('Date: ',CAST(NOW() AS
DATE)).
You should not use CAST() to
extract data in different formats but instead use string functions
like LEFT() or
EXTRACT(). See
Section 11.7, “Date and Time Functions”.
To cast a string to a numeric value in numeric context, you normally do not have to do anything other than to use the string value as though it were a number:
mysql> SELECT 1+'1';
-> 2
If you use a string in an arithmetic operation, it is converted to a floating-point number during expression evaluation.
If you use a number in string context, the number automatically is converted to a string:
mysql> SELECT CONCAT('hello you ',2);
-> 'hello you 2'
For information about implicit conversion of numbers to strings, see Section 11.2, “Type Conversion in Expression Evaluation”.
MySQL supports arithmetic with both signed and unsigned 64-bit
values. If you are using numeric operators (such as
+ or
-) and one of the
operands is an unsigned integer, the result is unsigned by default
(see Section 11.6.1, “Arithmetic Operators”). You can override
this by using the SIGNED or
UNSIGNED cast operator to cast a value to a
signed or unsigned 64-bit integer, respectively.
mysql>SELECT CAST(1-2 AS UNSIGNED)-> 18446744073709551615 mysql>SELECT CAST(CAST(1-2 AS UNSIGNED) AS SIGNED);-> -1
If either operand is a floating-point value, the result is a
floating-point value and is not affected by the preceding rule.
(In this context, DECIMAL column
values are regarded as floating-point values.)
mysql> SELECT CAST(1 AS UNSIGNED) - 2.0;
-> -1.0
The SQL mode affects the result of conversion operations. Examples:
If you convert a “zero” date string to a date,
CONVERT()andCAST()returnNULLand produce a warning when theNO_ZERO_DATESQL mode is enabled.For integer subtraction, if the
NO_UNSIGNED_SUBTRACTIONSQL mode is enabled, the subtraction result is signed even if any operand is unsigned.
For more information, see Section 5.1.7, “Server SQL Modes”.