buffer

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

バッファー是一個可以代表固定大小的可變內存塊的對象。 內存庫提供對內存對象的創建和操作的功能,提供在全球 buffer 變量中的所有功能。

Buffer 是一種用於低層級的雙重數據存取結構,可以替換使用 string.pack()string.unpack() 的使用。使用案例包括閱取和寫入現有的雙重數據格式,運作與資料在更緊湊的格式中,並且對於固定長度的整數和漂浮點進行串化。對於

當通過 Roblox API 傳送一個 buffer 通過自訂事件時, buffer 對象的身份不會保留,並且目標將收到副本。與其他限制類似,不能從多個 Actor 腳本(並行 Luau)使用同一個 buffer 對象。

許多功能接受從開始器內的位元開始的偏移。開始器內的位元從 0 開始接受第一個位元。所有的位移、計數和大小都應為正整數。如果閱取或寫入操作的位元位於位元內,發生錯誤。如果閱取或寫入操作的位元位於位元內,發生錯誤。如果閱取或寫入操作的位元位於位元內,發生錯誤。

使用整數和浮點的 readwrite 方法的方法使用 小端ian 編碼。

概要

函式

函式

create

建立要求大小的 tamper 隙間,使用所有初始化為 0 的字節。大小限制為 1 GiB,或 1,073,741,824 位元。請注意,大小限制可能會在裝置內存不足時無法分配。

參數

size: number

버퍼的大小。

返回

fromstring

建立一個用於輸入字串的輸入模型。輸入模型的大小等同於輸入字串的長度。

參數

str: string

返回

tostring

將錯誤碼作為字串返回。

參數

返回

返回資源大小。

參數

返回

readi8

閱取資料從記憶體儲存到的資料,重新解釋位元作為 8 位已簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readu8

閱取資料從記憶體儲存到的資料,重新解釋位元作為 8 位未簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readi16

閱取資料從記憶體儲存到的資料,重新解釋位元作為 16 位已簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readu16

閱取資料從記憶體儲存到的資料,重新解釋位元作為 16 位未簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readi32

閱取資料從記憶體儲存到的資料,重新解釋位元作為 32 位已簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readu32

閱取資料從記憶體儲存到的資料,重新解釋位元作為 32 位未簽名整數,並將其轉換為數字。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readf32

重新解釋偏移值作為 32 位漂浮點值,並將其轉換為數字。如果浮點值與任何代表 NaN (不是數字) 的位階相符,返回的值可能會轉換為不同的靜態 NaN 代表。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

readf64

重新解釋偏移值作為 64 位漂浮點值,並將其轉換為數字。如果浮點值與任何代表 NaN (不是數字) 的位階相符,返回的值可能會轉換為不同的靜態 NaN 代表。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

返回

writei8

void

將數據寫入暫存資料,將數字轉換為 8 位已簽名整數,並且寫入單一位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字[-128, 127].

返回

void

writeu8

void

將數據寫入記憶體,將數字轉換為 8 位未簽名整數,並且寫入單一位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字 [0, 255]。

返回

void

writei16

void

將數據寫入記憶體,將數字轉換為 16 位已簽名的整數,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字[-32,768, 32,767].

返回

void

writeu16

void

將數據寫入記憶體,將數字轉換為 16 位未簽名整數,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字 [0, 65,536]。

返回

void

writei32

void

將數據寫入記憶體,將數字轉換為 32 位已簽名整數,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字[-2,147,483,648, 2,147,483,647].

返回

void

writeu32

void

將數據寫入記憶體,將數字轉換為 32 位未簽名整數,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字 [0, 4,294,967,295]。

返回

void

writef32

void

將數據寫入記憶體,將數字轉換為 32 位漂浮點值,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

單一精準漂浮點數。

返回

void

writef64

void

將數據寫入記憶體,將數字轉換為 64 位漂浮點值,並重新解釋為個別位元。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

雙精度漂浮點數。

返回

void

readstring

從指定 offset 的暫存器閱取一個長度為 count 的字串。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

count: number

要閱已讀的長度。

返回

writestring

void

將字串資料寫入指定的 offset 位元欄中的資料。如果指定的 count 是可選的,則只有 count 個字符從字串中取得。

參數

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: string

資料可以寫。

count: number

從字串中擷取的位元數。此值不能大於字串長度。

返回

void

copy

void

source 開始,將 sourceOffset 的內容複製到 1> target1> 。

可能有 sourcetarget 相同。複製相同區域內的區域複製將作為源區域複製到暫時區域,然後該區域複製到目標。

參數

target: buffer

버퍼到複製資料。

targetOffset: number

從記憶體開始的時間延遲,從 0 開始。

source: buffer

Buffer 來從資料中取得。

sourceOffset: number

從記憶體開始的時間延遲,從 0 開始。

預設值:0
count: number

要複製的字節數。如果未指定,整個 source 資料從 sourceOffset 開始。

返回

void

fill

void

count 位元設置在開始於指定 offsetvalue 的暫存器中。

參數

存取暫存資料。

offset: number

從記憶體開始的時間延遲,從 0 開始。

value: number

範圍內的整數數字 [0, 255]。

count: number

寫入的字節數。如果未指定,就會設定所有於指定的字節。

返回

void