From ae756dd2b0d8ba53cbf7e150cdfa98ec5e4f003f Mon Sep 17 00:00:00 2001 From: romanzhukov Date: Fri, 6 Aug 2021 12:04:55 +0300 Subject: [PATCH] Add stings empty nonempty functions --- .../functions/string-functions.md | 38 +++++++++++++-- .../functions/string-functions.md | 46 ++++++++++++++++--- 2 files changed, 74 insertions(+), 10 deletions(-) diff --git a/docs/en/sql-reference/functions/string-functions.md b/docs/en/sql-reference/functions/string-functions.md index 8723b9d278a..0156b4331ba 100644 --- a/docs/en/sql-reference/functions/string-functions.md +++ b/docs/en/sql-reference/functions/string-functions.md @@ -48,9 +48,41 @@ Result: ## notEmpty {#notempty} -Returns 0 for an empty string or 1 for a non-empty string. -The result type is UInt8. -The function also works for arrays or UUID. +Checks whether the input string is not empty. + +**Syntax** + +``` sql +notempty(x) +``` + +A string is considered non-empty if it contains at least one byte, even if this is a space or a null byte. The UUID is empty if it contains all zeros (zero UUID). + +**Arguments** + +- `x` — Input value. [Array](../data-types/array.md), [String](../data-types/string.md), [UUID](../data-types/uuid.md). + +**Returned value** + +- Returns `1` for a non-empty string or `0` for an empty string string. + +Type: [UInt8](../data-types/int-uint.md). + +**Example** + +Query: + +```sql +SELECT notempty('text'); +``` + +Result: + +```text +┌─empty('')─┐ +│ 1 │ +└───────────┘ +``` ## length {#length} diff --git a/docs/ru/sql-reference/functions/string-functions.md b/docs/ru/sql-reference/functions/string-functions.md index e6c8e17bdca..097ff593ef7 100644 --- a/docs/ru/sql-reference/functions/string-functions.md +++ b/docs/ru/sql-reference/functions/string-functions.md @@ -23,7 +23,45 @@ empty(x) **Возвращаемое значение** -- Возвращает `1` для пустой строки, и `0` — для непустой строки. +- Возвращает `1` для пустой строки и `0` — для непустой строки. + +Тип: [UInt8](../data-types/int-uint.md). + +**Пример** + +Запрос: + +```sql +SELECT notempty('text'); +``` + +Результат: + +```text +┌─empty('')─┐ +│ 1 │ +└───────────┘ +``` + +## notEmpty {#notempty} + +Проверяет, является ли входная строка непустой. + +**Синтаксис** + +``` sql +empty(x) +``` + +Строка считается непустой, если содержит хотя бы один байт, пусть даже это пробел или нулевой байт. UUID считается пустой, если он содержит только нули (нулевой UUID). + +**Параметры** + +- `x` — Входная строка. [Array](../data-types/array.md), [String](../data-types/string.md), [UUID](../data-types/uuid.md). + +**Возвращаемое значение** + +- Возвращает `1` для непустой строки и `0` — для пустой строки. Тип: [UInt8](../data-types/int-uint.md). @@ -43,12 +81,6 @@ SELECT empty(''); └───────────┘ ``` -## notEmpty {#notempty} - -Возвращает 0 для пустой строки, и 1 для непустой строки. -Тип результата — UInt8. -Функция также работает для массивов. - ## length {#length} Возвращает длину строки в байтах (не символах, не кодовых точках).