writeText (NotesStream - JavaScript)

ストリームにテキストを書き込みます。

定義場所

NotesStream

構文

writeText(text:string) : int

writeText(text:string, endOfLine:int) : int

パラメータ 説明
text 書き込むテキストであり、最大で 2 GB バイトです。
endOfLine テキストに付加される行末文字。 デフォルトは NotesStream.EOL_NONE です。
  • NotesStream.EOL_CR 2 では、復帰 (ASCII 13) が付加されます。
  • NotesStream.EOL_CRLF 0 では、復帰と改行 (ASCII 10 + 13) が付加されます。
  • NotesStream.EOL_LF 1 では、改行 (ASCII 10) が付加されます。
  • NotesStream.EOL_NONE 5 ではなにも付加されません。
  • NotesStream.EOL_PLATFORM 3 は、現在のプラットフォームの規則に従います。
戻り値 説明
int 書き込まれた文字数。

使用法

このメソッドは、ストリームの最後にテキストを追加します。

ストリームが読み取り専用である場合、このメソッドでは例外がスローされます。 IsReadOnly を参照してください。

ストリームの書き込み時には、プロパティの値は以下のようになります。

ストリームが空のファイルで開かれ、文字セットが Unicode、UTF-16、UTF-16BE、UTF-16LE である場合、 このメソッドはストリームの先頭にバイトオーダーマークまたは署名バイトを書き込みます。 これらのバイトは、同じ文字セットでのストリームの後続のアクセスにおいて透過性があります。

例

このボタンは、現在の文書の subject アイテムと body アイテムをテキストファイルに書き込みます。
var filepath:string = database.getFileName();
filepath = "c:¥¥" + filepath.left(filepath.length - 3) + "txt";
requestScope.status = "Output file: " + filepath;
var stream:NotesStream = session.createStream();
if (stream.open(filepath, "ASCII")) {
	if (stream.isReadOnly()) {
		requestScope.status = filepath + " is read-only";
		return;
	}
	stream.truncate();
	requestScope.status += "¥nBytes written: " +
	stream.writeText(currentDocument.getItemValueString("subject"),
	NotesStream.EOL_CRLF);
	if (document1.hasItem("body")) {
		requestScope.status += "¥nBytes written: " +
		stream.writeText(document1.getItemValue("body").firstElement());
	} else {
		requestScope.status += "¥nBytes written: 0";
	}
	stream.close();
} else {
	requestScope.status = "Output file open failed";
}
このボタンは、現在のデータベース内の文書から文書コレクションを作成し、それを DXL としてテキストファイルにエクスポートします。
var stream:NotesStream = session.createStream();
var filename:string = "c:¥¥dxl¥¥";
filename = filename + database.getFileName();
filename = filename.substring(0, filename.length() - 3) + "dxl";
if (stream.open(filename)) {
	if (stream.isReadOnly()) {
		requestScope.status = filename + " is read-only";
		return;
	}
	requestScope.status = "Opened " + filename;
	stream.truncate();
        
	// Create note collection
	var nc:NotesNoteCollection = database.createNoteCollection(false);
	nc.setSelectDocuments(true);
	nc.buildCollection();
        
	// Export note collection as DXL
	var exporter:NotesDxlExporter = session.createDxlExporter();
	var output:string = exporter.exportDxl(nc);
	stream.writeText(output);
	requestScope.status = "Exported note collection as DXL ";
	stream.close();
} else {
	requestScope.status = "Unable to open " + filename;
}

言語間の参照

LotusScript® NotesStream クラスの WriteText メソッド

Java™ Stream クラスの writeText メソッド

親トピック: NotesStream (JavaScript)