دوال التشفير

أُضيفت في: v25.6.0

يفكّ ترميز سلسلة عنوان Bech32 التي أُنشئت باستخدام إحدى خوارزميتي bech32 أو bech32m.

الصياغة

bech32Decode(address[, 'raw'])

وسيطات الدالة

• address — سلسلة Bech32 المطلوب فك ترميزها. String أو FixedString
• mode — اختياري. مرّر 'raw' لفك الترميز من دون إزالة البايت الأول باعتباره إصدار الشاهد. استخدم هذا مع العناوين غير التابعة لـ SegWit (مثل Cosmos SDK). String

القيمة المعادة

يعيد Tuple يتكوّن من (hrp, data) استُخدم في ترميز السلسلة. تكون البيانات بتنسيق ثنائي. Tuple(String, String)

أمثلة

فك ترميز العنوان

SELECT tup.1 AS hrp, hex(tup.2) AS data FROM (SELECT bech32Decode('bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4') AS tup)

┌─hrp─┬─data─────────────────────────────────────┐
│ bc  │ 751E76E8199196D454941C45D1B3A323F1433BD6 │
└─────┴──────────────────────────────────────────┘

عنوان الشبكة التجريبية

SELECT tup.1 AS hrp, hex(tup.2) AS data FROM (SELECT bech32Decode('tb1qw508d6qejxtdg4y5r3zarvary0c5xw7kxpjzsx') AS tup)

┌─hrp─┬─data─────────────────────────────────────┐
│ tb  │ 751E76E8199196D454941C45D1B3A323F1433BD6 │
└─────┴──────────────────────────────────────────┘

أُضيفت في: v25.6.0

تُشفِّر سلسلة بيانات ثنائية، إلى جانب الجزء المقروء بشريًا (HRP)، باستخدام خوارزميات Bech32 or Bech32m.

الصياغة

bech32Encode(hrp, data[, witver | 'bech32' | 'bech32m'])

وسيطات الدالة

• hrp — سلسلة String تتكوّن من 1 - 83 حرفًا صغيرًا وتحدّد "الجزء المقروء بشريًا" من الشيفرة. تكون عادةً 'bc' أو 'tb'. String أو FixedString
• data — سلسلة String من البيانات الثنائية المطلوب ترميزها. String أو FixedString
• witver_or_variant — اختياري. إمّا إصدار شاهد من نوع UInt* (القيمة الافتراضية = 1، و0 لـ Bech32، و1+ لـ Bech32m) أو صيغة ترميز من نوع String: 'bech32' ‏(BIP173) أو 'bech32m' ‏(BIP350). عند استخدام صيغة نصية، لا يُضاف بايت إصدار الشاهد في البداية — وهذا مطلوب للعناوين غير التابعة لـ SegWit مثل Cosmos SDK. UInt* أو String

القيمة المُعادة

تعيد سلسلة عنوان Bech32 تتكوّن من الجزء المقروء بشريًا، ومحرف فاصل يكون دائمًا '1'، وجزء بيانات. لن يتجاوز طول السلسلة 90 حرفًا. وإذا تعذّر على الخوارزمية إنشاء عنوان صالح من المُدخلات، فستُعيد سلسلة فارغة. String

أمثلة

Bech32m الافتراضي

-- When no witness version is supplied, the default is 1, the updated Bech32m algorithm.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'))

bc1pw508d6qejxtdg4y5r3zarvary0c5xw7kj9wkru

خوارزمية Bech32

-- A witness version of 0 will result in a different address string.
SELECT bech32Encode('bc', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 0)

bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4

HRP مخصّص

-- While 'bc' (Mainnet) and 'tb' (Testnet) are the only allowed hrp values for the
-- SegWit address format, Bech32 allows any hrp that satisfies the above requirements.
SELECT bech32Encode('abcdefg', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 10)

abcdefg12w508d6qejxtdg4y5r3zarvary0c5xw7kh526px

عنوان Cosmos SDK ‏(BIP173، من دون witness version)

-- Using 'bech32' variant encodes raw data without a witness version byte,
-- compatible with Cosmos SDK, Injective, Osmosis, and other non-SegWit chains.
SELECT bech32Encode('inj', unhex('751e76e8199196d454941c45d1b3a323f1433bd6'), 'bech32')

inj1w508d6qejxtdg4y5r3zarvary0c5xw7ks5q7aq

أُضيف في: v21.8.0

يعيد سلسلة تحتوي على التمثيل الثنائي للمعامل وفقًا للمنطق التالي لمختلف الأنواع:

الصياغة

bin(arg)

الوسائط

• arg — قيمة لتحويلها إلى ثنائي. String أو FixedString أو (U)Int* أو Float* أو Decimal أو Date أو DateTime

القيمة المُعادة

يعيد سلسلة نصية تحتوي على التمثيل الثنائي للوسيطة. String

أمثلة

عدد صحيح بسيط

SELECT bin(14)

┌─bin(14)──┐
│ 00001110 │
└──────────┘

أرقام Float32

SELECT bin(toFloat32(number)) AS bin_presentation FROM numbers(15, 2)

┌─bin_presentation─────────────────┐
│ 00000000000000000111000001000001 │
│ 00000000000000001000000001000001 │
└──────────────────────────────────┘

أرقام Float64

SELECT bin(toFloat64(number)) AS bin_presentation FROM numbers(15, 2)

┌─bin_presentation─────────────────────────────────────────────────┐
│ 0000000000000000000000000000000000000000000000000010111001000000 │
│ 0000000000000000000000000000000000000000000000000011000001000000 │
└──────────────────────────────────────────────────────────────────┘

تحويل معرّف UUID

SELECT bin(toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0')) AS bin_uuid

┌─bin_uuid─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ 01100001111100001100010000000100010111001011001100010001111001111001000001111011101001100000000001101010110100111101101110100000 │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

أُضيفت في: v21.7.0

تُرجع هذه الدالة مواقع البتات ذات القيمة 1 (بترتيب تصاعدي) في التمثيل الثنائي لعدد صحيح غير موقَّع. تُحوَّل أعداد الإدخال الصحيحة الموقَّعة أولًا إلى عدد صحيح غير موقَّع.

الصياغة

bitPositionsToArray(arg)

وسيطات الدالة

• arg — قيمة صحيحة. (U)Int*

القيمة المُعادة

تعيد مصفوفة تتضمن مواضع البتات ذات القيمة 1 في التمثيل الثنائي للإدخال، مرتبة ترتيبًا تصاعديًا. Array(UInt64)

أمثلة

ضبط بت واحد

SELECT bitPositionsToArray(toInt8(1)) AS bit_positions

┌─bit_positions─┐
│ [0]           │
└───────────────┘

تعيين جميع البتات

SELECT bitPositionsToArray(toInt8(-1)) AS bit_positions

┌─bit_positions─────┐
│ [0,1,2,3,4,5,6,7] │
└───────────────────┘

أُضيف في: v1.1.0

تفكّك هذه الدالة عددًا صحيحًا إلى مجموع قوى العدد اثنين. وتُعاد قوى العدد اثنين في مصفوفة مرتبة تصاعديًا.

الصياغة

bitmaskToArray(num)

وسيطات الدالة

• num — قيمة صحيحة. (U)Int*

القيمة المُعادة

تعيد مصفوفة تتضمن قوى العدد اثنين المرتبة تصاعديًا والتي يساوي مجموعها عدد الإدخال. Array(UInt64)

أمثلة

مثال أساسي

SELECT bitmaskToArray(50) AS powers_of_two

┌─powers_of_two─┐
│ [2,16,32]     │
└───────────────┘

قوة واحدة للعدد 2

SELECT bitmaskToArray(8) AS powers_of_two

┌─powers_of_two─┐
│ [8]           │
└───────────────┘

أُضيفت في: v1.1.0

تشبه bitmaskToArray، لكنها تُرجع قوى العدد اثنين على هيئة سلسلة نصية مفصولة بفواصل.

الصياغة

bitmaskToList(num)

وسيطات الدالة

• num — قيمة عددية صحيحة. (U)Int*

القيمة المُعادة

يُرجع سلسلة نصية تحتوي على قوى العدد 2 مفصولة بفواصل. String

أمثلة

مثال أساسي

SELECT bitmaskToList(50) AS powers_list

┌─powers_list─┐
│ 2,16,32     │
└─────────────┘

استُحدث في: v20.1.0

يعيد سلسلة نصية بطول يساوي عدد الوسيطات المُمرَّرة، بحيث تكون قيمة كل بايت هي قيمة الوسيطة المقابلة له. يقبل عدة وسيطات من الأنواع الرقمية.

إذا كانت قيمة الوسيطة خارج نطاق نوع البيانات UInt8، فستُحوَّل إلى UInt8 مع احتمال حدوث التقريب والتجاوز.

الصياغة

char(num1[, num2[, ...]])

الوسائط

• num1[, num2[, num3 ...]] — وسائط رقمية تُفسَّر على أنها أعداد صحيحة. (U)Int8/16/32/64 أو Float*

القيمة المُعادة

يعيد سلسلة نصية من البايتات المُعطاة. String

أمثلة

مثال أساسي

SELECT char(104.1, 101, 108.9, 108.9, 111) AS hello;

┌─hello─┐
│ hello │
└───────┘

إنشاء ترميزات مخصّصة

-- You can construct a string of arbitrary encoding by passing the corresponding bytes.
-- for example UTF8
SELECT char(0xD0, 0xBF, 0xD1, 0x80, 0xD0, 0xB8, 0xD0, 0xB2, 0xD0, 0xB5, 0xD1, 0x82) AS hello;

┌─hello──┐
│ привет │
└────────┘

أُضيفت في: v1.1.0

تعيد سلسلة نصية تحتوي على التمثيل السداسي العشري للـ argument وفقًا للمنطق التالي باختلاف الأنواع:

تستخدم الدالة الأحرف الكبيرة A-F، من دون أي بادئات (مثل 0x) أو لواحق (مثل h).

البنية

hex(arg)

الوسائط

• arg — قيمة لتحويلها إلى تمثيل سداسي عشري. String أو (U)Int* أو Float* أو Decimal أو Date أو DateTime

القيمة المُعادة

تُرجِع سلسلة نصية تحتوي على التمثيل السداسي العشري للوسيطة. String

أمثلة

عدد صحيح بسيط

SELECT hex(1)

01

أرقام Float32

SELECT hex(toFloat32(number)) AS hex_presentation FROM numbers(15, 2)

┌─hex_presentation─┐
│ 00007041         │
│ 00008041         │
└──────────────────┘

الأعداد من نوع Float64

SELECT hex(toFloat64(number)) AS hex_presentation FROM numbers(15, 2)

┌─hex_presentation─┐
│ 0000000000002E40 │
│ 0000000000003040 │
└──────────────────┘

تحويل معرّف UUID

SELECT lower(hex(toUUID('61f0c404-5cb3-11e7-907b-a6006ad3dba0'))) AS uuid_hex

┌─uuid_hex─────────────────────────┐
│ 61f0c4045cb311e7907ba6006ad3dba0 │
└──────────────────────────────────┘

أُضيف في: v24.6.0

يفكّ ترميز فهرس منحنى Hilbert إلى Tuple من الأعداد الصحيحة غير الموقّعة، يمثّل إحداثيات في فضاء متعدد الأبعاد.

كما في الدالة hilbertEncode، لهذه الدالة وضعا تشغيل:

• بسيط
• موسّع

الوضع البسيط

يقبل حتى عددين صحيحين غير موقّعين كوسيطات، ويُنتج شيفرة UInt64.

الوضع الموسّع

يقبل قناع نطاق (Tuple) كوسيطة أولى، وما يصل إلى عددين صحيحين غير موقّعين كوسيطات أخرى. يحدّد كل رقم في القناع عدد الـ bits التي ستُزاح بها الوسيطة المقابلة إلى اليسار، مما يؤدي فعليًا إلى تحجيمها ضمن نطاقها.

قد يكون توسيع النطاق مفيدًا عندما تحتاج إلى توزيع متقارب لوسيطات تختلف نطاقاتها كثيرًا (أو عدد قيم مميّزة) على سبيل المثال: 'IP Address' (0...FFFFFFFF) و'Country code' (0...FF). وكما في دالة الترميز، يقتصر ذلك على 8 أرقام كحد أقصى.

الصياغة

hilbertDecode(tuple_size, code)

وسيطات الدالة

• tuple_size — قيمة عدد صحيح لا تزيد على 2. UInt8/16/32/64 أو Tuple(UInt8/16/32/64)
• code — شيفرة UInt64. UInt64

القيمة المعادة

يعيد قيمة من النوع Tuple بالحجم المحدد. Tuple(UInt64)

أمثلة

الوضع البسيط

SELECT hilbertDecode(2, 31)

(3,4)

وسيطة واحدة

-- Hilbert code for one argument is always the argument itself (as a tuple).
SELECT hilbertDecode(1, 1)

(1)

الوضع الموسّع

-- A single argument with a tuple specifying bit shifts will be right-shifted accordingly.
SELECT hilbertDecode(tuple(2), 32768)

(8192)

استخدام الأعمدة

-- First create the table and insert some data
CREATE TABLE hilbert_numbers(
    n1 UInt32,
    n2 UInt32
)
ENGINE=MergeTree()
ORDER BY n1 SETTINGS index_granularity_bytes = '10Mi';
insert into hilbert_numbers (*) values(1,2);

-- Use column names instead of constants as function arguments
SELECT untuple(hilbertDecode(2, hilbertEncode(n1, n2))) FROM hilbert_numbers;

1	2

أُضيف في: v24.6.0

يحسب الشيفرة الخاصة بمنحنى هيلبرت لقائمة من الأعداد الصحيحة غير الموقعة.

للدالة وضعان للتشغيل:

• البسيط
• الموسّع

الوضع البسيط

يقبل حتى عددين صحيحين غير موقّعين كوسيطتين، وينتج شيفرة من النوع UInt64.

الوضع الموسّع

يقبل قناع نطاق (Tuple) بوصفه الوسيطة الأولى، وحتى 2 من الأعداد الصحيحة غير الموقعة بوصفها الوسيطات الأخرى.

يحدّد كل رقم في القناع عدد البتات التي ستُزاح بها الوسيطة المقابلة إلى اليسار، مما يؤدي فعليًا إلى تحجيم الوسيطة ضمن نطاقها.

الصياغة

-- Simplified mode
hilbertEncode(args)

-- Expanded mode
hilbertEncode(range_mask, args)

المعاملات

• args — حتى قيمتَين من UInt أو عمودَين من النوع UInt. UInt8/16/32/64
• range_mask — في الوضع الموسّع، حتى قيمتَين من UInt أو عمودَين من النوع UInt. UInt8/16/32/64

القيمة المُعادة

يُرجع شيفرة UInt64. UInt64

أمثلة

الوضع البسيط

SELECT hilbertEncode(3, 4)

31

الوضع الموسّع

-- Range expansion can be beneficial when you need a similar distribution for
-- arguments with wildly different ranges (or cardinality).
-- For example: 'IP Address' (0...FFFFFFFF) and 'Country code' (0...FF).
-- Note: tuple size must be equal to the number of the other arguments.
SELECT hilbertEncode((10, 6), 1024, 16)

4031541586602

وسيطة واحدة

-- For a single argument without a tuple, the function returns the argument
-- itself as the Hilbert index, since no dimensional mapping is needed.
SELECT hilbertEncode(1)

1

وسيطة واحدة (موسَّعة)

-- If a single argument is provided with a tuple specifying bit shifts, the function
-- shifts the argument left by the specified number of bits.
SELECT hilbertEncode(tuple(2), 128)

512

استخدام الأعمدة

-- First create the table and insert some data
CREATE TABLE hilbert_numbers(
    n1 UInt32,
    n2 UInt32
)
ENGINE=MergeTree()
ORDER BY n1;
insert into hilbert_numbers (*) values(1, 2);

-- Use column names instead of constants as function arguments
SELECT hilbertEncode(n1, n2) FROM hilbert_numbers;

13

أُضيف في: v24.6.0

يفك ترميز Morton ‏(ZCurve) إلى tuple المناظرة من الأعداد الصحيحة غير الموقَّعة.

كما هو الحال مع الدالة mortonEncode، فإن لهذه الدالة وضعَي تشغيل:

• البسيط
• الموسَّع

الوضع البسيط

يقبل حجم tuple الناتجة بوصفه وسيطات الدالة الأول، والشيفرة بوصفها وسيطات الدالة الثاني.

الوضع الموسَّع

يقبل قناع نطاق (tuple) بوصفه وسيطات الدالة الأول، والشيفرة بوصفها وسيطات الدالة الثاني. ويحدّد كل رقم في القناع مقدار تقليص النطاق:

• 1 - بدون تقليص
• 2 - تقليص بمقدار 2x
• 3 - تقليص بمقدار 3x ⋮
• حتى 8x.

قد يكون توسيع النطاق مفيدًا عندما تحتاج إلى توزيع متقارب لمعاملات ذات نطاقات مختلفة جدًا (أو عدد قيم مميّزة مختلف جدًا). على سبيل المثال: 'IP Address' (0...FFFFFFFF) و'Country code' (0...FF). وكما هو الحال مع دالة الترميز، يقتصر ذلك على 8 أرقام كحد أقصى.

الصياغة

-- Simple mode
mortonDecode(tuple_size, code)

-- Expanded mode
mortonDecode(range_mask, code)

وسيطات الدالة

• tuple_size — قيمة عددية صحيحة لا تتجاوز 8. UInt8/16/32/64
• range_mask — في الوضع الموسّع، القناع الخاص بكل معامل. القناع هو Tuple من أعداد صحيحة غير موقّعة. ويحدّد كل رقم في القناع مقدار تقليص النطاق. Tuple(UInt8/16/32/64)
• code — شيفرة من النوع UInt64. UInt64

القيمة المعادة

يعيد Tuple بالحجم المحدد. Tuple(UInt64)

أمثلة

الوضع البسيط

SELECT mortonDecode(3, 53)

(1,2,3)

وسيطة واحدة

SELECT mortonDecode(1, 1)

(1)

الوضع الموسَّع، تقليص معامل واحد

SELECT mortonDecode(tuple(2), 32768)

(128)

استخدام الأعمدة

-- First create the table and insert some data
CREATE TABLE morton_numbers(
    n1 UInt32,
    n2 UInt32,
    n3 UInt16,
    n4 UInt16,
    n5 UInt8,
    n6 UInt8,
    n7 UInt8,
    n8 UInt8
)
ENGINE=MergeTree()
ORDER BY n1;
INSERT INTO morton_numbers (*) values(1, 2, 3, 4, 5, 6, 7, 8);

-- Use column names instead of constants as function arguments
SELECT untuple(mortonDecode(8, mortonEncode(n1, n2, n3, n4, n5, n6, n7, n8))) FROM morton_numbers;

1	2	3	4	5	6	7	8

أُضيفت في: v24.6.0

تحسب ترميز Morton ‏(ZCurve) لقائمة من الأعداد الصحيحة غير الموقعة.

للدالة نمطان للتشغيل:

• بسيط
• موسّع*

الوضع البسيط

يقبل ما يصل إلى 8 أعداد صحيحة غير موقعة كوسائط ويُنتج قيمة UInt64.

الوضع الموسّع

يقبل قناع نطاق (Tuple) كوسيط أول، و ما يصل إلى 8 أعداد صحيحة غير موقعة كوسائط أخرى.

يحدد كل رقم في القناع مقدار توسيع النطاق:

• 1 - بدون توسيع
• 2 - توسيع بمقدار 2x
• 3 - توسيع بمقدار 3x ⋮
• توسيع يصل إلى 8x.

الصياغة

-- Simplified mode
mortonEncode(args)

-- Expanded mode
mortonEncode(range_mask, args)

الوسيطات

• args — حتى 8 أعداد صحيحة غير موقَّعة أو أعمدة من النوع المذكور أعلاه. UInt8/16/32/64
• range_mask — في الوضع الموسَّع، القناع الخاص بكل وسيط. القناع عبارة عن Tuple من أعداد صحيحة غير موقَّعة من 1 إلى 8. ويحدِّد كل رقم في القناع مقدار تقليص النطاق. Tuple(UInt8/16/32/64)

القيمة المُعادة

يُرجع رمزًا من النوع UInt64. UInt64

أمثلة

الوضع البسيط

SELECT mortonEncode(1, 2, 3)

53

الوضع الموسّع

-- Range expansion can be beneficial when you need a similar distribution for
-- arguments with wildly different ranges (or cardinality)
-- For example: 'IP Address' (0...FFFFFFFF) and 'Country code' (0...FF).
-- Note: the Tuple size must be equal to the number of the other arguments.
SELECT mortonEncode((1,2), 1024, 16)

1572864

وسيطة واحدة

-- Morton encoding for one argument is always the argument itself
SELECT mortonEncode(1)

1

موسّع لوسيطة واحدة

SELECT mortonEncode(tuple(2), 128)

32768

استخدام الأعمدة

-- First create the table and insert some data
CREATE TABLE morton_numbers(
    n1 UInt32,
    n2 UInt32,
    n3 UInt16,
    n4 UInt16,
    n5 UInt8,
    n6 UInt8,
    n7 UInt8,
    n8 UInt8
)
ENGINE=MergeTree()
ORDER BY n1;
INSERT INTO morton_numbers (*) values(1, 2, 3, 4, 5, 6, 7, 8);

-- Use column names instead of constants as function arguments
SELECT mortonEncode(n1, n2, n3, n4, n5, n6, n7, n8) FROM morton_numbers;

2155374165

أُضيفت في: v24.1.0

يفكّ ترميز sqid إلى مصفوفة من الأرقام.

الصياغة

sqidDecode(sqid)

وسيطات الدالة

• sqid — معرّف sqid المطلوب فك ترميزه. String

القيمة المعادة

يعيد مصفوفة أرقام من sqid. Array(UInt64)

أمثلة

مثال على الاستخدام

SELECT sqidDecode('gXHfJ1C6dN');

┌─sqidDecode('gXHfJ1C6dN')─┐
│ [1,2,3,4,5]              │
└──────────────────────────┘

ظهر لأول مرة في: v24.1.0

يحوِّل الأرقام إلى sqid، وهي سلسلة معرّفات تشبه معرّفات YouTube.

الصيغة

sqidEncode(n1[, n2, ...])

الأسماء البديلة: sqid

المعاملات

• n1[, n2, ...] — أي عدد من الأرقام. UInt8/16/32/64

القيمة المعادة

يعيد معرّف hash من نوع String

أمثلة

مثال على الاستخدام

SELECT sqidEncode(1, 2, 3, 4, 5);

┌─sqidEncode(1, 2, 3, 4, 5)─┐
│ gXHfJ1C6dN                │
└───────────────────────────┘

أُضيف في: v21.8.0

تفسِّر كل زوج من الخانات الثنائية (في الوسيطة) على أنه عدد، ثم تحوِّله إلى البايت الذي يمثِّله هذا العدد. وتنفِّذ هذه الدالة العملية العكسية للدالة bin.

بالنسبة إلى وسيطة رقمية، لا تُرجع unbin() المعكوس لـ bin(). وإذا أردت تحويل النتيجة إلى عدد، فيمكنك استخدام الدالتين reverse و reinterpretAs<Type>.

تدعم الخانات الثنائية 0 و1. ولا يلزم أن يكون عدد الخانات الثنائية من مضاعفات الثمانية. وإذا احتوت سلسلة الوسيطة على أي شيء غير الخانات الثنائية، فستكون النتيجة غير معرّفة (من دون طرح أي استثناء).

الصياغة

unbin(arg)

وسيطات الدالة

• arg — سلسلة تحتوي على أي عدد من الخانات الثنائية. String

القيمة المُعادة

تُرجِع سلسلة ثنائية (BLOB). String

أمثلة

الاستخدام الأساسي

SELECT UNBIN('001100000011000100110010'), UNBIN('0100110101111001010100110101000101001100')

┌─UNBIN('001100000011000100110010')─┬─UNBIN('0100110101111001010100110101000101001100')─┐
│ 012                               │ MySQL                                             │
└───────────────────────────────────┴───────────────────────────────────────────────────┘

حوِّل إلى عدد

SELECT reinterpretAsUInt64(reverse(unbin('1110'))) AS num

┌─num─┐
│  14 │
└─────┘

أُضيفت في: v1.1.0

تنفّذ العملية العكسية لـ hex. إذ تفسّر كل زوج من الأرقام السداسية العشرية (في الوسيط) على أنه عدد، ثم تحوّله إلى البايت الذي يمثّله هذا العدد. والقيمة المعادة هي سلسلة ثنائية (BLOB).

إذا أردت تحويل النتيجة إلى عدد، يمكنك استخدام الدالتين reverse و reinterpretAs<Type>.

يدعم الأحرف الكبيرة والصغيرة A-F. ولا يلزم أن يكون عدد الأرقام السداسية العشرية زوجيًا. فإذا كان فرديًا، فسيُفسَّر الرقم الأخير على أنه النصف الأقل أهمية من البايت 00-0F. وإذا احتوت سلسلة الوسيط على أي شيء غير أرقام سداسية عشرية، فستُعاد نتيجة تعتمد على التنفيذ (من دون طرح استثناء). أما بالنسبة إلى الوسيط الرقمي، فلا تنفّذ unhex() معكوس hex(N).

الصياغة

unhex(arg)

وسيطات الدالة

• arg — سلسلة تحتوي على أي عدد من المحارف السداسية العشرية. String أو FixedString

القيمة المُعادة

تعيد سلسلة ثنائية (BLOB). String

أمثلة

الاستخدام الأساسي

SELECT unhex('303132'), UNHEX('4D7953514C')

┌─unhex('303132')─┬─UNHEX('4D7953514C')─┐
│ 012             │ MySQL               │
└─────────────────┴─────────────────────┘

حوّل إلى رقم

SELECT reinterpretAsUInt64(reverse(unhex('FFF'))) AS num

┌──num─┐
│ 4095 │
└──────┘