تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
SUBSTRING
تعيد جزءًا من تعبير حرفي أو ثنائي. الدالة SUBSTR اسم مستعار للدالة SUBSTRING.
راجع أيضًا:
[SELECT] [ أنواع البيانات ]
لاستخراج حقل من كائن JSON، استخدم الدالة JSON_EXTRACT.
بناء الجملة
SELECT SUBSTRING(expression, start[, length]) FROM <multipartIdentifier>;
SELECT SUBSTR(expression, start[, length]) FROM <multipartIdentifier>;
الوسيطات
expression
سلسلة نصية بترميز ASCII أو قيمة من نوع BLOB.
إذا كانت expression سلسلة نصية، فإن فهارس الأحرف تشير إلى أحرف UTF-8 الفعلية. إذا كانت expression من نوع BLOB، فإن الفهارس تشير إلى البايتات.
start
عدد صحيح يمثل الحرف أو البايت الأول من التسلسل الفرعي المراد إرجاعه من تعبير الإدخال. إذا كانت start سالبة، فيتم تحديد الحرف الأول من السلسلة الفرعية بالعد من اليمين وليس من اليسار.
الحرف الموجود في أقصى يسار expression هو الحرف رقم 1.
length
قيمة اختيارية من نوع عدد صحيح تمثل طول التسلسل الفرعي المراد إرجاعه بعد قيمة start. إذا لم يتم تحديد length، فإن الدالة تعيد جميع الأحرف حتى نهاية السلسلة النصية أو قيمة BLOB التي تحددها expression.
إذا كانت length سالبة، فيتم استخدام القيمة المطلقة للوسيطة length.
القيمة المرجعة
تعيد قيمة من نوع سلسلة نصية أو BLOB حسب نوع expression.
أمثلة
إرجاع أول n أحرف من عمود
SELECT SUBSTRING(name, 1, 5) as "first five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
اقتطاع أول n أحرف من عمود
SELECT SUBSTR(name, 5) as "from char 5"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
إرجاع آخر n أحرف من عمود
SELECT SUBSTRING(name, -5) as "last five chars"
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
لمزيد من المعلومات، راجع https://www.sqlite.org/lang_corefunc.html#substr