Wide Studio Object Reference

Wide Studio Home
Up to


クラスの型

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)
機能
文字列を追加します。
処理
引数
(in)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);
機能
代入オペレータです。
処理
引数
(in)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);
機能
文字列追加オペレータです。
処理
引数
(in)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);
機能
文字列追加オペレータです。
処理
引数
(in)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);
機能
文字列合成オペレータです。
処理
引数
(in)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