CArchive::WriteString

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

バッファのデータを CArchive オブジェクトに関連付けられたファイルに書き込みます。

void WriteString(
   LPCTSTR lpsz 
);

パラメータ

lpsz
NULL 文字で終わるテキスト文字列を保持するバッファへのポインタを指定します。

解説

文字列の終わりを示す NULL 文字 ('\0') は、ファイルには書き込みません。また、改行文字も自動的に書き込まれません。

WriteString 関数は、ディスクフルの状態を含むいくつかの状態に応じて例外をスローします。

Write も利用できます。この関数は NULL 文字で文字列を終わらせるのではなく、指定されたバイト数でファイルに書き込みます。

使用例

CFile myFile(_T("My__test__file.dat"), 
   CFile::modeCreate | CFile::modeReadWrite);
CString str1("String1"), str2("String2"), str;

// Create a storing archive.
CArchive arStore(&myFile, CArchive::store);

// Write str1 and str2 to the archive
arStore.WriteString(str1);
arStore.WriteString(_T("\n"));
arStore.WriteString(str2);
arStore.WriteString(_T("\n"));

// Close the storing archive
arStore.Close();

// Create a loading archive.
myFile.SeekToBegin();
CArchive arLoad(&myFile, CArchive::load);

// Verify the two strings are in the archive.
arLoad.ReadString(str);
ASSERT(str == str1);
arLoad.ReadString(str);
ASSERT(str == str2);