Робота з рядками

ASCII(str string)
BIN(int integer)
CHAR(int integer, ...)
CHARACTER_LENGTH(str string)
CHAR_LENGTH(str string)
CONCAT(str1 string, str2 string,...)
CONCAT_WS(separator string, str1 string, str2 string,...)
CONV(int_or_str integer or string, from_base integer, to_base integer)
ELT( N integer, str1 string, str2 string, str3 string,...)
EXPORT_SET( bits, on string , off string, [separator char, [number_of_bits integer]])
FIELD( str string, str1 string, str2 string, str3 string,...)
FIND_IN_SET( str string, strlist string )
HEX(int_or_str string or integer)
INSERT( str string, pos integer, len integer, newstr string )
INSTR( str string, substr string)
LCASE( str string ) string
LEFT( str string, len integer)
LENGTH(str string)
LOAD_FILE( file_name string )
LOCATE(substr string, str string, pos integer)
LOWER( str string )
LPAD( str string, len integer, padstr string)
LTRIM( str string )
MAKE_SET( bits, str1 string , str2 string ,...)
MID(str string, pos integer, len integer)
OCT(int integer)
OCTET_LENGTH(str string)
LOCATE(substr string, str string)
ORD(str string)
POSITION(substr string IN str string)
REPLACE( str string, from_str string, to_str string)
REPEAT( str string, count integer)
REVERSE( str string )
RIGHT( str string, len integer)
RPAD( str string, len integer, padstr string)
RTRIM( str string )
SOUNDEX( str string )
SPACE( N integer )
SUBSTRING(str string FROM pos integer FOR len integer)
SUBSTRING_INDEX( str string, delim string, count integer)
TRIM( [[BOTH | LEADING | TRAILING] [remstr] string FROM] str string )
UCASE( str string )
UPPER( str string )

Будь-яка строкова функція поверне NULL, якщо рядок результату перевищує довжину, встановлену параметром сервера max_allowed_packet.

 

integer ASCII(str string)

Повертає ASCII-код першого лівого символу рядка str. Повертає 0, якщо рядок str порожній. Повертає NULL, якщо рядок str не існує.

Приклади:

mysql> select ASCII('2');
        -> 50
mysql> select ASCII(2);
        -> 50
mysql> select ASCII('dx');
        -> 100

Див. також ORD().

 

integer ORD(str string)

У випадку, якщо перший лівий символ рядка str є багатобайтовим, повертає його код у форматі: ((перший байт ASCII-код)*256+(другий байт ASCII-код))[*256+третій байт ASCII-код...].

Якщо перший лівий символ рядка str не є багатобайтовим, то дія аналогічна дії функції ASCII() - повертає ASCII-код першого лівого символу рядка str.

Приклади:

mysql> select ORD('2');
        -> 50

Див. також ASCII().

 

string CONV(int_or_str integer or string, from_base integer, to_base integer)

Потужна функція для конвертування числа (int_or_str ) з однієї системи числення (from_base) в іншу систему (to_base). Повертає NULL, якщо аргументи NULL. Мінімальне значення .._base - 2, максимальне 36.

Приклади:

mysql> select CONV("a",16,2);
        -> '1010'
mysql> select CONV("6E",18,8);
        -> '172'
mysql> select CONV(-17,10,-18);
        -> '-H'
mysql> select CONV(10+"10"+'10'+0xa,10,10);
        -> '40'

Див. також BIN(), OCT(), HEX().

 

string BIN(int integer)

Повертає двійкове значення аргументу int. Аналогічно дії CONV(int,10,2). Повертає NULL, якщо аргумент int NULL.

Приклади:

mysql> select BIN(12);
        -> '1100'

Див. також CONV().

 

string OCT(int integer)

Повертає вісімкове значення аргументу int. Аналогічно дії CONV(int,10,8). Повертає NULL, якщо аргумент int NULL.

Приклади:

mysql> select OCT(12);
        -> '14'

Див. також CONV().

 

string HEX(int_or_str string or integer)

Повертає шістнадцяткове значення аргументу int_or_string. Аналогічно дії CONV(int,10,16). Повертає NULL, якщо аргумент int_or_string NULL.

Приклади:

mysql> select HEX(255);
        -> 'FF'
mysql> select HEX("abc");
        -> 616263
mysql> select 0x616263;
        -> "abc"

Див. також CONV().

 

string CHAR(int integer, ...)

Повертає рядок символів визначених кодом/кодами ASCII. Значення NULL пропускається.

Приклади:

mysql> select CHAR(77,121,83,81,'76');
        -> 'MySQL'
mysql> select CHAR(77,77.3,'77.3');
        -> 'MMM'

Див. також ASCII(), ORD().

 

string CONCAT(str1 string, str2 string,...)

Об'єднує рядки Результатом є рядок, що складається з аргументів. Повертає NULL, якщо будь-який з аргументів є NULL. Може бути більше 2 аргументів. Числові аргументи конвертуються у відповідні рядки.

Приклади:

mysql> select CONCAT('My', 'S', 'QL');
        -> 'MySQL'
mysql> select CONCAT('My', NULL, 'QL');
        -> NULL
mysql> select CONCAT(14.3);
        -> '14.3'

Див. також CONCAT_WS().

 

string CONCAT_WS(separator string, str1 string, str2 string,...)

Об'єднує рядки подібно до функції CONCAT(), але з розділювачем separator, який вставляється між рядками-аргументами. Якщо separator є NULL, то результат буде NULL. Функція пропускає інші аргументи, якщо їх значення NULL.

Приклади:

mysql> select CONCAT_WS(",","First name","Second name","Last Name");
       -> 'First name,Second name,Last Name'
mysql> select CONCAT_WS(",","First name",NULL,"Last Name");
       -> 'First name,Last Name'

Див. також CONCAT().

 

integer LENGTH(str string)

Функції повертають довжину рядка str.

Приклади:

mysql> select LENGTH('text');
        -> 4

Примітка: багатобайтові символи враховуються функцією CHAR_LENGTH().

Див. також OCTET_LENGTH(), CHAR_LENGTH(), CHARACTER_LENGTH().

 

integer OCTET_LENGTH(str string)

Функції повертають довжину рядка str.

Приклади:

mysql> select OCTET_LENGTH('text');
        -> 4

Примітка: багатобайтові символи враховуються функцією CHAR_LENGTH().

Див. також LENGTH(), CHAR_LENGTH(), CHARACTER_LENGTH().

 

integer CHAR_LENGTH(str string)

Функції повертають довжину рядка str. Підтримує багатобайтові символи.

Приклади:

mysql> select CHAR_LENGTH('text');
        -> 4

Див. також LENGTH(), OCTET_LENGTH(), CHARACTER_LENGTH().

 

integer CHARACTER_LENGTH(str string)

Функції повертають довжину рядка str.

Приклади:

mysql> select CHARACTER_LENGTH('text');
        -> 4

Примітка: багатобайтові символи враховуються функцією CHAR_LENGTH().

Див. також LENGTH(), OCTET_LENGTH(), CHAR_LENGTH().

 

integer POSITION(substr string IN str string)

Повертає позицію першого входження підрядка substr у рядку str. Повертає 0, якщо substr не знайдено в рядку str. Підтримує багатобайтові символи.

Приклади:

mysql> select POSITION('bar', 'foobarbar');
        -> 4
mysql> select POSITION('xbar', 'foobar');
        -> 0

Див. також INSTR().

 

integer LOCATE(substr string, str string, pos integer)

LOCATE(substr string, str string) повертає позицію першого входження підрядка substr у рядку str. Повертає 0, якщо substr не знайдено в рядку str. LOCATE(substr string, str string, pos integer) повертає позицію першого входження підрядка substr у рядку str, але починаючи з pos. Повертає 0, якщо substr не знайдено в рядку str (з урахуванням позиції, звісно). Підтримує багатобайтові символи.

Приклади:

mysql> select LOCATE('bar', 'foobarbar',5);
        -> 7
mysql> select LOCATE('bar', 'foobarbar');
        -> 4
mysql> select LOCATE('xbar', 'foobar');
        -> 0

Див. також INSTR(), POSITION().

 

integer INSTR( str string, substr string)

Повертає позицію першого входження підрядка substr у рядку str. Повертає 0, якщо substr не знайдено в рядку str (з урахуванням позиції, звісно). Підтримує багатобайтові символи. Аналог LOCATE(), тільки аргументи поміняно місцями.

Приклади:

mysql> select INSTR('foobarbar', 'bar');
        -> 4
mysql> select INSTR('xbar', 'foobar');
        -> 0

Див. також LOCATE(), POSITION().

 

string LPAD( str string, len integer, padstr string)

Повертає рядок str, додавши до початку str рядок padstr і привівши загальну кількість символів у поверненому рядку до len. Якщо len більше, ніж сума довжин рядків, то різниця за рахунок повторення рядка padstr.

Приклади:

mysql> select LPAD('hi',4,'??');
        -> '??hi'

Див. також RPAD().

 

string RPAD( str string, len integer, padstr string)

Повертає рядок str, додавши до кінця str рядок padstr і привівши загальну кількість символів у поверненому рядку до len. Якщо len більше, ніж сума довжин рядків, то різниця за рахунок повторення рядка padstr.

Приклади:

mysql> select RPAD('hi',5,'?');
        -> 'hi???'

Див. також LPAD().

 

string LEFT( str string, len integer)

Повертає len перших символів із рядка str. Підтримує багатобайтові символи.

Приклади:

mysql> select LEFT('foobarbar', 5);
        -> 'fooba'

Див. також RIGHT(), SUBSTRING(), MID(), SUBSTRING_INDEX()

 

string RIGHT( str string, len integer)

Повертає len останніх символів із рядка str. Підтримує багатобайтові символи.

Приклади:

mysql> select RIGHT('foobarbar', 4);
        -> 'rbar'

Див. також LEFT(), SUBSTRING(), MID(), SUBSTRING_INDEX().

 

string SUBSTRING( str string, pos integer, len integer )

string SUBSTRING(str string FROM pos integer FOR len integer)

Повертає підрядок рядка str довжиною len символів з позиції pos. Підтримує багатобайтові символи. Варіант з "FROM " використовується в синтаксисі ANSI SQL92. У функції SUBSTRING(), якщо не вказано аргумент len, то повертає весь підрядок рядка str з позиції pos.

Приклади:

mysql> select SUBSTRING('Quadratically',5,6);
        -> 'ratica'
mysql> select SUBSTRING('Quadratically',5);
        -> 'ratically'
mysql> select SUBSTRING('foobarbar' FROM 4);
        -> 'barbar'

Див. також LEFT(), RIGHT(), SUBSTRING_INDEX().

 

string MID(str string, pos integer, len integer)

Повертає підрядок рядка str довжиною len символів з позиції pos. Підтримує багатобайтові символи. Варіант з "FROM " використовується в синтаксисі ANSI SQL92. У функції SUBSTRING(), якщо не вказано аргумент len, то повертає весь підрядок рядка str з позиції pos.

Приклади:

mysql> select MID('Quadratically',5,6);
        -> 'ratica'
mysql> select MID('Quadratically',5);
        -> 'ratically'
mysql> select MID('foobarbar' FROM 4);
        -> 'barbar'

Див. також LEFT(), RIGHT(), SUBSTRING_INDEX().

 

string SUBSTRING_INDEX( str string, delim string, count integer)

Повертає весь підрядок рядка str з позиції, визначеної розділювачем delim, що знаходиться за рахунком count.

Приклади:

mysql> select SUBSTRING_INDEX('www.mysql.com', '.', 2);
        -> 'www.mysql'
mysql> select SUBSTRING_INDEX('www.mysql.com', '.', -2);
        -> 'mysql.com'

Див. також LEFT(), SUBSTRING(), MID(), RIGHT().

 

string LTRIM( str string )

Повертає рядок str, видаливши пробіли з початку рядка. Підтримує багатобайтові символи.

Приклади:

mysql> select LTRIM('  barbar');
        -> 'barbar'

Див. також TRIM(), RTRIM().

 

string RTRIM( str string )

Повертає рядок str, видаливши пробіли з кінця рядка. Підтримує багатобайтові символи.

Приклади:

mysql> select RTRIM('barbar   ');
        -> 'barbar'

Див. також TRIM(), LTRIM().

 

string TRIM( [[BOTH | LEADING | TRAILING] [remstr] string FROM] str string )

З одним аргументом "str" - повертає рядок str, видаливши пробіли з кінця рядка. Аргумент "remstr" визначає символ/підрядок для видалення. Підтримує багатобайтові символи. mysql> select TRIM(' bar '); -> 'bar'

Приклади:

mysql> select TRIM('  bar   ');
        -> 'bar'
mysql> select TRIM(LEADING 'x' FROM 'xxxbarxxx');
        -> 'barxxx'
mysql> select TRIM(BOTH 'x' FROM 'xxxbarxxx');
        -> 'bar'
mysql> select TRIM(TRAILING 'xyz' FROM 'barxxyz');
        -> 'barx'

Див. також RTRIM(), LTRIM().

 

string SOUNDEX( str string )

Обчислює soundex ключ для str. Ключ soundex має таку властивість, що слова, які вимовляються однаково, мають однаковий soundex ключ, і це може бути використано для коригування результатів пошуку. Повертає рядок довжиною 4 символи, що починається літерою A-Z.

Приклади:

mysql> select SOUNDEX('Hello');
        -> 'H400'
mysql> select SOUNDEX('Quadratically');
        -> 'Q36324'

 

string SPACE( N integer )

Повертає рядок, що складається з N пробілів.

Приклади:

mysql> select SPACE(6);
        -> '      '

Див. також REPEAT().

 

string REPLACE( str string, from_str string, to_str string)

Повертає рядок str, замінивши в ньому всі підрядки from_str на to_str. Підтримує багатобайтові символи.

Приклади:

mysql> select REPLACE('www.websupport.maryan.com.ua', 'w', 'Ww');
        -> 'WwWwWw.Wwebsupport.maryan.com.ua'

 

string REPEAT( str string, count integer)

Повертає рядок, що складається з count разів повтореного рядка str. Поверне NULL, якщо один з аргументів NULL.

Приклади:

mysql> select REPEAT('MySQL', 3);
        -> 'MySQLMySQLMySQL'

Див. також SPACE().

 

string REVERSE( str string )

Повертає рядок, у якому всі символи з останнього на перший. Див. приклад. Підтримує багатобайтові символи.

Приклади:

mysql> select REVERSE('abc');
        -> 'cba'

 

string INSERT( str string, pos integer, len integer, newstr string )

Повертає рядок str, із вставкою підрядка newstr, з позиції pos рядка str і довжиною len символів. Підтримує багатобайтові символи.

Приклади:

mysql> select INSERT('Quadratic', 3, 4, 'What');
        -> 'QuWhattic'

 

string ELT( N integer, str1 string, str2 string, str3 string,...)

Поверне str1, якщо N = 1, str2 якщо N = 2, І так далі. Поверне NULL, якщо N менше 1 більше кількості аргументів.

Приклади:

mysql> select ELT(1, 'ej', 'Heja', 'hej', 'foo');
        -> 'ej'
mysql> select ELT(4, 'ej', 'Heja', 'hej', 'foo');
        -> 'foo'

Див. також FIELD().

 

integer FIELD( str string, str1 string, str2 string, str3 string,...)

Поверне індекс (номер за порядком) str зі списку рядків str1, str2, str3, ... . Поверне 0, якщо str не знайдена в списку.

Приклади:

mysql> select FIELD('ej', 'Hej', 'ej', 'Heja', 'hej', 'foo');
        -> 2
mysql> select FIELD('fo', 'Hej', 'ej', 'Heja', 'hej', 'foo');
        -> 0

Див. також ELT().

 

integer FIND_IN_SET( str string, strlist string )

Повертає значення від 1 до ..., залежно від позиції рядка str серед рядків (підрядків) у рядку strlist. Рядки (підрядки) в strlist розділені ",". Повертає 0, якщо str не знайдена серед рядків у strlist. Повертає NULL, якщо один з аргументів NULL.

Приклади:

mysql> SELECT FIND_IN_SET('b','a,b,c,d');
        -> 2

Див. також MAKE_SET().

 

string MAKE_SET( bits, str1 string , str2 string ,...)

Повертає один із рядків-аргументів залежно від побітового стану bits. str1 повернеться при bit 0, str2 при bit 1, і так далі.

Приклади:

mysql> SELECT MAKE_SET(1,'a','b','c');
        -> 'a'
mysql> SELECT MAKE_SET(1 | 4,'hello','nice','world');
        -> 'hello,world'
mysql> SELECT MAKE_SET(0,'a','b','c');
        -> ''

Див. також ELT(), FIND_IN_SET().

 

string EXPORT_SET( bits, on string , off string, [separator char, [number_of_bits integer]])

Повертає рядок, у якому для кожного біта виводиться стан on або off . Розділені стани separator.

Приклади:

mysql> select EXPORT_SET(5,'Y','N',',',4)
        -> Y,N,Y,N

 

string LCASE( str string ) string

Повертає рядок str, замінивши в ньому всі великі літери на малі. Підтримує багатобайтові символи.(За замовчуванням ISO-8859-1 Latin1).

Приклади:

mysql> select LCASE('QUADRATICALLY');
        -> 'quadratically'

Див. також UCASE(), UPPER(), LCASE(), LOWER().

 

string LOWER( str string )

Повертає рядок str, замінивши в ньому всі великі літери на малі. Підтримує багатобайтові символи.(За замовчуванням ISO-8859-1 Latin1).

Приклади:

mysql> select LOWER('QUADRATICALLY');
        -> 'quadratically'

Див. також UCASE(), UPPER(), LCASE(), LOWER().

 

string UCASE( str string )

Повертає рядок str, замінивши в ньому всі малі літери на великі. Підтримує багатобайтові символи.(За замовчуванням ISO-8859-1 Latin1).

Приклади:

mysql> select UCASE('Hej');
        -> 'HEJ'

Див. також UCASE(), UPPER(), LCASE(), LOWER().

 

string UPPER( str string )

Повертає рядок str, замінивши в ньому всі малі літери на великі. Підтримує багатобайтові символи.(За замовчуванням ISO-8859-1 Latin1).

Приклади:

mysql> select UPPER('Hej');
        -> 'HEJ'

Див. також UCASE(), UPPER(), LCASE(), LOWER().

 

string LOAD_FILE( file_name string )

Читає файл і повертає його контент у вигляді рядка. file_name є повним шляхом до файлу на сервері. Необхідно стежити за фізичною наявністю самого файлу та відповідними правами доступу скрипта до нього. Файл повинен бути розміром не більше, ніж встановлено параметром max_allowed_packet. При виникненні проблем (відсутність файлу тощо) повертає NULL.