nlib
nn::nlib::Utf16InputStream クラス

UTF-16の文字列ストリームをUTF-8にして読み込むためのクラスです。 [詳解]

#include "nn/nlib/WcharInputStream.h"

+ nn::nlib::Utf16InputStream の継承関係図

その他の継承メンバ

- 基底クラス nn::nlib::InputConverterStream に属する継承公開メンバ関数
errno_t SetStream (InputStream *istr) noexcept
 変換前のデータを読み込む入力ストリームを設定します。 [詳解]
 
InputStreamGetStream () const noexcept
 変換前のデータを読み込む入力ストリームを取得します。 [詳解]
 
- 基底クラス nn::nlib::InputStream に属する継承公開メンバ関数
errno_t GetErrorValue () const noexcept
 エラー値を取得します。 [詳解]
 
size_t Pos () const noexcept
 ストリーム上の現在位置を返します。 [詳解]
 
uint64_t Pos64 () const noexcept
 ストリーム上の現在位置を64bit値で返します。 [詳解]
 
bool IsEos () noexcept
 ストリームを最後まで読み終えている場合trueを返します。最後まで読み終えていない場合やエラーが発生している場合はfalseを返します。 [詳解]
 
int Read () noexcept
 ストリームから1バイトを読み込みます。 [詳解]
 
int Peek () noexcept
 ストリームを消費せずに次の1バイトを読み込みます。 [詳解]
 
size_t Skip (size_t nbytes) noexcept
 nbytes を読み飛ばします。 [詳解]
 
size_t Read (void *ptr, size_t nbytes) noexcept
 ptr で示されるメモリにnbytes 読み込みます。 [詳解]
 
template<size_t N>
size_t Read (nlib_byte_t(&buf)[N]) noexcept
 上記関数のテンプレートオーバーロードです。
 
bool Close () noexcept
 ストリームを閉じます。成功した場合にはtrueを返します。 [詳解]
 
bool Mark (size_t readlimit) noexcept
 現在の読み込み位置にGoBackToMark()で戻ることができるように設定します。 [詳解]
 
bool GoBackToMark () noexcept
 最後にMark()を実行した読み込み位置に戻ります。 [詳解]
 
bool IsMarkSupported () const noexcept
 このストリームがMark()GoBackToMark()をサポートしていればtrueを返します。
 
 operator bool () const
 オブジェクトが初期化済みで内部でエラーが発生していなければtrue、発生していればfalseを返します。
 
constexpr InputStream () noexcept
 デフォルトコンストラクタです。 派生クラスから呼び出されます。
 
virtual ~InputStream () noexcept
 デストラクタです。 派生クラスから呼び出されます。
 
- 基底クラス nn::nlib::InputStream に属する継承限定公開メンバ関数
void SetBuffer (void *p, size_t nbytes, bool is_mark_supported, bool is_buf_readonly) noexcept
 InputStreamが持つバッファを設定します。 [詳解]
 
void SetError (errno_t e) const noexcept
 InputStreamにエラーを設定します。 [詳解]
 

詳解

UTF-16の文字列ストリームをUTF-8にして読み込むためのクラスです。

説明
InputConverterStream::SetStream()関数で、UTF-16文字列を読み込むストリームを設定して利用します。 UTF-16のエンディアンは、実行マシンのエンディアンと一致している必要があります。
以下がコード例です。
const nlib_utf16_t* str = u"\xD83E\xDD29\xD83E\xDDDD"; // Star-Struck, Elf
nlib_ns::MemoryInputStream is(str, sizeof(*str) * 4);
errno_t e = stream.Init();
SUCCEED_IF(e == 0);
e = stream.SetStream(&is);
SUCCEED_IF(e == 0);
int c;
while ((c = stream.Read()) > 0) {
nlib_printf("%02x ", c);
}
nlib_printf("\n");
/*
Output:
f0 9f a4 a9 f0 9f a7 9d
*/
オブジェクトの状態遷移
オブジェクトの状態遷移の概略は以下のとおりです。
dot_inline_dotgraph_10.png

WcharInputStream.h22 行目に定義があります。


このクラス詳解は次のファイルから抽出されました: