الفرق بين المراجعتين لصفحة: «Ruby/String»

مراجعة 19:21، 11 ديسمبر 2018

السلاسل النصية (string) هي سلسلة تحتوي على حرف واحد أو أكثر وقد تحتوي على حروف أبجدية، مثل أرقام ورموز، ويكون كل حرف (أو رمز أو رقم) ممثلاً ببايت. السلاسل النصية في لغة البرمجة روبي عبارة عن كائنات (Objects)، وعلى عكس لغات البرمجة الأخرى، فإن النصوص قابلة للتغيير (Mutable) والتي تعني أننا نستطيع تعديل النصوص بدلًا من إنشاء نصوص جديدة.

علامتا الاقتباس المزدوجتين والمفردتين

يتم إنشاء السلاسل النصية (string) في لغة روبي باستعمال علامات الاقتباس المزدوجة (مثل "string") أو المفردة (مثل 'string').

يمكن مثلًا كتابة العبارة النصية Hello Ruby بالشكل “ Hello Ruby ” (علامتا تنصيص مزدوجتين) أو الشكل ‘ Hello Ruby ’ (علامتا تنصيص مفردتين). الفرق الوحيد بينهما هو أن الطريقة الأولى تتيح استيفاء النصوص (String Interpolation) وإدراج شيفرات برمجية في السلاسل النصية.

تهريب علامات الاقتباس

يتم تهريب علامات الاقتباس بوضع الخط المائل العكسي قبل علامة الاقتباس بالشكل التالي "\:

“Sami said: \” Hello everyone \” “ #=>  Sami said: “ Hello everyone “

استعمال المحددات

يمكن تعريف السلسلة النصية باستعمال المحددات، حيث توضع في البداية علامة النسبة المئوية (%)، ومن ثم توضع المحددات في بداية ونهاية السلسلة النصية، والمحددات هي رموز يختارها المبرمج، على سبيل المثال علامة $ وعلامة & وعلامة @، كذلك يمكن استعمال الأقواس المعقوفة ({ }) أو المُربعة ([ ]) كمحدد. إليك المثال التالي :

%$ Sami Says: “ Hello everyone “ $ #=> Sami Says: “ Hello everyone “

%{ Sami Says: “ Hello everyone “ } #=> Sami Says: “ Hello everyone “

%[ Sami Says: “ Hello everyone ” ] #=> Sami Says: “ Hello everyone “

واضح من المثال أنه أياً كان المحدد، فإن النتيجة سوف تبقى نفسها.

السلاسل النصية والمتغيرات

يمكن حفظ السلاسل النصية في متغيرات من أجل العودة إليها لاحقًا، إذ كل ما يجب فعله هو تعريف اسم المتغير وإعطاءه قيمة النص المرغوب تخزينه.

title = “Welcome To Ruby Documentation”

puts title #=>  Welcome To Ruby Documentation

إدراج شيفرات برمجية في السلاسل النصية

يتم إدراج شيفرات برمجية في السلاسل النصية عن طريق وضعها ضمن أقواس معقوصة ({ }) مسبوقة بعلامة # ضمن السلسلة النصية نفسها.

name = “wikiHsoup”

puts “ My name is #{name} ” #=> My name is wikiHsoup

puts “ Sum is #{1+1} “ #=> Sum is 2

يجب الإشارة إلى أن إدراج الشيفرات البرمجية يعمل فقط مع السلاسل النصية المعرفة باستعمال علامتا التنصيص المزدوجتين والمحددات، ولا يعمل مع السلاسل النصية المعرفة باستخدام علامتا التنصيص المفردتين (' ').

name = “wikiHsoup”

puts ‘ My name is #{name} ‘ #=> My name is #{name}

ملاحظات

لمَّا كان هنالك بعض التعارضات في الأسماء البديلة، فيجب على من يستعل الصنف String أن يكون واعيًّا وحذرًا لكي تفرِّق بين التوابع التي تعدِّل محتوى السلسلة النصية الأصلية نفسها وبين التي تعدِّل المحتوى وتضعه في سلسلة نصية جديدة. عادةً، التوابع التي تنتهي بعلامة التعجب "!" هي التي تعدِّل السلسلة النصية الأصلية بينما تضع التوابع الأخرى المحتوى الذي عدلته في سلسلة نصية جديدة. على أي حال، هنالك استثناءات دومًا، لذا اقرأ التوثيق كل تابع بشكل جيد قبل استعماله.

توابع الصنف العامة

`new`

`try_convert`

توابع النسخة العامة

`%`

`*`

ينسخ سلسلة نصية عددًا محدَّدًا من المرات ثم يضعها في سلسلة نصية جديدة.

`+`

يجمع سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة.

‎`+@‎`

يعيد المعامل + عند استدعائه بالشكل str+ نسخةً مطابقةً للسلسلة النصية str وقابلةً للتغيير (Mutable) في حال كانت هذه السلسلة النصية مجمدة.

‎`-@‎`

يعيد المعامل - عند استدعائه بالشكل str- نسخةً مطابقةً ومجمدةً للسلسلة النصية str في حال كانت غير مجمدة.

`>>`

يُلحق الكائن المُعطى بالسلسلة النصية.

`<=>`

يُقارن بين سلسلتين نصيتين ثم يعيد القيم 1-، أو 1، أو 0، إذا ما كانت السلسلة النصية الأولى أكبر أو أصغر أو تساوي السلسلة النصية الثانية على التوالي.

`==`

يتحقق من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى.

`===`

يتحقق من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى.

‎`=~‎`

`[]`

يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

`[]=`

`ascii_only?‎`

يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط.

`b`

`bytes`

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

`bytesize`

يعيد طول السلسلة النصية التي استدعيت معه بالبايت.

`byteslice`

يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

`capitalize`

`capitalize!‎`

`casecmp`

`casecmp?‎`

`center`

`chars`

`chomp`

`chomp!‎`

`chop`

`chop!‎`

`chr`

`clear`

`codepoints`

`concat`

`count`

`crypt`

`delete`

`delete!‎`

`downcase`

`downcase!‎`

`dump`

`each_byte`

`each_char`

`each_codepoint`

`each_grapheme_cluster`

`each_line`

`empty?‎`

`encode`

`encode!‎`

`encoding`

`end_with?‎`

`eql?‎`

`force_encoding`

`freeze`

`getbyte`

`grapheme_clusters`

`gsub`

`gsub!‎`

`hash`

`hex`

`include?‎`

`index`

`initialize_copy`

`insert`

`inspect`

`intern`

`length`

`lines`

`ljust`

`lstrip`

`lstrip!‎`

`match`

`match?‎`

`next`

`next!‎`

`oct`

`ord`

`partition`

`prepend`

`replace`

`reverse`

`reverse!‎`

`rindex`

`rjust`

`rpartition`

`rstrip`

`rstrip!‎`

`scan`

`scrub`

`scrub!‎`

`setbyte`

`size`

`slice`

`slice!‎`

`split`

`squeeze`

`squeeze!‎`

`start_with?‎`

`strip`

`strip!‎`

`sub`

`sub!‎`

`succ`

`succ!‎`

`sum`

`swapcase`

`swapcase!‎`

`to_c`

`to_f`

`to_i`

`to_r`

`to_s`

`to_str`

`to_sym`

`tr`

`tr!‎`

`tr_s`

`tr_s!‎`

`undump`

`unpack`

`unpack1`

`upcase`

`upcase!‎`

`upto`

`valid_encoding?‎`

مصادر

صفحة الصنف String في توثيق روبي الرسمي.

@@ سطر 54: / سطر 54: @@
 ===<code>[[Ruby/String/25|%]]</code>===
 ===<code>[[Ruby/String/2A|*]]</code>===
+ينسخ سلسلة نصية عددًا محدَّدًا من المرات ثم يضعها في سلسلة نصية جديدة.
 ===<code>[[Ruby/String/2B|+]]</code>===
-===<code>[[Ruby/String/2B-40|+@]]</code>===
+يجمع سلسلتين نصيتين مع بعضهما بعضًا ثم يعيد الناتج في سلسلة نصية جديدة.
-===<code>[[Ruby/String/2D-40|-@]]</code>===
-===<code>[[Ruby/String/3C-3C|<<]]</code>===
+===‎<code>[[Ruby/String/2B-40|+@‎]]</code>===
+يعيد المعامل <code>+</code> عند استدعائه بالشكل <code>str+</code> نسخةً مطابقةً للسلسلة النصية <code>str</code> وقابلةً للتغيير (Mutable) في حال كانت هذه السلسلة النصية مجمدة.
+===‎<code>[[Ruby/String/2D-40|-@‎]]</code>===
+يعيد المعامل <code>-</code> عند استدعائه بالشكل <code>str-</code> نسخةً مطابقةً ومجمدةً للسلسلة النصية <code>str</code> في حال كانت غير مجمدة.
+===<code>[[Ruby/String/3C-3C|>>]]</code>===
+يُلحق الكائن المُعطى بالسلسلة النصية.
 ===<code>[[Ruby/String/3C-3D-3E|<=>]]</code>===
+يُقارن بين سلسلتين نصيتين ثم يعيد القيم 1-، أو 1، أو 0، إذا ما كانت السلسلة النصية الأولى أكبر أو أصغر أو تساوي السلسلة النصية الثانية على التوالي.
 ===<code>[[Ruby/String/3D-3D|==]]</code>===
+يتحقق من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى.
 ===<code>[[Ruby/String/3D-3D-3D|===]]</code>===
-===<code>[[Ruby/String/3D~|=~]]</code>===
+يتحقق من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى.
+===‎<code>[[Ruby/String/3D~|=~‎]]</code>===
 ===<code>[[Ruby/String/5B-5D|[]]]</code>===
+يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.
 ===<code>[[Ruby/String/5B-5D-3D|[]=]]</code>===
-===<code>[[Ruby/String/ascii_only-3F|ascii_only?]]</code>===
+===<code>[[Ruby/String/ascii_only-3F|ascii_only?‎]]</code>===
+يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز [[Arduino/asciichart|ASCII]] فقط.
 ===<code>[[Ruby/String/b|b]]</code>===
 ===<code>[[Ruby/String/bytes|bytes]]</code>===
+يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة.
 ===<code>[[Ruby/String/bytesize|bytesize]]</code>===
+يعيد طول السلسلة النصية التي استدعيت معه بالبايت.
 ===<code>[[Ruby/String/byteslice|byteslice]]</code>===
+يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.
 ===<code>[[Ruby/String/capitalize|capitalize]]</code>===
-===<code>[[Ruby/String/capitalize-21|capitalize!]]</code>===
+===<code>[[Ruby/String/capitalize-21|capitalize!‎]]</code>===
 ===<code>[[Ruby/String/casecmp|casecmp]]</code>===
-===<code>[[Ruby/String/casecmp-3F|casecmp?]]</code>===
+===<code>[[Ruby/String/casecmp-3F|casecmp?‎]]</code>===
 ===<code>[[Ruby/String/center|center]]</code>===
 ===<code>[[Ruby/String/chars|chars]]</code>===
 ===<code>[[Ruby/String/chomp|chomp]]</code>===
-===<code>[[Ruby/String/chomp-21|chomp!]]</code>===
+===<code>[[Ruby/String/chomp-21|chomp!‎]]</code>===
 ===<code>[[Ruby/String/chop|chop]]</code>===
-===<code>[[Ruby/String/chop-21|chop!]]</code>===
+===<code>[[Ruby/String/chop-21|chop!‎]]</code>===
 ===<code>[[Ruby/String/chr|chr]]</code>===
 ===<code>[[Ruby/String/clear|clear]]</code>===
@@ سطر 86: / سطر 112: @@
 ===<code>[[Ruby/String/crypt|crypt]]</code>===
 ===<code>[[Ruby/String/delete|delete]]</code>===
-===<code>[[Ruby/String/delete-21|delete!]]</code>===
+===<code>[[Ruby/String/delete-21|delete!‎]]</code>===
 ===<code>[[Ruby/String/delete_prefix|delete_prefix]]</code>===
-===<code>[[Ruby/String/delete_prefix-21|delete_prefix!]]</code>===
+===<code>[[Ruby/String/delete_prefix-21|delete_prefix!‎]]</code>===
 ===<code>[[Ruby/String/delete_suffix|delete_suffix]]</code>===
-===<code>[[Ruby/String/delete_suffix-21|delete_suffix!]]</code>===
+===<code>[[Ruby/String/delete_suffix-21|delete_suffix!‎]]</code>===
 ===<code>[[Ruby/String/downcase|downcase]]</code>===
-===<code>[[Ruby/String/downcase-21|downcase!]]</code>===
+===<code>[[Ruby/String/downcase-21|downcase!‎]]</code>===
 ===<code>[[Ruby/String/dump|dump]]</code>===
 ===<code>[[Ruby/String/each_byte|each_byte]]</code>===
@@ سطر 99: / سطر 125: @@
 ===<code>[[Ruby/String/each_grapheme_cluster|each_grapheme_cluster]]</code>===
 ===<code>[[Ruby/String/each_line|each_line]]</code>===
-===<code>[[Ruby/String/empty-3F|empty?]]</code>===
+===<code>[[Ruby/String/empty-3F|empty?‎]]</code>===
 ===<code>[[Ruby/String/encode|encode]]</code>===
-===<code>[[Ruby/String/encode-21|encode!]]</code>===
+===<code>[[Ruby/String/encode-21|encode!‎]]</code>===
 ===<code>[[Ruby/String/encoding|encoding]]</code>===
-===<code>[[Ruby/String/end_with-3F|end_with?]]</code>===
+===<code>[[Ruby/String/end_with-3F|end_with?‎]]</code>===
-===<code>[[Ruby/String/eql-3F|eql?]]</code>===
+===<code>[[Ruby/String/eql-3F|eql?‎]]</code>===
 ===<code>[[Ruby/String/force_encoding|force_encoding]]</code>===
 ===<code>[[Ruby/String/freeze|freeze]]</code>===
@@ سطر 110: / سطر 136: @@
 ===<code>[[Ruby/String/grapheme_clusters|grapheme_clusters]]</code>===
 ===<code>[[Ruby/String/gsub|gsub]]</code>===
-===<code>[[Ruby/String/gsub-21|gsub!]]</code>===
+===<code>[[Ruby/String/gsub-21|gsub!‎]]</code>===
 ===<code>[[Ruby/String/hash|hash]]</code>===
 ===<code>[[Ruby/String/hex|hex]]</code>===
-===<code>[[Ruby/String/include-3F|include?]]</code>===
+===<code>[[Ruby/String/include-3F|include?‎]]</code>===
 ===<code>[[Ruby/String/index|index]]</code>===
 ===<code>[[Ruby/String/initialize_copy|initialize_copy]]</code>===
@@ سطر 123: / سطر 149: @@
 ===<code>[[Ruby/String/ljust|ljust]]</code>===
 ===<code>[[Ruby/String/lstrip|lstrip]]</code>===
-===<code>[[Ruby/String/lstrip-21|lstrip!]]</code>===
+===<code>[[Ruby/String/lstrip-21|lstrip!‎]]</code>===
 ===<code>[[Ruby/String/match|match]]</code>===
-===<code>[[Ruby/String/match-3F|match?]]</code>===
+===<code>[[Ruby/String/match-3F|match?‎]]</code>===
 ===<code>[[Ruby/String/next|next]]</code>===
-===<code>[[Ruby/String/next-21|next!]]</code>===
+===<code>[[Ruby/String/next-21|next!‎]]</code>===
 ===<code>[[Ruby/String/oct|oct]]</code>===
 ===<code>[[Ruby/String/ord|ord]]</code>===
@@ سطر 134: / سطر 160: @@
 ===<code>[[Ruby/String/replace|replace]]</code>===
 ===<code>[[Ruby/String/reverse|reverse]]</code>===
-===<code>[[Ruby/String/reverse-21|reverse!]]</code>===
+===<code>[[Ruby/String/reverse-21|reverse!‎]]</code>===
 ===<code>[[Ruby/String/rindex|rindex]]</code>===
 ===<code>[[Ruby/String/rjust|rjust]]</code>===
 ===<code>[[Ruby/String/rpartition|rpartition]]</code>===
 ===<code>[[Ruby/String/rstrip|rstrip]]</code>===
-===<code>[[Ruby/String/rstrip-21|rstrip!]]</code>===
+===<code>[[Ruby/String/rstrip-21|rstrip!‎]]</code>===
 ===<code>[[Ruby/String/scan|scan]]</code>===
 ===<code>[[Ruby/String/scrub|scrub]]</code>===
-===<code>[[Ruby/String/scrub-21|scrub!]]</code>===
+===<code>[[Ruby/String/scrub-21|scrub!‎]]</code>===
 ===<code>[[Ruby/String/setbyte|setbyte]]</code>===
 ===<code>[[Ruby/String/size|size]]</code>===
 ===<code>[[Ruby/String/slice|slice]]</code>===
-===<code>[[Ruby/String/slice-21|slice!]]</code>===
+===<code>[[Ruby/String/slice-21|slice!‎]]</code>===
 ===<code>[[Ruby/String/split|split]]</code>===
 ===<code>[[Ruby/String/squeeze|squeeze]]</code>===
-===<code>[[Ruby/String/squeeze-21|squeeze!]]</code>===
+===<code>[[Ruby/String/squeeze-21|squeeze!‎]]</code>===
-===<code>[[Ruby/String/start_with-3F|start_with?]]</code>===
+===<code>[[Ruby/String/start_with-3F|start_with?‎]]</code>===
 ===<code>[[Ruby/String/strip|strip]]</code>===
-===<code>[[Ruby/String/strip-21|strip!]]</code>===
+===<code>[[Ruby/String/strip-21|strip!‎]]</code>===
 ===<code>[[Ruby/String/sub|sub]]</code>===
-===<code>[[Ruby/String/sub-21|sub!]]</code>===
+===<code>[[Ruby/String/sub-21|sub!‎]]</code>===
 ===<code>[[Ruby/String/succ|succ]]</code>===
-===<code>[[Ruby/String/succ-21|succ!]]</code>===
+===<code>[[Ruby/String/succ-21|succ!‎]]</code>===
 ===<code>[[Ruby/String/sum|sum]]</code>===
 ===<code>[[Ruby/String/swapcase|swapcase]]</code>===
-===<code>[[Ruby/String/swapcase-21|swapcase!]]</code>===
+===<code>[[Ruby/String/swapcase-21|swapcase!‎]]</code>===
 ===<code>[[Ruby/String/to_c|to_c]]</code>===
 ===<code>[[Ruby/String/to_f|to_f]]</code>===
@@ سطر 168: / سطر 194: @@
 ===<code>[[Ruby/String/to_sym|to_sym]]</code>===
 ===<code>[[Ruby/String/tr|tr]]</code>===
-===<code>[[Ruby/String/tr-21|tr!]]</code>===
+===<code>[[Ruby/String/tr-21|tr!‎]]</code>===
 ===<code>[[Ruby/String/tr_s|tr_s]]</code>===
-===<code>[[Ruby/String/tr_s-21|tr_s!]]</code>===
+===<code>[[Ruby/String/tr_s-21|tr_s!‎]]</code>===
 ===<code>[[Ruby/String/undump|undump]]</code>===
 ===<code>[[Ruby/String/unicode_normalize|unicode_normalize]]</code>===
-===<code>[[Ruby/String/unicode_normalize-21|unicode_normalize!]]</code>===
+===<code>[[Ruby/String/unicode_normalize-21|unicode_normalize!‎]]</code>===
-===<code>[[Ruby/String/unicode_normalized-3F|unicode_normalized?]]</code>===
+===<code>[[Ruby/String/unicode_normalized-3F|unicode_normalized?‎]]</code>===
 ===<code>[[Ruby/String/unpack|unpack]]</code>===
 ===<code>[[Ruby/String/unpack1|unpack1]]</code>===
 ===<code>[[Ruby/String/upcase|upcase]]</code>===
-===<code>[[Ruby/String/upcase-21|upcase!]]</code>===
+===<code>[[Ruby/String/upcase-21|upcase!‎]]</code>===
 ===<code>[[Ruby/String/upto|upto]]</code>===
-===<code>[[Ruby/String/valid_encoding-3F|valid_encoding?]]</code>===
+===<code>[[Ruby/String/valid_encoding-3F|valid_encoding?‎]]</code>===
 == مصادر ==