SharedString Class Reference

u8stringとstringとwstringをshared_ptrで持ち共有する More...

#include <webcface/common/encoding.h>

Inheritance diagram for SharedString:

Public Member Functions
	SharedString ()
	SharedString (std::nullptr_t)
	SharedString (std::shared_ptr< internal::SharedStringData > data)
std::string_view	u8StringView () const
StringView	u8StringViewShare () const
std::string_view	decode () const
StringView	decodeShare () const
std::wstring_view	decodeW () const
WStringView	decodeShareW () const
bool	empty () const
bool	startsWith (std::string_view str) const
bool	startsWith (char str) const
SharedString	substr (std::size_t pos, std::size_t len=std::string::npos) const
std::size_t	find (char c, std::size_t pos=0) const
bool	operator== (const SharedString &other) const
bool	operator<= (const SharedString &other) const
bool	operator>= (const SharedString &other) const
bool	operator!= (const SharedString &other) const
bool	operator< (const SharedString &other) const
bool	operator> (const SharedString &other) const

Static Public Member Functions
static SharedString	fromU8String (std::string u8s)
static SharedString	fromU8StringStatic (std::string_view u8s)
static SharedString	encode (std::string s)
static SharedString	encodeStatic (std::string_view s)
static SharedString	encode (std::wstring ws)
static SharedString	encodeStatic (std::wstring_view ws)
static const std::string &	emptyStr ()
static const std::wstring &	emptyStrW ()

Detailed Description

u8stringとstringとwstringをshared_ptrで持ち共有する

Since

ver2.0

See also

StringInitializer

• 初期状態ではdataがnullptr、またはu8stringのみ値を持ちstringとwstringは空
• コピーするとdataのポインタ(shared_ptr)のみをコピーし、 文字列自体のコピーは発生しない
• SharedStringどうしを比較するときdataポインタが等しければ文字列自体の比較をしない。
• decodeやdecodeWが呼ばれたときdata内部に変換後の文字列を保存する。 一度保存したstringやwstringを別の値に書き換えることはない (のでc_strなどの参照は保持される)
• string→utf8: windowsではusingUTF8(false)の場合ANSIからutf8へエンコーディングの変換を行うが、 usingUTF8(true)の場合なにもせずそのままコピーする。
• utf-8→string: windowsでusingUTF8(false)の場合はANSIに、 それ以外の場合なにもせずそのままコピーする。
• ver2.10〜 staticな生文字列ポインタをstring_viewとして保持することを可能にした。 その場合string_viewの範囲外だがNULL終端であることが保証される。
• ver2.10〜 u8StringView(), decode(), decodeW() はただのstring_viewだが、data()がnull終端文字列であることは保証される。 u8StringViewShare(), decodeShare(), decodeShareW() はshared_ptrのコピーを含みちょっと遅い。

Constructor & Destructor Documentation

SharedString() [1/3]

SharedString ( )

inline

SharedString() [2/3]

SharedString ( std::nullptr_t  )

inline

SharedString() [3/3]

SharedString ( std::shared_ptr< internal::SharedStringData >  data )

explicit

Member Function Documentation

decode()

std::string_view decode

(

)

const

decodeShare()

StringView decodeShare

(

)

const

decodeShareW()

WStringView decodeShareW

(

)

const

decodeW()

std::wstring_view decodeW

(

)

const

empty()

bool empty

(

)

const

emptyStr()

const std::string & emptyStr ( )

static

emptyStrW()

const std::wstring & emptyStrW ( )

static

encode() [1/2]

SharedString encode ( std::string  s )

static

encode() [2/2]

SharedString encode ( std::wstring  ws )

static

encodeStatic() [1/2]

SharedString encodeStatic ( std::string_view  s )

static

encodeStatic() [2/2]

SharedString encodeStatic ( std::wstring_view  ws )

static

find()

std::size_t find	(	char	c,
		std::size_t	pos = 0
	)		const

fromU8String()

SharedString fromU8String ( std::string  u8s )

static

fromU8StringStatic()

SharedString fromU8StringStatic ( std::string_view  u8s )

static

operator!=()

bool operator!= ( const SharedString &  other ) const

inline

operator<()

bool operator< ( const SharedString &  other ) const

inline

operator<=()

bool operator<=

(

const SharedString &

other

)

const

operator==()

bool operator==

(

const SharedString &

other

)

const

operator>()

bool operator> ( const SharedString &  other ) const

inline

operator>=()

bool operator>=

(

const SharedString &

other

)

const

startsWith() [1/2]

bool startsWith

(

char

str

)

const

startsWith() [2/2]

bool startsWith

(

std::string_view

str

)

const

substr()

SharedString substr	(	std::size_t	pos,
		std::size_t	len = std::string::npos
	)		const

u8StringView()

std::string_view u8StringView

(

)

const

u8StringViewShare()

StringView u8StringViewShare

(

)

const

---

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

• common/include/webcface/common/encoding.h
• common/src/encoding.cc