FileStream  - AS3

입력 버퍼에서 읽을 수 있는 데이터 바이트 수를 반환합니다. 읽기 메서드 중 하나를 사용하여 데이터를 읽기 전에 사용자 코드에서 bytesAvailable을 호출하여 읽을 수 있는 데이터가 충분한지 확인해야 합니다.

데이터의 바이트 순서로, Endian 클래스의 BIG_ENDIAN 또는 LITTLE_ENDIAN 상수입니다.

readObject() 또는 writeObject() 메서드를 사용하여 이진 데이터를 쓰거나 읽을 때 AMF3 또는 AMF0 중에서 어떤 형식이 사용되는지 여부를 지정합니다.

값은 ObjectEncoding 클래스의 상수입니다. 기본적으로 AMF3 형식이 사용됩니다.

관련 API 요소

파일에서의 현재 위치입니다.

이 값은 다음과 같을 때 수정됩니다.

• 속성을 명시적으로 설정할 때
• FileStream 객체에서 읽을 때(read 메서드 중 하나 사용)
• FileStream 객체에 쓸 때

길이가 2³²바이트보다 더 큰 파일을 지원하기 위해 위치가 단위가 아닌 숫자로 정의됩니다. 이 속성의 값은 항상 2⁵³보다 작은 정수입니다. 이 값을 소수 부분이 있는 숫자로 설정하면 가장 가까운 정수로 반내림됩니다.

비동기적으로 파일을 읽을 때 position 속성을 설정하면 응용 프로그램이 지정된 위치에서 시작되는 데이터를 사용하여 읽기 버퍼를 채우기 시작하며, bytesAvailable 속성은 0으로 설정될 수 있습니다. read 메서드를 사용하여 데이터를 읽기 전에 complete 이벤트를 기다리거나 read 메서드를 사용하기 전에 progress 이벤트를 기다리고 bytesAvailable 속성을 확인하십시오.

import flash.fileSystem.*;
import flash.utils.ByteArray;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory.resolvePath("Apollo Test/test.txt");
var stream:FileStream = new FileStream();
stream.addEventListener(Event.COMPLETE, readBytes);
stream.openAsync(sourceFile, FileMode.READ);

function readBytes(e:Event):void {
    var bytes:ByteArray = new ByteArray();
    trace("position 0:", stream.position); // 0
    bytes[0] = stream.readByte();
    trace("position 1:", stream.position); // 1
    fileStream.readBytes(bytes, stream.position, 4); 
    trace("position 2:", stream.position); // 5
    stream.close();
}

파일을 비동기적으로 읽을 때 디스크에서 읽을 최소 데이터 양입니다.

이 속성은 비동기 스트림이 현재 위치를 벗어나서 읽으려고 시도하는 데이터의 양을 지정합니다. 파일 시스템 페이지 크기에 따라 블록 단위로 데이터를 읽습니다. 따라서 페이지 크기가 8KB(8192바이트)인 컴퓨터 시스템에서 readAhead를 9,000으로 설정하면 런타임이 한 번에 두 개의 블록 또는 16,384바이트를 읽습니다. 이 속성의 기본값은 무한대입니다. 기본적으로 읽기를 위해 비동기적으로 열린 파일은 파일 끝까지 읽습니다.

읽기 버퍼에서 데이터를 읽으면 readAhead 속성의 값이 변경되지 않습니다. 버퍼에서 데이터를 읽으면 읽기 버퍼를 다시 채우기 위해 새 데이터를 읽습니다.

비동기적으로 열린 파일에는 readAhead 속성이 아무런 효과도 없습니다.

데이터를 비동기적으로 읽을 때 FileStream 객체는 progress 이벤트를 전달합니다. progress 이벤트의 이벤트 핸들러 메서드에서 필요한 만큼의 바이트 수가 사용 가능한지 확인한 다음(bytesAvailable 속성 확인) read 메서드를 사용하여 읽기 버퍼에서 데이터를 읽습니다.

import flash.filesystem.*;

var file:File = File.desktopDirectory.resolvePath("test.txt");
var fileStream:FileStream = new FileStream();
fileStream.readAhead = 100;
fileStream.addEventListener(ProgressEvent.PROGRESS, readProgressHandler)
fileStream.openAsync(file, FileMode.READ);
var results:ByteArray;

function readProgressHandler(event:ProgressEvent):void {
    if (fileStream.bytesAvailable >= 100) {
        fileStream.readBytes(results, 0, 100);
    }
}

FileStream 객체를 만듭니다. open() 또는 openAsync() 메서드를 사용하여 파일을 엽니다.

관련 API 요소

FileStream 객체를 닫습니다.

close() 메서드를 호출한 후에는 데이터를 읽거나 쓸 수 없습니다. 비동기적으로 파일을 연 경우(FileStream 객체가 openAsync() 메서드를 사용하여 파일을 연 경우) close() 메서드를 호출하면 객체가 close 이벤트를 전달합니다.

응용 프로그램을 자동으로 닫으면 응용 프로그램에서 FileStream 객체와 연관된 모든 파일이 닫힙니다. 하지만 데이터가 반드시 작성되도록 하기 위해 응용 프로그램을 닫기 전에 쓰기 대기 중인 데이터가 있는 비동기적으로 열린 모든 FileStream 객체에 대해 closed 이벤트에 등록하는 것이 가장 좋습니다.

open() 또는 openAsync() 메서드를 호출하여 FileStream를 다시 사용할 수 있습니다. FileStream 객체와 연관된 모든 파일이 닫히지만 객체가 close 이벤트를 전달하지 않습니다.

비동기적으로 열린 FileStream 객체(openAsync() 메서드 사용)에 대해서는 FileStream 객체에 대한 close() 이벤트를 호출하고 객체를 참조하는 속성 및 변수를 삭제한 경우에도 대기 중인 작업이 있는 한 FileStream 객체는 가비지 컬렉션되지 않으며 이벤트 핸들러는 완료를 위해 등록됩니다. 특히 다르게 참조되지 않은 FileStream 객체는 다음 중 하나라도 가능한 한 계속 유지됩니다.

• 파일 읽기 작업의 경우에는 파일 끝에 도달하지 않았고 complete 이벤트가 전달되지 않았습니다.
• 출력 데이터는 여전히 쓸 수 있으며 출력 관련 이벤트(예: outputProgress 이벤트 또는 ioError 이벤트)에는 등록된 이벤트 리스너가 있습니다.

관련 API 요소

import flash.filesystem.*;
import flash.events.Event;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.WRITE);
fileStream.writeUTFBytes("Hello");
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();

function fileClosed(event:Event):void {
    trace("closed");
}            

import flash.filesystem.*;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF("Hello");
fileStream.close();

file 매개 변수로 지정된 파일을 가리키도록 동기적으로 FileStream 객체를 엽니다.

FileStream 객체가 이미 열려 있는 경우 메서드를 호출하면 파일을 닫은 후에 열며, 이전에 열려 있던 파일에 대해서는 더 이상의 이벤트(close 포함)가 제공되지 않습니다.

파일 잠금을 지원하는 시스템에서는 "쓰기" 또는 "업데이트" 모드(FileMode.WRITE 또는 FileMode.UPDATE)로 열린 파일은 닫히기 전까지 읽을 수 없습니다.

파일에 대한 작업 수행을 완료하면 FileStream 객체의 close() 메서드를 호출합니다. 일부 운영 체제에서는 동시에 열 수 있는 파일 수가 제한됩니다.

매개 변수

관련 API 요소

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);
fileStream.close();

file 매개 변수로 지정된 파일을 가리키도록 비동기적으로 FileStream 객체를 엽니다.

FileStream 객체가 이미 열려 있는 경우 메서드를 호출하면 파일을 닫은 후에 열며, 이전에 열려 있던 파일에 대해서는 더 이상의 이벤트(close 포함)가 제공되지 않습니다.

fileMode 매개 변수가 FileMode.READ 또는 FileMode.UPDATE로 설정되어 있으면 파일이 열리는 즉시 AIR가 데이터를 입력 버퍼로 읽어들이며, 데이터를 입력 버퍼로 읽어들이는 동안 progress 및 open 이벤트가 전달됩니다.

파일 잠금을 지원하는 시스템에서는 "쓰기" 또는 "업데이트" 모드(FileMode.WRITE 또는 FileMode.UPDATE)로 열린 파일은 닫히기 전까지 읽을 수 없습니다.

파일에 대한 작업 수행을 완료하면 FileStream 객체의 close() 메서드를 호출합니다. 일부 운영 체제에서는 동시에 열 수 있는 파일 수가 제한됩니다.

매개 변수

관련 API 요소

import flash.filesystem.*;
import flash.events.Event;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.addEventListener(Event.COMPLETE, fileCompleteHandler)
fileStream.openAsync(file, FileMode.READ);

function fileCompleteHandler(event:Event):void {
    var str:String = fileStream.readMultiByte(fileStream.bytesAvailable, File.systemCharset);
    trace(str);
    fileStream.close();
}

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부울 값을 읽습니다. 단일 바이트를 읽고 해당 바이트가 0이 아니면 true를, 그렇지 않으면 false를 반환합니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 있는 바이트를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 length 매개 변수로 지정된 만큼의 데이터 바이트 수를 읽습니다. offset에 지정된 위치부터 bytes 매개 변수에 지정된 ByteArray 객체로 바이트를 읽습니다.

매개 변수

파일 스트림, 바이트 스트림 또는 바이트 배열에서 IEEE 754 배정밀도 부동 소수점 숫자를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 IEEE 754 단정밀도 부동 소수점 숫자를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 있는 32비트 정수를 읽습니다.

지정된 문자 세트를 사용하여 파일 스트림, 바이트 스트림 또는 바이트 배열에서 지정된 길이의 멀티바이트 문자열을 읽습니다.

매개 변수

관련 API 요소

파일 스트림, 바이트 스트림 또는 바이트 배열에서 AMF 직렬 형식으로 인코딩된 객체를 읽습니다.

관련 API 요소

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 있는 16비트 정수를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 없는 바이트를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 없는 32비트 정수를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 부호 없는 16비트 정수를 읽습니다.

파일 스트림, 바이트 스트림 또는 바이트 배열에서 UTF-8 문자열을 읽습니다. 문자열 앞에는 문자열의 길이를 바이트 단위로 나타내는 unsigned short가 있어야 합니다.

이 메서드는 Java^® IDataInput 인터페이스의 readUTF() 메서드와 비슷합니다.

바이트 스트림 또는 바이트 배열에서 UTF-8 바이트 시퀀스를 읽고 문자열을 반환합니다.

매개 변수

FileStream 객체의 position 속성으로 지정된 위치에서 파일을 자릅니다.

position 속성으로 지정된 위치의 바이트에서 파일 끝까지가 삭제됩니다. 파일을 쓰기용으로 열어야 합니다.

관련 API 요소

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.UPDATE);
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.close();

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.UPDATE);
trace("start", file.size)
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
    trace("closed", file.size); 
}

부울 값을 씁니다. value 매개 변수에 따라 단일 바이트를 씁니다. 값이 true이면 1, false이면 0을 씁니다.

매개 변수

바이트를 씁니다. 매개 변수의 하위 8비트가 사용되고, 상위 24비트는 무시됩니다.

매개 변수

지정된 바이트 배열인 bytes에서 offset(0부터 시작하는 인덱스)이 지정하는 바이트부터 시작하여 length에 지정된 길이만큼의 바이트 시퀀스를 파일 스트림, 바이트 스트림 또는 바이트 배열에 기록합니다.

length 매개 변수를 생략하면 기본 길이인 0이 사용되어 offset에서 시작하여 전체 버퍼를 씁니다. offset 매개 변수도 생략하면 전체 버퍼를 씁니다.

offset 또는 length 매개 변수가 범위를 벗어나면 bytes 배열의 시작과 끝이 대신 적용됩니다.

매개 변수

IEEE 754 배정밀도 64비트 부동 소수점 숫자를 씁니다.

매개 변수

IEEE 754 단정밀도 32비트 부동 소수점 숫자를 씁니다.

매개 변수

부호 있는 32비트 정수를 씁니다.

매개 변수

지정된 문자 세트를 사용하여 파일 스트림, 바이트 스트림 또는 바이트 배열에 멀티바이트 문자열을 씁니다.

매개 변수

관련 API 요소

파일 스트림, 바이트 스트림 또는 바이트 배열에 AMF 직렬 형식으로 객체를 씁니다.

매개 변수

관련 API 요소

16비트 정수를 씁니다. 매개 변수의 하위 16비트가 사용되고, 상위 16비트는 무시됩니다.

매개 변수

부호 없는 32비트 정수를 씁니다.

매개 변수

파일 스트림, 바이트 스트림 또는 바이트 배열에 UTF-8 문자열을 씁니다. UTF-8 문자열의 바이트 단위 길이를 16비트 정수로 먼저 쓰고 문자열의 문자를 나타내는 바이트를 씁니다.

매개 변수

UTF-8 문자열을 씁니다. writeUTF()와 비슷하지만 문자열 앞에 16비트 길이 워드를 추가하지 않습니다.

매개 변수

close() 메서드를 명시적으로 호출하여 스트림이 닫혔음을 나타냅니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

스트림의 끝에 도달했음을 알립니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

비동기 파일 I/O 작업 중 오류가 발생했음을 나타냅니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

버퍼링된 데이터가 파일에 기록되었음을 알립니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

스트림에 있는 새 데이터의 가용성을 알립니다.

이 이벤트에는 다음과 같은 속성이 있습니다.