عرض مصدر Node.js/string decoder

<nowiki><noinclude>{{DISPLAYTITLE:الوحدة String Decoder في Node.js}}</nowiki><nowiki></noinclude></nowiki>

وحدة فك الترميز <code>string_decoder</code> توفر واجهة برمجية API لفك ترميز كائنات <code>Buffer</code> إلى سلاسل بطريقة تصون المحارف متعددة البايتات المرمزة بواسطة UTF-8 و UTF-16. يمكن الوصول إلى هذه الوحدة باستخدام:<syntaxhighlight lang="javascript">
const { StringDecoder } = require('string_decoder');
</syntaxhighlight>المثال التالي يعرض الاستخدام الأساسي لصنف <code>StringDecoder</code>:<syntaxhighlight lang="javascript">
const { StringDecoder } = require('string_decoder');
const decoder = new StringDecoder('utf8');

const cent = Buffer.from([0xC2, 0xA2]);
console.log(decoder.write(cent));

const euro = Buffer.from([0xE2, 0x82, 0xAC]);
console.log(decoder.write(euro));
</syntaxhighlight>عندما تُكتَب نسخة من الصنف <code>Buffer</code> إلى نسخة من الصنف <code>StringDecoder</code>، ستُستخدم ذاكرة مؤقتة داخلية لضمان أنّ السلسلة مفكوكة الترميز لا تحوي أي محارف متعددة البايت غير مكتملة.حيث تُحفظ في الذاكرة المؤقتة حتى الإستدعاء التالي للتابع <code>stringDecoder.write()</code>‎ أو حتى يستدعى التابع <code>stringDecoder.end()</code>‎.

في المثال التالي، البايتات الثلاث مرمّزة بترميز UTF-8  لرمز اليورو الأوروبي (<code>€</code>)، تُكتب عبر ثلاث عمليات منفصلة:<syntaxhighlight lang="javascript">
const { StringDecoder } = require('string_decoder');
const decoder = new StringDecoder('utf8');

decoder.write(Buffer.from([0xE2]));
decoder.write(Buffer.from([0x82]));
console.log(decoder.end(Buffer.from([0xAC])));
</syntaxhighlight>

== الصنف StringDecoder ==

=== <code>new StringDecoder([encoding])‎</code> ===
أُضيف في الإصدار: 0.1.99
* <code>encoding</code> ‎[[JavaScript/String|<string‎>]]‎: ترميز المحارف الذي سيستخدمه الصنف <code>StringDecoder</code>. '''القيمة الافتراضية:''' <code>'utf8'</code>  ينشئ نسخة جديدة من الصنف <code>StringDecoder</code>.

=== <code>stringDecoder.end([buffer])‎</code> ===
أُضيف في الإصدار: 0.9.3
* <code>buffer</code> [[Node.js/buffer|<Buffer>]]‎: نسخة من الصنف <code>Buffer</code> لكي يُفك ترميزها
* القيمة المعادة: سلسلة نصية [[JavaScript/String|<string>]].
يعيد أي مدخلات متبقية محفوظة في الذاكرة المؤقتة الداخلية كسلسلة نصية،  ستُبدّل محارف ال UTF-8 و UTF-16  غير المكتملة  إلى بديل مناسب لترميز المحارف المستخدم.

إذا كان الوسيط <code>buffer</code> متوافرًا، سوف يُنجز استدعاء أخير واحد للتابع <code>stringDecoder.write()</code>‎ قبل إعادة باقي الدخل.

=== <code>stringDecoder.write(buffer)‎</code> ===
سجل التغييرات
{| class="wikitable mw-collapsible"
!الإصدار
!التغييرات
|-
|v8.0.0
|كل محرف غير متوفر يستبدل الآن بمحرف بديل فريد عوضًا عن واحد لكل بايت منفرد.
|-
|v0.1.99
|أضيف في: v0.1.99
|}
* <code>buffer</code> [[Node.js/buffer|<Buffer>‎]]: نسخة من الصنف <code>Buffer</code> لكي يُفك ترميزها.

* القيمة المُعادة: سلسلة نصية [[JavaScript/String|<string>]].
تعاد سلسة نصية مفكوكة الترميز، ضامنة أنّ أي محارف غير مكتملة في نهاية المعامل <code>Buffer</code> سوف تُهمل في السلسلة المعادة وتخزن في ذاكرة مؤقتة داخلية للاستدعاء القادم للتابع <code>stringDecoder.write()</code>‎ أو <code>stringDecoder.end()‎</code>.

== مصادر ==
* [https://nodejs.org/dist/latest-v10.x/docs/api/string_decoder.html صفحة الوحدة String Decoder في توثيق Node.js الرسمي.]
[[تصنيف:Node.js]]