WIL説明書(C++)  3.0.0
全メンバ一覧 | 公開型 | 公開メンバ関数 | 静的公開メンバ関数 | 限定公開メンバ関数
FVCL::Data::CFvStringA クラス
データオブジェクト

文字列管理クラス(ASCII) [詳解]

詳解

文字列管理クラス(ASCII)

namespace FVCL::Data

ASCII文字列を管理するデータ構造クラスです。
内部では、CHAR 型の連続した配列に文字列を格納しています。 固定長文字列と同様に、終端には '\0' が格納されます。

必要条件:
ヘッダー: FVCLbasic.h
参照
FVCL::Data::CFvString
+ FVCL::Data::CFvStringA の継承関係図

公開型

enum  {
  DefaultInitial = 256,
  DefaultIncrease = 128
}
 
enum  { DataID = 18 }
 

公開メンバ関数

 CFvStringA ()
 コンストラクタ [詳解]
 
 CFvStringA (const CFvStringA &str)
 コピーコンストラクタ [詳解]
 
 CFvStringA (const CHAR *str)
 コンストラクタ [詳解]
 
virtual ~CFvStringA ()
 デストラクタ [詳解]
 
virtual INT GetDataID () const
 データIDの取得 [詳解]
 
virtual bool GetPointer (INT id, void **val) const
 クラスのthisポインタの取得 [詳解]
 
virtual bool Resize (UINT sz, CHAR init=0x20)
 文字列メモリ確保 [詳解]
 
virtual UINT GetLength () const
 文字列長の取得 [詳解]
 
virtual CHAR * GetBuffer () const
 文字列バッファの取得 [詳解]
 
virtual CHAR GetAt (UINT index) const
 1文字取得 [詳解]
 
virtual CHAR SetAt (UINT index, CHAR val)
 1文字設定 [詳解]
 
virtual CFvStringA & CopySub (const CFvStringA &src, UINT begin, UINT end)
 文字列の部分複製 [詳解]
 
virtual UINT GetTypeSize () const
 文字サイズの取得 [詳解]
 
virtual bool Format (const CHAR *format,...)
 書式付き文字列指定 [詳解]
 
virtual bool FormatV (const CHAR *format, va_list arg_list)
 書式付き文字列指定 [詳解]
 
virtual CHAR & operator[] (UINT index)
 文字参照 [詳解]
 
virtual const CHAR & operator[] (UINT index) const
 文字参照 [詳解]
 
virtual CFvStringA & operator= (const CFvStringA &src)
 代入オペレータ [詳解]
 
virtual CFvStringA & operator= (LPCSTR src)
 代入オペレータ [詳解]
 
virtual bool operator== (const CFvStringA &src) const
 比較オペレータ(==) [詳解]
 
virtual bool operator!= (const CFvStringA &src) const
 比較オペレータ(!=) [詳解]
 
virtual bool operator== (LPCSTR src) const
 比較オペレータ(==) [詳解]
 
virtual bool operator!= (LPCSTR src) const
 比較オペレータ(!=) [詳解]
 
virtual CFvStringA operator+ (const CFvStringA &src)
 加算オペレータ [詳解]
 
virtual CFvStringA operator+ (LPCSTR src)
 加算オペレータ [詳解]
 
virtual CFvStringA & operator+= (const CFvStringA &src)
 加算代入オペレータ [詳解]
 
virtual CFvStringA & operator+= (LPCSTR src)
 加算代入オペレータ [詳解]
 
virtual operator LPCSTR () const
 キャストオペレータ [詳解]
 
- 基底クラス FVCL::CFvDataObject に属する継承公開メンバ関数
 CFvDataObject ()
 標準のコンストラクタ [詳解]
 
virtual ~CFvDataObject ()
 デストラクタ [詳解]
 
virtual bool Load (LPCTSTR szFileName)
 データファイルの読み込み [詳解]
 
virtual bool Save (LPCTSTR szFileName)
 データファイル保存 [詳解]
 
- 基底クラス FVCL::CFvObject に属する継承公開メンバ関数
 CFvObject ()
 標準のコンストラクタ [詳解]
 
virtual ~CFvObject ()
 デストラクタ [詳解]
 
INT SetErrorCode (INT err)
 エラーコードの設定 [詳解]
 
INT SetErrorCode (INT err) const
 エラーコードの設定 [詳解]
 
INT GetErrorCode () const
 エラーコードの取得 [詳解]
 
bool SetAllocateOption (INT value)
 画像領域確保時のオプションの設定 [詳解]
 
INT GetAllocateOption () const
 画像領域確保時のオプションの取得 [詳解]
 
void * operator new (size_t uiSize)
 new オペレータ [詳解]
 
void * operator new[] (size_t uiSize)
 new[] オペレータ [詳解]
 
void operator delete (void *pvObject)
 delete オペレータ [詳解]
 
void operator delete[] (void *pvObject)
 delete[] オペレータ [詳解]
 
void * operator new (size_t uiSize, LPCSTR szFileName, INT iLine)
 new オペレータ [詳解]
 
void * operator new[] (size_t uiSize, LPCSTR szFileName, INT iLine)
 new[] オペレータ [詳解]
 
void operator delete (void *pvObject, LPCSTR szFileName, INT iLine)
 delete オペレータ [詳解]
 
void operator delete[] (void *pvObject, LPCSTR szFileName, INT iLine)
 delete[] オペレータ [詳解]
 
virtual CFvObject & operator= (const CFvObject &src)
 代入オペレータ [詳解]
 
virtual bool operator== (const CFvObject &src) const
 比較オペレータ (==) [詳解]
 
virtual bool operator!= (const CFvObject &src) const
 比較オペレータ (!=) [詳解]
 

静的公開メンバ関数

static CFvStringA FormatS (const CHAR *format,...)
 書式付き文字列指定 [詳解]
 
- 基底クラス FVCL::CFvObject に属する継承静的公開メンバ関数
static bool SetDefaultAllocateOption (INT value)
 既定の画像領域確保時のオプションの設定 [詳解]
 
static INT GetDefaultAllocateOption ()
 既定の画像領域確保時のオプションの取得 [詳解]
 

限定公開メンバ関数

UINT fnGetLength (const CHAR *str) const
 文字列バイト数の算出 [詳解]
 
void fnCopy (const CHAR *src, CHAR *dst, UINT src_start, UINT dst_start, UINT sz) const
 文字列コピー [詳解]
 
void fnStrCopy (const CHAR *src, CHAR *dst) const
 文字列コピー [詳解]
 
- 基底クラス FVCL::CFvObject に属する継承限定公開メンバ関数
INT fnCPUCheck ()
 CPU情報の取得 [詳解]
 

その他の継承メンバ

- 基底クラス FVCL::CFvObject に属する継承限定公開変数類
INT m_ErrorCode
 エラーコード [詳解]
 
INT m_AllocateOption
 画像領域確保時のオプション [詳解]
 

列挙型メンバ詳解

anonymous enum
列挙値
DefaultInitial 

領域の初期容量(要素数)

DefaultIncrease 

領域の増分(要素数)

anonymous enum
列挙値
DataID 

文字列管理クラスのデータID

このクラスのデータIDです。

構築子と解体子

FVCL::Data::CFvStringA::CFvStringA ( )

コンストラクタ

標準のコンストラクタです。サイズ0の文字列となります。

FVCL::Data::CFvStringA::CFvStringA ( const CFvStringA &  str)

コピーコンストラクタ

同一クラスのオブジェクトの内容を複製して、このオブジェクトを構築します。

引数
[in]strコピー元文字列
例外
FVCL::CFveBadAllocExceptionメモリ不足のため、文字列をコピーできませんでした。
FVCL::Data::CFvStringA::CFvStringA ( const CHAR *  str)

コンストラクタ

文字列を指定してオブジェクトを構築します。

引数
[in]strコピー元文字列
例外
FVCL::CFveBadAllocExceptionメモリ不足のため、文字列をコピーできませんでした。
FVCL::Data::CFvStringA::~CFvStringA ( )
virtual

デストラクタ

文字列を解放します。

関数詳解

FVCL::Data::CFvStringA::GetDataID ( ) const
virtual

データIDの取得

データIDを取得します。

戻り値
データIDを返します。
参照
CFvStringA::DataID

FVCL::CFvDataObjectを実装しています。

FVCL::Data::CFvStringA::GetPointer ( INT  id,
void **  val 
) const
virtual

クラスのthisポインタの取得

指定されたデータIDと自身のIDが一致する場合に thisポインタを返します。

引数
[in]idデータID
[out]valthisポインタを格納する変数へのポインタ
戻り値
true正常
false異常
参照
CFvStringA::DataID

FVCL::CFvDataObjectを実装しています。

FVCL::Data::CFvStringA::Resize ( UINT  sz,
CHAR  init = 0x20 
)
virtual

文字列メモリ確保

文字列のメモリを指定サイズ分確保し、指定文字で初期化します。

引数
[in]sz確保サイズ
[in]init初期化文字
戻り値
true正常
false異常
GetErrorCodeメソッドによりエラーコードを取得できます。
エラーコード:
値 定数 内容
1 FVCL_ErrorCode::FAILED_TO_ALLOCATE メモリの確保に失敗しました。
FVCL::Data::CFvStringA::GetLength ( ) const
virtual

文字列長の取得

文字列の先頭から終端までのバイト数を取得します。
終端記号は含まれません。また、2byte文字は、1文字につき2となります。

戻り値
文字列長をバイト単位で返します。
解説:
文字列のバイト数を取得します。文字数ではありませんのでご注意ください。
CFvStringA str( "hello世界" );
UINT len = str.GetLength(); // len = 9

FVCL::Data::CFvStringA::GetBuffer ( ) const
virtual

文字列バッファの取得

文字列の先頭アドレスを取得します。

戻り値
文字列の先頭アドレスを返します。
解説:
戻り値のアドレスは、ユーザ側で保管せず、一時的な利用にのみご使用ください。 このクラスが持つ配列の再確保が行われた際は、このアドレスは無効になりますのでご注意ください。
参照
GetLength
FVCL::Data::CFvStringA::GetAt ( UINT  index) const
virtual

1文字取得

文字列中の文字を一文字だけ取得します。

引数
[in]index文字位置
戻り値
指定位置の文字を返します。
例外
FVCL::CFveBadAccessException指定位置が文字列外です。
参照
SetAt
FVCL::Data::CFvStringA::SetAt ( UINT  index,
CHAR  val 
)
virtual

1文字設定

文字列中の1文字を、指定の文字に入れ替えます。

引数
[in]index文字位置
[in]val設定文字
戻り値
設定された文字を返します。
例外
FVCL::CFveBadAccessException指定位置が文字列外です。
参照
GetAt
FVCL::Data::CFvStringA::CopySub ( const CFvStringA &  src,
UINT  begin,
UINT  end 
)
virtual

文字列の部分複製

文字列の始点から終点までの間のみを、このインスタンスに複製します。

引数
[in]srcコピー元
[in]begin始点
[in]end終点(終点を含む)
戻り値
複製後のこのインスタンスへの参照を返します。
例外
FVCL::CFveBadAllocExceptionメモリ不足のため、文字列をコピーできませんでした。
FVCL::CFveBadParamExceptionbegin または end 引数の位置が文字列外です。
FVCL::Data::CFvStringA::GetTypeSize ( ) const
virtual

文字サイズの取得

1文字のバッファバイト数を取得します。常に1が返されます。

戻り値
常に1を返します。
FVCL::Data::CFvStringA::Format ( const CHAR *  format,
  ... 
)
virtual

書式付き文字列指定

sprintf が C スタイルの文字配列に書式化されたデータを設定する場合と同じ方法で、書式付きデータを CFvStringA に書き込みます。
出力書式文字列に関しては、ANSIのsprintf()をご参照ください。

引数
[in]format出力書式文字列
[in]...可変個引数
戻り値
true正常
false異常
GetErrorCodeメソッドによりエラーコードを取得できます。
エラーコード:
値 定数 内容
1 FVCL_ErrorCode::FAILED_TO_ALLOCATE メモリの確保に失敗しました。
参照
FormatV
FVCL::Data::CFvStringA::FormatV ( const CHAR *  format,
va_list  arg_list 
)
virtual

書式付き文字列指定

書式付き文字列と可変長引数リストを CFvString オブジェクトに書き込みます。

引数
[in]format出力書式文字列
[in]arg_list可変個引数集
戻り値
true正常
false異常
GetErrorCodeメソッドによりエラーコードを取得できます。
エラーコード:
値 定数 内容
1 FVCL_ErrorCode::FAILED_TO_ALLOCATE メモリの確保に失敗しました。
解説:
出力書式文字列に関しては、ANSIのsprintf()をご参照ください。
参照
Format
FVCL::Data::CFvStringA::FormatS ( const CHAR *  format,
  ... 
)
static

書式付き文字列指定

出力書式文字列を指定してオブジェクトを構築します。
sprintf が C スタイルの文字配列に書式化されたデータを設定する場合と同じ方法です。
出力書式文字列に関しては、ANSIのsprintf()をご参照ください。

引数
[in]format出力書式文字列
[in]...可変個引数
戻り値
生成したオブジェクトを返します。
例外
FVCL::CFveBadAllocExceptionメモリ不足のため、文字列をコピーできませんでした。
FVCL::Data::CFvStringA::operator[] ( UINT  index)
virtual

文字参照

指定位置の文字を参照します。

引数
[in]index指定位置
戻り値
指定位置の文字への参照を返します。
例外
FVCL::CFveBadAccessException指定位置が文字列外です。
FVCL::Data::CFvStringA::operator[] ( UINT  index) const
virtual

文字参照

指定位置の文字を参照します。

引数
[in]index指定位置
戻り値
指定位置の文字への参照を返します。
例外
FVCL::CFveBadAccessException指定位置が文字列外です。
FVCL::Data::CFvStringA::operator= ( const CFvStringA &  src)
virtual

代入オペレータ

右辺文字列を、このオブジェクトに代入します。

引数
[in]srcコピー元文字列
戻り値
代入後のこのオブジェクトへの参照を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator= ( LPCSTR  src)
virtual

代入オペレータ

右辺文字列を、このオブジェクトに代入します。

引数
[in]srcコピー元文字列
戻り値
代入後のこのオブジェクトへの参照を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator== ( const CFvStringA &  src) const
virtual

比較オペレータ(==)

同一クラスのオブジェクトの内容と比較します。

引数
[in]src比較対象
戻り値
true一致
false不一致
参照
operator!=
FVCL::Data::CFvStringA::operator!= ( const CFvStringA &  src) const
virtual

比較オペレータ(!=)

同一クラスのオブジェクトの内容と比較します。

引数
[in]src比較対象
戻り値
true不一致
false一致
参照
operator==
FVCL::Data::CFvStringA::operator== ( LPCSTR  src) const
virtual

比較オペレータ(==)

文字列とオブジェクトの内容を比較します。

引数
[in]src比較対象
戻り値
true一致
false不一致
FVCL::Data::CFvStringA::operator!= ( LPCSTR  src) const
virtual

比較オペレータ(!=)

文字列とオブジェクトの内容を比較します。

引数
[in]src比較対象
戻り値
true不一致
false一致
FVCL::Data::CFvStringA::operator+ ( const CFvStringA &  src)
virtual

加算オペレータ

引数
[in]src連結する文字列
戻り値
このオブジェクトが持つ文字列と右辺文字列を連結した文字列を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator+ ( LPCSTR  src)
virtual

加算オペレータ

引数
[in]src連結する文字列
戻り値
このオブジェクトが持つ文字列と右辺文字列を連結した文字列を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator+= ( const CFvStringA &  src)
virtual

加算代入オペレータ

右辺文字列を、このオブジェクトが持つ文字列に連結します。

引数
[in]src連結する文字列
戻り値
連結後のこのオブジェクトへの参照を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator+= ( LPCSTR  src)
virtual

加算代入オペレータ

右辺文字列を、このオブジェクトが持つ文字列に連結します。

引数
[in]src連結する文字列
戻り値
連結後のこのオブジェクトへの参照を返します。
例外
FVCL::CFveBadAllocExceptionメモリの確保に失敗しました。
FVCL::Data::CFvStringA::operator LPCSTR ( ) const
virtual

キャストオペレータ

文字列の先頭アドレスを返します。

FVCL::Data::CFvStringA::fnGetLength ( const CHAR *  str) const
protected

文字列バイト数の算出

文字列バイト数を算出します。終端記号は含まれません。

引数
[in]str対象文字列
戻り値
バイト数を返します。
参照
GetLength
FVCL::Data::CFvStringA::fnCopy ( const CHAR *  src,
CHAR *  dst,
UINT  src_start,
UINT  dst_start,
UINT  sz 
) const
protected

文字列コピー

指定領域だけ文字列をコピーします

引数
[in]srcコピー元
[out]dstコピー先
[in]src_startコピー元開始位置
[in]dst_startコピー先開始位置
[in]szサイズ
解説:
コピー先文字列は、コピー元文字列分のメモリが確保されている必要があります。
参照
CopySub
FVCL::Data::CFvStringA::fnStrCopy ( const CHAR *  src,
CHAR *  dst 
) const
protected

文字列コピー

コピー元文字列をすべて、コピー先文字列にコピーします。

引数
[in]srcコピー元文字列
[out]dstコピー先文字列
解説:
コピー先文字列は、コピー元文字列分のメモリが確保されている必要があります。
Documentation copyright © 2007 FAST Corporation. [B-001864]
Generated on 2023年11月02日(木) 10時13分00秒 for WIL説明書(C++) by doxygen 1.8.11