string型
文字列型は、テキストを一連のUTF-16文字のリストとして表現します。
定義
名前空間: Alice
アセンブリ: Losetta.dll
文字列型は、関係演算子と文字列演算子をサポートしています。 文字列型の既定値は空の文字列""
です。また、この型の型指定修飾子はstring
です。
すべてのAliceScriptに組み込まれている型はすべて文字列型への暗黙的な変換をサポートしています。文字列型に限って、明示的な変換と明示的な変換は同じ動作になります。
対応 | |
---|---|
AliceScript | RC1、RC2、GM、2.0、2.1、2.2、2.3、3.0 |
AliceSister | GM、2.0、2.1、2.2、2.3、3.0 |
Losetta | 0.8、0.9、0.10 |
説明
文字列は、テキストを表すために使用される文字の配列とみなすことができます。メモリ内のstring
型の最大サイズは2GB、つまりおよそ10億文字です。
文字列型の変数を定義する
文字列型は次の方法で初期化されます。
- 変数に文字列リテラルを割り当てる。これは文字列を作成するためにもっとも一般的に使用される方法です。次の例では、代入を使用して文字列を定義しています。
- 文字列連結演算子(
+
)を使用して、文字列リテラル同士を結合する。次の例では、文字列リテラル同士を+
や+=
演算子を使用して結合しています。
- 文字列補間または複合書式指定を使用する。次の例では、文字列補間を使用して
a + b
の値を出力しています。
number a = 1;
number b = 2;
string str = $"{a} + {b} = {a + b}";
print(str);
// 出力: 1 + 2 = 3
- variable.ToStringメソッドを使用する。次の例では、数値型の変数
a
をToString
メソッドを使用して文字列に変換しています。
文字列リテラル
プログラム内で文字列を定義するには、文字列リテラルを使用します。文字列リテラルは通常、ダブルクオーテーション("
)で囲まれています。この種の文字列リテラルの宣言中に改行やコメントを挟むことはできません。次に例を示します。
文字列リテラル内で特殊文字を使用するには、エスケープ文字を使用します。 エスケープ文字は、以下のような用途で使用します。
""
内で"
を書くなど、直接使用できない記号を書く- 改行文字やタブ文字など、不可視文字を見える形で書く
AliceScriptのエスケープ文字は\
(バックスラッシュ、日本語環境では¥
と表示されることもある)で始まる1~8つの英数字で表記します。エスケープ文字では、大文字と小文字を区別し、認識できないエスケープ文字を見つけた場合はUNKNOWN_ESCAPE_CHARエラーが発生します。
次に、エスケープ文字とその意味を示します。
エスケープ文字 | Unicodeコードポイント | 説明 |
---|---|---|
\0 |
\u0000 |
ヌル文字 |
\a |
\u0007 |
ベル(警告)文字 |
\b |
\u0008 |
バックスペース |
\t |
\u0009 |
水平タブ |
\n |
\u000a |
ラインフィード |
\v |
\u000b |
垂直タブ |
\f |
\u000c |
フォームフィード |
\r |
\u000d |
キャリッジリターン |
\e |
\u001b |
エスケープ |
\\ |
\u005c |
バックスラッシュ |
\' |
\u0027 |
シングルクオーテーション |
\" |
\u0022 |
ダブルクオーテーション |
\u |
\uHHHH |
Unicodeコードポイント(4桁) |
\U |
\UHHHHHHHH |
Unicodeコードポイント(8桁) |
\x |
\UH[H][H][H] |
Unicodeコードポイント(任意桁) |
特殊文字とレンダリング
ここで示した文字に限らず、すべてのUnicode文字がレンダリングされるわけではありません。たとえば\a
は、レンダリングされず、コンソールに警告音を鳴らします。
文字列リテラル中で使用できない文字
\ufdd0
~\ufddf
の範囲にある文字は、SAIMが処理に使用することがあるため、文字列リテラル中で使用できません。
また、\u0000
のように指定することで4バイトUnicode文字コードを表現できます。
さらに、\U00000000
のように指定することで8バイトUnicode文字コードも表現可能です。
コラム: 改行
文字列の内部で改行したい場合が時々あります。文字列の中で改行するには、\r
や\n
、\r\n
のいずれか環境に応じたものを使用します。
元々\r\n
のそれぞれの文字は、タイプライターで別々の意味を表していました。
リテラル | 記号 | 読みかた | 意味 |
---|---|---|---|
\r |
CR | キャリッジリターン | タイプライターのキャレットを一番左に移動させる |
\n |
LF | ラインフィード | タイプライターのキャレットを一行下に移動させる |
タイプライターのEnterキーは、元々\r\n
(一番左に移動させた後下に移動させる)役割を持っていました。Windowsの改行コードが\r\n
(CRLF)であるのはこのためです。
しかし初期のコンピューターでは、改行に2バイトも使用している余裕はありませんでした。このため、Unixでは改行コードを\n
に、XeroxやClassic Mac OSでは改行コードを\r
としました。
話を戻すと、AliceScriptの文字列リテラルで改行を表すには、環境に応じて改行コードを書き換える必要があります。次の例をご覧ください。
これを回避するには、env_newLineを使用して、環境に応じて変化するようにします。 次の例をご覧ください。
文字列と文字
文字列内の各文字は、内部的にはUnicodeコードポイントのスカラー(数値)として扱われています。実際、string.foreach
メソッドを使用すると文字列をひとつひとつの文字を含む文字列に変換することができ、string.length
プロパティを呼び出すと、文字列内に含まれる文字の個数を取得できます。
通常、文字列をUTF-16で表現したひとつの要素はひとつの文字を表します。つまり、string.length
の値は文字列内に含まれる文字の個数と等しくなります。しかし、特殊な文字の中には複数の要素が必要になる場合があります。(これをサロゲートペアと呼びます)この場合、string.length
の値は必ずしも文字列内に含まれる文字の個数と一致するとは限りません。表示される文字の個数を取得するには、string.lengthInTextElementsを使用してください。
文字列とUnicode標準
文字列の扱いはSAIMの各実装に依存するため、各実装のバージョンあるいはCLRによって対応するUnicodeのバージョンが異なる可能性があります。
次の表は、AliceScriptの各実装と準拠するUnicodeのバージョンを示します。
実装の名前 | Unicode標準のバージョン |
---|---|
AliceScript | Unicode標準、バージョン11.0.0 |
AliceSister | Unicode標準、バージョン6.3.0 |
Losetta | Unicode標準、バージョン13.0.0 |
UTF-8文字列リテラル
対応バージョン>=Alice3.0
UTF-8文字列リテラルを使用することで、コード中で文字列をUTF-8データで表現できます。UTF-8リテラルは文字列の先頭にu8
をつけることで表現できます。このリテラルは文字列ではなくバイナリ型を表すことにご注意ください。次に例を示します。
逐語的文字列リテラル
対応バージョン>=Alice3.0
逐語的文字列リテラルを使用すると、ダブルクオーテーション("
)などをエスケープ文字なしに表現できます。この形式で文字列を表現するには文字列をシングルクオーテーション('
)で囲みます。逐語的文字列リテラルではエスケープ文字を使用することはできません。次に例を示します。
逐語的文字列リテラルを使用すると、ダブルクオーテーション("
)などをエスケープ文字なしに表現できます。この形式で文字列を表現するには文字列をシングルクオーテーション('
)で囲みます。逐語的文字列リテラルではエスケープ文字は、\\
と\'
のみ使用できます。次に例を示します。
cs title="AliceScript"
var str = '"Hello",World'; // "Hello",World
生文字列リテラル
対応バージョン>=Alice2.1
生文字列リテラルを使用すると、さらに柔軟に文字列を表現できます。まず、この方式ではエスケープ文字は使用できません。さらに、宣言中の改行が許可されます。これは次のように宣言します。
つまり、生文字列リテラルでは、文字列を必要な個数のダブルクオーテーション("
)で囲みます。ダブルクオーテーションは少なくとも3つ以上必要で、奇数個である必要があります。
また、このリテラル内ではそれ自体を囲むダブルクオーテーションの数を超えない限り、ダブルクオーテーションを連続して使用できます。つまり、""
を表現するには""" "" """
とすればできますし、"""
を表現するには""""" """ """
とすれば表現できます。
ダブルクオーテーションは奇数個
生文字列リテラルを囲むダブルクオーテーションは必ず奇数個を使用してください。たとえば、"""" "" """"
と表現するとインタプリタには5つの文字列リテラルと解釈されます。
文字列補間
対応バージョン>=Alice3.0
ダブルクオーテーションのひとつ前に$
特殊文字が存在する場合、SAIMは文字列リテラルを、補間式が含まれている可能性がある文字列補間リテラルとして認識します。文字列補間リテラルの補間式は、式の結果の文字列表現によって置換されます。
文字列補間によって、より読みやすく便利に文字列内に値や式を挿入できます。これは、複合書式指定よりも読みやすくなります。次の例では、複合書式指定と文字列補間の両方を使用して同じ結果を表示しています。これを比較してみてください。
var x = 2;
var y = 3;
//複合書式指定
print(string_format("{0} + {1} = {2}",x,y,(x+y)));
//文字列補間
print($"{x} + {y} = {x+y}");
文字列補間リテラルの構造
文字列リテラルを文字列補間リテラルとして識別するため、文字列の先頭に$
の記号を追加する必要があります。複数の文字列補間リテラルを連結するには、$
記号をそれぞれの文字列リテラルに追加します。
文字列補間リテラルには、逐語的文字列リテラルを使用できます。次に例を示します。
また、文字列補間リテラルには、生文字列リテラルも使用できます。次に例を示します。
この例は次のように出力されます。
文字列補間リテラルで{
や}
文字を表現したい場合はその文字の直前に\
バックスラッシュを追加して文字をエスケープします。これは、逐語的文字列リテラルや生文字列リテラルでも同様です。
次に例を示します。
セキュリティ上の懸念事項
複合書式指定や純粋な文字列連結と同様に、文字列補間はSQLインジェクションなどのセキュリティ上の問題を起こしうることがあります。以下に、SQLインジェクションを起こす文字列補間の例を示します。
このような半完成のSQL文があるとき、id
が"'; DELETE FROM Table; SELECT * FROM Table WHERE id='
"と入力された場合、このクエリを実行するとテーブルのすべてのデータが削除されます。
プロパティ
IsNormalized | 現在の文字列がUnicode正規形Cであるかを示す値を取得します |
Length | 現在の文字列の文字数を返します |
LengthInTextElements | 現在の文字列の文字要素の数を取得します |
メソッド
Chunk(number) | 現在の文字列を指定した文字数ごとに分割した配列を取得します。 |
CodePointAt(number) | 現在の文字列の指定した場所にある文字のUTF-16コードポイントを取得します。 |
CodePointAt(number,bool) | 現在の文字列の指定した場所にある文字のコードポイントを取得します。 |
CompareTo(string) | この文字列と指定した文字列を比較して、文字列を並べ替えたときにこの文字列が前にくるか、後ろにくるか、または同じであるかを表す整数を取得します。 |
CompareTo(string,bool) | 大文字と小文字を比較するかを指定した上でこの文字列と指定した文字列を比較して、文字列を並べ替えたときにこの文字列が前にくるか、後ろにくるか、または同じであるかを表す整数を取得します。 |
CompareTo(string,bool,bool) | 大文字と小文字を比較するかとカルチャを考慮するかを指定した上でこの文字列と指定した文字列を比較して、文字列を並べ替えたときにこの文字列が前にくるか、後ろにくるか、または同じであるかを表す整数を取得します。 |
CompareTo(string,bool,string) | 大文字と小文字を比較するかとカルチャの名前を指定した上でこの文字列と指定した文字列を比較して、文字列を並べ替えたときにこの文字列が前にくるか、後ろにくるか、または同じであるかを表す整数を取得します。 |
Contains(string) | 現在の文字列内に指定された文字列が存在するかを示す値を取得します。 |
Contains(string,bool) | 大文字小文字を区別するかを指定して、現在の文字列内に指定された文字列が存在するかを示す値を取得します。 |
Contains(string,bool,bool) | 大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列内に指定された文字列が存在するかを示す値を取得します。 |
EndsWith(string) | 現在の文字列が指定した文字列で終わるかどうかを判定します |
EndsWith(string,bool) | 大文字小文字を区別するかを指定して、現在の文字列が指定した文字列で終わるかどうかを判定します |
EndsWith(string,bool,bool) | 大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列が指定した文字列で終わるかどうかを判定します |
Equals(string) | カルチャと大文字小文字を区別してこの文字列と、指定した文字列が同一かどうかを判断します |
Equals(string,bool) | 大文字小文字を区別するかを指定して、この文字列と、指定した文字列が同一かどうかを判断します |
Equals(string,bool,bool) | 大文字小文字の区別と、現在のカルチャを考慮するかを指定して、この文字列と指定した文字列が同一かどうかを判断します |
Format(params variable) | 指定された値を使用して現在の文字列を複合書式指定子としてフォーマットした文字列を取得します |
GetBytes() | 現在の文字列に含まれるすべての文字をUTF-8文字コードのデータにエンコードします |
GetBytes(string) | 現在の文字列に含まれるすべての文字を指定された名前に対応する文字コードのデータにエンコードします |
GetBytes(number) | 現在の文字列に含まれるすべての文字を指定されたコードページに対応する文字コードのデータにエンコードします |
Indent(number,string) | 文字列を指定されたレベルで字下げした新しい文字列を取得します |
IndexOf(string,number) | 指定された文字列が現在の文字列内で最初に見つかった位置のインデックスを返します。検索は、指定されたインデックスから開始され、見つからなかった場合は-1を返します。 |
Insert(number,string) | 現在の文字列内の指定したインデックスにその値を挿入した文字列を取得します。 |
IsEmptyOrNull() | 現在の文字列が空か、あるいはnullであるかどうかを示す値を取得します |
IsEmptyOrWhiteSpace() | 現在の文字列が空か、あるいは空白文字のみであるかどうかを示す値を取得します |
Join(string,params string) | 指定された区切り文字を使用して文字を連結します |
LastIndexOf(string,number) | 指定された文字列が現在の文字列内で最後に見つかった位置のインデックスを返します |
Normalize() | 同じ文字を表すコードポイントのすべての並びを共通の正規化された形式に文字列を変換した新しい文字列を取得します |
PadCenter(number,bool,bool) | 指定された文字数になるまで両側に空白文字を埋め込むことで、この文字列を中央寄せした新しい文字列を作成します。 |
PadCenter(number,string,bool,bool) | 指定された文字数になるまで両側に指定された文字を埋め込むことで、この文字列を中央寄せした新しい文字列を作成します。 |
PadLeft(number) | 指定された文字数になるまで右側に空白文字を埋め込むことで、この文字列を左寄せした新しい文字列を取得します。 |
PadLeft(number,bool) | 指定された文字数になるまで右側に空白文字を埋め込むことで、この文字列を左寄せした新しい文字列を取得します。 |
PadLeft(number,string,bool) | 指定した文字数になるまで右側に指定した文字を埋め込み、必要に応じて切り詰めることで、指定した文字数内でこの文字列を左寄せした新しい文字列を取得します。 |
PadRight(number) | 指定された文字数になるまで左側に空白文字を埋め込むことで、この文字列を右寄せした新しい文字列を取得します。 |
PadRight(number,bool) | 指定された文字数になるまで左側に空白文字を埋め込むことで、この文字列を右寄せした新しい文字列を取得します。 |
PadRight(number,string,bool) | 指定した文字数になるまで左側に指定した文字を埋め込み、必要に応じて切り詰めることで、指定した文字数内でこの文字列を右寄せした新しい文字列を取得します。 |
Remove(params string) | 現在の文字列から指定された値を削除した文字列を取得します。 |
RemoveAt(number) | 現在の文字列の指定したインデックスにある値を削除した文字列を取得します |
Repeat(number) | 現在の文字列を指定回数繰り返した文字列を取得します |
Replace(string,string) | 現在の文字列内に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。 |
Replace(string,string,number,number) | 現在の文字列内の指定した範囲に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。 |
Replace(string,string,bool) | 指定した一致ルールを使用して、現在の文字列内に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。 |
Replace(string,string,bool,bool) | 指定した一致ルールを使用して、現在の文字列内の指定した範囲に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。 |
ReplaceLineEndings() | 現在の文字列中のすべての改行文字を現在の環境の改行文字に置換します。 |
ReplaceLineEndings(string) | 現在の文字列中のすべての改行文字を指定した文字列に置換します。 |
Split() | 現在の文字列を一文字ずつに分割した配列を取得します。 |
Split(string) | 現在の文字列を指定した区切り文字列で分割した配列を取得します。 |
SplitLines() | 現在の文字列を行単位で分割した配列を取得します。 |
StartsWith(string) | 現在の文字列が指定した文字列で始まるかどうかを判定します。 |
StartsWith(string,bool) | 大文字小文字を区別するかを指定して、現在の文字列が指定した文字列で始まるかどうかを判定します。 |
StartsWith(string,bool,bool) | 大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列が指定した文字列で始まるかどうかを判定します。 |
SubString(number) | 現在の文字列から指定した開始位置から末尾までの文字列を取得します。 |
SubString(number,number) | 現在の文字列から指定した範囲の文字列を取得します。 |
ToLower() | 現在の文字列内の文字をすべて小文字に置換します。 |
ToLower(string?) | 指定された地域の規則を使用して、現在の文字列内の文字をすべて小文字に置換します。 |
ToLowerInvariant() | 地域に依存しない規則を使用して、現在の文字列内の文字をすべて小文字に置換します。 |
ToTitleCase() | 現在の文字列の単語の頭文字を大文字に置換します。 |
ToTitleCase(string?) | 指定された地域の規則を使用して、現在の文字列の単語の頭文字を大文字に置換します。 |
ToTitleCaseInvariant() | 地域に依存しない規則を使用して、現在の文字列の単語の頭文字を大文字に置換します。 |
ToUpper() | 現在の文字列内の文字をすべて大文字に置換します。 |
ToUpper(string?) | 指定された地域の規則を使用して、現在の文字列内の文字をすべて大文字に置換します。 |
ToUpperInvariant() | 地域に依存しない規則を使用して、現在の文字列内の文字をすべて大文字に置換します。 |
Trim() | 現在の文字列から先頭および末尾にある空白文字をすべて削除した文字列を取得します。 |
Trim(params string) | 現在の文字列から指定した文字列が先頭および末尾に現れる箇所をすべて削除した文字列を取得します。 |
TrimEnd() | 現在の文字列から末尾にある空白文字をすべて削除した文字列を取得します |
TrimEnd(params string) | 現在の文字列から末尾にある空白文字をすべて削除した文字列を取得します |
TrimStart() | 現在の文字列から先頭にある空白文字をすべて削除した文字列を取得します |
TrimStart(params string) | 現在の文字列から指定した文字列が先頭に現れる箇所をすべて削除した文字列を取得します |
拡張メソッド
Alice.Regex
名前 | 説明 |
---|---|
IsMatch(this string input, string pattern) | 指定された正規表現に一致する箇所が、指定された文字列内に見つかるかどうかを調べます |
Like(this string input, string pattern) | 文字列が一定のパターンと一致するかを調べます |
Matches(this string input, string pattern) | 指定された正規表現に一致する箇所をすべて取得します。 |
ReplaceAll(this string input, string pattern, string replacement) | 指定した文字列内でパターンに一致する文字列を、すべて指定した文字列で置き換えます。 |
ReplaceFirst(this string input, string pattern, string replacement) | 指定した文字列内でパターンに一致する文字列の初めに見つかった部分を、指定した文字列で置き換えます。 |