CString の基本操作

[アーティクル]
08/09/2011

更新 : 2011 年 3 月

ここでは、次の基本的な CString 操作について説明します。

標準 C リテラル文字列からの CString オブジェクトの生成
CString 中の文字のアクセス
2 つの CString オブジェクトの結合
CString オブジェクトの比較
CString オブジェクトの変換

Class CString は、クラステンプレート CStringT クラスに基づいています。 CString は、CStringT の typedef です。正確には、CString は、クラステンプレートを使用してクラスを定義する一般的な方法である CStringT の明示的特殊化の typedef です。同様に定義されたクラスは、CStringA および CStringW です。明示的特殊化の詳細については、「Class Template Instantiation」を参照してください。

CString、CStringA、および CStringW は、atlstr.h で定義されます。 CStringT は、cstringt.h で定義されます。

CString、CStringA、および CStringW は、CStringT で定義されたメソッドおよび演算子のセットを取得して、サポート対象の文字列データで使用します。メソッドの一部は、C ランタイムライブラリの文字列操作機能と同等か、場合によっては拡張されたものです。

注:CStringネイティブクラスです。 C++/CLI マネージプロジェクト用の文字列クラスの場合は、System.String を使用します。

標準 C リテラル文字列からの CString オブジェクトの生成

1 つの CString オブジェクトを別のオブジェクトに代入できるのと同様に、C 形式のリテラル文字列を CString に代入できます。

C リテラル文字列の値を CString オブジェクトに代入する場合。
```
CString myString = _T("This is a test");   
```
CString オブジェクトの値を他の CString オブジェクトに代入する場合。
```
CString oldString = _T("This is a test");
CString newString = oldString;
```
CString オブジェクトを別の CString オブジェクトに代入すると、オブジェクトの内容がコピーされます。したがって、2 つの文字列が、その文字列を構成する実際の文字への参照を共有することはありません。 CString オブジェクトを値として使用する方法の詳細については、「CString の評価」を参照してください。

注意

Unicode または ANSI 用にコンパイルできるアプリケーションを作成するには、_T マクロを使用してリテラル文字列を記述します。詳細については、「Unicode とマルチバイト文字セット (MBCS: Multibyte Character Set) のサポート」を参照してください。

CString 中の文字のアクセス

CString オブジェクト内の個々の文字には、GetAt メソッドおよび SetAt メソッドを使用してアクセスできます。 GetAt の代わりに配列要素、つまり添字演算子 ([ ]) を使用して、個々の文字を取得することもできます。この方法は、標準の C 形式文字列で、インデックスを使用して配列要素にアクセスする方法と似ています。CString 内の文字のインデックス値は、0 から始まります。

2 つの CString オブジェクトの結合

2 つの CString オブジェクトを結合するには、結合演算子 (+ または +=) を使用します。

CString s1 = _T("This ");        // Cascading concatenation
s1 += _T("is a ");
CString s2 = _T("test");
CString message = s1 + _T("big ") + s2;  
// Message contains "This is a big test".

結合演算子 (+ または +=) の引数のうち少なくとも 1 つは CString オブジェクトにする必要がありますが、それ以外の引数には文字列定数 ("big" など) または char (x など) を使用できます。

CString オブジェクトの比較

Compare メソッド、および CString の == 演算子は等価です。 Compare、operator==、および CompareNoCase は MBCS および Unicode に対応しています。また、CompareNoCase は大文字と小文字を区別しません。 CString の Collate メソッドはロケールを認識しますが、Compare よりも動作が遅い場合があります。 Collate は、固有の並べ替え順序をサポートする必要がある場合以外は使用しないでください。

CString の比較関数および相当する Unicode/MBCS 互換の C ランタイムライブラリ関数を次の表に示します。

CString の関数	MBCS ランタイム関数	Unicode 関数
Compare	_mbscmp	wcscmp
CompareNoCase	_mbsicmp	_wcsicmp
Collate	_mbscoll	wcscoll

CStringT クラステンプレートは、CString で使用できる関係演算子 (<、<=、>=、>、==、および !=) を定義します。次の例に示すように、これらの演算子を使用して、2 つの CStrings を比較できます。

CString s1(_T("Tom"));
CString s2(_T("Jerry"));
ASSERT(s2 < s1);

CString オブジェクトの変換

CString オブジェクトを他の文字列型に変換する方法については、「方法: さまざまな文字列型間で変換する」を参照してください。

CString の wcout を使用してください。

CString でを使用するwcoutオブジェクトに明示的にキャストする必要があります、const wchar_t*、次のよう。

CString cs("meow");
  wcout << (const wchar_t*) cs << endl;

キャスト、なしcsは、void*とwcoutオブジェクトのアドレスを印刷します。この現象は、微妙なとの相互作用は自分で正しいテンプレート引数控除とオーバーロードの解決準拠の C++ 標準によって引き起こされます。

参照

CStringT クラス

Class Template Instantiation

Explicit Specialization of Class Templates

Partial Specialization of Class Templates (C++)

CStringT クラス

概念

方法: さまざまな文字列型間で変換する

その他の技術情報

文字列 (ATL/MFC)

履歴の変更

日付	History	理由
2011 年 3 月	Wcout ストリームの CString 動作を説明するセクションを追加しました。	次のいずれかのトークンに置換。情報の拡充

2011 年 3 月

Wcout ストリームの CString 動作を説明するセクションを追加しました。

次のいずれかのトークンに置換。

情報の拡充

次の方法で共有