← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

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

  • Committer: Brian Aker
  • Date: 2011-02-17 10:09:00 UTC
  • mfrom: (2173.2.1 clean-include-usuage)
  • Revision ID: brian@tangent.org-20110217100900-4tpuxxzdl1sj00sh
Merge Monty for headers.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/functions/string/length.rst
 
1
Length and Size Functions
 
2
=========================
 
3
 
 
4
BIT_LENGTH
 
5
----------
 
6

The BIT_LENGTH(str) function return the String str length in bits. Here are the some example of the BIT_LENGTH(str) function:
     
 
7
For example: ::
 
8
 
 
9
        SELECT BIT_LENGTH('a');
 
10
 
 
11
Returns 8
 
12
 
 
13
CHAR_LENGTH
 
14
-----------
 
15

The CHAR_LENGTH(str) function returns string length measured in characters. 
 
16
 
 
17
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. ::
       
 
18
        CHARACTER_LENGTH(str)

 
19
This function is same as CHAR_LENGTH(). 
 
20
 
 
21
 
 
22
LENGTH()
 
23
--------
 
24
 
 
25
The LENGTH function returns the length of the string argument in bytes. A multi-byte character counts as multiple bytes. This means that for a string containing a three-byte character, LENGTH() returns 3, whereas CHAR_LENGTH() returns 1. For example: ::
 
26
 
 
27
        select length(_utf8 '€');
 
28
 
 
29
Returns 3
 
30
 
 
31
The is because the Euro sign is encoded as 0xE282AC in UTF-8 and thereby occupies 3 bytes.
 
32
 
 
33
 
 
34
OCTET_LENGTH()            
 
35
---------------
 
36
 
 
37
A synonym for LENGTH()