This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
dev:sql:functions:character_length [2010/07/09 03:25] els |
dev:sql:functions:character_length [2016/06/28 22:38] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
{{page>:top_add&nofooter&noeditbtn}} | {{page>:top_add&nofooter&noeditbtn}} | ||
- | {{page>:sql_bar&nofooter&noeditbtn}} | + | |
- | ====== Omnidex SQL Function: CHARACTER_LENGTH ====== | + | ====== Development: Omnidex SQL ====== |
- | ===== Description ===== | + | |
+ | ===== SQL Functions: CHARACTER_LENGTH ====== | ||
+ | |||
+ | ==== Description ==== | ||
The CHARACTER_LENGTH function returns the number of characters in a string. The abbreviation, CHAR_LENGTH, is supported as a synonym for CHARACTER_LENGTH. | The CHARACTER_LENGTH function returns the number of characters in a string. The abbreviation, CHAR_LENGTH, is supported as a synonym for CHARACTER_LENGTH. | ||
- | CHARACTER_LENGTH should not be confused with $DATA_LENGTH and $COLUMN_LENGTH. $DATA_LENGTH returns the number of characters plus the null-terminator for C STRING datatypes. $COLUMN_LENGTH returns the length of the column as declared in the table. | + | CHARACTER_LENGTH should not be confused with $DATA_LENGTH and $COLUMN_LENGTH. $DATA_LENGTH returns the number of characters plus the null-terminator for STRING datatypes. $COLUMN_LENGTH returns the length of the column as declared in the table. |
This function returns an INTEGER datatype. | This function returns an INTEGER datatype. | ||
- | ===== Syntax ===== | + | ===== Syntax ==== |
CHAR[ACTER]_LENGTH ( character_expression ) | CHAR[ACTER]_LENGTH ( character_expression ) | ||
Line 15: | Line 18: | ||
Required. Any expression that returns a character-class datatype. Examples of expressions are columns, concatenations of columns, literal strings and functions that return a character datatype. | Required. Any expression that returns a character-class datatype. Examples of expressions are columns, concatenations of columns, literal strings and functions that return a character datatype. | ||
- | ===== Examples ===== | + | ==== Examples ==== |
- | ==== Example 1: Column ==== | + | === Example 1: Column === |
<code> | <code> | ||
> select name, character_length(name) len from individuals; | > select name, character_length(name) len from individuals; | ||
Line 32: | Line 35: | ||
</code> | </code> | ||
- | ==== Example 2: Character Expression ==== | + | === Example 2: Character Expression === |
<code> | <code> | ||
> select gender, name, char_length(gender || name) len from individuals; | > select gender, name, char_length(gender || name) len from individuals; | ||
Line 47: | Line 50: | ||
</code> | </code> | ||
+ | ====== Additional Resources ====== | ||
+ | |||
+ | See also: | ||
+ | {{page>dev:sql:functions:see_also_string&nofooter&noeditbtn&noheader}} | ||
{{page>:bottom_add&nofooter&noeditbtn}} | {{page>:bottom_add&nofooter&noeditbtn}} |