 | | Wide Studio Object Reference
| |
クラスの型
WSCstring
メソッド関数仕様
WSCstring 関数の説明
- 書式
- WSCstring()
- 機能
- 文字列クラスのコンストラクタです。
文字列クラスのインスタンスを一つ作成します。
- 処理
-
- 引数
- なし。
- 返値
- 文字列クラスのインスタンスへのポインタ
- 注意
-
- サンプル
-
WSCstring str;
str = "文字列";
printf("str=%s\n",(char*)str);
WSCstring 関数の説明
- 書式
- WSCstring(char* str,long encoding = WS_EN_DEFAULT)
- 機能
- 文字列クラスのコンストラクタです。
- 処理
- 文字列とその文字列のエンコーディングを指定します。
- 引数
-
(in)char* str | 文字列 |
(in)long encoding | 文字列のエンコーディング |
エンコーディングに指定できる値には、
次のようなものがあります。省略すると WS_EN_DEFAULT
が指定されます。
属性値 | 意味 |
WS_EN_DEFAULT | 現在の設定を指定(省略時の値) |
WS_EN_LOCALE | 現在の LANG 環境変数の設定を指定 |
WS_EN_NONE | 設定を行わない |
WS_EN_ISO8859_1 | ISO8859(1) を指定 |
WS_EN_ISO8859_2 | ISO8859(2) を指定 |
WS_EN_ISO8859_3 | ISO8859(3) を指定 |
WS_EN_ISO8859_4 | ISO8859(4) を指定 |
WS_EN_ISO8859_5 | ISO8859(5) を指定 |
WS_EN_ISO8859_6 | ISO8859(6) を指定 |
WS_EN_ISO8859_7 | ISO8859(7) を指定 |
WS_EN_ISO8859_8 | ISO8859(8) を指定 |
WS_EN_ISO8859_9 | ISO8859(9) を指定 |
WS_EN_ISO8859_10 | ISO8859(10) を指定 |
WS_EN_ISO8859_11 | ISO8859(11) を指定 |
WS_EN_ISO8859_12 | ISO8859(12) を指定 |
WS_EN_ISO8859_13 | ISO8859(13) を指定 |
WS_EN_ISO8859_14 | ISO8859(14) を指定 |
WS_EN_ISO8859_15 | ISO8859(15) を指定 |
WS_EN_UTF8 | UTF8 を指定 |
WS_EN_KOI8R | KOI8R を指定 |
WS_EN_EUCJP | EUCJP を指定 |
WS_EN_SJIS | SJIS を指定 |
WS_EN_EUCKR | EUCKR を指定 |
WS_EN_EUCCN | EUCCN を指定 |
WS_EN_BIG5 | BIG5 を指定 |
- 返値
- 文字列クラスのインスタンスへのポインタ
- 注意
-
- サンプル
-
//EUCJP コードで文字列を設定する場合
WSCstring str("文字列",WS_EN_EUCJP);
printf("str=%s\n",(char*)str);
WSCstring 関数の説明
- 書式
- WSCstring(WSCstring& str)
- 機能
- 文字列クラスのコピーコンストラクタです。
文字列クラスのインスタンスを一つ作成します。
- 処理
-
- 引数
-
(in)WSCstring& str | 文字列インスタンス |
- 返値
- 文字列クラスのインスタンスへのポインタ
- 注意
-
- サンプル
-
WSCstring str("文字列");
WSCstring str2 = str;
printf("str2=%s\n",(char*)str2);
setString 関数の説明
- 書式
- void setString(char* str,long encode = WS_EN_DEFAULT)
- 機能
- 文字列を設定します。
- 処理
-
- 引数
-
(in)char* str | 文字列 |
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str;
str.setString("文字列",WS_EN_EUCJP);
printf("str=%s\n",(char*)str);
getString 関数の説明
- 書式
- char* getString(long encode = WS_EN_DEFAULT)
- 機能
- 文字列を取得します。
- 処理
-
- 引数
-
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- 指定されたエンコーディングの文字列
- 注意
- 返された文字列を解放してはなりません。
- サンプル
-
WSCstring str;
str.setString("文字列",WS_EN_EUCJP);
printf("str=%s\n",str.getString());
getChars 関数の説明
- 書式
- long getChars()
- 機能
- 現在設定されている文字列のキャラクタ数を取得します。
- 処理
-
- 引数
- なし。
- 返値
- 文字列のキャラクタ数
- 注意
-
- サンプル
-
WSCstring str;
str.setString("文字列",WS_EN_EUCJP);
printf("str=%d\n",str.getChars()); //3 が返されます。
getEncoding 関数の説明
- 書式
- long getEncoding()
- 機能
- 現在設定されている文字列のエンコーディングを取得します。
- 処理
-
- 引数
- なし。
- 返値
- エンコーディング
返されるエンコーディングの種類は、
WSCstring(char*,long) を参照ください。
- サンプル
-
WSCstring str;
str.setString("文字列",WS_EN_EUCJP);
printf("encoding=%d\n",str.getEncoding()); //WS_EN_EUCJP = 20 が返されます。
- 注意
-
isExist 関数の説明
- 書式
- long isExist(char* str,long encoding = WS_EN_DEFAULT)
- 機能
- 文字列を検索します。
- 処理
-
- 引数
-
(in)char* str | 文字列 |
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- キャラクタ数による存在した位置、存在しなかった場合は、-1。
- 注意
-
- サンプル
-
if (str.isExist("文字") == -1){
//"文字"が存在しなかった場合
}else{
//"文字"が存在した場合
}
addString 関数の説明
- 書式
- void addString(const WSCstring& str)
- 機能
- 文字列を追加します。
- 処理
-
- 引数
-
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列");
WSCstring str2("追加");
str.addString(str2);
printf("str=%s\n",(char*)str); //"文字列追加"が表示されます。
addString 関数の説明
- 書式
- void addString(const WSCvariant& str,long encoding=WS_EN_DEFAULT)
- 機能
- 文字列を追加します。
- 処理
-
- 引数
-
(in)WSCvariant& str | 文字列 |
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
WSCvariant val;
val = "追加";
str.addString(val,WS_EN_EUCJP);
printf("str=%s\n",(char*)str); //"文字列追加"が表示されます。
addString 関数の説明
- 書式
- void addString(char* str,long encoding=WS_EN_DEFAULT)
- 機能
- 文字列を追加します。
- 処理
-
- 引数
-
(in)cha* str | 文字列 |
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
str.addString("追加",WS_EN_EUCJP);
printf("str=%s\n",(char*)str); //"文字列追加"が表示されます。
cutString 関数の説明
- 書式
- void cutString(WSCulong pos);
- 機能
- 指定されたキャラクタ位置以降の文字列を削除します。
- 処理
-
- 引数
-
(in)WSCulong pos | 先頭を 0 としたカットしたい文字の位置 |
0 を指定すると、文字列を全て削除します。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
str.cutString(2);
printf("str=%s\n",(char*)str); //"文字"が表示されます。
insertString 関数の説明
- 書式
- void insertString(WSCulong pos,WSCstring& str);
- 機能
- 指定されたキャラクタ位置に文字列を挿入します。
- 処理
-
- 引数
-
(in)WSCulong pos | 先頭を 0 とした挿入したい文字の位置 |
(in)WSCstring& str | 文字列 |
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
WSCstring str2("挿入",WS_EN_EUCJP);
str.insertString(0,str2);
printf("str=%s\n",(char*)str); //"挿入文字列"が表示されます。
deleteChar 関数の説明
- 書式
- void deleteChar(WSCulong pos)
- 機能
- 指定されたキャラクタ位置の1文字を削除します。
- 処理
-
- 引数
-
(in)WSCulong pos | 先頭を 0 としたカットしたい文字の位置 |
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
str.deleteChar(2);
printf("str=%s\n",(char*)str); //"文字"が表示されます。
deleteChars 関数の説明
- 書式
- void deleteChars(WSCulong pos,WSCulong len)
- 機能
- 指定されたキャラクタ位置の文字列を削除します。
- 処理
-
- 引数
-
(in)WSCulong pos | 先頭を 0 としたカットしたい文字の位置 |
(in)WSCulong len | 削除したい文字の数 |
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
str.deleteChars(2,1);
printf("str=%s\n",(char*)str); //"文字"が表示されます。
clear 関数の説明
- 書式
- void clear()
- 機能
- 文字列をクリアします。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列",WS_EN_EUCJP);
//設定された文字列をクリアするには、次のようにします。
str.clear();
delLineFeed 関数の説明
- 書式
- void delLineFeed()
- 機能
- 文字列中の改行文字を削除します。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列\n改行",WS_EN_EUCJP);
str.delLineFeed();
printf("str=%s\n",(char*)str); //"文字列改行"が表示されます。
delString 関数の説明
- 書式
- void delString(char* str,lon num,long encoding = WS_EN_DEFAULT)
- 機能
- 指定された文字列を指定された個数分、検索して削除します。
削除する個数に 0 を指定すると、
一致した文字列を全て削除します。
- 処理
-
- 引数
-
(in)char* str | 削除したい文字列 |
(in)long num | 削除する個数 |
(in)long encoding | エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("文字列1文字列2文字列",WS_EN_EUCJP);
str.deleteString("文字列",1,WS_EN_EUCJP);
printf("str=%s\n",(char*)str); //"1文字列2文字列"が表示されます。
str.deleteString("文字列",0,WS_EN_EUCJP);
printf("str=%s\n",(char*)str); //"12"が表示されます。
delHeadSpace 関数の説明
- 書式
- void delHeadSpace();
- 機能
- 文字列の先頭にある半角スペースをカットします。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str(" 文字列",WS_EN_EUCJP);
str.delHeadSpace();
printf("str=%s\n",(char*)str); //"文字列"が表示されます。
to_upper 関数の説明
- 書式
- void to_upper();
- 機能
- 英字文字列を大文字に変換します。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("abcABC");
str.to_upper();
printf("str=%s\n",(char*)str); //"ABCABC"が表示されます。
to_lower 関数の説明
- 書式
- void to_lower();
- 機能
- 英字文字列を小文字に変換します。
- 処理
-
- 引数
- なし。
- 返値
- なし。
- 注意
-
- サンプル
-
WSCstring str("abcABC");
str.to_lower();
printf("str=%s\n",(char*)str); //"abcabc"が表示されます。
replaceString 関数の説明
- 書式
- long replaceString(char* src,char* dest,long num,long encoding= WS_EN_DEFAULT)
- 機能
- 指定された文字列を置換します。
- 処理
- src で指定された文字列を、dest で指定された文字列に
変換します。
num で指定された数分だけ一致したものを置換します。
num が 0 の場合、一致するものすべてを置換します。
- 引数
-
(in)char* src | 置換前文字列 |
(in)char* dest | 置換後文字列 |
(in)long num | 置換個数 |
(in)long encoding | 文字列のエンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- 置換された数
- 注意
-
- サンプル
-
WSCstring str("abcabcabc");
str.replaceString("abc","123",1);
printf("str=%s\n",(char*)str); //"123abcabc"が表示されます。
str.replaceString("abc","123",0);
printf("str=%s\n",(char*)str); //"123123123"が表示されます。
getWords 関数の説明
- 書式
- long getWords(char* sep,long encoding = WS_EN_DEFAULT)
- 機能
- sep で指定された文字列で区切られたワード数を取得します。
sep と encoding を省略すると、空白で区切られたワード数を
取得します。、
- 処理
-
- 引数
-
(in)char* sep | 区切り文字列 |
(in)long encoding | 文字列エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- 置換された数
- 注意
-
- サンプル
-
WSCstring str("ABC,abc,123");
long words = str.getWords(","); //3 が返されます。
long i;
for(i=0; i < words; i++){
WSCstring word = str.getWord(i,",");
long wordpos = str.getWordPos(i,",");
printf("word%d=%s\n",i,(char*)word); //ABC、abc、123 が順番に表示されます。
printf(" pos=%d\n",wordpos); //ABC、abc、123 の位置が表示されます。
}
getWordCharPos 関数の説明
- 書式
- long getWordCharPos(long no,char* sep,long encoding = WS_EN_DEFAULT)
- 機能
- sep で指定された文字列で区切られたワードで
先頭を 0 とした no 番目のワードの文字数位置を取得します。
sep と encoding を省略すると、空白で区切られたワードの位置を
取得します。、
- 処理
-
- 引数
-
(in)long no | ワード番号(0,1,2〜) |
(in)char* sep | 区切り文字列 |
(in)long encoding | 文字列のエンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- 指定されたワードの位置
- 注意
-
- サンプル
- getWords() を参照してください。
getWord 関数の説明
- 書式
- WSCstring getWord(long no,char* sep,long encoding = WS_EN_DEFAULT)
- 機能
- sep で指定された文字列で区切られたワードで
先頭を 0 とした no 番目のワードを取得します。
sep と encoding を省略すると、空白で区切られた
ワードを取得します。
- 処理
-
- 引数
-
(in)long no | ワード番号(0,1,2〜) |
(in)char* sep | 区切り文字列 |
(in)long encoding | 文字列エンコーディング |
エンコーディングは、
省略すると WS_EN_DEFAULTが指定されます。
指定できるエンコーディングは、WSCstring(char*,long) を
参照ください。
- 返値
- 指定されたワード
- 注意
-
- サンプル
- getWords() を参照してください。
getLines 関数の説明
- 書式
- long getLines()
- 機能
- 行数を取得します。
- 処理
-
- 引数
- なし。
- 返値
- 行数
- 注意
-
- サンプル
-
WSCstring str("abc\nabc\nabc");
long lines = str.getLines(); //3 が返されます。
= オペレータの説明
- 書式
- WSCstring& operator = (const WSCstring& str);
- 機能
- 代入オペレータです。
- 処理
-
- 引数
-
(in)WSCstring& str | 代入したい文字列 |
- 返値
- 複写された文字列
- 注意
-
- サンプル
-
WSCstring str;
WSCstring str2("abc");
str = str2;
= オペレータの説明
- 書式
- WSCstring& operator = (char* str);
- 機能
- 代入オペレータです。
- 処理
-
- 引数
-
- 返値
- 複写された文字列
- 注意
-
- サンプル
-
WSCstring str;
str = "abc"; //代入
= オペレータの説明
- 書式
- WSCstring& operator = (const WSCvariant& str);
- 機能
- 代入オペレータです。
- 処理
-
- 引数
-
(in)WSCvariant& str | 代入したいデータ |
- 返値
- 複写された文字列
- 注意
-
- サンプル
-
WSCvariant str("abc");
WSCstring str2;
str2 = str; //WSCvarinat の代入
+= オペレータの説明
- 書式
- WSCstring& operator += (const WSCstring& str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
(in)WSCstring& str | 追加したい文字列 |
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCstring str2("ABC");
str += str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
+= オペレータの説明
- 書式
- WSCstring& operator += (char* str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
char* str2 = "ABC";
str += str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
+= オペレータの説明
- 書式
- WSCstring& operator += (const WSCvariant& str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
(in)WSCvariant& str | 追加したいデータ |
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCvariant str2;
str2 = "ABC";
str += str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
<< オペレータの説明
- 書式
- WSCstring& operator << (const WSCstring& str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
(in)WSCstring& str | 追加したい文字列 |
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCstring str2("ABC");
str << str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
<< オペレータの説明
- 書式
- WSCstring& operator << (char* str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
char* str2 = "ABC";
str << str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
<< オペレータの説明
- 書式
- WSCstring& operator << (const WSCvariant& str);
- 機能
- 文字列追加オペレータです。
- 処理
-
- 引数
-
(in)WSCvariant& str | 追加したいデータ |
- 返値
- 追加された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCvariant str2;
str2 = "ABC";
str << str2;
printf("str=%s\n",(char*)str); //"abcABC" が表示されます。
+ オペレータの説明
- 書式
- WSCstring& operator + (const WSCstring& str);
- 機能
- 文字列合成オペレータです。
- 処理
-
- 引数
-
(in)WSCstring& str | 追加したい文字列 |
- 返値
- 合成された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCstring str2("ABC");
WSCstring str3;
str3 = str + str2;
printf("str3=%s\n",(char*)str3); //"abcABC" が表示されます。
+ オペレータの説明
- 書式
- WSCstring& operator + (char* str);
- 機能
- 文字列合成オペレータです。
- 処理
-
- 引数
-
- 返値
- 合成された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
char* str2 = "ABC";
WSCstring str3;
str3 = str + str2;
printf("str3=%s\n",(char*)str3); //"abcABC" が表示されます。
+ オペレータの説明
- 書式
- WSCstring& operator + (const WSCvariant& str);
- 機能
- 文字列合成オペレータです。
- 処理
-
- 引数
-
(in)WSCvariant& str | 追加したいデータ |
- 返値
- 合成された文字列
- 注意
-
- サンプル
-
WSCstring str("abc");
WSCvariant str2;
str2 = "ABC";
WSCstring str3;
str3 = str + str2;
printf("str3=%s\n",(char*)str3); //"abcABC" が表示されます。
Document Release 3.20 For Use with Wide Studio Release 3.20, Winter 2002 WideStudio Home | Up to Copyright(C) T. Hirabayashi, 1999-2002 | | Last modified: Nov. 28, 2002 | |