bech32Decode
على عكس دالة الترميز، يتعامل
bech32Decode تلقائيًا مع FixedStrings ذات الحشو.address— سلسلة Bech32 المطلوب فك ترميزها.StringأوFixedStringmode— اختياري. مرّر'raw'لفك الترميز من دون إزالة البايت الأول باعتباره إصدار الشاهد. استخدم هذا مع العناوين غير التابعة لـ SegWit (مثل Cosmos SDK).String
Tuple يتكوّن من (hrp, data) استُخدم في ترميز السلسلة. تكون البيانات بتنسيق ثنائي. Tuple(String, String)
أمثلة
فك ترميز العنوان
Query
Response
Query
Response
bech32Encode
عند استخدام نوع البيانات
FixedString، إذا كانت القيمة لا تملأ الحقل بالكامل، فستُحشى بمحارف null.
وبينما تتعامل الدالة bech32Encode مع هذا تلقائيًا بالنسبة إلى الوسيط hrp، يجب ألا تكون القيم في الوسيط data محشوة.
لهذا السبب، لا يُنصح باستخدام نوع البيانات FixedString لقيم بياناتك إلا إذا كنت
متأكدًا من أن أطوالها جميعًا متساوية، وأن عمود FixedString لديك مضبوط على هذا الطول أيضًا.hrp— سلسلةStringتتكوّن من1 - 83حرفًا صغيرًا وتحدّد “الجزء المقروء بشريًا” من الشيفرة. تكون عادةً ‘bc’ أو ‘tb’.StringأوFixedStringdata— سلسلةStringمن البيانات الثنائية المطلوب ترميزها.StringأوFixedStringwitver_or_variant— اختياري. إمّا إصدار شاهد من نوع UInt* (القيمة الافتراضية = 1، و0لـ Bech32، و1+ لـ Bech32m) أو صيغة ترميز من نوع String:'bech32'(BIP173) أو'bech32m'(BIP350). عند استخدام صيغة نصية، لا يُضاف بايت إصدار الشاهد في البداية — وهذا مطلوب للعناوين غير التابعة لـ SegWit مثل Cosmos SDK.UInt*أوString
String
أمثلة
Bech32m الافتراضي
Query
Response
Query
Response
Query
Response
Query
Response
bin
| النوع | الوصف |
|---|---|
(U)Int* | يطبع الأرقام الثنائية من الأكثر أهمية إلى الأقل أهمية (بترتيب big-endian أو بالترتيب “المقروء للبشر”). ويبدأ بأكثر بايت غير صفري أهمية (مع حذف البايتات الصفرية البادئة)، لكنه يطبع دائمًا ثمانية أرقام لكل بايت حتى إذا كان الرقم الأول صفرًا. |
Date and DateTime | يُنسَّق كأعداد صحيحة مقابلة (عدد الأيام منذ epoch بالنسبة إلى Date، وقيمة Unix timestamp بالنسبة إلى DateTime). |
String and FixedString | تُشفَّر جميع البايتات ببساطة على هيئة ثمانية أرقام ثنائية. ولا تُحذف البايتات الصفرية. |
Float* and Decimal | تُشفَّر وفقًا لتمثيلها في الذاكرة. ونظرًا إلى أننا ندعم معمارية little-endian، فهي تُشفَّر بترتيب little-endian. ولا تُحذف البايتات الصفرية البادئة أو اللاحقة. |
UUID | يُشفَّر كسلسلة بترتيب big-endian. |
arg— قيمة لتحويلها إلى ثنائي.StringأوFixedStringأو(U)Int*أوFloat*أوDecimalأوDateأوDateTime
String
أمثلة
عدد صحيح بسيط
Query
Response
Query
Response
Query
Response
Query
Response
bitPositionsToArray
arg— قيمة صحيحة.(U)Int*
Array(UInt64)
أمثلة
ضبط بت واحد
Query
Response
Query
Response
bitmaskToArray
num— قيمة صحيحة.(U)Int*
Array(UInt64)
أمثلة
مثال أساسي
Query
Response
Query
Response
bitmaskToList
num— قيمة عددية صحيحة.(U)Int*
String
أمثلة
مثال أساسي
Query
Response
char
UInt8، فستُحوَّل
إلى UInt8 مع احتمال حدوث التقريب والتجاوز.
الصياغة
num1[, num2[, num3 ...]]— وسائط رقمية تُفسَّر على أنها أعداد صحيحة.(U)Int8/16/32/64أوFloat*
String
أمثلة
مثال أساسي
Query
Response
Query
Response
hex
| النوع | الوصف |
|---|---|
(U)Int* | تطبع الأرقام السداسية العشرية (“nibbles”) من الأعلى أهمية إلى الأدنى أهمية (بترتيب كبير الطرفية أو بترتيب “مقروء للبشر”). وتبدأ بأعلى بايت غير صفري أهمية (مع حذف البايتات الصفرية البادئة)، لكنها تطبع دائمًا الرقمين الخاصين بكل بايت حتى لو كان الرقم الأول صفرًا. |
Date و DateTime | تُنسَّق كالأعداد الصحيحة المقابلة لها (عدد الأيام منذ epoch بالنسبة إلى Date، وقيمة Unix timestamp بالنسبة إلى DateTime). |
String و FixedString | تُشفَّر جميع البايتات ببساطة على شكل رقمين سداسيين عشريين. ولا تُحذف البايتات الصفرية. |
Float* و Decimal | تُشفَّر وفق تمثيلها في الذاكرة. ويمثّل ClickHouse القيم داخليًا دائمًا بتنسيق little endian، لذلك تُشفَّر بهذا التنسيق. ولا تُحذف البايتات الصفرية البادئة أو اللاحقة. |
UUID | يُشفَّر كسلسلة بترتيب كبير الطرفية. |
A-F، من دون أي بادئات (مثل 0x) أو لواحق (مثل h).
البنية
arg— قيمة لتحويلها إلى تمثيل سداسي عشري.Stringأو(U)Int*أوFloat*أوDecimalأوDateأوDateTime
String
أمثلة
عدد صحيح بسيط
Query
Response
Query
Response
Query
Response
Query
Response
hilbertDecode
hilbertEncode، لهذه الدالة وضعا تشغيل:
- بسيط
- موسّع
UInt64.
الوضع الموسّع
يقبل قناع نطاق (Tuple) كوسيطة أولى، وما يصل إلى عددين صحيحين غير موقّعين
كوسيطات أخرى. يحدّد كل رقم في القناع عدد الـ bits التي
ستُزاح بها الوسيطة المقابلة إلى اليسار، مما يؤدي فعليًا إلى تحجيمها
ضمن نطاقها.
قد يكون توسيع النطاق مفيدًا عندما تحتاج إلى توزيع متقارب
لوسيطات تختلف نطاقاتها كثيرًا (أو عدد قيم مميّزة) على سبيل المثال: ‘IP Address’ (0...FFFFFFFF)
و’Country code’ (0...FF). وكما في دالة الترميز، يقتصر ذلك على 8
أرقام كحد أقصى.
الصياغة
tuple_size— قيمة عدد صحيح لا تزيد على2.UInt8/16/32/64أوTuple(UInt8/16/32/64)code— شيفرةUInt64.UInt64
Tuple بالحجم المحدد. Tuple(UInt64)
أمثلة
الوضع البسيط
Query
Response
Query
Response
Query
Response
Query
Response
hilbertEncode
- البسيط
- الموسّع
args— حتى قيمتَين منUIntأو عمودَين من النوعUInt.UInt8/16/32/64range_mask— في الوضع الموسّع، حتى قيمتَين منUIntأو عمودَين من النوعUInt.UInt8/16/32/64
UInt64. UInt64
أمثلة
الوضع البسيط
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
mortonDecode
mortonEncode، فإن لهذه الدالة وضعَي تشغيل:
- البسيط
- الموسَّع
1- بدون تقليص2- تقليص بمقدار 2x3- تقليص بمقدار 3x ⋮- حتى 8x.
(0...FFFFFFFF)
و’Country code’ (0...FF). وكما هو الحال مع دالة الترميز، يقتصر ذلك على
8 أرقام كحد أقصى.
البنية
tuple_size— قيمة عددية صحيحة لا تتجاوز 8.UInt8/16/32/64range_mask— في الوضع الموسّع، القناع الخاص بكل معامل. القناع هو Tuple من أعداد صحيحة غير موقّعة. ويحدّد كل رقم في القناع مقدار تقليص النطاق.Tuple(UInt8/16/32/64)code— رمز من النوع UInt64.UInt64
Tuple(UInt64)
أمثلة
الوضع البسيط
Query
Response
Query
Response
Query
Response
Query
Response
mortonEncode
- بسيط
- موسّع*
UInt64.
الوضع الموسّع
يقبل قناع نطاق (Tuple) كوسيط أول، و
ما يصل إلى 8 أعداد صحيحة غير موقعة كوسائط أخرى.
يحدد كل رقم في القناع مقدار توسيع النطاق:
- 1 - بدون توسيع
- 2 - توسيع بمقدار 2x
- 3 - توسيع بمقدار 3x ⋮
- توسيع يصل إلى 8x.
args— حتى 8 أعداد صحيحة غير موقَّعة أو أعمدة من النوع المذكور أعلاه.UInt8/16/32/64range_mask— في الوضع الموسَّع، القناع الخاص بكل وسيط. القناع عبارة عنTupleمن أعداد صحيحة غير موقَّعة من1إلى8. ويحدِّد كل رقم في القناع مقدار تقليص النطاق.Tuple(UInt8/16/32/64)
UInt64. UInt64
أمثلة
الوضع البسيط
Query
Response
Query
Response
Query
Response
Query
Response
Query
Response
sqidDecode
sqid— معرّفsqidالمطلوب فك ترميزه.String
sqid. Array(UInt64)
أمثلة
مثال على الاستخدام
Query
Response
sqidEncode
sqid
المعاملات
n1[, n2, ...]— أي عدد من الأرقام.UInt8/16/32/64
String
أمثلة
مثال على الاستخدام
Query
Response
unbin
bin.
بالنسبة إلى وسيطة رقمية، لا تُرجع unbin() المعكوس لـ bin(). وإذا أردت تحويل النتيجة إلى عدد، فيمكنك استخدام الدالتين reverse و reinterpretAs<Type>.
إذا جرى استدعاء
unbin من داخل clickhouse-client، فستُعرَض السلاسل الثنائية باستخدام UTF-8.0 و1. ولا يلزم أن يكون عدد الخانات الثنائية من مضاعفات الثمانية. وإذا احتوت سلسلة الوسيطة على أي شيء غير الخانات الثنائية،
فستكون النتيجة غير معرّفة (من دون طرح أي استثناء).
الصيغة
arg— سلسلة تحتوي على أي عدد من الخانات الثنائية.String
String
أمثلة
الاستخدام الأساسي
Query
Response
Query
Response
unhex
hex. إذ تفسّر كل زوج من الأرقام السداسية العشرية (في الوسيط) على أنه عدد، ثم تحوّله
إلى البايت الذي يمثّله هذا العدد. والقيمة المعادة هي سلسلة ثنائية (BLOB).
إذا أردت تحويل النتيجة إلى عدد، يمكنك استخدام الدالتين reverse و reinterpretAs<Type>.
يفسّر
clickhouse-client السلاسل على أنها UTF-8.
وقد يؤدي ذلك إلى ظهور القيم التي يعيدها hex بشكل غير متوقع.A-F.
ولا يلزم أن يكون عدد الأرقام السداسية العشرية زوجيًا.
فإذا كان فرديًا، فسيُفسَّر الرقم الأخير على أنه النصف الأقل أهمية من البايت 00-0F.
وإذا احتوت سلسلة الوسيط على أي شيء غير أرقام سداسية عشرية، فستُعاد نتيجة تعتمد على التنفيذ (من دون طرح استثناء).
أما بالنسبة إلى الوسيط الرقمي، فلا تنفّذ unhex() معكوس hex(N).
الصياغة
arg— سلسلة تحتوي على أي عدد من المحارف السداسية العشرية.StringأوFixedString
String
أمثلة
الاستخدام الأساسي
Query
Response
Query
Response