buffer

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

버퍼는 고정 크기의 변경 가능한 메모리 블록을 나타내는 개체입니다. 버퍼 라이브러리는 버퍼 개체의 생성 및 조작을 위한 기능을 제공하며, 전역 buffer 변수에 모든 기능을 제공합니다.

버퍼는 저수준의 이진 데이터 저장 구조로 사용되도록 의도되었습니다, 대체하여 사용 string.pack()string.unpack()의 이전 이용 사례는 읽기 및 쓰기 이진 형식, 작업 데이터를 더 압축적인 형식으로 작동, 직접 길이 정

Roblox API를 통해 버퍼를 사용자 지정 이벤트를 통해 전송할 때 버퍼 개체의 식별자는 유지되지 않고 대상은 복사본을 받습니다. 다른 제한과 마찬가지로, 여러 개의 Actor 스크립트에서 동일한 버퍼 개체를 사용할 수 없습니다(병렬 루오).

많은 함수에서 버퍼의 시작 부분에서 오프셋을 수락합니다. 버퍼 메모리 블록의 시작 부분에서 0의 오프셋은 첫 번째 바이트에 액세스합니다. 모든 오프셋, 카운트 및 크기는 음수 정수 숫자여야 합니다. 읽기 또는 쓰기 작업에 액세스하는 바이트가 버퍼 메모리 블록 외부

정수 및 부동 소수점과 작동하는 readwrite 메서드는 작은 엔디안 인코딩을 사용합니다.

요약

함수

함수

create

요청된 크기의 버퍼를 모든 바이트로 초기화하여 0으로 만듭니다. 크기 제한은 1GiB, 또는 1,073,741,824바이트입니다. 메모리가 부족하면 버퍼가 더 크면 할당되지 않을 수 있음을 알려주세요.

매개 변수

size: number

버퍼의 크기.

반환

fromstring

문자열의 콘텐츠에 대해 버퍼를 초기화합니다. 버퍼의 크기는 문자열의 길이와 같습니다.

매개 변수

str: string

반환

tostring

버퍼 데이터를 문자열로 반환합니다.

매개 변수

반환

버퍼의 크기를 바이트 단위로 반환합니다.

매개 변수

반환

readi8

오프셋의 바이트를 8비트 서명 정수로 다시 해석하고 숫자로 변환합니다.Reads the data from the buffer by reinterpreting bytes at the offset as an 8-bit signed integer and converting it into a number.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readu8

오프셋의 바이트를 8비트 정수로 재해석하고 그 정수를 숫자로 변환합니다.Reads the data from the buffer by reinterpreting bytes at the offset as an 8-bit unsigned integer and converting it into a number.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readi16

오프셋의 바이트를 16비트 서명 정수로 재해석하고 숫자로 변환합니다.Reads the data from the buffer by reinterpreting bytes at the offset as a 16-bit signed integer and converting it into a number.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readu16

오프셋의 바이트를 16비트 정수로 다시 해석하고 숫자로 변환하여 버퍼에서 데이터를 읽습니다.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readi32

오프셋의 바이트를 32비트 서명 정수로 다시 해석하고 정수로 변환합니다.Reads the data from the buffer by reinterpreting bytes at the offset as a 32-bit signed integer and converting it into a number.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readu32

오프셋의 바이트를 32비트 정수로 다시 해석하고 정수로 변환하여 버퍼에서 데이터를 읽습니다.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

반환

readf32

오프셋을 32비트 부동 소수점 값으로 다시 해석하고 부동 소수점 값을 숫자로 변환하여 버퍼에서 데이터를 읽습니다. 부동 소수점 값이 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비트 정수로 변환하고 단일 바이트를 작성하여 버퍼에 데이터를 기록합니다.Writes data to the buffer by converting the number into an 8-bit unsigned integer and writing a single byte.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: number

범위 [0, 255] 내의 정수 숫자입니다.

반환

void

writei16

void

숫자를 16비트 유효 정수로 변환하고 개별 바이트로 재해석하여 버퍼에 쓸 데이터를 작성합니다.Writes data to the buffer by converting the number into a 16-bit signed integer and reinterpreting it as individual bytes.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: number

범위 내 정수 값 [-32,768, 32,767].

반환

void

writeu16

void

숫자를 16비트 유효 숫자로 변환하고 개별 바이트로 다시 해석하여 버퍼에 쓸 데이터를 작성합니다.Writes data to the buffer by converting the number into a 16-bit unsigned integer and reinterpreting it as individual bytes.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: number

범위 [0, 65,536] 내의 정수 숫자입니다.

반환

void

writei32

void

숫자를 32비트 유효 정수로 변환하고 개별 바이트로 재해석하여 버퍼에 쓸 데이터를 작성합니다.Writes data to the buffer by converting the number into a 32-bit signed integer and reinterpreting it as individual bytes.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: number

범위 내 정수 값 [-2,147,483,648, 2,147,483,647]입니다.

반환

void

writeu32

void

숫자를 32비트 유효 숫자로 변환하고 개별 바이트로 다시 해석하여 버퍼에 쓸 데이터를 작성합니다.Writes data to the buffer by converting the number into a 32-bit unsigned integer and reinterpreting it as individual bytes.

매개 변수

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

지정된 count 길이의 문자열을 버퍼에서 읽습니다.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

count: number

읽음길이.

반환

writestring

void

문자열에서 데이터를 버퍼에 기록합니다. 옵션적인 offset 가 지정된 경우 문자열에서만 count 바이트를 가져옵니다.

매개 변수

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: string

쓰기 데이터.

count: number

문자열에서 가져올 바이트 수입니다. 이 값은 문자열 길이보다 크면 안 됩니다.

반환

void

copy

void

복사본 count 바이트를 시작하여 source 에서 오프셋 sourceOffset 까지 1> target1> 에 복사합니다.

소스 및 target 이 동일할 수 있습니다. 동일한 버퍼 내의 중첩되는 영역을 복사하면 원본 영역이 임시 버퍼로 복사된 것처럼 작동하고 그 버퍼는 대상에 복사됩니다.

매개 변수

target: buffer

데이터를 복사하는 버퍼입니다.

targetOffset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

source: buffer

데이터를 가져올 버퍼입니다.

sourceOffset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

기본값: 0
count: number

복사할 바이트 수. 생략하면 전체 source 데이터를 시작하는 sourceOffset부터 복사됩니다.

반환

void

fill

void

버퍼에서 지정된 count부터 offset까지 시작하는 value 바이트를 설정합니다.

매개 변수

데이터를 기록할 버퍼를 작성합니다.

offset: number

버퍼 메모리의 시작 부분에서 오프셋을 시작으로, 0부터 시작합니다.

value: number

범위 [0, 255] 내의 정수 숫자입니다.

count: number

기록할 바이트 수입니다. 생략하면 지정된 오프셋 후의 모든 바이트가 설정.

반환

void