Строковые функции MySQL4 (mysql sql string text)
Ключевые слова: mysql, sql, string, text, (найти похожие документы)
From: Андрей МАРЬЯН <[email protected]>
Newsgroups: http://WebSupport.maryan.com.ua
Subject: Строковые функции MySQL4
Строковые функции MySQL4
Перевод: Андрей МАРЬЯН (Andrew MARYAN), http://www.maryan.com.ua/
Последнюю версию этой статьи, а также массу другой документации и
примеров, вы всегда можете найти по адресу http://WebSupport.maryan.com.ua/
- 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().
См. такжe 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(), [103]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. Дополнительную информацию по этой функции можно
получить http://www.mysql.com/documentation/mysql++/mysql++-examples.html
mysql> UPDATE table_name SET blob_column=LOAD_FILE("/tmp/picture") WHERE id=1;
*****
Перевод c <<MySQL Reference Manual for vercion 4.0.2-alpha>>.
Последнюю версию этой статьи, а также массу другой документации и
примеров, вы всегда можете найти по адресу
http://WebSupport.maryan.com.ua. Перепечатка и публикации данной статьи
приветствуются с указанием на веб адрес http://WebSupport.maryan.com.ua/
и уведомлением по почтовому адресу [email protected]
© Copyright 2001-2002 by Andrew MARYAN web company. All Rights reserved.
