يتم إنشاء الوثائق أدناه من جدول النظام
system.functions.CRC32
0xffffffff (بتنفيذ zlib).
الصيغة
s— سلسلة من نوعStringيُراد حساب CRC32 لها.String
UInt32
أمثلة
مثال على الاستخدام
Query
Response
CRC32IEEE
s— السلسلة النصية المراد حساب قيمة CRC32 لها.String
UInt32
أمثلة
مثال على الاستخدام
Query
Response
CRC64
s— قيمة من النوع String يُحسَب لها CRC64.String
UInt64
أمثلة
مثال على الاستخدام
Query
Response
appendTrailingCharIfAbsent
c إلى السلسلة s إذا كانت s غير فارغة ولا تنتهي بالحرف c.
الصياغة
s بعد إلحاق المحرف c بها إذا كانت s لا تنتهي بـ c. String
أمثلة
مثال على الاستخدام
Query
Response
ascii
s كقيمة من النوع Int32.
الصيغة
s— مُدخل من النوع String.String
s فارغة، فالنتيجة هي 0. وإذا لم يكن المحرف الأول محرف ASCII أو لم يكن جزءًا من نطاق Latin-1 Supplement في UTF-16، فالنتيجة غير معرّفة. Int32
أمثلة
مثال على الاستخدام
Query
Response
base32Decode
encoded— عمود أو ثابت من نوع String.String
String
أمثلة
مثال على الاستخدام
Query
Response
base32Encode
plaintext— النص الصريح المطلوب ترميزه.String
String أو FixedString
أمثلة
مثال على الاستخدام
Query
Response
base58Decode
expected_size لاختيار مفكّك ترميز محسّن بحجم ثابت.
القيم المدعومة حاليًا هي 32 و64. أما القيم الأخرى، فيُستخدم مفكّك الترميز العام.
عند اختيار مفكّك الترميز المحسّن، ولكن يتعذر فك ترميز المُدخل إلى هذا العدد من البايتات بالضبط،
تطرح الدالة استثناءً (أو تُرجع سلسلة فارغة في tryBase58Decode).
البنية
encoded— عمود String أو ثابت لفك ترميزه.Stringexpected_size— اختياري. الحجم المتوقع بعد فك الترميز بالبايت. عندما تكون القيمة 32 أو 64، يُستخدم مفكّك ترميز مُحسَّن؛ وبالنسبة إلى القيم الأخرى، يُستخدم مفكّك الترميز العام.UInt8, UInt16, UInt32, or UInt64
String
أمثلة
مثال على الاستخدام
Query
Response
base58Encode
plaintext— النص الصريح المطلوب ترميزه.String
String
أمثلة
مثال على الاستخدام
Query
Response
base64Decode
FROM_BASE64
المعاملات
encoded— عمود أو ثابت من نوع String لفك ترميزه. إذا لم تكن السلسلة النصية مرمّزة بترميز Base64 ترميزًا صالحًا، فسيتم إطلاق استثناء.String
String
أمثلة
مثال على الاستخدام
Query
Response
base64Encode
TO_BASE64
الوسيطات
plaintext— عمود أو ثابت من النص الصريح لفك ترميزه.String
String
أمثلة
مثال على الاستخدام
Query
Response
base64URLDecode
encoded— عمود أو ثابت من نوع String لترميزه. إذا لم تكن السلسلة النصية مرمّزة بترميز Base64 ترميزًا صالحًا، فسيُطلق استثناء.String
String
أمثلة
مثال على الاستخدام
Query
Response
base64URLEncode
plaintext— عمود أو ثابت يحتوي على نص صريح لترميزه.String
String
أمثلة
مثال على الاستخدام
Query
Response
basename
expr— تعبير نصي من النوع String. يجب تهريب محارف الشرطة المائلة العكسية.String
String
أمثلة
استخراج اسم الملف من مسار Unix
Query
Response
Query
Response
Query
Response
byteHammingDistance
mismatches
الوسائط
القيمة المُعادة
تعيد مسافة هامينغ بين السلسلتين. UInt64
أمثلة
مثال على الاستخدام
Query
Response
caseFoldUTF8
ffi لا تزال تُفكَّك لأن طيّ حالة Unicode نفسه يوسّعها.
الصياغة
str— سلسلة إدخال مرمَّزة بترميز UTF-8.String
String
أمثلة
الطيّ الأساسي لحالة الأحرف
Query
Response
compareSubstrings
s1— السلسلة الأولى للمقارنة.Strings2— السلسلة الثانية للمقارنة.Strings1_offset— الموضع فيs1الذي تبدأ منه المقارنة (بدءًا من الصفر).UInt*s2_offset— الموضع فيs2الذي تبدأ منه المقارنة (فهرس يبدأ من الصفر).UInt*num_bytes— الحد الأقصى لعدد البايتات المراد مقارنتها في كلتا السلسلتين. إذا كانs1_offset(أوs2_offset) +num_bytesيتجاوز نهاية سلسلة الإدخال، فسيُخفَّضnum_bytesتبعًا لذلك.UInt*
-1إذا كانتs1[s1_offset:s1_offset+num_bytes] <s2[s2_offset:s2_offset+num_bytes].0إذا كانتs1[s1_offset:s1_offset+num_bytes] =s2[s2_offset:s2_offset+num_bytes].1إذا كانتs1[s1_offset:s1_offset+num_bytes] >s2[s2_offset:s2_offset+num_bytes].Int8
Query
Response
concat
String أو FixedString إلى سلاسل نصية باستخدام آلية التسلسل الافتراضية الخاصة بها.
ونظرًا إلى أن ذلك يخفّض الأداء، فلا يُنصح باستخدام معاملات ليست من نوع String/FixedString.
البنية
s1, s2, ...— أي عدد من القيم من أي نوع.Any
NULL، فستُعيد الدالة NULL. وإذا لم تكن هناك أي وسيطات، فستُعيد سلسلة فارغة. Nullable(String)
أمثلة
دمج السلاسل النصية
Query
Response
Query
Response
concatAssumeInjective
concat، لكنها تفترض أن concat(s1, s2, ...) → sn دالة حقنية،
أي إنها تُرجع قيماً مختلفة لوسائط مختلفة.
يمكن استخدامها لتحسين GROUP BY.
الصيغة
s1, s2, ...— أي عدد من القيم بأي نوع.StringأوFixedString
NULL، فستعيد الدالة NULL. وإذا لم يتم تمرير أي وسائط، فستعيد سلسلة نصية فارغة. String
أمثلة
تحسين Group by
Query
Response
concatWithSeparator
concat_ws
الوسيطات
sep— الفاصل المطلوب استخدامه.const Stringأوconst FixedStringexp1, exp2, ...— التعبير المراد ضمّه. تُحوَّل الوسيطات التي لا يكون نوعهاStringأوFixedStringإلى سلاسل نصية باستخدام التسلسل الافتراضي لها. ونظرًا إلى أن هذا يخفّض الأداء، فلا يُنصح باستخدام وسيطات ليست من النوعString/FixedString.Any
String ناتجة عن ضمّ الوسيطات. إذا كانت أي من قيم الوسيطات تساوي NULL، فستُرجع الدالة NULL. String
أمثلة
مثال استخدام
Query
Response
concatWithSeparatorAssumeInjective
concatWithSeparator، لكنه يفترض أن concatWithSeparator(sep[,exp1, exp2, ... ]) → result دالة حقنية.
تُسمى الدالة حقنية إذا كانت تُرجِع نتائج مختلفة لوسائط مختلفة.
يمكن استخدامه لتحسين GROUP BY.
البنية
sep— الفاصل المراد استخدامه.const Stringأوconst FixedStringexp1, exp2, ...— التعبير المراد ربطه. تُحوَّل الوسيطات التي لا تكون من النوعStringأوFixedStringإلى سلاسل نصية باستخدام التسلسل الافتراضي الخاص بها. ونظرًا لأن هذا يخفّض الأداء، فلا يُنصح باستخدام وسيطات ليست من النوعString/FixedString.StringأوFixedString
String الناتج عن ربط الوسيطات. إذا كانت أي من قيم الوسيطات NULL، فستُعيد الدالة NULL. String
أمثلة
مثال على الاستخدام
Query
Response
conv
number— الرقم المراد تحويله. يمكن أن يكون سلسلة نصية أو نوعًا رقميًا. -from_base— الأساس الأصلي (2-36). يجب أن يكون عددًا صحيحًا. -to_base— الأساس الهدف (2-36). يجب أن يكون عددًا صحيحًا.
Query
Response
Query
Response
Query
Response
Query
Response
convertCharset
s بعد تحويل ترميزها من from إلى to.
الصياغة
s بعد تحويل ترميزها من from إلى to. String
أمثلة
مثال على الاستخدام
Query
Response
damerauLevenshteinDistance
UInt64
أمثلة
مثال على الاستخدام
Query
Response
decodeHTMLComponent
s— سلسلة نصية من نوع String تحتوي على كيانات HTML المطلوب فك ترميزها.String
String
أمثلة
مثال على الاستخدام
Query
Response
decodeXMLComponent
s— قيمة من النوع String تحتوي على كيانات XML المطلوب فك ترميزها.String
String
أمثلة
مثال على الاستخدام
Query
Response
editDistance
levenshteinDistance
المعاملات
القيمة المعادة
تعرض مسافة التحرير بين السلسلتين. UInt64
أمثلة
مثال للاستخدام
Query
Response
editDistanceUTF8
levenshteinDistanceUTF8
المعاملات
القيمة المعادة
تُرجع مسافة التحرير بين سلسلتي UTF8. UInt64
أمثلة
مثال على الاستخدام
Query
Response
encodeXMLComponent
s— السلسلة النصية المطلوب تهريب محارفها.String
String
أمثلة
مثال على الاستخدام
Query
Response
endsWith
1 إذا كانت s تنتهي بـ suffix، وإلا فتعيد 0. UInt8
أمثلة
مثال للاستخدام
Query
Response
endsWithCaseInsensitive
s— سلسلة المراد التحقق منها.Stringsuffix— اللاحقة غير الحساسة لحالة الأحرف المراد التحقق منها.String
1 إذا كانت s تنتهي باللاحقة suffix دون حساسية لحالة الأحرف، وإلا فتعيد 0. UInt8
أمثلة
مثال استخدام
Query
Response
endsWithCaseInsensitiveUTF8
s تنتهي باللاحقة suffix مع تجاهل حالة الأحرف.
تفترض أن السلسلة تحتوي على نص صالح بترميز UTF-8.
إذا انتُهك هذا الافتراض، فلا يُطرَح أي استثناء وتكون النتيجة غير معرّفة.
الصيغة
s— السلسلة النصية المطلوب التحقق منها.Stringsuffix— اللاحقة المطلوب التحقق منها دون مراعاة حالة الأحرف.String
1 إذا كانت s تنتهي باللاحقة suffix دون مراعاة حالة الأحرف، وإلا فيُرجع 0. UInt8
أمثلة
مثال للاستخدام
Query
Response
endsWithUTF8
s تنتهي باللاحقة suffix.
تفترض أن السلسلة تحتوي على نص صحيح بترميز UTF-8.
إذا لم يصح هذا الافتراض، فلا يُطرَح أي استثناء وتكون النتيجة غير معرّفة.
الصيغة
1 إذا كانت s تنتهي بـ suffix، وإلا فتُعيد 0. UInt8
أمثلة
مثال على الاستخدام
Query
Response
extractTextFromHTML
- إزالة جميع وسوم HTML/XML
- إزالة التعليقات (
{/* */}) - إزالة عناصر script وstyle مع محتواها
- معالجة مقاطع CDATA (تُنسخ حرفيًا كما هي)
- التعامل الصحيح مع المسافات البيضاء وتوحيدها
html—Stringيحتوي على محتوى HTML لاستخراج النص منه.String
String
أمثلة
مثال على الاستخدام
Query
Response
firstLine
s— سلسلة الإدخال.String
String
أمثلة
مثال للاستخدام
Query
Response
idnaDecode
idnaEncode() وidnaDecode() لا يعيد بالضرورة السلسلة الأصلية بسبب تسوية حالة الأحرف.
الصيغة
s— سلسلة الإدخال.String
String
أمثلة
مثال على الاستخدام
Query
Response
idnaEncode
لا يُجرى أي فك لترميز النسبة المئوية أو إزالة لعلامات الجدولة أو المسافات أو محارف التحكّم.
s— سلسلة الإدخال.String
String
أمثلة
مثال على الاستخدام
Query
Response
initcap
لأن
initcap يحوّل فقط الحرف الأول من كل كلمة إلى حرف كبير، فقد تلاحظ سلوكًا غير متوقع في الكلمات التي تحتوي على فاصلات عليا أو أحرف كبيرة.
هذا سلوك معروف، ولا توجد حاليًا أي خطط لإصلاحه.s— سلسلة الإدخال.String
s بعد تحويل الحرف الأول من كل كلمة إلى حرف كبير. String
أمثلة
مثال على الاستخدام
Query
Response
Query
Response
initcapUTF8
initcap، تحوّل initcapUTF8 الحرف الأول من كل كلمة إلى حرف كبير وباقي الأحرف إلى أحرف صغيرة.
يفترض أن السلسلة تحتوي على نص صالح بترميز UTF-8.
إذا لم يتحقق هذا الافتراض، فلا يُطرَح أي استثناء وتكون النتيجة غير معرّفة.
لا تكتشف هذه الدالة اللغة؛ فعلى سبيل المثال، قد لا تكون النتيجة صحيحة تمامًا في التركية (i/İ مقابل i/I).
إذا اختلف طول تسلسل بايتات UTF-8 بين الحالتين الكبيرة والصغيرة لنقطة ترميز، فقد تكون النتيجة غير صحيحة لهذه النقطة الترميزية.
s— السلسلة النصية المُدخلة.String
s بعد تحويل الحرف الأول من كل كلمة إلى حرف كبير. String
أمثلة
مثال على الاستخدام
Query
Response
isValidASCII
String أو FixedString المُدخلة تحتوي فقط على بايتات ASCII (0x00–0x7F)، وإلا فتُرجع 0. وهي مُحسّنة للحالة الإيجابية (أي عندما يكون المُدخل ASCII صالحًا).
الصيغة
isASCII
المعاملات
- لا شيء.
Query
Response
isValidUTF8
s— السلسلة المطلوب التحقّق من صلاحية ترميزها بتنسيق UTF-8.String
1 إذا كانت مجموعة البايتات تُشكّل نصًا صالحًا بترميز UTF-8، وإلا فتُرجِع 0. UInt8
أمثلة
مثال على الاستخدام
Query
Response
jaroSimilarity
Float64
أمثلة
مثال على الاستخدام
Query
Response
jaroWinklerSimilarity
Float64
أمثلة
مثال على الاستخدام
Query
Response
left
s وفق قيمة offset المحددة، بدءًا من اليسار.
الصيغة
s— السلسلة التي تُستخرج منها سلسلة فرعية.StringأوFixedStringoffset— عدد بايتات الإزاحة.(U)Int*
- إذا كانت قيمة
offsetموجبة، فستكون النتيجة سلسلة فرعية منsبطولoffsetبايتًا، تبدأ من يسار السلسلة. - إذا كانت قيمة
offsetسالبة، فستكون النتيجة سلسلة فرعية منsبطولlength(s) - |offset|بايتًا، تبدأ من يسار السلسلة. - سلسلة فارغة إذا كانت
lengthتساوي0.String
Query
Response
Query
Response
leftPad
length المحددة.
الصيغة
lpad
المعاملات
string— سلسلة الإدخال المطلوب حشوها.Stringlength— طول السلسلة الناتجة. إذا كانت القيمة أصغر من طول سلسلة الإدخال، فستُختصر سلسلة الإدخال إلىlengthحرفًا.(U)Int*pad_string— اختياري. السلسلة المستخدمة لحشو سلسلة الإدخال. إذا لم تُحدَّد، فستُحشى سلسلة الإدخال بمسافات.String
String
أمثلة
مثال على الاستخدام
Query
Response
leftPadUTF8
leftPad الذي يقيس طول السلسلة بالبايتات، يُقاس طول السلسلة بنقاط الترميز.
الصيغة
string— سلسلة الإدخال المطلوب حشوها.Stringlength— طول السلسلة الناتجة. إذا كانت القيمة أصغر من طول سلسلة الإدخال، فستُقصَّر سلسلة الإدخال إلىlengthحرفًا.(U)Int*pad_string— اختياري. السلسلة المستخدمة لحشو سلسلة الإدخال. إذا لم يتم تحديدها، فسيُحشَى الإدخال بمسافات.String
String
أمثلة
مثال على الاستخدام
Query
Response
leftUTF8
s المرمّزة بترميز UTF-8 باستخدام offset محدد يبدأ من اليسار.
الصيغة
s— السلسلة النصية المرمّزة بترميز UTF-8 المراد استخراج مقطع فرعي منها.StringأوFixedStringoffset— عدد بايتات الإزاحة.(U)Int*
- إذا كانت قيمة
offsetموجبة، يُعاد مقطع فرعي منsبطولoffsetبايتًا، بدءًا من يسار السلسلة النصية.\n” - إذا كانت قيمة
offsetسالبة، يُعاد مقطع فرعي منsبطولlength(s) - |offset|بايتًا، بدءًا من يسار السلسلة النصية.\n” - سلسلة نصية فارغة إذا كانت
lengthتساوي 0.String
Query
Response
Query
Response
lengthUTF8
CHARACTER_LENGTH, CHAR_LENGTH
المعاملات
s—Stringيحتوي على نص صالح مُرمَّز بترميز UTF-8.String
s محسوبًا بعدد نقاط الترميز في Unicode. UInt64
أمثلة
مثال على الاستخدام
Query
Response
lower
lcase
الوسائط
s— سلسلة نصية لتحويلها إلى أحرف صغيرة.String
s بأحرف صغيرة. String
أمثلة
مثال على الاستخدام
Query
Response
lowerUTF8
input— السلسلة النصية المُدخلة المطلوب تحويلها إلى أحرف صغيرة.String
String
أمثلة
الأول
Query
Response
naturalSortKey
NATURAL_SORT_KEY
المعاملات
s— سلسلة نصية لتحويلها إلى مفتاح فرز طبيعي.String
s. String
أمثلة
مثال على الاستخدام
Query
Response
normalizeUTF8NFC
str— سلسلة الإدخال المرمّزة بترميز UTF-8.String
String
أمثلة
مثال على الاستخدام
Query
Response
normalizeUTF8NFD
str— سلسلة الإدخال المرمّزة بترميز UTF-8.String
String
أمثلة
مثال على الاستخدام
Query
Response
normalizeUTF8NFKC
str— السلسلة النصية المُدخلة والمشفَّرة بترميز UTF-8.String
String
أمثلة
مثال على الاستخدام
Query
Response
normalizeUTF8NFKCCasefold
str— سلسلة الإدخال المرمّزة بترميز UTF-8.String
String
أمثلة
مثال على الاستخدام
Query
Response
normalizeUTF8NFKD
str— سلسلة إدخال مرمّزة بترميز UTF-8.سلسلة
سلسلة
أمثلة
مثال على الاستخدام
Query
Response
punycodeDecode
s— سلسلة مرمّزة بـ Punycode.String
String
أمثلة
مثال استخدام
Query
Response
punycodeEncode
s— قيمة الإدخال.String
String
أمثلة
مثال على الاستخدام
Query
Response
regexpExtract
haystack تطابق نمط regexp وتتوافق مع فهرس مجموعة regex.
الصيغة
REGEXP_EXTRACT, REGEXP_SUBSTR
الوسائط
haystack— String، السلسلة التي ستتم فيها مطابقة نمط regexp.Stringpattern— String، تعبير regexp. قد يحتويpatternعلى عدة مجموعات regexp، ويحددindexمجموعة regex المطلوب استخراجها. تشير القيمة0إلى مطابقة التعبير النمطي بالكامل.const Stringindex— اختياري. عدد صحيح غير سالب يحدد مجموعة regex المطلوب استخراجها. القيمة الافتراضية هي1إذا كانpatternيحتوي على مجموعة ملتقطة واحدة على الأقل، و0(المطابقة بالكامل) إذا لم يكنpatternيحتوي على أي مجموعة ملتقطة.(U)Int*
String
أمثلة
مثال على الاستخدام
Query
Response
regexpPosition
occurrence لـ pattern داخل haystack، مع بدء البحث من موضع البايت position.
إذا كانت return_option تساوي 0 (الافتراضي)، فسيُعاد موضع أول بايت في المطابقة. وإذا كانت تساوي 1، فسيُعاد موضع أول بايت بعد المطابقة.
إذا كانت subexpression أكبر من 0، فسيُعاد موضع مجموعة الالتقاط المقابلة بدلًا من المطابقة بأكملها.
تعيد 0 إذا لم يُعثر على أي مطابقة، أو إذا لم تشارك مجموعة الالتقاط المطلوبة في المطابقة.
يُوفَّر هذا للتوافق مع regexp_instr في PostgreSQL (وهو متاح أيضًا تحت هذا alias). لاحظ أن المواضع هنا تعتمد على البايتات، بما يتوافق مع دوال Regex الأخرى في ClickHouse؛ بينما يعتمد regexp_instr في PostgreSQL على المحارف.
البنية
regexpInstr, regexp_instr
الوسائط
haystack— السلسلة المراد البحث فيها.Stringpattern— نمط التعبير النمطي.const Stringposition— اختياري. موضع البايت المعتمد على 1 لبدء البحث. القيمة الافتراضية: 1.(U)Int*occurrence— اختياري. يحدد أي تطابق يجب إرجاعه. القيمة الافتراضية: 1.(U)Int*return_option— اختياري. تُرجع القيمة 0 موضع بداية التطابق، وتُرجع القيمة 1 الموضع الذي يلي التطابق مباشرةً. القيمة الافتراضية: 0.(U)Int*flags— اختياري. خيارات Regex. القيم المدعومة:i(غير حساس لحالة الأحرف)،c(حساس لحالة الأحرف)،m/n(مراسي متعددة الأسطر)،s(النقطة تطابق سطرًا جديدًا). القيمة الافتراضية: فارغ.const Stringsubexpression— اختياري. فهرس مجموعة الالتقاط المطلوب إرجاع موضعها. 0 تعني التطابق الكامل. القيمة الافتراضية: 0.(U)Int*
UInt64
أمثلة
الاستخدام الأساسي
Query
Response
removeDiacriticsUTF8
removeAccentsUTF8
المعاملات
str— سلسلة إدخال بترميز UTF-8.String
String
أمثلة
إزالة علامات التشكيل الأساسية
Query
Response
repeat
s عدد n من المرات. إذا كانت n سالبة، فتعيد الدالة سلسلة فارغة. String
أمثلة
مثال على الاستخدام
Query
Response
reverseUTF8
s— سلسلة تحتوي على نص صالح بترميز UTF-8.سلسلة
سلسلة
أمثلة
مثال على الاستخدام
Query
Response
right
s بإزاحة offset محددة تبدأ من اليمين.
البنية
s— السلسلة التي يُراد استخراج سلسلة فرعية منها.StringأوFixedStringoffset— عدد بايتات الإزاحة.(U)Int*
- إذا كانت
offsetموجبة، فستُعاد سلسلة فرعية منsبطولoffsetبايتًا، بدءًا من يمين السلسلة. - إذا كانت
offsetسالبة، فستُعاد سلسلة فرعية منsبطولlength(s) - |offset|بايتًا، بدءًا من يمين السلسلة. - سلسلة فارغة إذا كانت
lengthتساوي0.String
Query
Response
Query
Response
rightPad
length المحددة.
البنية
rpad
الوسيطات
string— سلسلة الإدخال المطلوب حشوها.Stringlength— طول السلسلة الناتجة. إذا كانت القيمة أصغر من طول سلسلة الإدخال، فسيتم تقصير سلسلة الإدخال إلىlengthحرفًا.(U)Int*pad_string— اختياري. السلسلة المستخدمة لحشو سلسلة الإدخال. إذا لم يتم تحديدها، فسيتم حشو سلسلة الإدخال بمسافات.String
String
أمثلة
مثال على الاستخدام
Query
Response
rightPadUTF8
rightPad الذي يقيس طول السلسلة بالبايتات، يُقاس طول السلسلة هنا بنقاط الترميز.
الصيغة
string— سلسلة الإدخال المطلوب ملؤها.Stringlength— طول السلسلة الناتجة. إذا كانت القيمة أصغر من طول سلسلة الإدخال، فسيتم اختصار سلسلة الإدخال إلىlengthحرفًا.(U)Int*pad_string— اختياري. السلسلة المستخدمة لملء سلسلة الإدخال. إذا لم يتم تحديدها، فستُملأ سلسلة الإدخال بمسافات.String
String
أمثلة
مثال على الاستخدام
Query
Response
rightUTF8
s المرمّزة بترميز UTF-8، بإزاحة offset محددة تبدأ من اليمين.
البنية
s— السلسلة النصية المرمّزة بترميز UTF-8 المطلوب استخراج سلسلة فرعية منها.StringأوFixedStringoffset— عدد بايتات الإزاحة.(U)Int*
- إذا كانت
offsetموجبة، فتُعاد سلسلة فرعية منsبطولoffsetبايت، تبدأ من يمين السلسلة النصية. - إذا كانت
offsetسالبة، فتُعاد سلسلة فرعية منsبطولlength(s) - |offset|بايت، تبدأ من يمين السلسلة النصية. - سلسلة نصية فارغة إذا كانت
lengthتساوي0.String
Query
Response
Query
Response
soundex
s— سلسلة الإدخال.String
String
أمثلة
مثال على الاستخدام
Query
Response
space
) بعدد المرات المحدد.
البنية
n— عدد مرات تكرار المسافة.(U)Int*
n مرة. إذا كان n <= 0، فستُرجِع الدالة سلسلة فارغة. String
أمثلة
مثال على الاستخدام
Query
Response
sparseGrams
n،
بحيث تكون قيم التجزئة لـ (n-1)-grams عند أطراف السلسلة الفرعية
أكبر بشكل صارم من قيم أي (n-1)-gram داخل السلسلة الفرعية.
تستخدم CRC32 بوصفها دالة تجزئة.
الصيغة
s— سلسلة نصية مُدخلة.Stringmin_ngram_length— اختياري. الحد الأدنى لطول الـ n-gram المستخرج. القيمة الافتراضية والدنيا هي 3.UInt*max_ngram_length— اختياري. الحد الأقصى لطول الـ n-gram المستخرج. القيمة الافتراضية هي 100. يجب ألا تقل قيمته عنmin_ngram_length.UInt*min_cutoff_length— اختياري. إذا تم تحديده، فلن تُعاد إلا n-grams التي يكون طولها أكبر من أو يساويmin_cutoff_length. القيمة الافتراضية هي نفسهاmin_ngram_length. يجب ألا تقل قيمته عنmin_ngram_lengthوألا تزيد علىmax_ngram_length.UInt*
Array(String)
أمثلة
مثال على الاستخدام
Query
Response
sparseGramsHashes
n،
بحيث تكون قيم تجزئة لـ (n-1)-grams عند حدود السلسلة الفرعية
أكبر بشكل صارم من قيم أي (n-1)-gram داخل السلسلة الفرعية.
يستخدم CRC32 بوصفها دالة تجزئة.
البنية
s— سلسلة إدخال.Stringmin_ngram_length— اختياري. الحد الأدنى لطولngramالمستخرج. القيمة الافتراضية والدنيا هي 3.UInt*max_ngram_length— اختياري. الحد الأقصى لطولngramالمستخرج. القيمة الافتراضية هي 100. ويجب ألا تقل عنmin_ngram_length.UInt*min_cutoff_length— اختياري. إذا تم تحديده، فلن تُعاد إلاn-gramsالتي يكون طولها أكبر من أو يساويmin_cutoff_length. القيمة الافتراضية هي نفسهاmin_ngram_length. ويجب ألا تقل عنmin_ngram_lengthوألا تزيد علىmax_ngram_length.UInt*
Array(UInt32)
أمثلة
مثال على الاستخدام
Query
Response
sparseGramsHashesUTF8
n، حيث تكون قيم تجزئة مقاطع (n-1)-gram عند حدود المقطع الفرعي أكبر تمامًا من قيم تجزئة أي مقطع (n-1)-gram داخله.
تتوقع سلسلة UTF-8، وتطرح استثناءً إذا كان تسلسل UTF-8 غير صالح.
تستخدم CRC32 كدالة تجزئة.
البنية
s— سلسلة إدخال.Stringmin_ngram_length— اختياري. الحد الأدنى لطولngramالمستخرج. القيمة الافتراضية والدنيا هي 3.UInt*max_ngram_length— اختياري. الحد الأقصى لطولngramالمستخرج. القيمة الافتراضية هي 100. ويجب ألا تقل عنmin_ngram_length.UInt*min_cutoff_length— اختياري. إذا تم تحديده، فستُعاد فقطn-gramsالتي يكون طولها أكبر من أو يساويmin_cutoff_length. القيمة الافتراضية هي نفسهاmin_ngram_length. ويجب ألا تقل عنmin_ngram_lengthوألا تزيد علىmax_ngram_length.UInt*
Array(UInt32)
أمثلة
مثال على الاستخدام
Query
Response
sparseGramsUTF8
n، حيث تكون قيم التجزئة لـ (n-1)-grams عند حدود السلسلة الفرعية أكبر بشكل صارم من قيم أي (n-1)-gram داخلها.
تتوقع سلسلة UTF-8، وتُطلق استثناءً في حال وجود تسلسل UTF-8 غير صالح.
تستخدم CRC32 بوصفها دالة تجزئة.
البنية
s— سلسلة الإدخال.Stringmin_ngram_length— اختياري. الحد الأدنى لطولngramالمستخرَج. القيمة الافتراضية والدنيا هي 3.UInt*max_ngram_length— اختياري. الحد الأقصى لطولngramالمستخرَج. القيمة الافتراضية هي 100. ويجب ألا تقل عنmin_ngram_length.UInt*min_cutoff_length— اختياري. إذا تم تحديده، فلن تُعاد إلاn-gramsالتي يكون طولها أكبر من أو مساويًا لـmin_cutoff_length. القيمة الافتراضية هي نفسهاmin_ngram_length. ويجب ألا تقل عنmin_ngram_lengthوألا تزيد علىmax_ngram_length.UInt*
Array(String)
أمثلة
مثال على الاستخدام
Query
Response
startsWith
1 إذا كانت s تبدأ بـ prefix، وإلا فيعيد 0. UInt8
أمثلة
مثال على الاستخدام
Query
Response
startsWithCaseInsensitive
s— السلسلة النصية المطلوب التحقق منها.Stringprefix— البادئة المطلوب التحقق منها دون مراعاة حالة الأحرف.String
1 إذا كانت s تبدأ بالبادئة prefix دون مراعاة حالة الأحرف، وإلا فيعيد 0. UInt8
أمثلة
مثال على الاستخدام
Query
Response
startsWithCaseInsensitiveUTF8
s— السلسلة المراد التحقق منها.Stringprefix— البادئة المراد التحقق منها، مع تجاهل حالة الأحرف.String
1 إذا كانت s تبدأ بـ prefix مع تجاهل حالة الأحرف، وإلا تُرجع 0. UInt8
أمثلة
مثال على الاستخدام
Query
Response
startsWithUTF8
1 إذا كانت s تبدأ بـ prefix، وإلا فيُعيد 0. UInt8
أمثلة
مثال للاستخدام
Query
Response
stringBytesEntropy
s— السلسلة النصية المراد تحليلها.String
Float64
أمثلة
مثال على الاستخدام
Query
Response
stringBytesUniq
s— السلسلة المطلوب تحليلها.String
UInt16
أمثلة
مثال على الاستخدام
Query
Response
stringJaccardIndex
Float64
أمثلة
مثال على الاستخدام
Query
Response
stringJaccardIndexUTF8
stringJaccardIndex، ولكن للسلاسل النصية المرمّزة بـ UTF8.
الصيغة
Float64
أمثلة
مثال على الاستخدام
Query
Response
substring
s التي تبدأ عند فهرس البايت المحدد offset.
يبدأ عدّ البايتات من 1 وفقًا للمنطق التالي:
- إذا كانت قيمة
offsetهي0، فستُعاد سلسلة فارغة. - إذا كانت قيمة
offsetسالبة، فستبدأ السلسلة الفرعية على بُعدoffsetحرفًا من نهاية السلسلة بدلًا من بدايتها.
length الحد الأقصى لعدد البايتات التي يمكن أن تتضمنها السلسلة الفرعية المعادة.
الصيغة
byteSlice, mid, substr
الوسائط
s— السلسلة المُراد استخراج مقطع فرعي منها.StringأوFixedStringأوEnumoffset— موضع بداية المقطع الفرعي فيs.(U)Int*length— اختياري. الحد الأقصى لطول المقطع الفرعي.(U)Int*
s بطول length بايتًا، بدءًا من الفهرس offset. String
أمثلة
الاستخدام الأساسي
Query
Response
substringIndex
s التي تسبق count من مرات ظهور الفاصل delim، كما في Spark أو MySQL.
الصيغة
SUBSTRING_INDEX
الوسائط
s— السلسلة التي يُستخرَج منها المقطع الفرعي.Stringdelim— المحرف الفاصل.Stringcount— عدد مرات ظهور الفاصل التي يجب احتسابها قبل استخراج المقطع الفرعي. إذا كانت قيمةcountموجبة، فسيُعاد كل ما يقع إلى يسار الفاصل الأخير (مع العد من اليسار). وإذا كانت قيمةcountسالبة، فسيُعاد كل ما يقع إلى يمين الفاصل الأخير (مع العد من اليمين).UIntأوInt
s يسبق count من مرات ظهور delim. String
أمثلة
مثال على الاستخدام
Query
Response
substringIndexUTF8
s التي تسبق count من مرات ظهور الفاصل delim، وذلك على مستوى نقاط Unicode البرمجية.
تفترض أن السلسلة تحتوي على نص صالح مُرمَّز بترميز UTF-8.
إذا لم يتحقق هذا الافتراض، فلا يتم طرح أي استثناء وتكون النتيجة غير معرّفة.
الصيغة
s— السلسلة المطلوب استخراج السلسلة الفرعية منها.Stringdelim— الحرف الفاصل الذي سيتم التقسيم عنده.Stringcount— عدد مرات ظهور الفاصل التي يجب عدّها قبل استخراج السلسلة الفرعية. إذا كانت قيمةcountموجبة، فسيتم إرجاع كل ما يقع إلى يسار الفاصل الأخير (مع العد من اليسار). وإذا كانت قيمةcountسالبة، فسيتم إرجاع كل ما يقع إلى يمين الفاصل الأخير (مع العد من اليمين).UIntأوInt
s تقع قبل count من مرات ظهور delim. String
أمثلة
مثال UTF8
Query
Response
substringUTF8
s تبدأ عند فهرس نقطة الترميز offset المحدد.
ويبدأ عدّ نقاط الترميز من 1 وفقًا للمنطق التالي:
- إذا كانت قيمة
offsetهي0، فستُعاد سلسلة فارغة. - إذا كانت قيمة
offsetسالبة، فتبدأ السلسلة الفرعية عندoffsetنقطة ترميز محسوبة من نهاية السلسلة بدلًا من بدايتها.
length الحد الأقصى لعدد نقاط الترميز التي يمكن أن تحتويه السلسلة الفرعية المُعادة.
تفترض هذه الدالة أن السلسلة تحتوي على نص بترميز UTF-8 صحيح.
وإذا لم يتحقق هذا الافتراض، فلا يُطرَح أي استثناء وتكون النتيجة غير معرّفة.
s— السلسلة التي يُستخرج منها سلسلة فرعية.StringأوFixedStringأوEnumoffset— موضع بداية السلسلة الفرعية فيs.IntأوUIntlength— الحد الأقصى لطول السلسلة الفرعية. اختياري.IntأوUInt
s بطول length من نقاط الترميز، بدءًا من فهرس نقطة الترميز offset. String
أمثلة
مثال على الاستخدام
Query
Response
toValidUTF8
� (U+FFFD).
وعند العثور على عدة محارف غير صالحة متتالية، تُختزل إلى محرف استبدال واحد.
الصيغة
s— أي مجموعة من البايتات مُمثَّلة ككائن من نوع البيانات String.String
String
أمثلة
مثال على الاستخدام
Query
Response
trimBoth
trim
الوسائط
s— السلسلة النصية المطلوب إزالة الأحرف منها.Stringtrim_characters— اختياري. الأحرف المطلوب إزالتها. إذا لم تُحدَّد، فستُزال أحرف المسافات البيضاء الشائعة.String
String
أمثلة
مثال على الاستخدام
Query
Response
trimLeft
ltrim
الوسائط
input— السلسلة النصية المطلوب اقتطاعها.Stringtrim_characters— اختياري. الأحرف المطلوب اقتطاعها. إذا لم يتم تحديدها، تُزال أحرف المسافات البيضاء الشائعة.String
String
أمثلة
مثال على الاستخدام
Query
Response
trimRight
rtrim
الوسائط
s— السلسلة المطلوب اقتطاع الأحرف منها.Stringtrim_characters— أحرف اختيارية لاقتطاعها. إذا لم يتم تحديدها، فستُزال أحرف المسافات البيضاء الشائعة.String
String
أمثلة
مثال على الاستخدام
Query
Response
tryBase32Decode
encoded— عمود String أو قيمة ثابتة لفك ترميزها. إذا لم تكن السلسلة مرمّزة بترميز Base32 بشكل صحيح، فستُرجع سلسلة فارغة عند حدوث خطأ.String
String
أمثلة
مثال على الاستخدام
Query
Response
tryBase58Decode
base58Decode، لكنه يعيد سلسلة فارغة عند حدوث خطأ.
الصيغة
encoded— عمودStringأو قيمة ثابتة. إذا لم تكن السلسلة مرمّزة بترميز Base58 صالح، فستُرجِع سلسلة فارغة عند حدوث خطأ.Stringexpected_size— اختياري. الحجم المتوقع بعد فك الترميز بالبايت. عندما تكون القيمة 32 أو 64، يُستخدم مفكِّك ترميز مُحسَّن؛ وبالنسبة إلى القيم الأخرى، يُستخدم مفكِّك الترميز العام.UInt8, UInt16, UInt32, or UInt64
String
أمثلة
مثال على الاستخدام
Query
Response
tryBase64Decode
base64Decode، لكنه يعيد سلسلة فارغة عند حدوث خطأ.
البنية
encoded— عمود String أو قيمة ثابتة لفك ترميزها. إذا لم تكن السلسلة مرمّزة بترميز Base64 صالح، فسيُرجِع سلسلة فارغة عند حدوث خطأ.String
String
أمثلة
مثال على الاستخدام
Query
Response
tryBase64URLDecode
base64URLDecode، لكنه يعيد سلسلة فارغة عند حدوث خطأ.
الصيغة
encoded— عمود من نوع String أو قيمة ثابتة لفك ترميزها. إذا لم تكن السلسلة مُرمَّزة بترميز Base64 صالح، فستُرجِع سلسلة فارغة عند حدوث خطأ.String
String
الأمثلة
مثال على الاستخدام
Query
Response
tryIdnaEncode
s— سلسلة الإدخال.String
String
أمثلة
مثال على الاستخدام
Query
Response
tryPunycodeDecode
punycodeDecode، لكنه يعيد سلسلة فارغة إذا لم يتم تمرير سلسلة صالحة مُرمَّزة بـ Punycode.
الصيغة
s— سلسلة مُرمَّزة باستخدام Punycode.String
String
أمثلة
مثال على الاستخدام
Query
Response
upper
ucase
الوسائط
s— السلسلة المراد تحويلها إلى أحرف كبيرة.String
s بعد تحويلها إلى أحرف كبيرة. String
أمثلة
مثال على الاستخدام
Query
Response
upperUTF8
لا تكتشف هذه الدالة اللغة. فعلى سبيل المثال، قد لا تكون النتيجة صحيحة تمامًا للغة التركية (i/İ مقابل i/I).
إذا كان طول تسلسل بايتات UTF-8 مختلفًا بين الأحرف الكبيرة والصغيرة لنقطة ترميز ما (مثل
ẞ و ß)، فقد تكون النتيجة غير صحيحة لتلك النقطة.s— من النوعString
String
أمثلة
مثال على الاستخدام
Query
Response