| クラス名：TXString |
| 機能 |
メンバ関数名 |
機能詳細、使用例 |
| 長さ関連 |
| 文字列の長さ（文字単位）を取得 |
GetLength() |
TXString tStr = txu(“aaa”);
Length = tStr.GetLength();
結果）Length：3
TXString tStr = txu(“aaああ”);
Length = tStr.GetLength();
結果）Length：4
|
| 文字列の長さ（バイト単位）を取得 |
GetByteSize() |
TXString tStr = txu(“aaa”);
Length = tStr. GetByteSize ();
結果）Length：6
TXString tStr = txu(“aaああ”);
Length = tStr. GetByteSize ();
結果）Length：8
|
| 文字列の長さ（バイト単位）を取得 |
GetEncodingLength() |
TXString tStr = txu(“aaa”);
Length = tStr.GetEncodingLength(ETXEncoding:eWinEncoded);
結果）Length：3
TXString tStr = txu(“aaああ”);
Length = tStr.GetEncodingLength(ETXEncoding:eWinEncoded);
結果）Length：6
※エンコーディングの種類
ETXEncoding: eWinEncoded
eSysEncoded
eUTF8
eUTF16
eUnkown
|
| 文字列を指定した長さに切り捨てる |
Truncate() |
TXString tStr = txu(“abcdefg”);
tStr.Truncate(2);
結果）tStr：“ab”
|
| 文字列が空か確認する |
IsEmpty() |
TXChar tc = ‘‘;
BOOL boo = tStr. IsEmpty ();
結果） : TRUE
TXChar tc = ‘abc‘;
BOOL boo = tStr. IsEmpty ();
結果） : FALSE
|
| 要素へのアクセス |
| 特定の一文字を返す |
GetAt() |
TXString tStr = txu(“abcdefg”);
tStr.GetAt (2); // GetAt (検索文字位置);※0オリジン
結果）“c”
|
| 特定の一文字を置換する |
SetAt() |
TXString tStr = txu(“abcdefg”);
tStr.SetAt(2, ‘0’); // SetAt (検索文字位置); ※0オリジン
結果）“ab0defg”
|
| 挿入と削除 |
| 文字、文字列を挿入 |
Insert() |
TXString tStr = txu(“abcdefg”);
tStr.Insert(2, “999”); // Insert (挿入文字位置, “挿入文字列”); ※0オリジン
結果）“ab999cdefg”
|
| 文字列から特定の文字を削除 |
Delete() |
TXString tStr = txu(“abcdefg”);
tStr.Delete(0,3); // Delete (開始位置, 文字数); ※0オリジン
結果）“defg”
|
| 文字列の最後の一文字を削除 |
DeleteLast() |
TXString tStr = txu(“abc”);
tStr.DeleteLast(); → “ab”
|
| 文字列の先頭及び末尾の文字（' ‘、’¥t’）を削除する |
Trim() |
TXString tStr = txu(“ abcdefg ”);
tStr.Trim ();
結果）“abcdefg”
|
| 文字列の先頭の特定文字（' ‘、’¥t’）を削除する |
TrimLeft() |
TXString tStr = txu(“ abcdefg ”);
tStr.TrimLeft ();
結果）“abcdefg ”
|
| 文字列の末尾の特定文字（' ‘、’¥t’）を削除する |
TrimRight() |
TXString tStr = txu(“ abcdefg ”);
tStr.TrimRight ();
結果）“ abcdefg”
|
| 変換 |
| 文字列の置換 |
Replace() |
TXString tStr = txu(“abcdefg”);
tStr.Replace(“abc”, “123”);
結果）“123defg”
|
| すべての文字を大文字に変換する |
MakeUpper() |
TXString tStr = txu(“abcdefg”);
tStr.MakeUpper ();
結果）“ABCDEFG”
|
| すべての文字を小文字に変換する |
MakeLower() |
TXString tStr = txu(“ABCDEFG”);
tStr.MakeLower ();
結果）“abcdefg”
|
| すべての文字を反転する |
MakeReverse () |
TXString tStr = txu(“ABCDEFG”);
tStr.MakeReverse ();
結果）“GFEDCBA”
|
| 濁点を合成形式に変換する |
ToPrecomposed() |
TXString tStr = txu(“か゛か゛か゛”);
tStr. ToPrecomposed ();
結果）“ががが”
※Macネイティブの場合濁点が分解方式になるのでこの関数を使って合成方式に変換する。
|
| 濁点を分解形式に変換する |
ToDecomposed () |
TXString tStr = txu(“ががが”);
tStr. ToDecomposed ();
結果）“か゛か゛か゛”
※濁点を合成方式から分解方式に変換する。
|
| データの取得とキャスト |
| 標準APIなどのchar型にポインタを渡す |
GetCharPtr()、GetData() |
char型のAPIなどにTXString型を渡したい時に使う。
Windows）
fopen(tStr.GetData(), “wt”);
strcpy( p,tx.GetData() );
Mac）
strcpy( p,tx.GetCharPtr() );
fopen(tStr.GetCharData(), “wt”);
|
| データを外部バッファにコピー |
| データを外部バッファにコピー |
CopyInto() |
char型の場合）
TXString tStr = txu(“abcdefg”);
char buf[512];
tStr.CopyInto(buf, sizeof(buf), ETXEcoding::eWinEncoding);
結果）buf : “abcdefg”
ワイド文字の場合）
wchat_t buf[512];
tStr.CopyInto(buf, sizeof(buf));
結果）buf : “abcdefg”
|
| 検索 |
| 文字列を先頭（指定した位置）から検索 |
Find() |
TXString tStr = txu(“abcdefg”);
Index = tStr.Find (“fg”,0); // Find (検索文字列, 開始位置); ※0オリジン
結果）index : 5
※複数存在する場合は最初の見つかったオフセットを返す。
|
| 文字列を最後尾から検索 |
ReverseFind() |
TXString tStr = txu(“abcdeabfg”);
Index = tStr.ReverseFind (“ab”); // ReverseFind (検索文字列); ※0オリジン
結果）index : 5
※例の場合、find()で返ってくる値は0になる。
|
| 文字列の末尾から最初に出現した文字列を検索 |
Mid() |
TXString tStr = txu(“abcdefg”);
tStr.Mid(2, 3); //Mid (開始位置, 長さ); ※0オリジン
結果）“cde”
|
| 文字を右から取り出す |
Right() |
TXString tStr = txu(“abcdefg”);
tStr.Right(2); //Right(長さ); ※0オリジン
結果）“fg”
|
| 文字を左から取り出す |
Left() |
TXString tStr = txu(“abcdefg”);
tStr.Left(5); //Left (長さ); ※0オリジン
結果）“abcde”
|
| 数値変換 |
| 文字列を数値（整数、浮動小数点）に変換 |
atoi()、atof() |
TXString tStr = txu(“1250”);
Num = tStr.atoi ();
結果）Num : 1250（バイナリ）
|
| 数値（整数、浮動小数点）を文字列に変換 |
itoa()、ftoa() |
float num = 1.98;
tStr.ftoa (num);
結果）”1.98”
|