Строковые функции
Строковые функции возвращают NULL , если длина результата оказывается больше, чем указано в значении серверного параметра max_allowed_packet . См. раздел Настройка параметров сервера.
Для функций, работающих с позициями в строке, нумерация позиций начинается с 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() .
Если строковая функция содержит в качестве аргумента строку с двоичными данными, то и результирующая строка также будет строкой с двоичными данными. При этом число, конвертированное в строку, воспринимается как строка с двоичными данными. Это имеет значение только при выполнении операций сравнения.
1 2 3 4 5 6
8 8 8
| |