4.6.2 WString_varクラス

WString_varクラスは、文字列操作を簡易化するためのいくつかのメンバ関数を提供します。その他のvarクラスとの大きな違いは、constあり、constなしの場合の2種類のメンバ関数が定義されていることです。
WString_varクラスのクラス定義を以下に示します。

class WString_var {
    public : 
        WString_var();                                    // デフォルトコンストラクタ
        WString_var( WChar * );                           // WChar * コンストラクタ
        WString_var( const WChar * );                     // WChar *コンストラクタ
        WString_var( const WString_var & );               // コピーコンストラクタ
        ~WString_var();                                   // デストラクタ

        WString_var    &operator=( WChar * );             // WChar *代入演算子
        WString_var    &operator=( const WChar * );       // WChar *代入演算子
        WString_var    &operator=( const WString_var & ); // 代入演算子

        operator       WChar*();                          // 変換オペレータ
        operator       const WChar*()  const;             // 変換オペレータ

        WChar          &operator[]( ULong );              // [ ]オペレータ
        WChar          operator[]( ULong )  const;        // [ ]オペレータ
    private: 
        WChar          *_ptr; 
};

WString_varクラスのメンバ	意味
デフォルトコンストラクタ	インスタンス生成時、_ptrをNULLに初期化します。
WChar *コンストラクタ	constなし：インスタンス生成時、指定されたパラメタのポインタを_ptrに設定します。 constあり：インスタンス生成時、指定されたパラメタのコピーを作成し、_ptrに設定します。_ptrの領域を新規獲得します。メモリ不足により領域の獲得に失敗した場合は、_ptrにNULLが設定されます。
コピーコンストラクタ	インスタンス生成時、指定されたパラメタの_ptrのデータのコピーを作成し、_ptrに設定します。_ptrの領域を新規獲得します。メモリ不足により領域の獲得に失敗した場合は、_ptrにNULLが設定されます。
デストラクタ	_ptrをCORBA::wstring_freeによって解放します。
WChar *代入演算子	constなし：右辺で指定されたWCharポインタを_ptrに代入します。 constあり：右辺で指定されたWCharポインタデータのコピーを_ptrに代入します。_ptrの領域を新規獲得します。メモリ不足により領域の獲得に失敗した場合は、_ptrにNULLが設定されます。
代入演算子	右辺で指定されたWString_var変数の_ptrのデータのコピーを作成し、_ptrに代入します。_ptrの領域を新規獲得します。メモリ不足により領域の獲得に失敗した場合は、_ptrにNULLが設定されます。
交換演算子	_ptrに設定されているポインタを取り出します。
[ ]演算子	パラメタで指定されている_ptr番目の要素の参照値を取り出します。

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

デフォルトコンストラクタは、_ptrをNULLに初期化します。
デフォルトコンストラクタの使用例と処理内容を以下に示します。

WString_var  data; 

CORBA::WString_var::WString_var()
{
    _ptr = NULL; 
}

WChar*コンストラクタ

WChar*コンストラクタは、constなしの場合、インスタンス生成時、指定されたパラメタのポインタを_ptrに設定します。constありの場合は、インスタンス生成時、指定されたパラメタのコピーを_ptrに設定します。
WChar *コンストラクタの使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
(*str)[0] = 'テ'; 
(*str)[1] = 'ス'; 
(*str)[2] = 'ト'; 
(*str)[3] = '\0'; 

CORBA::WString_var data1( str );                       // WChar*コンストラクタ(constなし) 
CORBA::WString_var data2( (const CORBA::WChar *)str ); // WChar *コンストラクタ(constあり) 

CORBA::WString_var::WString_var( WChar *p ) 
{
    _ptr = p; 
}

CORBA::WString_var::WString_var( const WChar *p ) 
{
    ...  // _ptrにpの内容を複写します
}

コピーコンストラクタ

コピーコンストラクタは、インスタンス生成時、指定されたパラメタの_ptrに設定されているデータ自身の_ptrに複写します。
コピーコンストラクタの使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
(*str)[0] = 'テ'; 
(*str)[1] = 'ス'; 
(*str)[2] = 'ト'; 
(*str)[3] = '\0'; 

CORBA::WString_var data1( str );      // WChar*コンストラクタ(constなし) 
CORBA::WString_var data2( data1 );    // コピーコンストラクタ

CORBA::WString_var::WString_var(
const CORBA::WString_var &r ) 
{
    ...    // rの_ptrを取り出し、そのコピーを_ptrに設定します。
}

デストラクタ

デストラクタは、インスタンス解放時、_ptrに設定されているデータを解放します。
デストラクタの使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
(*str)[0] = 'テ'; 
(*str)[1] = 'ス'; 
(*str)[2] = 'ト'; 
(*str)[3] = '\0'; 

CORBA::WString_var *data = new CORBA::WString_var( str );  // WChar*コンストラクタ(constなし) 

delete data;   // デストラクタが起動され_ptr(この例ではstrの指す領域)が解放されます

CORBA::WString_var::~WString_var()
{
    CORBA::wstring_free( _ptr ); 
}

WChar *代入演算子

WChar*代入演算子は、constなしの場合、右辺で指定されたWChar*ポインタを_ptrに代入します。constありの場合は、右辺で指定されたWChar*ポインタの指すデータのコピーを作成し、そのポインタを_ptrに設定します。すでに_ptrにデータが設定されている場合は、constなし、constありいずれの場合も、すでに設定されている_ptrのデータを解放した後で、それぞれの処理を実行します。
WChar*代入演算子の使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
(*str)[0] = 'テ'; 
(*str)[1] = 'ス'; 
(*str)[2] = 'ト'; 
(*str)[3] = '\0'; 

CORBA::WString_var data; 

data = (CORBA::WChar *)str;        // WChar*代入演算子(constなし) 
data = (const CORBA::WChar *)str;  // WChar*代入演算子(constあり) 

CORBA::WString_var  &
CORBA::WString_var::operator=( WChar *p ) 
{
    if( _ptr ) 
        CORBA::wstring_free( _ptr ); 
    _ptr = p; 
    return *this; 
}

CORBA::WString_var  &
CORBA::WString_var::operator=( const WChar *p ) 
{
    if( _ptr ) 
        CORBA::wstring_free( _ptr ); 
    ...    // _ptrにpのコピーを作成し、そのポインタを設定
    return *this; 
}

代入演算子

代入演算子は、右辺で指定されたWString_var変数の_ptrの設定されているデータのコピーを作成し、_ptrに設定します。すでに_ptrにデータが設定されている場合は、そのデータを解放した後、処理を行います。
代入演算子の使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
(*str)[0] = 'テ'; 
(*str)[1] = 'ス'; 
(*str)[2] = 'ト'; 
(*str)[3] = '\0'; 

CORBA::WString_var data; 

data = test;    // WChar*代入演算子(constなし) 

CORBA::WString_var  data2; 

data2 = data1;  // 代入演算子

CORBA::WString_var  &
CORBA::WString_var::operator=( const CORBA::WString_var &r ) 
{
    if( _ptr ) 
        CORBA::wstring_free( _ptr ); 
        ...    // rの_ptrを取り出し、そのコピーを_ptrに設定します。
    return *this; 
}

[ ]演算子

[ ]演算子は、_ptrに設定されているパラメタで指定されたデータ+1番目のデータの参照値を返します。
[ ]演算子の使用例と処理内容を以下に示します。

CORBA::WChar * str = CORBA::wstring_alloc(3); 
strcpy( str, "テスト" ); 
 
CORBA::WString_var data; 

data = test;                   // WChar*代入演算子(constなし) 

CORBA::WChar x = data[2];      // 3文字目'ト'が返ります。

WChar   &
CORBA::WString_var::operator[]( ULong index ) 
{
    return _ptr[index]; 
}