~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/functions/string/conversion.rst

new string function docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Conversion Functions
 
2
====================
 
3
 
 
4
ASCII
 
5
-----
 
6

The ASCII(str) function returns the numeric value of the leftmost character of the string ’str’. It returns NULL if str is NULL. It works for 8-bit characters.
 
7
 
 
8
For example:  ::
 
9
 
 
10
        SELECT ASCII('0');
 
11
 
 
12
Returns 48 ::
 
13
 
 
14
        SELECT ASCII('d');
 
15
 
 
16
Returns 100
 
17
 
 
18
CHAR
 
19
----
 
20

SQL CHAR function is the opposite of the ASCII function. It converts an integer in range 0-255 into a ASCII character. It returns a string (the character), given the integer value. This function skips NULL values.   

 
21
For example: ::
 
22
 
 
23
        SELECT CHAR(65) AS ch_65;
 
24
 
 
25
Returns "A"
 
26
 
 
27
CHAR_LENGTH
 
28
-----------
 
29

The CHAR_LENGTH(str) function returns string length measured in characters. 
 
30
 
 
31
A multi-byte character counts as single character such as a string contains 5 two-byte characters, then LENGTH() function returns 10, but the CHAR_LENGTH() returns 5. ::
       
 
32
        CHARACTER_LENGTH(str)

 
33
This function is same as CHAR_LENGTH(). 

 
34
 
 
35
BIN
 
36
---
 
37

The BIN string function returns a string value that represents the binary value of N, where N is a longlong(BIGINT) number. This function is equivalent to CONV(N, 10 , 0). If the function return the null then N is null. 
 
38
 
 
39
Syntax:
 
40
 
 
41
BIN (N);
 
42
 
 
43
For exempt: ::
 
44
 
 
45
        SELECT BIN(12);
 
46
 
 
47
Returns: '1100'