الفرق بين المراجعتين ل"Ruby/Array/pack"

من موسوعة حسوب
< Ruby‏ | Array
اذهب إلى التنقل اذهب إلى البحث
سطر 17: سطر 17:
 
يأخذ هذا المعامل إحدى قيم الموجهات المستعملة مع التابع <code>pack</code> وهي:
 
يأخذ هذا المعامل إحدى قيم الموجهات المستعملة مع التابع <code>pack</code> وهي:
 
-------(لا تنس ترجمة الموجهات)
 
-------(لا تنس ترجمة الموجهات)
 +
 +
{| class="wikitable"
 +
!االموجه             
 +
!عناصر المصفوفة
 +
!شرح                                                                                       
 +
|-
 +
|<code>C</code>
 +
|<code>Integer</code>
 +
|8 بتات بدون إشارة (‎8-bit unsigned)
 +
|-
 +
|<code>S</code>
 +
|<code>Integer</code>
 +
|16 بتة بدون إشارة، هندي أولي  ‎16-bit unsigned, native endian [uint16_t] )‎)
 +
|-
 +
|<code>L</code>
 +
|<code>Integer</code>
 +
|32 بتة بدون إشارة، هندي أولي  ‎32-bit unsigned, native endian [uint32_t] )‎)
 +
|-
 +
|<code>Q</code>
 +
|<code>Integer</code>
 +
|64 بتة بدون إشارة، هندي أولي  ‎64-bit unsigned, native endian [uint64_t] )‎)
 +
|-
 +
|<code>J</code>
 +
|<code>Integer</code>
 +
|عرض المؤشر بدون إشارة، هندي أولي (pointer width unsigned, native endian [uintptr_t]‎ )
 +
هذا الموجه متاح منذ Ruby 2.3
 +
|-
 +
| colspan="3" |
 +
|-
 +
|c
 +
|<code>Integer</code>
 +
|8 بتات بإشارة (‎8-bit signed)
 +
|-
 +
|<code>s</code>
 +
|<code>Integer</code>
 +
|16 بتة بإشارة، هندي أولي  ‎16-bit signed, native endian [int16_t] )‎)
 +
|-
 +
|<code>l</code>
 +
|<code>Integer</code>
 +
|32 بتة بإشارة، هندي أولي  ‎32-bit signed, native endian [int32_t] )‎)
 +
|-
 +
|<code>q</code>
 +
|<code>Integer</code>
 +
|64 بتة بإشارة، هندي أولي  ‎64-bit signed, native endian [int64_t] )‎)
 +
|-
 +
|<code>j</code>
 +
|<code>Integer</code>
 +
|عرض المؤشر بإشارة، هندي أولي (pointer width signed, native endian [intptr_t]‎ )
 +
هذا الموجه متاح منذ Ruby 2.3
 +
|}
  
 
=== <code>buffer: aBufferString</code> ===
 
=== <code>buffer: aBufferString</code> ===

مراجعة 10:48، 7 سبتمبر 2018

يُحزِّمُ (packs) التابع pack محتويات المصفوفة التي استُدعيت معه على شكل تسلسل ثنائي (binary sequence) وفقًا للمُوجِّهات (directives) الواردة في المعامل aTemplateString؛ يمكن أن يتبع المُوجِّهات ","" و "A"" و ""a"" عددًا يحدّد عرض الحقل الناتج. قد تأخذ المُوجّهات المتبقية عددًا أيضًا مما يشير إلى عدد عناصر المصفوفة المطلوب تحويلها.

إذا كان العدد يمثِّل محرف النجمة ("*")، فستُحوَّل جميع عناصر المصفوفة المتبقية. يمكن أن تُتبَع أيٌّ من المُوجّهات "sSiIlL" بشرطة سفلية ("_") أو إشارة تعجب ("!") لاستخدام الحجم الأصلي للمنصة الأساسية (underlying platform) للنوع المحدد؛ خلا ذلك، ستستخدم حجمًا مستقلًا عن المنصة (platform-independent size). يتم تجاهل المسافات البيضاء في سلسلة القالب.

في حال تمرير المعامل aBufferString وكانت سعته (capacity) كافية، فسيستخدمها التابع pack كمخزن مؤقت (buffer) ثمَّ يعيدها. عندما تُحدَّد الإزاحة (offset) ببداية aTemplateString، فستُملَأ النتيجة بعد الإزاحة. في حالة وجود محتويات سابقة في aBufferString وكان طولها أكبر من الإزاحة offset، فسيُكتَب الناتج فوق ما بقي من offsetOfBuffer. أمّا إذا كان طولها أصغر، فسيُملَأ الفراغ المتبقي بالمحرف "‎\0".

البنية العامة

 pack( aTemplateString ) → aBinaryString
pack( aTemplateString, buffer: aBufferString ) → aBufferString

المعاملات

aTemplateString

يأخذ هذا المعامل إحدى قيم الموجهات المستعملة مع التابع pack وهي:

(لا تنس ترجمة الموجهات)

االموجه عناصر المصفوفة شرح
C Integer 8 بتات بدون إشارة (‎8-bit unsigned)
S Integer 16 بتة بدون إشارة، هندي أولي ‎16-bit unsigned, native endian [uint16_t] )‎)
L Integer 32 بتة بدون إشارة، هندي أولي ‎32-bit unsigned, native endian [uint32_t] )‎)
Q Integer 64 بتة بدون إشارة، هندي أولي ‎64-bit unsigned, native endian [uint64_t] )‎)
J Integer عرض المؤشر بدون إشارة، هندي أولي (pointer width unsigned, native endian [uintptr_t]‎ )

هذا الموجه متاح منذ Ruby 2.3

c Integer 8 بتات بإشارة (‎8-bit signed)
s Integer 16 بتة بإشارة، هندي أولي ‎16-bit signed, native endian [int16_t] )‎)
l Integer 32 بتة بإشارة، هندي أولي ‎32-bit signed, native endian [int32_t] )‎)
q Integer 64 بتة بإشارة، هندي أولي ‎64-bit signed, native endian [int64_t] )‎)
j Integer عرض المؤشر بإشارة، هندي أولي (pointer width signed, native endian [intptr_t]‎ )

هذا الموجه متاح منذ Ruby 2.3

buffer: aBufferString

مخزن مؤقت يستعمل -إن كانت سعته كافية- لتخزين ناتج تنفيذ التابع pack فيه. انتبه إلى أنَّ الخيار "buffer:‎'' لا يضمن عدم تخصيص الذاكرة في التابع pack. إذا كانت سعة aBufferString غير كافية، فسيَحجز التابع pack حجمًا مناسبًا من الذاكرة.

القيم المعادة

يعاد كائنٌ من النوع aBinaryString، أو تخزَّن هذه البيانات المعادة في المعامل aBufferString (إن أعطي) ثم يعاد.

أمثلة

أمثلة على استخدام التابع pack: 

 a = [ "a", "b", "c" ]
n = [ 65, 66, 67 ]
a.pack("A3A3A3")   #=> "a  b  c  "
a.pack("a3a3a3")   #=> "a\000\000b\000\000c\000\000"
n.pack("ccc")      #=> "ABC"

انظر أيضًا

  • التابع hash: يعيد قيمة Hash للمصفوفة التي استُدعيت معه.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Ruby/Array/pack&oldid=16970"