オブジェクトファイルハンドル

ファイルハンドルオブジェクト

1
var fd = fs.open('test.txt');

相続関係

メンバーのプロパティ

fd

整数、現在のファイル記述子をクエリします

1
readonly Integer FileHandle.fd;

メンバー関数

chmod

現在のファイルのアクセス許可を照会します。Windows はこの方法をサポートしていません。

1
FileHandle.chmod(Integer mode) async;

呼び出しパラメータ:

• mode: 整数、設定されたアクセス権限を指定します

---

stat

現在のファイルの基本情報を問い合わせます

1
Stat FileHandle.stat() async;

返される結果:

• Stat、ファイルの基本情報を返します。

---

read

ファイル記述子に従ってファイルの内容を読み取ります

1
2
3
4
Integer FileHandle.read(Buffer buffer,
    Integer offset = 0,
    Integer length = 0,
    Integer position = -1) async;

呼び出しパラメータ:

• buffer:Buffer、読み取り結果はに書き込まれますBuffer物体
• offset: 整数、Buffer書き込みオフセット、デフォルトは 0
• length: 整数、ファイルから読み取られたバイト数、デフォルトは 0
• position: 整数、ファイル読み取り位置、デフォルトは現在のファイル位置です

返される結果:

• Integer、実際に読み取られたバイト数

---

write

ファイル記述子に従ってコンテンツをファイルに書き込みます

1
2
3
4
Integer FileHandle.write(Buffer buffer,
    Integer offset = 0,
    Integer length = -1,
    Integer position = -1) async;

呼び出しパラメータ:

• buffer:Buffer、書かれることBuffer物体
• offset: 整数、Bufferデータ読み取りオフセット、デフォルトは 0
• length: 整数、ファイルに書き込まれるバイト数、デフォルトは -1
• position: 整数、ファイルの書き込み場所、デフォルトは現在のファイルの場所です

返される結果:

• Integer、実際に書き込まれたバイト数

---

ファイル記述子に従ってコンテンツをファイルに書き込みます

1
2
3
Integer FileHandle.write(String string,
    Integer position = -1,
    String encoding = "utf8") async;

呼び出しパラメータ:

• string: String、書き込む文字列
• position: 整数、ファイルの書き込み場所、デフォルトは現在のファイルの場所です
• encoding: 文字列、デコード方法を指定します。デフォルトのデコードは utf8 です。

返される結果:

• Integer、実際に書き込まれたバイト数

---

close

現在のファイルハンドルを閉じる

1
FileHandle.close() async;

---

toString

オブジェクトの文字列表現を返します。通常、「[Native Object]」が返されます。オブジェクトは、独自の特性に従って再実装できます。

1
String FileHandle.toString();

返される結果:

• String、オブジェクトの文字列表現を返します。

---

toJSON

オブジェクトの JSON 形式表現を返します。通常は、オブジェクトによって定義された読み取り可能なプロパティのコレクションを返します。

1
Value FileHandle.toJSON(String key = "");

呼び出しパラメータ:

• key: 文字列、使用されません

返される結果:

• Value、シリアル化可能な JSON を含む値を返します