string

文字列型は、テキストを一連のUTF-16文字のリストとして表現します。

定義

名前空間:Alice / アセンブリ : Losetta.dll / サポート: AliceScript1

文字列型は結合、比較、等値、加算演算子をサポートしています。 文字列型の規定値は空の文字列""です。また、この型の型指定修飾子はstringです。

すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。

namespace Alice;
public class string;

説明

文字列は、テキストを表すために使用される文字の配列とみなすことができます。メモリ内のstring型の最大サイズは2GB、つまりおよそ10億文字です。

文字列型の変数を定義する

文字列型は次の方法で初期化されます。

• 変数に文字列リテラルを割り当てる。これは文字列を作成するためにもっとも一般的に使用される方法です。次の例では、代入を使用して文字列を定義しています。

var str = "Hello,World";

• 文字列連結演算子（+）を使用して、文字列リテラル同士を結合する。次の例では、文字列リテラル同士を+や+=演算子を使用して結合しています。

var str = "Hello," + "World";
str += "!";
print(str);

• 複合書式指定を使用するか、ToStringメソッドを呼び出して変数を文字列に変換する。次の例では、数値型に対してToString()メソッドを呼び出すことで文字列を生成しています。

var a = 1;
var str = a.ToString();

文字列リテラル

プログラム内で文字列を定義するには、文字列リテラルを使用します。文字列リテラルは通常、ダブルクオーテーション（"）で囲まれています。この種の文字列リテラルの宣言中に改行やコメントを挟むことはできません。次に例を示します。

var str = "Hello,World";

文字列リテラル内で特殊文字を使用するには、エスケープ文字を使用します。 エスケープ文字は、以下のような用途で使用します。

• ""内で"を書くなど、直接使用できない記号を書く
• 改行文字やタブ文字など、不可視文字を見える形で書く

AliceScriptのエスケープ文字は\（バックスラッシュ、日本語環境では¥と表示されることもある）で始まる1～8つの英数字で表記します。エスケープ文字では、大文字と小文字を区別し、認識できないエスケープ文字を見つけた場合はUNKNOWN_ESCAPE_CHARエラーが発生します。

次に、エスケープ文字とその意味を示します。

また、\u0000のように指定することで4バイトUnicode文字コードを表現できます。

さらに、\U00000000のように指定することで8バイトUnicode文字コードも表現可能です。

文字列と文字

文字列内の各文字は、内部的にはUnicodeコードポイントのスカラー（数値）として扱われています。実際、string.foreachメソッドを使用すると文字列をひとつひとつの文字を含む文字列に変換することができ、string.lengthプロパティを呼び出すと、文字列内に含まれる文字の個数を取得できます。

通常、ひとつの要素はひとつの文字を表します。つまり、string.lengthの値は文字列内に含まれる文字の個数と等しくなります。しかし、特殊な文字の中には複数の要素が必要になる場合があります。（これをサロゲートペアと呼びます）この場合、string.lengthの値は必ずしも文字列内に含まれる文字の個数と一致するとは限りません。

文字列とUnicode標準

文字列の扱いはSAIMの各実装に依存するため、各実装のバージョンあるいはCLRによって対応するUnicodeのバージョンが異なる可能性があります。

次の表は、AliceScriptの各実装と準拠するUnicodeのバージョンを示します。

逐語的文字列リテラル

対応バージョン>=Alice3.0 逐語的文字列リテラルを使用すると、ダブルクオーテーション（"）などをエスケープ文字なしに表現できます。この形式で文字列を表現するには文字列をシングルクオーテーション（'）で囲みます。逐語的文字列リテラルではエスケープ文字を使用することはできません。次に例を示します。

var str = '"Hello",World'; // "Hello",World

var str = '"Hello",World'; // "Hello",World

生文字列リテラル

対応バージョン>=Alice2.1

生文字列リテラルを使用すると、さらに柔軟に文字列を表現できます。まず、この方式ではエスケープ文字は使用できません。さらに、宣言中の改行が許可されます。これは次のように宣言します。

var str ="""Hello,
"World"!"""

つまり、生文字列リテラルでは、文字列を必要な個数のダブルクオーテーション（"）で囲みます。ダブルクオーテーションは少なくとも3つ以上必要で、奇数個である必要があります。 また、このリテラル内ではそれ自体を囲むダブルクオーテーションの数を超えない限り、ダブルクオーテーションを連続して使用できます。つまり、""を表現するには""" "" """とすればできますし、"""を表現するには""""" """ """とすれば表現できます。

文字列補間

対応バージョン>=Alice3.0

ダブルクオーテーションのひとつ前に$特殊文字が存在する場合、SAIMは文字列リテラルを、補間式が含まれている可能性がある文字列補間リテラルとして認識します。文字列補間リテラルの補間式は、式の結果の文字列表現によって置換されます。

文字列補間によって、より読みやすく便利に文字列内に値や式を挿入できます。これは、複合書式指定よりも読みやすくなります。次の例では、複合書式指定と文字列補間の両方を使用して同じ結果を表示しています。これを比較してみてください。

var x = 2;
var y = 3;

//複合書式指定
print(string_format("{0} + {1} = {2}",x,y,(x+y)));
//文字列補間
print($"{x} + {y} = {x+y}");

文字列補間リテラルの構造

文字列リテラルを文字列補間リテラルとして識別するため、文字列の先頭に$の記号を追加する必要があります。複数の文字列補間リテラルを連結するには、$記号をそれぞれの文字列リテラルに追加します。

文字列補間リテラルには、逐語的文字列リテラルを使用できます。次に例を示します。

var x = 2;
var y = 3;

print($'"{x}" + "{y}" = "{x+y}"');//出力例: "2" + "3" = "5"

また、文字列補間リテラルには、生文字列リテラルも使用できます。次に例を示します。

var x = 2;
var y = 3;

print($"""
  {x}
+ {y}
-----
  {x+y}""");

この例は次のように出力されます。

  2
+ 3
-----
  5

文字列補間リテラルで{や}文字を表現したい場合はその文字の直前に\バックスラッシュを追加して文字をエスケープします。これは、逐語的文字列リテラルや生文字列リテラルでも同様です。 次に例を示します。

var x = 2;
var y = 3;

print($"\{{x}\} + \{{y}\} = \{{x+y}\}");//出力例: {2} + {3} = {5}

セキュリティ上の懸念事項

複合書式指定や純粋な文字列連結と同様に、文字列補間はSQLインジェクションなどのセキュリティ上の問題を起こしうることがあります。以下に、SQLインジェクションを起こす文字列補間の例を示します。

var query = $"SELECT * FROM Table WHERE id='{id}'";

このような半完成のSQL文があるとき、idが"'; DELETE FROM Table; SELECT * FROM Table WHERE id='"と入力された場合、このクエリを実行するとテーブルのすべてのデータが削除されます。

プロパティ

メソッド