applican

マイページに戻る

FileWriter ver.1.0

ファイルにデータを書き込むためのオブジェクトに関する機能です。

アプリカンAPIのver.1.0系のFileSystemのFileWriterのリファレンスです

  1. アプリカンAPIのver.2.0系のFileSystemのFileWriterのリファレンスはこちらからご確認ください。

プロパティ

readyState : Number 0=初期状態
1=書き込み中
2=処理終了
fileName : String ファイル名です。
length : long ファイル長です。
error : FileError エラー情報です。
onwritestart : Function 書き込み開始時にCallbackされます。
onwrite : Function 書き込み終了時にCallbackされます。
onabort : Function abort() メソッド実行時や書き込み処理が強制終了した場合にCallbackされます。
onerror : Function 書き込み失敗時にCallbackされます。
onwriteend : Function 成功、失敗を問わず処理時にCallbackされます。

メソッド

abort

メソッド説明

abort()

ファイルへの書き込みを中断します。

パラメータ

(none)

Return

void

write

メソッド説明

write(String utf8string)

ファイルへ書き込みます。

パラメータ

utf8string : String ファイルへ書き込むデータ内容を指定します。

Return

void

サンプルコード

//ファイル書き込み
function fileWrite1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, fileWrite1_gotFS, fileWrite1_fail);
}
function fileWrite1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, fileWrite1_gotFileEntry, fileWrite1_fail);
}
function fileWrite1_gotFileEntry(fileEntry) {
	fileEntry.createWriter(fileWrite1_gotFileWriter, fileWrite1_fail);
}
function fileWrite1_gotFileWriter(writer) {
	var dump = "fileWrite1_gotFileWriter\n";
	document.getElementById("dumpAreaFile").value =dump;

	writer.onwritestart = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwritestart\n";
	};
	writer.onabort = function(evt) {
		document.getElementById("dumpAreaFile").value += "onabort\n";
	};
	writer.onwrite = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwrite\n";
	};
	writer.onerror = function(evt) {
		document.getElementById("dumpAreaFile").value += "onerror\n";
	};
	writer.onwriteend = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwriteend\n";
	};
	writer.write("some sample text 1");
}
function fileWrite1_fail(error) {
	var dump = "fileWrite1_fail\n";
	dump += "code:"+error.code+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。
loading