std::basic_filebuf<CharT,Traits>:: open

関連付けられたファイルが既に開かれていた場合（ is_open ( ) ! = false ）、直ちにヌルポインタを返します。

それ以外の場合、指定された名前のファイルを開く（ s , p. c_str ( ) (C++17以降) または str. c_str ( ) オーバーロードに依存）。 std::ios_base::openmode 値は、例えば std:: ios_base :: out | std:: ios_base :: app のように記述できる。

ファイルは、あたかも std::fopen を呼び出したかのように開かれ、第2引数（ファイルアクセスモード）は mode & ~ std:: ios_base :: ate の結果によって決定されます。結果が表に示されたフラグの組み合わせでない場合、 open() は失敗します：

`, `$`\; タグ内のテキストは翻訳しない\; -\; C++固有の用語は翻訳しない\; したがって、翻訳すべきテキストは存在せず、元のHTMLコードは変更されていません。$

`、`$`タグ内のテキストは翻訳せず、元のフォーマットを保持しました。C++固有の用語も翻訳していません。$

オープン操作が成功し、かつ ( openmode & std:: ios_base :: ate ) ! = 0 （ ate ビットが設定されている）場合、ファイル位置をファイルの末尾に再配置します。これは std:: fseek ( file, 0 , SEEK_END ) を呼び出した場合と同様です。ここで file は std::fopen を呼び出して返されたポインタです。再配置が失敗した場合、 close() を呼び出し、失敗を示すためにヌルポインタを返します。

パラメータ

戻り値

this 成功時はポインタ、失敗時はヌルポインタを返します。

注記

open() は通常、コンストラクタまたは open() メンバ関数を通じて std::basic_fstream によって呼び出されます。

例

#include <fstream>
#include <iostream>
int main()
{
    std::string filename = "Test.b";
    std::filebuf fb;
    // 読み取り用ファイルの準備
    double d = 3.14;
    if (!fb.open(filename, std::ios::binary | std::ios::out))
    {
        std::cout << "Open file " << filename << " for write failed\n";
        return 1;
    } 
    fb.sputn(reinterpret_cast<char*>(&d), sizeof d);
    fb.close();
    // 読み取り用にファイルを開く
    double d2 = 0.0;
    if (!fb.open(filename, std::ios::binary | std::ios::in))
    {
        std::cout << "Open file " << filename << " for read failed\n";
        return 1;
    }
    auto got = fb.sgetn(reinterpret_cast<char*>(&d2), sizeof d2);
    if (sizeof(d2) != got)
        std::cout << "Read of " << filename << " failed\n";
    else
        std::cout << "Read back from file: " << d2 << '\n';
}

Read back from file: 3.14

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目