Abs x: Новый производитель. abs-x.

Функция abs(X) возвращает абсолютное значение числового аргумент X. Abs(X) возвращает NULL, если X имеет значение NULL. Abs(X) возвращает 0,0, если X является строкой или большим двоичным объектом. который не может быть преобразован в числовое значение. Если Х является целое число -9223372036854775808, тогда abs(X) выдает целочисленное переполнение ошибка, так как не существует эквивалентного положительного 64-битного значения с двумя дополнениями.

Функция changes() возвращает количество строк базы данных, которые были изменены. либо вставлены, либо удалены последней выполненной командой INSERT, DELETE, или оператор UPDATE, исключая операторы в триггерах более низкого уровня. Функция SQL changes() представляет собой оболочку функции sqlite3_changes64(). C/C++ и, следовательно, следует тем же правилам подсчета изменений.

Функция char(X1,X2,…,XN) возвращает строку, состоящую из символов, имеющих значения кодовой точки Юникода для целых чисел от X1 до XN соответственно.

Функция Coalesce() возвращает копию своего первого аргумента, отличного от NULL, или NULL, если все аргументы равны NULL. Coalesce() должен иметь как минимум 2 аргумента.

Функция format(FORMAT,…) SQL работает так же, как sqlite3_mprintf() C-языка функция и функция printf() из стандартной библиотеки C. Первый аргумент — это строка формата, указывающая, как построить вывод. строка, использующая значения, взятые из последующих аргументов. Если аргумент ФОРМАТ отсутствует или NULL, тогда результат будет NULL. Формат %n молча игнорируется и не потребляет аргумент. Формат %p является псевдонимом для %X. Формат %z взаимозаменяем с %s. Если в списке аргументов слишком мало аргументов, предполагается, что отсутствующие аргументы имеют значение NULL, которое преобразуется в 0 или 0.0 для числовых форматов или пустая строка для %s. См. встроенная документация printf() для получения дополнительной информации.

Функция glob(X,Y) эквивалентна функции выражение « Y GLOB X «. Обратите внимание, что аргументы X и Y в функции glob() меняются местами. относительно инфиксного оператора GLOB. Y — это строка, а X — это шаблон. Так, например, следующие выражения эквивалентны:

     имя GLOB '*гелий*'
     шар('*гелий*',имя)
   

Если интерфейс sqlite3_create_function() используется для переопределите функцию glob(X,Y) альтернативной реализацией, затем оператор GLOB вызовет альтернативную реализацию.

Функция hex() интерпретирует свой аргумент как BLOB и возвращает строка, представляющая собой шестнадцатеричное представление содержимого в верхнем регистре эта капля.

Если аргумент X в «hex( X )» является целое число или число с плавающей запятой, тогда «интерпретирует свой аргумент как BLOB» означает что двоичное число сначала преобразуется в текстовое представление UTF8, а затем этот текст интерпретируется как BLOB. Следовательно, «шестнадцатеричный (12345678)» отображает как «3132333435363738», а не двоичное представление целочисленного значения «0000000000BC614E».

Функция ifnull() возвращает копию своего первого аргумента, отличного от NULL, или NULL, если оба аргумента равны NULL. Ifnull() должно иметь ровно 2 аргумента. Функция ifnull() эквивалентна Coalesce() с двумя аргументами.

Функция iif(X,Y,Z) возвращает значение Y, если X истинно, и Z в противном случае. Функция iif(X,Y,Z) логически эквивалентна и генерирует то же самое. байт-код как выражение CASE «CASE WHEN X THEN Y ELSE Z END».

Функция instr(X,Y) находит первое вхождение строки Y в строка X и возвращает количество предшествующих символов плюс 1 или 0, если Y нигде не встречается в X. Или, если X и Y оба являются BLOB, то instr(X,Y) возвращает один больше, чем число байтов до первого вхождения Y, или 0, если Y нигде не встречается внутри X. Если оба аргумента X и Y для instr(X,Y) не равны NULL и не являются большими двоичными объектами. то оба интерпретируются как строки. Если либо X, либо Y имеют значение NULL в instr(X,Y), то результат равен NULL.

Функция last_insert_rowid() возвращает ROWID вставки последней строки из соединения с базой данных, которое вызвало функция. SQL-функция last_insert_rowid() представляет собой оболочку для sqlite3_last_insert_rowid() функция интерфейса C/C++.

Для строкового значения X функция length(X) возвращает количество символов (не байтов) в X до первого символа NUL. Поскольку строки SQLite обычно не содержат символов NUL, длина (X) Функция обычно возвращает общее количество символов в строке X. Для значения большого двоичного объекта X функция length(X) возвращает количество байтов в большом двоичном объекте. Если X равно NULL, то длина (X) равна NULL. Если X является числовым, то length(X) возвращает длину строки представление Х.

Обратите внимание, что для строк функция length(X) возвращает символов . длина строки, а не длина байта. Длина символа — это число символов в строке. Длина символа всегда отличается от длина в байтах для строк UTF-16 и может отличаться от длины в байтах для строк UTF-8, если строка содержит многобайтовые символы.

Для значений BLOB length(X) всегда возвращает длину BLOB в байтах.

Для строковых значений length(X) должна прочитать всю строку в память, чтобы для вычисления длины символа. Но для значений BLOB это не обязательно, так как SQLite знает, сколько байтов в BLOB. Следовательно, для многомегабайтных значений функция length(X) обычно намного быстрее для больших двоичных объектов, чем для строк, поскольку ему не нужно загружать значение в память.

Функция like() используется для реализации « Y LIKE X [ESCAPE Z] » выражение. Если присутствует необязательное предложение ESCAPE, то Функция like() вызывается с тремя аргументами. В противном случае это вызывается только с двумя аргументами. Обратите внимание, что параметры X и Y перевернуто в функции like() по отношению к инфиксному оператору LIKE. X — это шаблон, а Y — строка, соответствующая этому шаблону. Следовательно, следующие выражения эквивалентны:

     имя НРАВИТСЯ '%neon%'
     нравится('%неон%',имя)
   

Интерфейс sqlite3_create_function() можно использовать для переопределения функцию like() и тем самым изменить работу НРАВИТСЯ оператор. При переопределении функции like() может быть важно переопределить версии с двумя и тремя аргументами функции like() функция. В противном случае может быть вызван другой код для реализации LIKE в зависимости от того, было ли предложено условие ESCAPE. указано.

Функция правдоподобия (X, Y) возвращает аргумент X без изменений. Значение Y в вероятности (X, Y) должно быть константой с плавающей запятой. от 0,0 до 1,0 включительно. Функция правдоподобия (X) не является операцией, которую генератор кода оптимизирует так, чтобы он не потреблял циклы ЦП во время выполнения (то есть во время вызовов sqlite3_step()). Назначение функции правдоподобия (X, Y) состоит в том, чтобы дать подсказку планировщику запросов, что аргумент X является логическим значением, то есть верно с вероятностью приблизительно Y. Функция маловероятности (X) является сокращением для вероятности (X, 0,0625). Функция вероятного (X) является сокращением для правдоподобия (X, 0,9375).

Функция вероятного(X) возвращает аргумент X без изменений. Функция вероятного (X) не является операцией, которую генератор кода оптимизирует так, чтобы он не потреблял циклы ЦП в во время выполнения (то есть во время вызовов sqlite3_step()). Назначение функции вероятностного(X) состоит в том, чтобы дать подсказку планировщику запросов, что аргумент X является логическим значением обычно это правда. Функция вероятного (X) эквивалентна вероятности (X, 0,9375). См. также: маловероятно(X).

Функция load_extension(X,Y) загружает расширения SQLite из общего файл библиотеки с именем X, используя точку входа Y. Результат load_extension() всегда NULL. Если Y опущен, используется имя точки входа по умолчанию. Функция load_extension() вызывает исключение, если расширение не загрузить или инициализировать правильно.

Функция load_extension() завершится ошибкой, если расширение попытается изменить или удалить функцию SQL или последовательность сопоставления. расширение может добавлять новые функции или последовательности сопоставления, но не может изменить или удалить существующие функции или последовательности сопоставления, потому что эти функции и/или последовательности сопоставления могут использоваться в другом месте в текущем операторе SQL. Чтобы загрузить расширение, которое изменяет или удаляет функции или последовательности сопоставления, используйте sqlite3_load_extension() API языка C.

Из соображений безопасности загрузка расширений отключена по умолчанию и должна быть включена предварительным вызовом sqlite3_enable_load_extension().

Функция lower(X) возвращает копию строки X со всеми символами ASCII. преобразованы в нижний регистр. Встроенная по умолчанию функция lower() работает только для символов ASCII. Для преобразования регистра в не-ASCII символов, загрузите расширение ICU.

Функция ltrim(X,Y) возвращает строку, образованную удалением всех без исключения символы, которые появляются в Y слева от X. Если аргумент Y опущен, ltrim(X) удаляет пробелы с левой стороны Х.

Функция max() с несколькими аргументами возвращает аргумент с максимальное значение или вернуть NULL, если какой-либо аргумент равен NULL. Функция max() с несколькими аргументами ищет аргументы слева направо. для аргумента, который определяет функцию сортировки и использует эту функцию сортировки функция для всех сравнений строк. Если ни один из аргументов max() определить функцию сопоставления, тогда используется функция сопоставления BINARY. Обратите внимание, что max() — простая функция, когда имеет 2 или более аргументов, но работает как агрегатная функция, если задан только один аргумент.

Функция min() с несколькими аргументами возвращает аргумент с минимальное значение. Функция min() с несколькими аргументами ищет аргументы слева направо. для аргумента, который определяет функцию сортировки и использует эту функцию сортировки функция для всех сравнений строк. Если ни один из аргументов min() определить функцию сопоставления, тогда используется функция сопоставления BINARY. Обратите внимание, что min() — простая функция, когда имеет 2 или более аргументов, но работает как агрегатная функция, если задана только один аргумент.

Функция nullif(X,Y) возвращает свой первый аргумент, если аргументы разные и NULL, если аргументы совпадают. Функция nullif(X,Y) ищет в своих аргументах слева направо аргумент, определяющий функция сопоставления и использует эту функцию сопоставления для всех строк сравнения. Если ни один из аргументов nullif() не определяет функцию сопоставления затем используется функция сопоставления BINARY.

SQL-функция printf() является псевдонимом SQL-функции format(). SQL-функция format() первоначально называлась printf(). Но название было позже изменен на format() для совместимости с другими механизмами баз данных. Оригинал Имя printf() сохраняется как псевдоним, чтобы не нарушать устаревший код.

Функция quote(X) возвращает текст литерала SQL, который является значением его аргумента, подходящим для включения в оператор SQL. Строки заключаются в одинарные кавычки с экранированием во внутренних кавычках. по мере необходимости. BLOB кодируются как шестнадцатеричные литералы. Строки со встроенными символами NUL не могут быть представлены в виде строки. литералы в SQL и, следовательно, возвращаемый строковый литерал усекается до до первого НУЛ.

Функция random() возвращает псевдослучайное целое число. между -9223372036854775808 и +9223372036854775807.

Функция randomblob(N) возвращает N-байтовый BLOB-объект, содержащий псевдослучайные байт. Если N меньше 1, возвращается случайный двоичный объект размером 1 байт.

Подсказка: приложения могут генерировать глобально уникальные идентификаторы используя эту функцию вместе с hex() и/или ниже() вот так:

шестнадцатеричный (случайный двоичный объект (16))
ниже (шестнадцатеричный (случайный двоичный объект (16)))

Функция replace(X,Y,Z) возвращает строку, образованную заменой строка Z для каждого вхождения строки Y в строку X. последовательность сопоставления используется для сравнения. Если Y пустое строка, затем верните X без изменений. Если Z изначально не строка, перед обработкой она преобразуется в строку UTF-8.

Функция round(X,Y) возвращает число с плавающей запятой. значение X округляется до Y цифр справа от запятой. Если аргумент Y опущен или отрицателен, он принимается равным 0.

Функция rtrim(X,Y) возвращает строку, образованную удалением всех без исключения символы, которые появляются в Y с правой стороны X. Если аргумент Y опущен, rtrim(X) удаляет пробелы справа сторона Х.

Функция sign(X) возвращает -1, 0 или +1, если аргумент X является числовым. отрицательное, нулевое или положительное значение соответственно. Если аргумент to sign(X) имеет значение NULL или является строкой или большим двоичным объектом, который не может быть преобразован без потерь в число, то sign(X) возвращает NULL.

Функция soundex(X) возвращает строку, которая представляет собой кодировку soundex. строки Х. Строка «?000» возвращается, если аргумент имеет значение NULL или содержит нет буквенных символов ASCII. Эта функция отсутствует в SQLite по умолчанию. Он доступен, только если параметр времени компиляции SQLITE_SOUNDEX используется при сборке SQLite.

SQL-функция sqlite_compileoption_get() является оболочкой для Функция sqlite3_compileoption_get() C/C++. Эта подпрограмма возвращает N-й параметр времени компиляции, используемый для сборки SQLite. или NULL, если N выходит за пределы допустимого диапазона. См. также прагму compile_options.

SQL-функция sqlite_compileoption_used() является оболочкой над Функция sqlite3_compileoption_used() C/C++. Когда аргумент X для sqlite_compileoption_used(X) является строкой, — это имя параметра времени компиляции, эта процедура возвращает значение true (1) или false (0) в зависимости от того, использовалась ли эта опция во время строить.

Функция sqlite_offset(X) возвращает смещение в байтах в базе данных файл для начала записи, из которой будет считываться значение. Если X не является столбцом в обычной таблице, тогда sqlite_offset(X) возвращает НУЛЕВОЙ. Значение, возвращаемое sqlite_offset(X), может ссылаться либо на исходная таблица или индекс, в зависимости от запроса. Если бы значение X обычно извлекается из индекса, sqlite_offset(X) возвращает смещение к соответствующей индексной записи. Если бы значение X было извлекается из исходной таблицы, затем sqlite_offset(X) возвращает смещение к записи таблицы.

SQL-функция sqlite_offset(X) доступна, только если SQLite собран используя параметр времени компиляции -DSQLITE_ENABLE_OFFSET_SQL_FUNC.

Функция sqlite_source_id() возвращает строку, идентифицирующую конкретная версия исходного кода, которая использовалась для сборки SQLite библиотека. Строка, возвращаемая sqlite_source_id(), дата и время, когда исходный код был проверен, а затем хэш SHA3-256 для этой регистрации. Эта функция SQL-оболочка вокруг интерфейса sqlite3_sourceid() C.

Функция sqlite_version() возвращает строку версии для SQLite. библиотека, которая работает. Эта функция является SQL оболочка вокруг C-интерфейса sqlite3_libversion().

Функция substr(X,Y,Z) возвращает подстроку входной строки X, которая начинается с Y-м символом и длиной Z символов. Если Z опущен, то substr(X,Y) возвращает все символы до конца строки X, начиная с Y-го. Крайний левый символ X — это число 1. Если Y отрицательное то первый символ подстроки находится путем отсчета от справа, а не слева. Если Z отрицательно, то возвращаются символы abs(Z), предшествующие Y-му символу. Если X является строкой, то индексы символов относятся к фактическому UTF-8. персонажи. Если X является BLOB, то индексы относятся к байтам.

«substring()» — это псевдоним для «substr()», начиная с версии SQLite 3.34.

Функция total_changes() возвращает количество изменений строки вызвано INSERT, UPDATE или DELETE операторов с момента открытия текущего соединения с базой данных. Эта функция является оболочкой для sqlite3_total_changes64(). Интерфейс С/С++.

Функция trim(X,Y) возвращает строку, образованную удалением всех без исключения символы, которые появляются в Y с обоих концов X. Если аргумент Y опущен, trim(X) удаляет пробелы с обоих концов X.

Функция typeof(X) возвращает строку, указывающую тип данных выражение X: «null», «integer», «real», «text» или «blob».

Функция unicode(X) возвращает числовую кодовую точку Unicode, соответствующую первый символ строки X. Если аргумент unicode(X) не является строкой то результат не определен.

Функция маловероятно(X) возвращает аргумент X без изменений. Функция маловероятности (X) не является операцией, которую генератор кода оптимизирует так, чтобы он не потреблял циклы ЦП в во время выполнения (то есть во время вызовов sqlite3_step()). Функция маловероятности (X) предназначена для предоставления подсказки планировщику запросов, что аргумент X является логическим значением обычно это не так. Функция маловероятности (X) эквивалентна вероятности (X, 0,0625).

Функция upper(X) возвращает копию входной строки X, в которой все символы ASCII нижнего регистра преобразуются в эквивалентные им символы верхнего регистра.

Функция zeroblob(N) возвращает BLOB, состоящий из N байтов 0x00. SQLite очень эффективно управляет этими нулевыми каплями. Zeroblobs можно использовать для резервное пространство для BLOB, который позже записывается с использованием добавочный ввод-вывод BLOB. Эта функция SQL реализована с использованием функции sqlite3_result_zeroblob(). из интерфейса C/C++.