CStringT::Insert

更新 : 2007 年 11 月

文字列内の指定されたインデックス位置に 1 文字または部分文字列を挿入します。

int Insert(
   int iIndex,
   PCXSTR psz
);
int Insert(
   int iIndex,
   XCHAR ch
);

パラメータ

  • iIndex
    挿入位置の直後にある文字のインデックス。

  • psz
    挿入する部分文字列へのポインタ。

  • ch
    挿入する文字。

戻り値

挿入後の文字列の長さを返します。

解説

パラメータ iIndex で指定した文字以降の文字が後ろに移動して、文字または部分文字列の挿入スペースが確保されます。nIndex を 0 にすると、文字列全体の前に挿入されます。nIndex を文字列の長さを超える値にすると、現在の文字列と ch または psz で指定した文字または部分文字列が連結されます。

使用例

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;

CAtlString str(_T("SoccerBest"));
int n = str.Insert(6, _T("is "));
ASSERT(n == str.GetLength());
_tprintf_s(_T("1: %s\n"), (LPCTSTR) str);

n = str.Insert(6, _T(' '));
ASSERT(n == str.GetLength());
_tprintf_s(_T("2: %s\n"), (LPCTSTR) str);

n = str.Insert(55, _T('!'));
ASSERT(n == str.GetLength());
_tprintf_s(_T("3: %s\n"), (LPCTSTR) str);

必要条件

ヘッダー : cstringt.h

参照

参照

CStringT クラス

その他の技術情報

CStringT のメンバ