الانتقال إلى المحتوى الرئيسي
دوال السلاسل النصية العامة ودوال البحث داخل السلاسل النصية موضَّحة كلٌّ على حدة.
تُولَّد الوثائق أدناه من جدول النظام system.functions.

format

قُدِّم في: v20.1.0 نسّق سلسلة pattern باستخدام القيم (السلاسل النصية، والأعداد الصحيحة، وما إلى ذلك) المدرجة في الوسيطات، بطريقة مشابهة للتنسيق في بايثون. يمكن أن تحتوي سلسلة النمط على حقول استبدال محاطة بأقواس معقوفة {}. ويُعدّ أي شيء غير موجود داخل الأقواس نصًا حرفيًا، ويُنسخ كما هو إلى المخرجات. يمكن تمثيل القوس المعقوف الحرفي باستخدام قوسين: {{ و }}. يمكن أن تكون أسماء الحقول أرقامًا (تبدأ من الصفر) أو فارغة (وفي هذه الحالة تُسنَد إليها ضمنيًا أرقام متزايدة بالتتابع). الصياغة
المعاملات
  • pattern — سلسلة التنسيق التي تحتوي على عناصر نائبة. String
  • s0[, s1, ...] — قيمة واحدة أو أكثر لإحلالها في النمط. Any
القيمة المُعادة تُرجع سلسلة نصية منسّقة. String أمثلة عناصر نائبة مرقّمة
Query
Response
الترقيم الضمني
Query
Response

overlay

قُدِّمت في: v24.9.0 يستبدل جزءًا من السلسلة input بسلسلة أخرى هي replace، بدءًا من الموضع offset المفهرس ابتداءً من 1. الصياغة
المعاملات
  • s — سلسلة الإدخال. String
  • replace — سلسلة الاستبدال const String
  • offset — عدد صحيح من النوع Int (بفهرسة تبدأ من 1). إذا كانت قيمة offset سالبة، فيُحسب من نهاية السلسلة s. Int
  • length — اختياري. عدد صحيح من النوع Int. يحدد length طول المقطع داخل سلسلة الإدخال s المراد استبداله. إذا لم يتم تحديد length، فإن عدد البايتات المحذوفة من s يساوي طول replace؛ وإلا تُحذف length بايت. Int
القيمة المُعادة تعيد سلسلة بعد الاستبدال. String أمثلة استبدال بسيط
Query
Response
الاستبدال مع تحديد الطول
Query
Response

overlayUTF8

أُضيف في: v24.9.0 يستبدل جزءًا من السلسلة s بسلسلة أخرى هي replace، بدءًا من الفهرس offset ذي الأساس 1. يفترض أن السلسلة تحتوي على نص مرمّز بترميز UTF-8 صالح. إذا لم يتحقق هذا الافتراض، فلن يُطرَح أي استثناء وستكون النتيجة غير معرّفة. الصيغة
الوسيطات
  • s — سلسلة الإدخال. String
  • replace — سلسلة الاستبدال. const String
  • offset — عدد صحيح من النوع Int (بفهرسة تبدأ من 1). إذا كانت قيمة offset سالبة، فيُحسب الموضع من نهاية سلسلة الإدخال s. (U)Int*
  • length — اختياري. يحدد طول المقتطف داخل سلسلة الإدخال s المطلوب استبداله. إذا لم يتم تحديد length، فإن عدد الأحرف المُزالة من s يساوي طول replace، وإلا فتُزال length أحرف. (U)Int*
القيمة المعادة تعيد سلسلة نصية بعد الاستبدال. String أمثلة استبدال UTF-8
Query
Response

printf

أُضيف في: v24.8.0 تنسّق الدالة printf السلسلة المعطاة باستخدام القيم (مثل السلاسل النصية والأعداد الصحيحة والأعداد ذات الفاصلة العائمة وغيرها) المدرجة في الوسائط، على نحو مشابه لدالة printf في C++. يمكن أن تحتوي سلسلة التنسيق على محددات تنسيق تبدأ بالمحرف %. ويُعدّ أي شيء لا يقع ضمن % ومحدد التنسيق الذي يليه نصًا حرفيًا، ويُنسخ كما هو إلى المخرجات. يمكن إفلات المحرف % الحرفي باستخدام %%. يمكن أن تكون سلسلة التنسيق إما ثابتًا أو تعبير عمود، مما يتيح استخدام أنماط تنسيق مختلفة لكل صف. البنية
الوسائط
  • format — سلسلة التنسيق التي تحتوي على محددات %. String
  • sub1, sub2, ... — اختياري. صفر أو أكثر من القيم لإدراجها في سلسلة التنسيق. Any
القيمة المُعادة يعيد سلسلة منسّقة. String أمثلة تنسيق بأسلوب C++
Query
Response

regexpQuoteMeta

أُضيف في: v20.1.0 يضيف شرطة مائلة عكسية قبل هذه المحارف ذات المعنى الخاص في التعبيرات النمطية: \0, \\, |, (, ), ^, $, ., [, ], ?, *, +, {, :, -. ويختلف هذا التنفيذ قليلًا عن re2::RE2::QuoteMeta. فهو يهرّب البايت الصفري على هيئة \0 بدلًا من \x00، ولا يهرّب إلا المحارف المطلوبة. الصياغة
المعاملات
  • s — سلسلة الإدخال النصية التي تحتوي على أحرف يجب عمل escape لها في التعابير النمطية. String
القيمة المُعادة يُرجع سلسلة نصية مع عمل escape للأحرف الخاصة في التعابير النمطية. String أمثلة عمل escape للأحرف الخاصة في التعابير النمطية
Query
Response

replaceAll

أُضيف في: v1.1.0 يستبدل جميع حالات ظهور السلسلة الفرعية pattern في haystack بالسلسلة replacement. البنية
الأسماء المستعارة: replace الوسيطات
  • haystack — سلسلة الإدخال المراد البحث فيها. String
  • pattern — السلسلة الفرعية المطلوب العثور عليها واستبدالها. const String
  • replacement — السلسلة التي سيُستبدل بها النمط. const String
القيمة المُعادة تُرجِع سلسلة استُبدلت فيها جميع تكرارات النمط. String أمثلة استبدال جميع التكرارات
Query
Response

replaceOne

تم تقديمه في: v1.1.0 يستبدل أول ظهور للسلسلة الفرعية pattern في haystack بالسلسلة replacement. الصيغة
الوسائط
  • haystack — سلسلة الإدخال المراد البحث فيها. String
  • pattern — السلسلة الفرعية المطلوب العثور عليها واستبدالها. const String
  • replacement — السلسلة التي سيُستبدل بها النمط. const String
القيمة المُعادة يعيد سلسلة نصية بعد استبدال أول ظهور للنمط. String أمثلة استبدال أول ظهور
Query
Response

replaceRegexpAll

طُرحت في: v1.1.0 تشبه replaceRegexpOne، لكنها تستبدل جميع حالات ظهور النمط. واستثناءً من ذلك، إذا طابق تعبير نمطي سلسلة فرعية فارغة، فلا يُجرى الاستبدال أكثر من مرة واحدة. الصيغة
الأسماء البديلة: REGEXP_REPLACE الوسيطات
  • haystack — سلسلة الإدخال المراد البحث فيها. String
  • pattern — نمط التعبير النمطي المراد العثور عليه. const String
  • replacement — السلسلة التي سيُستبدل بها النمط، وقد تحتوي على استبدالات. const String
القيمة المرجعة يعيد سلسلةً استُبدلت فيها جميع المطابقات للتعبير النمطي. String أمثلة استبدال جميع الأحرف بنسخة مضاعفة
Query
Response
مثال على استبدال سلسلة فرعية فارغة
Query
Response

replaceRegexpOne

أُضيف في: v1.1.0 يستبدل أول ظهور للسلسلة الفرعية المطابقة للتعبير النمطي pattern (بصيغة re2) في haystack بالسلسلة replacement. يمكن أن تحتوي replacement على استبدالات \0-\9. تقابل الاستبدالات \1-\9 المجموعة الملتقِطة الأولى حتى التاسعة (المطابقة الفرعية)، بينما يقابل الاستبدال \0 المطابقة كاملةً. لاستخدام المحرف \ حرفيًا في السلسلتين pattern أو replacement، قم بتهريبه باستخدام \. ضع في اعتبارك أيضًا أن القيم الحرفية النصية تتطلب تهريبًا إضافيًا. الصيغة
الوسائط
  • haystack — سلسلة الإدخال المراد البحث فيها. String
  • pattern — نمط التعبير النمطي المطلوب العثور عليه. const String
  • replacement — السلسلة التي سيُستبدل بها النمط، وقد تتضمن استبدالات. const String
القيمة المُعادة يعيد سلسلة جرى فيها استبدال أول تطابق للتعبير النمطي. String أمثلة تحويل تواريخ ISO إلى التنسيق الأمريكي
Query
Response
نسخ سلسلة نصية عشر مرات
Query
Response

translate

أُضيفت في: v22.7.0 تستبدل الأحرف في السلسلة s باستخدام مطابقة أحرف واحدًا لواحد تحددها السلسلتان from وto. يجب أن تكون from وto سلسلتين ثابتتين من نوع ASCII. إذا كان حجم from وto متساويًا، فسيُستبدل كل ظهور لأول حرف من first في s بأول حرف من to، ويُستبدل كل ظهور لثاني حرف من first في s بثاني حرف من to، وهكذا. إذا كانت from تحتوي على أحرف أكثر من to، فستُحذف من s جميع ظهورات الأحرف الموجودة في نهاية from التي لا يقابلها حرف في to. لا تعدّل الدالة الأحرف غير التابعة لـ ASCII في s. البنية
الوسيطات
  • s — سلسلة الإدخال المراد ترجمتها. String
  • from — سلسلة ASCII ثابتة تحتوي على الأحرف المراد استبدالها. const String
  • to — سلسلة ASCII ثابتة تحتوي على أحرف الاستبدال. const String
القيمة المُعادة تعيد سلسلة بعد تطبيق تحويلات الأحرف عليها. String أمثلة تعيين الأحرف
Query
Response
أطوال متفاوتة
Query
Response

translateUTF8

ظهر في: v22.7.0 مثل translate، لكنه يفترض أن s وfrom وto سلاسل نصية مرمّزة بترميز UTF-8. الصياغة
الوسائط
  • s — سلسلة UTF-8 المُدخلة المراد تحويلها. String
  • from — سلسلة UTF-8 ثابتة تحتوي على الأحرف المراد استبدالها. const String
  • to — سلسلة UTF-8 ثابتة تحتوي على أحرف الاستبدال. const String
القيمة المُعادة تعيد قيمة من نوع البيانات String. String أمثلة تحويل أحرف UTF-8
Query
Response
آخر تعديل في ٢٥ يونيو ٢٠٢٦