عرض مصدر Ruby/String/getbyte

<noinclude>{{DISPLAYTITLE:التابع <code>String.getbyte</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby String]]
يُعيد التابع <code>getbyte</code> قيمة البايت المقابل للمحرف الموجود في الفهرس المُحدد من السلسلة النصية التي استدعي معها.
==البنية العامة==
<syntaxhighlight lang="ruby">getbyte(index) → 0 .. 255</syntaxhighlight>

== المعاملات ==

=== <code>index</code> ===
فهرس المحرف المُراد جلب قيمة البايت المقابل له.

==القيمة المعادة==
يُعاد [[Ruby/Integer|عدد صحيح]] بين 0 و 255 يمثِّل قيمة البايت المقابل للمحرف ذي الفهرس <code>index</code> في السلسلة النصية المعطاة، أو تُعاد القيمة <code>nil</code> في حال كان الفهرس يقع خارج السلسلة. 

==أمثلة==
مثال على استعمال التابع <code>getbyte</code>:
<syntaxhighlight lang="ruby">"hello".getbyte(0) #=> 104
"hello".getbyte(9) #=> nil
</syntaxhighlight>

==انظر أيضًا==
* المعامل <code>[[Ruby/String/5B-5D|[]]]</code>: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

* التابع <code>[[Ruby/String/bytes|bytes]]</code>: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة.

* التابع <code>[[Ruby/String/each byte|each_byte]]</code>: يُمرر كل بايت من بايتات السلسلة النصية التي استدعي معها إلى الكتلة المُعطاة.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-getbyte قسم التابع ‎getbyte في الصنف String في توثيق روبي الرسمي.]