OpenSiv3D  v0.6.5
C++20 framework for creative coding
s3d::TextReader Class Reference

読み込み用テキストファイル More...

#include <TextReader.hpp>

Public Member Functions

SIV3D_NODISCARD_CXX20 TextReader ()
 デフォルトコンストラクタ More...
 
SIV3D_NODISCARD_CXX20 TextReader (FilePathView path, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルをオープンします。 More...
 
template<class Reader , std::enable_if_t< std::is_base_of_v< IReader, Reader > &&!std::is_lvalue_reference_v< Reader >> * = nullptr>
SIV3D_NODISCARD_CXX20 TextReader (Reader &&reader, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルを IReader 経由でオープンします。 More...
 
SIV3D_NODISCARD_CXX20 TextReader (std::unique_ptr< IReader > &&reader, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルを IReader 経由でオープンします。 More...
 
bool open (FilePathView path, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルをオープンします。 More...
 
template<class Reader , std::enable_if_t< std::is_base_of_v< IReader, Reader > &&!std::is_lvalue_reference_v< Reader >> * = nullptr>
bool open (Reader &&reader, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルを IReader 経由でオープンします。 More...
 
bool open (std::unique_ptr< IReader > &&reader, const Optional< TextEncoding > &encoding=unspecified)
 テキストファイルを IReader 経由でオープンします。 More...
 
void close ()
 テキストファイルをクローズします。 More...
 
bool isOpen () const noexcept
 テキストファイルがオープンされているかを返します。 More...
 
 operator bool () const noexcept
 テキストファイルがオープンされているかを返します。 More...
 
Optional< char32readChar ()
 テキストファイルから 1 文字読み込みます。 More...
 
Optional< StringreadLine ()
 テキストファイルから 1 行読み込みます。 More...
 
Array< StringreadLines ()
 テキストファイルのすべての行を読み込みます。 More...
 
String readAll ()
 テキストファイルの内容をすべて読み込みます。 More...
 
bool readChar (char32 &ch)
 テキストファイルから 1 文字読み込みます。 More...
 
bool readLine (String &line)
 テキストファイルから 1 行読み込みます。 More...
 
bool readLines (Array< String > &lines)
 テキストファイルのすべての行を読み込みます。 More...
 
bool readAll (String &s)
 テキストファイルの内容をすべて読み込みます。 More...
 
TextEncoding encoding () const noexcept
 テキストのエンコーディング形式を返します。 More...
 
const FilePathpath () const noexcept
 オープンしているファイルのフルパスを返します。 More...
 

Detailed Description

読み込み用テキストファイル

Constructor & Destructor Documentation

◆ TextReader() [1/4]

SIV3D_NODISCARD_CXX20 s3d::TextReader::TextReader ( )

デフォルトコンストラクタ

◆ TextReader() [2/4]

SIV3D_NODISCARD_CXX20 s3d::TextReader::TextReader ( FilePathView  path,
const Optional< TextEncoding > &  encoding = unspecified 
)
explicit

テキストファイルをオープンします。

Parameters
pathファイルパス
encodingテキストのエンコーディング形式

◆ TextReader() [3/4]

template<class Reader , std::enable_if_t< std::is_base_of_v< IReader, Reader > &&!std::is_lvalue_reference_v< Reader >> * = nullptr>
SIV3D_NODISCARD_CXX20 s3d::TextReader::TextReader ( Reader &&  reader,
const Optional< TextEncoding > &  encoding = unspecified 
)
explicit

テキストファイルを IReader 経由でオープンします。

Template Parameters
ReaderIReader オブジェクトの型
Parameters
readerIReader オブジェクト
encodingテキストのエンコーディング形式

◆ TextReader() [4/4]

SIV3D_NODISCARD_CXX20 s3d::TextReader::TextReader ( std::unique_ptr< IReader > &&  reader,
const Optional< TextEncoding > &  encoding = unspecified 
)
explicit

テキストファイルを IReader 経由でオープンします。

Parameters
readerIReader オブジェクト
encodingテキストのエンコーディング形式

Member Function Documentation

◆ close()

void s3d::TextReader::close ( )

テキストファイルをクローズします。

◆ encoding()

TextEncoding s3d::TextReader::encoding ( ) const
noexcept

テキストのエンコーディング形式を返します。

Returns
テキストのエンコーディング形式

◆ isOpen()

bool s3d::TextReader::isOpen ( ) const
noexcept

テキストファイルがオープンされているかを返します。

Returns
ファイルがオープンされている場合 true, それ以外の場合は false

◆ open() [1/3]

bool s3d::TextReader::open ( FilePathView  path,
const Optional< TextEncoding > &  encoding = unspecified 
)

テキストファイルをオープンします。

Parameters
pathファイルパス
encodingテキストのエンコーディング形式
Returns
ファイルのオープンに成功した場合 true, それ以外の場合は false

◆ open() [2/3]

template<class Reader , std::enable_if_t< std::is_base_of_v< IReader, Reader > &&!std::is_lvalue_reference_v< Reader >> * = nullptr>
bool s3d::TextReader::open ( Reader &&  reader,
const Optional< TextEncoding > &  encoding = unspecified 
)

テキストファイルを IReader 経由でオープンします。

Template Parameters
ReaderIReader オブジェクトの型
Parameters
readerIReader オブジェクト
encodingテキストのエンコーディング形式
Returns
ファイルのオープンに成功した場合 true, それ以外の場合は false

◆ open() [3/3]

bool s3d::TextReader::open ( std::unique_ptr< IReader > &&  reader,
const Optional< TextEncoding > &  encoding = unspecified 
)

テキストファイルを IReader 経由でオープンします。

Parameters
readerIReader オブジェクト
encodingテキストのエンコーディング形式
Returns
ファイルのオープンに成功した場合 true, それ以外の場合は false

◆ operator bool()

s3d::TextReader::operator bool ( ) const
explicitnoexcept

テキストファイルがオープンされているかを返します。

Remarks
isOpen() と同じです。
Returns
ファイルがオープンされている場合 true, それ以外の場合は false

◆ path()

const FilePath& s3d::TextReader::path ( ) const
noexcept

オープンしているファイルのフルパスを返します。

Returns
ファイルがオープンしている場合、ファイルのフルパス。それ以外の場合は空の文字列。

◆ readAll() [1/2]

String s3d::TextReader::readAll ( )

テキストファイルの内容をすべて読み込みます。

Returns
読み込んだ文字列

◆ readAll() [2/2]

bool s3d::TextReader::readAll ( String s)

テキストファイルの内容をすべて読み込みます。

Parameters
s読み込んだ文字列の格納先
Returns
読み込みに成功した場合 true, ファイルの終端や失敗の場合は false

◆ readChar() [1/2]

Optional<char32> s3d::TextReader::readChar ( )

テキストファイルから 1 文字読み込みます。

Returns
読み込みに成功した場合はその文字の Optional, ファイルの終端や失敗の場合は none

◆ readChar() [2/2]

bool s3d::TextReader::readChar ( char32 ch)

テキストファイルから 1 文字読み込みます。

Parameters
ch読み込んだ文字の格納先
Returns
読み込みに成功した場合 true, ファイルの終端や失敗の場合は false

◆ readLine() [1/2]

Optional<String> s3d::TextReader::readLine ( )

テキストファイルから 1 行読み込みます。

Returns
読み込みに成功した場合はその文字列の Optional, ファイルの終端や失敗の場合は none

◆ readLine() [2/2]

bool s3d::TextReader::readLine ( String line)

テキストファイルから 1 行読み込みます。

Parameters
line読み込んだ文字列の格納先
Remarks
line が十分なキャパシティを持っている場合、メモリの再確保が発生しないため、引数の無い readLine() より効率的です。
Returns
読み込みに成功した場合 true, ファイルの終端や失敗の場合は false

◆ readLines() [1/2]

Array<String> s3d::TextReader::readLines ( )

テキストファイルのすべての行を読み込みます。

Returns
読み込んだすべての行

◆ readLines() [2/2]

bool s3d::TextReader::readLines ( Array< String > &  lines)

テキストファイルのすべての行を読み込みます。

Parameters
lines読み込んだ文字列の格納先
Returns
読み込みに成功した場合 true, ファイルの終端や失敗の場合は false

The documentation for this class was generated from the following file: