This shows you the differences between two versions of the page.
|
dev:sql:functions:character_length [2011/01/23 23:09] els |
dev:sql:functions:character_length [2016/06/28 22:38] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | {{page>:top_add&nofooter&noeditbtn}} | ||
| - | ====== Development: Omnidex SQL ====== | ||
| - | |||
| - | ===== 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. | ||
| - | |||
| - | 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. | ||
| - | |||
| - | This function returns an INTEGER datatype. | ||
| - | |||
| - | ===== Syntax ==== | ||
| - | CHAR[ACTER]_LENGTH ( character_expression ) | ||
| - | |||
| - | == character_expression == | ||
| - | 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 ==== | ||
| - | === Example 1: Column === | ||
| - | <code> | ||
| - | > select name, character_length(name) len from individuals; | ||
| - | |||
| - | NAME LEN | ||
| - | -------------------------------------------------- ----------- | ||
| - | MS. MARY LEWIS 14 | ||
| - | MRS. ALICE R TOLLIVER 21 | ||
| - | MR. SIDNEY K TOLLIVER 21 | ||
| - | MRS. JENNIFER J HOPKINS 23 | ||
| - | MR. CHARLIE HOPKINS 19 | ||
| - | MS. KIMBERLY BLUE 17 | ||
| - | KATHLEEN TUCKER 15 | ||
| - | |||
| - | </code> | ||
| - | |||
| - | === Example 2: Character Expression === | ||
| - | <code> | ||
| - | > select gender, name, char_length(gender || name) len from individuals; | ||
| - | |||
| - | G NAME LEN | ||
| - | - -------------------------------------------------- ----------- | ||
| - | F MS. MARY LEWIS 15 | ||
| - | F MRS. ALICE R TOLLIVER 22 | ||
| - | M MR. SIDNEY K TOLLIVER 22 | ||
| - | F MRS. JENNIFER J HOPKINS 24 | ||
| - | M MR. CHARLIE HOPKINS 20 | ||
| - | F MS. KIMBERLY BLUE 18 | ||
| - | F KATHLEEN TUCKER 16 | ||
| - | |||
| - | </code> | ||
| - | ====== Additional Resources ====== | ||
| - | |||
| - | See also: | ||
| - | {{page>dev:sql:functions:see_also_string&nofooter&noeditbtn&noheader}} | ||
| - | |||
| - | {{page>:bottom_add&nofooter&noeditbtn}} | ||