文字列関数

bool  StringAdd(
string&  string_var,       // 文字列を追加する文字列
string  add_substring      // 追加される文字列
);

void OnStart()
{
  long length=1000000;
string a=“a”,b=“b”,c;
//— 1 番目の方法
uint start=GetTickCount(),stop;
long i;
for(i=0;i<length;i++)
{
c=a+b;
}
stop=GetTickCount();
Print(“time for ‘c = a + b’ = “,(stop-start),” milliseconds, i = “,i);

//— 2 番目の方法
start=GetTickCount();
for(i=0;i<length;i++)
{
StringAdd(a,b);
}
stop=GetTickCount();
Print(“time for ‘StringAdd(a,b)’ = “,(stop-start),” milliseconds, i = “,i);

//— 3 番目の方法
start=GetTickCount();
a=“a”; // 変数 a を再初期化する
for(i=0;i<length;i++)
{
StringConcatenate(c,a,b);
}
stop=GetTickCount();
Print(“time for ‘StringConcatenate(c,a,b)’ = “,(stop-start),” milliseconds, i = “,i);
}

int  StringBufferLen(
string  string_var      // 文字列
）

void OnStart()
{
long length=1000;
string a=“a”,b=“b”;
//—
long i;
Print(“before: StringBufferLen(a) = “,StringBufferLen(a),
”  StringLen(a) = “,StringLen(a));
for(i=0;i<length;i++)
{
StringAdd(a,b);
}
Print(“after: StringBufferLen(a) = “,StringBufferLen(a),
”  StringLen(a) = “,StringLen(a));
}

int  StringCompare(
const string&  string1,                 // 比較される1 番目の文字列
const string&  string2,                 // 比較される2 番目の文字列
bool          case_sensitive=true      // 比較時の大文字と小文字の区別モードの選択
);

void OnStart()
{
//— apple と home を比較する
string s1=”Apple“;
string s2=”home“;

//— 大文字と小文字を区別して比較する
int result1=StringCompare(s1,s2);
if(result1>0) PrintFormat(“Case sensitive comparison: %s > %s“,s1,s2);
else
{
if(result1<0)PrintFormat(“Case sensitive comparison: %s < %s“,s1,s2);
else PrintFormat(“Case sensitive comparison: %s = %s“,s1,s2);
}

//— 大文字と小文字を区別しないで比較する
int result2=StringCompare(s1,s2,false);
if(result2>0) PrintFormat(“Case insensitive comparison: %s > %s“,s1,s2);
else
{
if(result2<0)PrintFormat(“Case insensitive comparison: %s < %s“,s1,s2);
else PrintFormat(“Case insensitive comparison: %s = %s“,s1,s2);
}
/* 結果:
    Case-sensitive comparison: Apple < home
    Case insensitive comparison: Apple < home
*/
}

int  StringConcatenate(
string&  string_var,  // 形成する文字列
void argument1       // 任意の基本データ型を持つ1 番目のパラメータ
  void argument2        // 任意の基本データ型を持つ2 番目のパラメータe
  …                    // 任意の基本データ型を持つ次のパラメータ
);

bool  StringFill(
string&  string_var,      // 書き込みされる文字列
ushort    character        // 書き込みに使用されるシンボル
);

void OnStart()
{
string str;
StringInit(str,20,’_’);
Print(“str = “,str);
StringFill(str,0);
Print(“str = “,str,“: StringBufferLen(str) = “, StringBufferLen(str));
}
// 結果
//   str = ____________________
//   str =  : StringBufferLen(str) = 20
//

int  StringFind(
string  string_value,        // 検索が行われる文字列
string  match_substring,    // 検索される文字列
int    start_pos=0          // 検索開始位置
);

ushort  StringGetCharacter(
string  string_value,    // 文字列
int    pos              // 文字列内でのシンボルの位置
);

bool  StringInit(
string&  string_var,      // 初期化される文字列
int      new_len=0,        // 初期化後の必要な文字列の長さ
ushort    character=0      // 初期化に使用されるシンボル
);

void OnStart()
{
//—
string str;
StringInit(str,200,0);
Print(“str = “,str,“: StringBufferLen(str) = “,
StringBufferLen(str),”  StringLen(str) = “,StringLen(str));
}
/*  結果
str = : StringBufferLen(str) = 200   StringLen(str) = 0
*/

int  StringLen(
string  string_value      // 文字列
);

bool  StringSetLength(
string&    string_var,      // 文字列
uint       new_length       // 新しい文字列の長さ
);

int  StringReplace(
string&        str,              // 部分文字列が書き込まれる文字列
const string   find,            // 検索された部分文字列
const string    replacement      // 見つかった位置に挿入される部分文字列
);

string text=“The quick brown fox jumped over the lazy dog.”;
int replaced=StringReplace(text,“quick”,“slow”);
replaced+=StringReplace(text,“brown”,“black”);
replaced+=StringReplace(text,“fox”,“bear”);
Print(“Replaced: “, replaced,“. Result=”,text);

//  結果
//  Replaced: 3. Result=The slow black bear jumped over the lazy dog.
//

bool  StringReserve(
string&    string_var,      // 文字列
uint       new_capacity     // 文字列を格納するバッファのサイズ
);

void OnStart()
{
string s;
//— StringReserveを使わずに動作速度を確認する
ulong t0=GetMicrosecondCount();
for(int i=0; i< 1024; i++)
s+=” “+(string)i;
ulong msc_no_reserve=GetMicrosecondCount()-t0;
s=NULL;
//— StringReserveを使用して同じことをする
StringReserve(s,1024 * 3);
t0=GetMicrosecondCount();
for(int i=0; i< 1024; i++)
s+=” “+(string)i;
ulong msc_reserve=GetMicrosecondCount()-t0;
//— 時刻を確認する
Print(“Test with StringReserve passed for “+(string)msc_reserve+” msc”);
Print(“Test without StringReserve passed for “+(string)msc_no_reserve+” msc”);
/* 結果:
Test with StringReserve passed for 50 msc
Test without StringReserve passed for 121 msc
*/
}

bool  StringSetCharacter(
string&   string_var,      // 文字列
int      pos,              // 位置
ushort    character        // 文字
);

void OnStart()
{
string str=“0123456789”;
Print(“before: str = “,str,“,StringBufferLen(str) = “,
StringBufferLen(str),”  StringLen(str) = “,StringLen(str));
//— 真ん中にゼロ値を追加する
StringSetCharacter(str,6,0);
Print(“after: str = “,str,“,StringBufferLen(str) = “,
StringBufferLen(str),”  StringLen(str) = “,StringLen(str));
//— 終わりにシンボルを追加する
int size=StringLen(str);
StringSetCharacter(str,size,’+’);
Print(“addition: str = “,str,“,StringBufferLen(str) = “,
StringBufferLen(str),”  StringLen(str) = “,StringLen(str));
}
/* 結果
before: str = 0123456789 ,StringBufferLen(str) = 0   StringLen(str) = 10
after: str = 012345 ,StringBufferLen(str) = 16   StringLen(str) = 6
addition: str = 012345+ ,StringBufferLen(str) = 16   StringLen(str) = 7
*/

int  StringSplit(
const string   string_value,      // 検索の行われる文字列
const ushort  separator,          // 区切り文字
string        & result[]          // 見つかった部分文字列を受け取るための参照で渡された配列
);

string to_split=“_life_is_good_”; // 部分文字列に分ける文字列
string sep=“_”;               // 区切り文字
ushort u_sep;                 // 区切り文字のコード
string result[];               // 文字列を受け取る配列
//— 区切り文字のコードを取得する
u_sep=StringGetCharacter(sep,0);
//— 文字列を部分文字列に分ける
int k=StringSplit(to_split,u_sep,result);
//— コメントを表示する
PrintFormat(“Strings obtained: %d. Used separator ‘%s’ with the code %d”,k,sep,u_sep);
//— 取得された文字列を全て出力する
if(k>0)
{
for(int i=0;i<k;i++)
{
PrintFormat(“result[%d]=\”%s\””,i,result[i]);
}
}

string  StringSubstr(
string  string_value,    // 文字列
int    start_pos,        // 開始位置
int    length=-1        // 抽出された文字列の長さ
);

bool  StringToLower(
string&  string_var      // 処理される文字列
);

bool  StringToUpper(
string&  string_var      // 処理される文字列
);

int  StringTrimLeft(
string&  string_var      // 切られる文字列
);

int  StringTrimRight(
string&  string_var      // 切られる文字列
);