|
Справочное руководство по MySQL6.3.2 Строковые функции
6.3.2 Строковые функции
Строковые функции возвращают NULL , если длина результата оказывается
больше, чем указано в значении серверного параметра max_allowed_packet .
See section 5.5.2 Настройка параметров сервера.
Для функций, работающих с позициями в строке, нумерация позиций начинается
с 1.
Возвращает значение ASCII-кода крайнего слева символа строки str ; 0 если
str является пустой строкой; NULL , если str равна NULL :
mysql> SELECT ASCII('2');
-> 50
mysql> SELECT ASCII(2);
-> 50
mysql> SELECT ASCII('dx');
-> 100
См. также функцию ORD() .
ORD(str)
-
Если крайний слева символ строки
str представляет собой многобайтный
символ, то данная функция возвращает его код, который вычисляется на
основе ASCII-кодов составляющих его символов по формуле: ((первый байт
ASCII-кода)*256+(второй байт ASCII-кода))[*256+третий байт ASCII-кода...].
Если крайний слева символ не является многобайтным, то данная функция
возвращает то же значение, что и ASCII():
mysql> SELECT ORD('2');
-> 50
CONV(N,from_base,to_base)
-
Преобразует числа из одной системы счисления в другую. Возвращает
строковое представление числа
N , преобразованного из системы счисления с
основой from_base в систему счисления с основой to_base . Если хотя бы один
из аргументов равен NULL , то возвращается NULL . Аргумент N
интерпретируется как целое число, но может быть задан как целое число или
строка. Минимальное значение основы системы счисления равно 2 , а
максимальное - 36 . Если аргумент to_base представлен отрицательным числом,
то принимается, что N - число со знаком. В противном случае N трактуется
как беззнаковое число. Функция CONV работает с 64-битовой точностью:
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(N)
-
Возвращает строку, представляющую двоичную величину
N , где N - целое число
большого размера (BIGINT ). Эквивалентна функции CONV(N,10,2) . Если N равно
NULL , возвращается NULL :
mysql> SELECT BIN(12);
-> '1100'
OCT(N)
-
Возвращает строковое представление восьмеричного значения числа
N , где N -
целое число большого размера. Эквивалентно функции CONV(N,10,8) . Если N
равно NULL , возвращается NULL :
mysql> SELECT OCT(12);
-> '14'
HEX(N_or_S)
-
Если
N_OR_S - число, то возвращается строковое представление
шестнадцатеричного числа N , где N - целое число большого размера (BIGINT ).
Эквивалентна функции CONV(N,10,16) . Если N_OR_S - строка, то функция
возвращает шестнадцатеричную строку N_OR_S , где каждый символ в N_OR_S
конвертируется в 2 шестнадцатеричных числа. Является обратной по отношению
к строкам 0xff .
mysql> SELECT HEX(255);
-> 'FF'
mysql> SELECT HEX("abc");
-> 616263
mysql> SELECT 0x616263;
-> "abc"
CHAR(N,...)
-
CHAR() интерпретирует аргументы как целые числа и возвращает строку,
состоящую из символов, соответствующих ASCII-коду этих чисел. Величины
NULL пропускаются:
mysql> SELECT CHAR(77,121,83,81,'76');
-> 'MySQL'
mysql> SELECT CHAR(77,77.3,'77.3');
-> 'MMM'
CONCAT(str1,str2,...)
-
Возвращает строку, являющуюся результатом конкатенации аргументов. Если
хотя бы один из аргументов равен
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(separator, str1, str2,...)
-
Функция
CONCAT_WS () обозначает CONCAT With Separator (конкатенация с
разделителем) и представляет собой специальную форму функции CONCAT() .
Первый аргумент является разделителем для остальных аргументов.
Разделитель, так же как и остальные аргументы, может быть строкой. Если
разделитель равен 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'
LENGTH(str)
-
OCTET_LENGTH(str)
-
CHAR_LENGTH(str)
-
CHARACTER_LENGTH(str)
-
Возвращает длину строки str:
mysql> SELECT LENGTH('text');
-> 4
mysql> SELECT OCTET_LENGTH('text');
-> 4
Обратите внимание: для CHAR_LENGTH() и CHARACTER_LENGTH() многобайтные
символы учитываются только однажды.
BIT_LENGTH(str)
-
Возвращает длину строки
str в битах:
mysql> SELECT BIT_LENGTH('text');
-> 32
LOCATE(substr,str)
-
POSITION(substr IN str)
-
Возвращает позицию первого вхождения подстроки
substr в строку str . Если
подстрока substr в строке str отсутствует, возвращается 0 :
mysql> SELECT LOCATE('bar', 'foobarbar');
-> 4
mysql> SELECT LOCATE('xbar', 'foobar');
-> 0
Данная функция поддерживает многобайтные величины. В MySQL 3.23 эта
функция чувствительна к регистру, а в 4.0 она чувствительна к регистру
только в случае, если хотя бы один из аргументов является строкой с
двоичными данными.
LOCATE(substr,str,pos)
-
Возвращает позицию первого вхождения подстроки
substr в строку str ,
начиная с позиции pos . Если подстрока substr в строке str отсутствует,
возвращается 0 :
mysql> SELECT LOCATE('bar', 'foobarbar',5);
-> 7
Данная функция поддерживает многобайтные величины. В MySQL 3.23 эта
функция чувствительна к регистру, а в 4.0 она чувствительна к регистру,
только в случае, если хотя бы один из аргументов является строкой с
двоичными данными.
INSTR(str,substr)
-
Возвращает позицию первого вхождения подстроки
substr в строку str . То же,
что и двухаргументная форма функции LOCATE() , за исключением перемены мест
аргументов:
mysql> SELECT INSTR('foobarbar', 'bar');
-> 4
mysql> SELECT INSTR('xbar', 'foobar');
-> 0
Данная функция поддерживает многобайтные величины. В MySQL 3.23 эта
функция чувствительна к регистру, а в 4.0 она чувствительна к регистру
только в случае, если хотя бы один из аргументов является строкой с
двоичными данными.
LPAD(str,len,padstr)
-
Возвращает строку
str , которая дополняется слева строкой padstr , пока
строка str не достигнет длины len символов. Если строка str длиннее, чем
len , то она будет укорочена до len символов.
mysql> SELECT LPAD('hi',4,'??');
-> '??hi'
RPAD(str,len,padstr)
-
Возвращает строку
str , которая дополняется справа строкой padstr , пока
строка str не достигнет длины len символов. Если строка str длиннее, чем
len , то она будет укорочена до len символов.
mysql> SELECT RPAD('hi',5,'?');
-> 'hi???'
LEFT(str,len)
-
Возвращает крайние слева
len символов из строки str :
mysql> SELECT LEFT('foobarbar', 5);
-> 'fooba'
Данная функция поддерживает многобайтные величины.
RIGHT(str,len)
-
Возвращает крайние справа
len символов из строки str :
mysql> SELECT RIGHT('foobarbar', 4);
-> 'rbar'
Данная функция поддерживает многобайтные величины.
SUBSTRING(str,pos,len)
-
SUBSTRING(str FROM pos FOR len)
-
MID(str,pos,len)
-
Возвращает подстроку длиной
len символов из строки str , начиная от позиции
pos . Существует форма с оператором FROM , для которой используется
синтаксис ANSI SQL92:
mysql> SELECT SUBSTRING('Quadratically',5,6);
-> 'ratica'
Данная функция поддерживает многобайтные величины.
SUBSTRING(str,pos)
-
SUBSTRING(str FROM pos)
-
Возвращает подстроку из строки
str , начиная с позиции pos :
mysql> SELECT SUBSTRING('Quadratically',5);
-> 'ratically'
mysql> SELECT SUBSTRING('foobarbar' FROM 4);
-> 'barbar'
Данная функция поддерживает многобайтные величины.
SUBSTRING_INDEX(str,delim,count)
-
Возвращает подстроку из строки
str перед появлениям count вхождений
разделителя delim . Если count положителен, то возвращается все, что
находится слева от последнего разделителя (считая слева). Если count
отрицателен, то возвращается все, что находится справа от последнего
разделителя (считая справа):
mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', 2);
-> 'www.mysql'
mysql> SELECT SUBSTRING_INDEX('www.mysql.com', '.', -2);
-> 'mysql.com'
Данная функция поддерживает многобайтные величины.
LTRIM(str)
-
Возвращает строку
str с удаленными начальными пробелами:
mysql> SELECT LTRIM(' barbar');
-> 'barbar'
Данная функция поддерживает многобайтные величины.
RTRIM(str)
-
Возвращает строку
str с удаленными конечными пробелами:
mysql> SELECT RTRIM('barbar ');
-> 'barbar'
Данная функция поддерживает многобайтные величины.
TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)
-
Возвращает строку
str с удаленными всеми префиксами и/или суффиксами,
указанными в remstr . Если не указан ни один из спецификаторов BOTH ,
LEADING или TRAILING , то подразумевается BOTH . Если аргумент remstr не
задан, то удаляются пробелы:
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'
Данная функция поддерживает многобайтные величины.
SOUNDEX(str)
-
Возвращает саундекс от str.
Soundex - ``идентификатор звучания строки''. Словосочетания
``К скалам бурым'' и ``С каламбуроми'' должны давать одинаковый
саундекс, т.к. на слух они звучат одинаково. Заметим, однако,
что этой функции для русского языка не существует. MySQL нуждается
в ней, и если кто-то может предоставить алгоритм саундекса на русском
языке - свяжитесь с нами. - Прим. переводчика.
Две созвучные строки, создающие впечатление почти одинаковых, могут иметь
идентичные саундексы. Обычно стандартная саундекс-строка имеет длину 4
символа, но функция
SOUNDEX() возвращает строку произвольной длины. Можно
использовать функцию SUBSTRING() для извлечения стандартного саундекса
строки из результата функции SOUNDEX() . В строке str игнорируются все
символы, не являющиеся буквами или цифрами. Все международные буквенные
символы, не входящие в диапазон A-Z , трактуются как гласные:
mysql> SELECT SOUNDEX('Hello');
-> 'H400'
mysql> SELECT SOUNDEX('Quadratically');
-> 'Q36324'
SPACE(N)
-
Возвращает строку, состоящую из
N пробелов:
mysql> SELECT SPACE(6);
-> ' '
REPLACE(str,from_str,to_str)
-
Возвращает строку
str , в которой все вхождения строки from_str заменены
на to_str :
mysql> SELECT REPLACE('www.mysql.com', 'w', 'Ww');
-> 'WwWwWw.mysql.com'
Данная функция поддерживает многобайтные величины.
REPEAT(str,count)
-
Возвращает строку, состоящую из строки
str , повторенной count раз. Если
значение count <= 0 , возвращает пустую строку. Возвращает NULL , если str
или count равны NULL :
mysql> SELECT REPEAT('MySQL', 3);
-> 'MySQLMySQLMySQL'
REVERSE(str)
-
Возвращает строку
str с обратным порядком символов:
mysql> SELECT REVERSE('abc');
-> 'cba'
Данная функция поддерживает многобайтные величины.
INSERT(str,pos,len,newstr)
-
Возвращает строку
str , в которой подстрока начиная с позиции pos , имеющая
длину len замещена на newstr :
mysql> SELECT INSERT('Quadratic', 3, 4, 'What');
-> 'QuWhattic'
Данная функция поддерживает многобайтные величины.
ELT(N,str1,str2,str3,...)
-
Возвращает
str1 , если N = 1 , str2 , если N = 2 , и так далее. Если N меньше,
чем 1 или больше, чем число аргументов, возвращается NULL . Функция ELT()
является дополненительной по отношению к функции FIELD() :
mysql> SELECT ELT(1, 'ej', 'Heja', 'hej', 'foo');
-> 'ej'
mysql> SELECT ELT(4, 'ej', 'Heja', 'hej', 'foo');
-> 'foo'
FIELD(str,str1,str2,str3,...)
-
Возвращает индекс строки
str в списке str1, str2, str3, ... . Если строка
str не найдена, возвращается 0 . Функция FIELD() является дополнительной по
отношению к функции ELT() :
mysql> SELECT FIELD('ej', 'Hej', 'ej', 'Heja', 'hej', 'foo');
-> 2
mysql> SELECT FIELD('fo', 'Hej', 'ej', 'Heja', 'hej', 'foo');
-> 0
FIND_IN_SET(str,strlist)
-
Возвращает значение от
1 до N , если строка str присутствует в списке
strlist , состоящем из N подстрок. Список строк представляет собой строку,
состоящую из подстрок, разделенных символами `,'. Если первый аргумент
представляет собой строку констант, а второй является столбцом типа SET ,
функция FIND_IN_SET() оптимизируется для использования двоичной
арифметики! Возвращает 0 , если str отсутствует в списке strlist или если
strlist является пустой строкой. Если один из аргументов равен NULL ,
возвращается 0 . Данная функция не будет корректно работать, если первый
аргумент содержит символ `,':
mysql> SELECT FIND_IN_SET('b','a,b,c,d');
-> 2
MAKE_SET(bits,str1,str2,...)
-
Возвращает множество (строку, содержащую подстроки, разделенные символами
`,'), состоящее из строк, имеющих соответствующий бит в наборе
bits .
Аргумент str1 соответствует биту 0 , str2 - биту 1 , и так далее. Нулевые
строки в наборах str1 , str2 , ... не прибавляются к результату:
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');
-> ''
EXPORT_SET(bits,on,off,[separator,[number_of_bits]])
-
Возвращает строку, где для каждому установленному биту в аргументе
bits
соответствует строка on , а каждому сброшенному биту - off .
Каждая строка отделена разделителем, указанным в параметре separator (по
умолчанию - `,'), причем используется только количество битов, заданное
аргументом number_of_bits (по умолчанию 64), из всего количества,
указанного в bits :
mysql> SELECT EXPORT_SET(5,'Y','N',',',4)
-> Y,N,Y,N
LCASE(str)
-
LOWER(str)
-
Возвращает строку
str , в которой все символы переведены в нижний регистр
в соответствии с текущей установкой набора символов (по умолчанию -
ISO-8859-1 Latin1):
mysql> SELECT LCASE('QUADRATICALLY');
-> 'quadratically'
Данная функция поддерживает многобайтные величины.
UCASE(str)
-
UPPER(str)
-
Возвращает строку
str , в которой все символы переведены в верхний регистр
в соответствии с текущей установкой набора символов (по умолчанию -
ISO-8859-1 Latin1):
mysql> SELECT UCASE('Hej');
-> 'HEJ'
Данная функция поддерживает многобайтные величины.
LOAD_FILE(file_name)
-
Читает заданный файл и возвращает его содержимое в виде строки. Данный
файл должен находится на сервере, должен быть указан полный путь к этому
файлу и пользователь должен обладать привилегией
FILE . Размер данного
файла должен быть меньше указанного в max_allowed_packet и файл должен
быть открыт для чтения для всех. Если файл не существует или не может быть
прочитан по одной из вышеупомянутых причин, то функция возвращает NULL :
mysql> UPDATE tbl_name
SET blob_column=LOAD_FILE("/tmp/picture")
WHERE id=1;
При использовании версии MySQL, отличной от 3.23 и 4.0, чтение файла
необходимо выполнять внутри вашего приложения и использовать команду
INSERT для внесения в базу данных информации, содержащейся в файле. Один
из путей реализации этого с использованием библиотеки MySQL++ можно найти
на http://www.mysql.com/documentation/mysql++/mysql++-examples.html.
MySQL при необходимости автоматически конвертирует числа в строки и
наоборот:
mysql> SELECT 1+"1";
-> 2
mysql> SELECT CONCAT(2,' test');
-> '2 test'
Для преобразования числа в строку явным образом, необходимо передать его в
качестве аргумента функции CONCAT() .
Если строковая функция содержит в качестве аргумента строку с двоичными
данными, то и результирующая строка также будет строкой с двоичными
данными. При этом число, конвертированное в строку, воспринимается как
строка с двоичными данными. Это имеет значение только при выполнении
операций сравнения.
Главы
|
|