string)" alt="integer ASCII(str string)" />

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().


string)" alt="integer ORD(str string)" />

integer ORD(str string)

В случае, если первый левый символ строки str является многобайтовым, возвращает его код в формате: ((первый байт ASCII- код)*256+(второй байт ASCII -код))[*256+третий байт ASCII -код...].

Если первый левый символ строки str не является многобайтовым, то действие аналогично действию функции ASCII() - возвращает ASCII-код первого левого символа строки str.

Примеры:

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

См. также ASCII().


integer or string, from_base integer, to_base integer)" alt="string CONV(int_or_str integer or string, from_base integer, to_base integer)" />

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().


integer)" alt="string BIN(int integer)" />

string BIN(int integer)

Возвращает двоичное значение аргумента int. Аналогично действию CONV(int,10,2). Возвращает NULL, если аргумент int  NULL.

Примеры:

mysql> select BIN(12);         -> '1100'
См. также CONV().


integer)" alt="string OCT(int integer)" />

string OCT(int integer)

Возвращает восьмиричное значение аргумента int. Аналогично действию CONV(int,10,8). Возвращает NULL, если аргумент int  NULL.

Примеры:

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

См. также CONV().


string or integer)" alt="string HEX(int_or_str string or integer)" />

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().


integer, ...)" alt="string CHAR(int integer, ...)" />

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, str2 string,...)" alt="string CONCAT(str1 string, str2 string,...)" />

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, str1 string, str2 string,...)" alt="string CONCAT_WS(separator string, str1 string, str2 string,...)" />

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().


string)" alt="integer LENGTH(str string)" />

integer LENGTH(str string)

Функции возвращают длину строки str.

Примеры:

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

Примечание: многобайтовые символы считаются функцией CHAR_LENGTH().

См. такжe OCTET_LENGTH(), CHAR_LENGTH(), CHARACTER_LENGTH().


string)" alt="integer OCTET_LENGTH(str string)" />

integer OCTET_LENGTH(str string)

Функции возвращают длину строки str.

Примеры:

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

Примечание: многобайтовые символы считаются функцией CHAR_LENGTH().

См. также LENGTH(), CHAR_LENGTH(), CHARACTER_LENGTH().


string)" alt="integer CHAR_LENGTH(str string)" />

integer CHAR_LENGTH(str string)

Функции возвращают длину строки str. Поддерживает многобайтовые символы.

Примеры:

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

См. также LENGTH(), OCTET_LENGTH(), CHARACTER_LENGTH().


string)" alt="integer CHARACTER_LENGTH(str string)" />

integer CHARACTER_LENGTH(str string)

Функции возвращают длину строки str.

Примеры:

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

Примечание: многобайтовые символы считаются функцией CHAR_LENGTH().

См. также LENGTH(), OCTET_LENGTH(), CHAR_LENGTH().


string IN str string)" alt="integer POSITION(substr string IN str string)" />

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().


string, str string, pos integer)" alt="integer LOCATE(substr string, str string, pos integer)" />

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().


string, substr string)" alt="integer INSTR( str string, substr string)" />

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, len integer, padstr string)" alt="string LPAD( str string, len integer, padstr string)" />

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

Возвращает строку str, добавив к началу str строку padstr и приведя общее количество символов в возвращенной строке к len. Если  len больше, чем сумма длин строк, то разница за счет повторения строки padstr.

Примеры:

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

См. также RPAD().


string, len integer, padstr string)" alt="string RPAD( str string, len integer, padstr string)" />

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

Возвращает строку str, добавив к концу str строку padstr и приведя общее количество символов в возвращенной строке к len. Если  len больше, чем сумма длин строк, то разница за счет повторения строки padstr.

Примеры:

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

См. также LPAD().


string, len integer)" alt="string LEFT( str string, len integer)" />

string LEFT( str string, len integer)

Возвращает len первых символов изи строки str. Поддерживает многобайтовые символы.

Примеры:

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

См. также RIGHT(), SUBSTRING(), MID(), SUBSTRING_INDEX()


string, len integer)" alt="string RIGHT( str string, len integer)" />

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, pos integer, len integer)" alt="string MID(str string, pos integer, len integer)" />

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, delim string, count integer)" alt="string SUBSTRING_INDEX( str string, delim string, count integer)" />

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 )" alt="string LTRIM( str string )" />

string LTRIM( str string )

Возвращает строку str, удалив пробелы с начала строки. Поддерживает многобайтовые символы.

Примеры:

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

См. также TRIM(), RTRIM().


string )" alt="string RTRIM( str string )" />

string RTRIM( str string )

Возвращает строку str, удалив пробелы с конца строки. Поддерживает многобайтовые символы.

Примеры:

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

См. также TRIM(), LTRIM().


string FROM] str string )" alt="string TRIM( [[BOTH | LEADING | TRAILING] [remstr] string FROM] str string )" />

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 )" alt="string SOUNDEX( str string )" />

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, from_str string, to_str string)" alt="string REPLACE( str string, from_str string, to_str string)" />

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, count integer)" alt="string REPEAT( str string, count integer)" />

string REPEAT( str string, count integer)

Возвращает строку, состоящую из  count  раз повтореной строки str. Возвратит  NULL если один из аргументов NULL.

Примеры:

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

См. также  SPACE().


string )" alt="string REVERSE( str string )" />
string REVERSE( str string )

Возвращает строку, в которой все символы с последнего на первый. См. пример. Поддерживает многобайтовые символы.

Примеры:

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


string, pos integer, len integer, newstr string )" alt="string INSERT( str string, pos integer, len integer, newstr string )" />

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

Возвращает строку str, со вставкой подстроки newstr, с позиции pos  строки str и длиной  len символов. Поддерживает многобайтовые символы.

Примеры:

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


integer, str1 string, str2 string, str3 string,...)" alt="string  ELT( N integer, str1 string, str2 string, str3 string,...)" />

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().


string, str1 string, str2 string, str3 string,...)" alt="integer FIELD( str string, str1 string, str2 string, str3 string,...)" />

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().


string, strlist string )" alt="integer FIND_IN_SET( str string, strlist string )" />

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().


MAKE_SET( bits, str1 string , str2 string ,...)" alt="string MAKE_SET( bits, str1 string , str2 string ,...)" />

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().


EXPORT_SET( bits, on string , off string, [separator char, [number_of_bits integer]])" alt="string EXPORT_SET( bits, on string , off string, [separator char, [number_of_bits integer]])" />

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 ) string" alt="string LCASE( str string ) string" />

string LCASE( str string ) string

Возвращает строку str, заменив в ней все заглавные буквы на прописные. Поддерживает многобайтовые символы.(По умолчанию ISO-8859-1 Latin1).

Примеры:

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

См. также  UCASE(), UPPER(), LCASE(), LOWER().


string )" alt="string LOWER( str string )" />

string LOWER( str string )

Возвращает строку str, заменив в ней все заглавные буквы на прописные. Поддерживает многобайтовые символы.(По умолчанию ISO-8859-1 Latin1).

Примеры:

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

См. также  UCASE(), UPPER(), LCASE(), LOWER().


string )" alt="string UCASE( str string )" />

string UCASE( str string )

Возвращает строку str, заменив в ней все прописные буквы на заглавные. Поддерживает многобайтовые символы.(По умолчанию ISO-8859-1 Latin1).

Примеры: 

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

См. также  UCASE(), UPPER(), LCASE(), LOWER().


string )" alt="string UPPER( str string )" />

string UPPER( str string )

Возвращает строку str, заменив в ней все прописные буквы на заглавные. Поддерживает многобайтовые символы.(По умолчанию ISO-8859-1 Latin1).

Примеры: 

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

См. также  UCASE(), UPPER(), LCASE(), LOWER().


string  )" alt="string LOAD_FILE( file_name string  )" />

string LOAD_FILE( file_name string  )

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

mysql> UPDATE table_name SET blob_column=LOAD_FILE("/tmp/picture") WHERE id=1;