توفّر الحزمة regexp دعمًا للتعبيرات النمطية في Go.
الصياغة
إنّ الصياغة الخاصة بالتعبيرات النمطية المقبولة هي الصياغة العامة نفسها التي تستخدمها Perl و Python ولغات أخرى.
يُفسَّر كل من أنماط البحث والنصوص المُدخَلة بترميز UTF-8.
عند استخدام العلامات الخلفية (`) لإنشاء السلاسل النصية، لا يكون للشرطات المائلة العكسية (\) أي معنى خاص، ولا تدلّ على بداية محارف خاصة مثل علامات الجدولة \t أو الأسطر الجديدة \n:
"\t\n" // regular string literal with 2 characters: a tab and a newline
`\t\n`// raw string literal with 4 characters: two backslashes, a 't', and an 'n'
لهذا السبب، من المستحسن استخدام العلامات الخلفية لإنشاء التعبيرات النمطية، لأن ذلك يعني أننا لا نحتاج إلى تخطّي الشرطات المائلة العكسية:
"\\" // string with a single backslash
`\\` // string with 2 backslashes
تصريف الأنماط - نوع RegExp
لاستخدام تعبير نمطي، علينا أولًا تصريف نمط السلسلة النصية.
التصريف هنا يعني أخذ نمط السلسلة النصية للتعبير النمطي وتحويله إلى تمثيل داخلي يسهل التعامل معه.
نحتاج إلى تصريف كل نمط مرة واحدة فقط، وبعد ذلك يمكننا استخدام النسخة المصرّفة من التعبير النمطي مرات عديدة.
يمثّل النوع regexp.Regexp تعبيرًا نمطيًا مصرّفًا.
يمكننا تصريف نمط سلسلة نصية إلى regexp.Regexp باستخدام الدالة regexp.Compile.
تُرجع هذه الدالة nil وخطأً إذا فشل التصريف:
re, err := regexp.Compile(`(a|b)+`)
fmt.Println(re, err) // => (a|b)+ <nil>
re, err = regexp.Compile(`a|b)+`)
fmt.Println(re, err) // => <nil> error parsing regexp: unexpected ): `a|b)+`
تُعدّ الدالة MustCompile بديلًا مريحًا للدالة Compile:
re = regexp.MustCompile(`[a-z]+\d*`)
باستخدام هذه الدالة، لا حاجة إلى التعامل مع خطأ.
ينبغي استخدام MustCompile فقط عندما نتأكد من أن النمط يُصرَّف، وإلا فسيدخل البرنامج في حالة panic.
طرق التعبيرات النمطية
هناك 16 طريقة في Regexp تطابق تعبيرًا نمطيًا وتحدّد النص المطابق.
تتطابق أسماءها مع هذا التعبير النمطي:
Find(All)?(String)?(Submatch)?(Index)?
- إذا وُجد
All، تُطابق الطريقة المطابقات المتتالية غير المتداخلة للتعبير بأكمله.
- إذا وُجد
String، فإن الوسيط سلسلة نصية؛ وإلا فهو شريحة من البايتات؛ وتُعدَّل القيم المُرجَعة وفقًا لذلك.
- إذا وُجد
Submatch، فإن القيمة المُرجَعة شريحة تحدّد المطابقات الفرعية المتتالية للتعبير.
- إذا وُجد
Index، تُحدَّد المطابقات والمطابقات الفرعية عبر أزواج فهارس البايتات داخل سلسلة الإدخال.
وهناك أيضًا طرق من أجل:
- استبدال مطابقات التعبيرات النمطية بسلاسل نصية بديلة، و
- تقسيم السلاسل النصية المفصولة بالتعبيرات النمطية.
إجمالًا، تعرّف حزمة regexp أكثر من 40 دالة وطريقة.
سنوضّح أدناه استخدام بعض الطرق.
يُرجى الرجوع إلى توثيق API لمعرفة تفاصيل هذه الدوال وغيرها.
أمثلة على MatchString
تُبلّغ الطريقة MatchString عمّا إذا كانت سلسلة نصية تحتوي على أي مطابقة لتعبير نمطي.
re = regexp.MustCompile(`[a-z]+\d*`)
b = re.MatchString("[a12]") // => true
b = re.MatchString("12abc34(ef)") // => true
b = re.MatchString(" abc!") // => true
b = re.MatchString("123 456") // => false
أمثلة على FindString
تُرجع الطريقة FindString سلسلة نصية تحمل نص أول مطابقة من اليسار للتعبير النمطي.
re = regexp.MustCompile(`[a-z]+\d*`)
s = re.FindString("[a12]") // => "a12"
s = re.FindString("12abc34(ef)") // => "abc34"
s = re.FindString(" abc!") // => "abc"
s = re.FindString("123 456") // => ""
أمثلة على FindStringSubmatch
تُرجع الطريقة FindStringSubmatch شريحة من السلاسل النصية تحمل نص أول مطابقة من اليسار للتعبير النمطي، ومطابقات تعبيراته الفرعية إن وُجدت.
ويمكن استخدام ذلك لتحديد السلاسل النصية المطابقة لمجموعات الالتقاط.
وتشير القيمة المُرجَعة nil إلى عدم وجود مطابقة.
re = regexp.MustCompile(`[a-z]+(\d*)`)
sl = re.FindStringSubmatch("[a12]") // => []string{"a12","12"}
sl = re.FindStringSubmatch("12abc34(ef)") // => []string{"abc34","34"}
sl = re.FindStringSubmatch(" abc!") // => []string{"abc",""}
sl = re.FindStringSubmatch("123 456") // => <nil>
أمثلة على ReplaceAllString
تُرجع الطريقة re.ReplaceAllString(src,repl) نسخة من src، مع استبدال مطابقات التعبير النمطي re بالسلسلة النصية البديلة repl.
re = regexp.MustCompile(`[a-z]+\d*`)
s = re.ReplaceAllString("[a12]", "X") // => "[X]"
s = re.ReplaceAllString("12abc34(ef)", "X") // => "12X(X)"
s = re.ReplaceAllString(" abc!", "X") // => " X!"
s = re.ReplaceAllString("123 456", "X") // => "123 456"
أمثلة على Split
تقطّع الطريقة re.Split(s,n) نصًا s إلى سلاسل نصية فرعية مفصولة بالتعبير، وتُرجع شريحة بالسلاسل النصية الفرعية الواقعة بين مطابقات ذلك التعبير.
ويحدّد العدد n الحدّ الأقصى لعدد السلاسل النصية الفرعية المُرجَعة.
وإذا كان n<0، تُرجع الطريقة كل السلاسل النصية الفرعية.
re = regexp.MustCompile(`[a-z]+\d*`)
sl = re.Split("[a12]", -1) // => []string{"[","]"}
sl = re.Split("12abc34(ef)", 2) // => []string{"12","(ef)"}
sl = re.Split(" abc!", -1) // => []string{" ","!"}
sl = re.Split("123 456", -1) // => []string{"123 456"}
تمرين تعلّمي
