コンテンツにスキップ

文字列(string)

文字列の取り扱い

string は、文字列を表現する組み込み型です。

"Vket Cloud" のように、ダブルクォーテーション「"」で囲まれた文字列は string 型として扱われます。

string は、文字列データを内部的に UTF-8 のバイト列として保持しています。文字列としての長さを取得する場合は Length() メソッドを、バイト列そのものの長さを取得するには LengthByte() を使用します。

変更可能な文字列

HeliScriptの string は変更可能です。"[]" のインデックス指定による書き換えや、Append() といったメソッドで、文字列の内容を書き換えることができます。

caution

現バージョンにおいて、文字列にアポストロフィ / シングルクォート( ' ' , U+0027)を含めると動作が停止するエラーが確認されております。
恐れ入りますが、文字列では同記号の使用を避けるようお願い致します。

stringのメソッド

ToInt()

public int ToInt()

文字列を整数値に変換します。変換に失敗した場合は 0 を返します。

ToFloat()

public float ToFloat()

文字列を浮動小数点数値に変換します。変換に失敗した場合は 0 を返します。

Length()

public int Length()

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

LengthByte()

public int LengthByte()

文字列を表現する、UTF-8 配列のバイト数を返します。

IsEmpty()

public bool IsEmpty()

文字列が空の場合は true を、そうでない場合は false を返します。

IndexOf(string)

public int IndexOf(string value)

引数で指定した文字列を検索し、見つかった場合はその文字列が最初に現れる位置を返します。検索対象の文字が見つからなかった場合は -1 を返します。

SubString(int, int)

public string SubString(int startIndex, int length)

文字列中の開始位置と長さを指定し、部分文字列を生成します。

Append(int)

public void Append(int value)

引数で指定した文字を、現在の文字列の末尾に追加します。

RemoveLast()

public void RemoveLast()

文字列の最後の1文字を削除します。

RemoveAt(int)

public void RemoveAt(int index)

引数で指定した位置の文字を、1文字削除します。

Replace(string, string)

public string Replace(string from, string to)

文字列中の部分文字列fromをすべて文字列toに置換します。

Split()

public list<string> Split()

空白文字で文字列を分割し、結果を文字列のリストとして返します。

空白文字に該当するのは以下の値です。

  • 空白 (0x20, ' ')
  • フォームフィード (0x0c, '\f')
  • ラインフィード (0x0a, '\n')
  • キャリッジリターン (0x0d, '\r')
  • 水平タブ (0x09, '\t')
  • 垂直タブ (0x0b, '\v')

Split(int)

public list<string> Split(int opt)

空白文字で文字列を分割し、結果を文字列のリストとして返します。

引数にオプション値を渡すことで、分割時の挙動を変更できます。

Split(string)

list<string> Split(string separator)

引数 separator によって文字列を分割し、結果を文字列のリストとして返します。

Split(string, int)

list<string> Split(string separator, int opt)

引数 separator によって文字列を分割し、結果を文字列のリストとして返します。

引数にオプション値を渡すことで、分割時の挙動を変更できます。

分割オプション

SplitOpt_None

const int SplitOpt_None = 0;

オプションとして何も行わない。

SplitOpt_RemoveEmpty

const int SplitOpt_RemoveEmpty = 1;

分割後の文字列に空文字が含まれる場合、それを破棄する。

SplitOpt_Trim

const int SplitOpt_Trim = 2;

分割後の文字列の前後に空白が存在する場合、それらをトリムする。

SplitOpt_RemoveAll

const int SplitOpt_RemoveAll = SplitOpt_RemoveEmpty | SplitOpt_Trim;

分割オプションの SplitOpt_RemoveEmpty と SplitOpt_Trim を組み合わせた値。

特殊な演算子

[ ] 演算子

文字列中の指定した位置にある文字を、int値として取得します。指定した位置への代入も可能です。

string text = "Hello!";

// 'H' を取得
int part = text[0];

// "Hello!" を "Hello?" に書き換える
text[text.Length() - 1] = '?';

+ 演算子

文字列を連結し、新しい文字列を生成します。

string text = "Vket";

// "VketCloud" を生成
string vketcloud = text + "Cloud";

// +=演算子で文字列そのものを置き換える
text += "Cloud";

% 演算子

一定の書式に沿ったテンプレート文字列に対し、引数として与えた多様な型の値を当てはめ、新たな文字列を生成します。

以下のサンプルコードのように、数値を文字列に変換することも可能です。 

int n;
string s;

s = "%d" % n;

文字列中に、"%" で始まる書式文字列を配置することで、% 演算子の引数を順番に適用します。

  • %d
  • 整数値を表現する書式指定子です。
  • %f
  • 浮動小数点数を表現する書式指定子です。
  • %s
  • 文字列を表現する書式指定子です。
// 1 + 1 = 2
int answer = 2;
hsSystemOutput("1 + 1 = %d\n" % answer);

// VketCloud hello world!
string hello  = "hello world!";
hsSystemOutput("VketCloud %s\n" % hello);

// "int value = myArray[99];"
hsSystemOutput("int %s = %s[%d];\n" % "value" % "myArray" % 99);
Feedback