buffer_read 함수 설명 및 활용 예제
함수 개요
buffer_read 함수는 주어진 버퍼의 현재 탐색 위치에서 지정된 타입의 데이터를 읽어오는 기능을 제공합니다. 함수 실행 후, 탐색 위치는 읽은 바이트 수만큼 이동합니다. 다음 buffer_read 호출은 이 새로운 위치에서 데이터를 읽게 됩니다.
버퍼의 현재 탐색 위치에서 시작하여 내용을 읽기 때문에, 함수 호출 전에 탐색 위치가 올바르게 설정되어 있어야 합니다. 그렇지 않으면 잘못된 결과가 반환되거나 아무것도 반환되지 않을 수 있습니다. buffer_peek 함수를 사용하면 탐색 위치를 변경하지 않고도 버퍼의 어느 위치에서든 값을 가져올 수 있습니다.
함수의 반환 값은 읽고 있는 데이터의 타입에 따라 달라지며, 다음과 같은 상수 중 하나가 될 수 있습니다:
- 함수가 성공하면 지정된 타입의 값을 반환합니다.
- 실패할 경우 실행 오류가 발생합니다.
- 잘못된 데이터 타입을 사용하면 잘못된 값이 반환됩니다.
HTML5에서 buffer_s32 또는 buffer_u32를 읽으면 값이 64비트 더블인 Real로 반환됩니다. 이는 int32가 해당 플랫폼에서 지원되지 않기 때문입니다.
문법
buffer_read(buffer, type)
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| buffer | Buffer | 읽어올 버퍼 |
| type | Buffer Data Type Constant | 버퍼에서 읽어올 데이터의 타입 |
반환 값
- Real, Boolean 또는 String
예제 코드
다음은 buffer_read 함수를 사용하는 예제입니다:
buffer = buffer_create(10240, buffer_grow, 1); // 버퍼 생성
// buffer_seek(buffer, buffer_seek_start, 0); // 탐색 위치 설정 (생략 가능)
buffer_write(buffer, buffer_string, "Hello World"); // 문자열을 버퍼에 쓰기
buffer_seek(buffer, buffer_seek_start, 0); // 탐색 위치를 0으로 설정
result = buffer_read(buffer, buffer_string); // 버퍼에서 문자열 읽기
show_debug_message("Result = " + result); // 결과 출력
위 코드는 버퍼를 생성하고 문자열을 기록한 후 다시 읽어오는 과정을 보여줍니다. 처음에 10240 바이트의 새로운 성장 버퍼를 생성하고, 문자열 "Hello World"를 버퍼에 기록합니다. 이때 탐색 위치는 12 바이트만큼 이동합니다: 문자열의 문자 수 11 바이트와 마지막 널 바이트 1 바이트입니다. 이후, 탐색 위치를 0으로 설정한 후 buffer_read를 사용하여 문자열을 읽어옵니다. 읽은 데이터는 result 변수에 저장되며, 디버그 메시지로 출력됩니다.
추가 활용 예제
- 정수 데이터 읽기
buffer = buffer_create(10240, buffer_grow, 1);
buffer_write(buffer, buffer_s32, 12345);
buffer_seek(buffer, buffer_seek_start, 0);
result = buffer_read(buffer, buffer_s32);
show_debug_message("Integer Result = " + string(result));
- 부울 데이터 읽기
buffer = buffer_create(10240, buffer_grow, 1);
buffer_write(buffer, buffer_boolean, true);
buffer_seek(buffer, buffer_seek_start, 0);
result = buffer_read(buffer, buffer_boolean);
show_debug_message("Boolean Result = " + string(result));
- 문자열 배열 읽기
buffer = buffer_create(10240, buffer_grow, 1);
buffer_write(buffer, buffer_string, "First String");
buffer_write(buffer, buffer_string, "Second String");
buffer_seek(buffer, buffer_seek_start, 0);
result1 = buffer_read(buffer, buffer_string);
result2 = buffer_read(buffer, buffer_string);
show_debug_message("First String = " + result1);
show_debug_message("Second String = " + result2);
이러한 예제들은 buffer_read 함수를 다양한 데이터 타입에 대해 활용하는 방법을 보여줍니다.