buffer

顯示已棄用項目

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

緩存是一個代表固定大小可變更的記憶區塊的對象。緩沖庫提供創建和操作緩沖對象的功能，並提供所有功能在全球變量 buffer 內。

緩存的目的是用於低等級的二進制資料存儲結構，取代 string.pack() 和 string.unpack() 的使用。使用案例包括閱讀和寫入現有的二進制格式、以更緊湊的形式工作與數據，將二進制格式轉換為特定的二進制格式，以及與固定長度的整數和浮點等原生記憶類型的一般工作。

當通過 Roblox API 傳送時，包括通過自訂事件發送緩沖對象的身份，緩沖對象的身份不會被保留，目標將收到一個副本。與其他限制類似，同一個緩存對象無法從多個 Actor 腳本中使用（並行 Luau）。

許多功能從開始時接受從緩存開始的字元偏移。從緩存記憶塊開始的 0 偏移存取第一個字元。所有偏移、計數和尺寸應為非負整數。如果使用任何讀取或寫入操作存取的字元超出緩存記憶，錯誤將被投擲。

使用整數和浮點的 read 和 write 方法使用小端量編碼。

概要

函式

create(size : number):buffer
創建緩存。
fromstring(str : string):buffer
從字串中創建緩存。
tostring(b : buffer):string
將緩存轉換為字串。
len(b : buffer):number
返回緩存的大小以字元。
readbits(b : buffer,bitOffset : number,bitCount : number):number
閱讀一系列位元到未簽名整數，從緩存中基於特定的 bitCount 整數從 0 到 32 ，包括在內。
readi8(b : buffer,offset : number):number
從緩存中讀取 8 位已簽名的整數。
readu8(b : buffer,offset : number):number
從緩存中讀取 8 位未簽名整數。
readi16(b : buffer,offset : number):number
從緩存中讀取 16 位簽名整數。
readu16(b : buffer,offset : number):number
從緩存中讀取 16 位未簽名整數。
readi32(b : buffer,offset : number):number
從緩存中讀取 32 位簽名整數。
readu32(b : buffer,offset : number):number
從緩存中讀取 32 位未簽名整數。
readf32(b : buffer,offset : number):number
從緩存中讀取 32 位浮點值。
readf64(b : buffer,offset : number):number
從緩存中讀取 64 位浮點值。
writebits(b : buffer,bitOffset : number,bitCount : number,value : number):()
根據特定的 bitCount 整數從 0 到 32 寫入數據到緩存，包括在內。
writei8(b : buffer,offset : number,value : number):()
寫一個 8 位簽名整數到緩存。
writeu8(b : buffer,offset : number,value : number):()
寫一個 8 位未簽名整數到緩存。
writei16(b : buffer,offset : number,value : number):()
寫入 16 位簽名整數到緩存。
writeu16(b : buffer,offset : number,value : number):()
寫入 16 位未簽名整數到緩存。
writei32(b : buffer,offset : number,value : number):()
寫 32 位簽名整數到緩存。
writeu32(b : buffer,offset : number,value : number):()
寫入 32 位未簽名整數到緩存。
writef32(b : buffer,offset : number,value : number):()
寫入 32 位浮點值到緩存。
writef64(b : buffer,offset : number,value : number):()
寫入 64 位浮點值到緩存。
readstring(b : buffer,offset : number,count : number):string
從緩存中讀取一個字串。
writestring(b : buffer,offset : number,value : string,count : number?):()
寫字串到緩存器。
copy(target : buffer,targetOffset : number,source : buffer,sourceOffset : number?,count : number?):()
複製緩存之間的字元。
fill(b : buffer,offset : number,value : number,count : number?):()
將緩存記憶區設置為某些 8 位未簽名整數值。

函式

create

buffer

創建一個要求尺寸的緩存，所有字元都被初始化為 0 。大小限制為 1 GiB，或 1,073,741,824 位元。請注意，大型緩存可能無法分配，如果裝置的記憶體不足。

參數

size: number

緩存的大小。

buffer

fromstring

buffer

創建一個初始化到字串內容的緩存。緩存的大小等於字串的長度。

參數

str: string

buffer

tostring

string

將緩存資料返回為字串。

buffer

概要

函式

函式

create

參數

返回

fromstring

參數

返回

tostring

參數

返回

len

參數

返回

readbits

參數

返回

readi8

參數

返回

readu8

參數

返回

readi16

參數

返回

readu16

參數

返回

readi32

參數

返回

readu32

參數

返回

readf32

參數

返回

readf64

參數

返回

writebits

參數

返回

writei8

參數

返回

writeu8

參數

返回

writei16

參數

返回

writeu16

參數

返回

writei32

參數

返回

writeu32

參數

返回

writef32

參數

返回

writef64

參數

返回

readstring

參數

返回

writestring

參數

返回

copy

參數

返回

fill