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" = המספרים מייצגים נקודות קוד Unicode בטווח ערכים מ-0x0000 עד 0x10FFFD

"UTF-8" = המספרים מייצגים את בייטי נקודות הקוד Unicode המקודדים באמצעות תכנית הקידוד UTF-8 של אורך משתנה, עם ערכים מ-0 עד 244

"UTF-16" = המספרים מייצגים את הערכים בני 16 הסיביות של נקודות קוד Unicode המקודדים באמצעות תכנית הקידוד UTF-16 באורך משתנה, עם ערכים מ-0 עד 65533; ערכי Unicode מ-U+010000 עד U+10FFFD מיוצגים בתור זוג surrogate המורכב מרצף של שני מספרים

"UTF-16LE" = המספרים מייצגים את בייטי תכנית הקידוד UTF-16 השמורים בפורמט little-endian, עם ערכים מ-0 עד 255; "UTF-16BE" = המספרים מייצגים את בייטי תכנית הקידוד UTF-16 השמורים בפורמט big-endian, עם ערכים מ-0 עד 255; "CP932" = המספרים מייצגים בייט בודדים או שילוב של ערכים בני 8 ו-16 סיביות מ-code page 932 של Microsoft (הרחבה של קידוד Shift JIS); ערכים דו-בייטיים ניתנים להצגה בתור מספר בן 16 סיביות או שני מספרים בני 8 סיביות

בקידודים שבהם מספרים מייצגים בתים, פונקציה זו תמיר ערכי 8 סיביות עם סימן לערכי 8 סיביות ללא סימן.

UnmatchedAction

מציין כיצד לטפל במספרים מחוץ לטווח או כאלה הממפים לקודי תווים לא תקינים:

0 = תווים שלא נמצאה להם התאמה מתעלמים

1 = תווים שלא הותאמו מוחלפים בתו החלפה Unicode‏ U+FFFD