EncodeStringFromVariant

متن، توابع متفرقه

توضیحات

این تابع برای کدگذاری یک رشته در قالب UTF-16LE از آرایه‌ای از اعداد ذخیره‌شده به‌صورت نوع Variant استفاده می‌شود

نحو

ActiveX

Function PDFlib::EncodeStringFromVariant(NumberList As Variant, Encoding As String, UnmatchedAction As Long) As String

پارامترها

NumberList

آرایهٔ variant از اعداد؛ اعداد آرایه را می‌توان در هر نوع variant ترتیبی ذخیره کرد (اعداد صحیح علامت‌دار یا بدون علامت از 8 تا 32 بیت)

Encoding

رشته‌ای که تعریف می‌کند اعداد آرایه چگونه به کد نویسه نگاشت شوند:

"Unicode" = اعداد، نقاط کد یونیکد با مقادیر 0x0000 تا 0x10FFFD را نشان می‌دهند

"UTF-8" = اعداد، بایت‌های نقاط کد یونیکد را نشان می‌دهند که با طرح کدگذاری با طول متغیر UTF-8 و مقادیر 0 تا 244 کدگذاری شده‌اند

"UTF-16" = اعداد، مقادیر 16 بیتی نقاط کد یونیکد را نشان می‌دهند که با طرح کدگذاری با طول متغیر UTF-16 و مقادیر 0 تا 65533 کدگذاری شده‌اند. مقادیر یونیکد از U+010000 تا U+10FFFD با یک جفت سرور (surrogate pair) شامل دنباله‌ای از دو عدد نمایش داده می‌شوند

"UTF-16LE" = اعداد، بایت‌های طرح کدگذاری UTF-16 ذخیره‌شده به‌صورت little-endian با مقادیر 0 تا 255 را نشان می‌دهند. "UTF-16BE" = اعداد، بایت‌های طرح کدگذاری UTF-16 ذخیره‌شده به‌صورت big-endian با مقادیر 0 تا 255 را نشان می‌دهند. "CP932" = اعداد، بایت‌های تکی یا ترکیبی از مقادیر 8 بیتی و 16 بیتی از code page 932 مایکروسافت (امتدادی از کدگذاری Shift JIS) را نشان می‌دهند. مقادیر دوبایتی را می‌توان به‌صورت یک عدد 16 بیتی یا دو عدد 8 بیتی نشان داد

برای encodingهایی که در آن‌ها عددها نمایانگر بایت هستند، این تابع مقدارهای signed 8-bit را به مقدارهای unsigned 8-bit cast می‌کند

UnmatchedAction

مشخص می‌کند با اعداد خارج از بازه یا اعدادی که به کد نویسهٔ نامعتبر نگاشت می‌شوند چگونه رفتار شود:

0 = نویسه‌های تطبیق‌نیافته نادیده گرفته می‌شوند

1 = نویسه‌های منطبق‌نشده با نویسهٔ جایگزین یونیکد U+FFFD جایگزین می‌شوند