string型

定義

名前空間: Alice
アセンブリ: Losetta.dll

文字列型は、関係演算子と文字列演算子をサポートしています。 文字列型の既定値は空の文字列""です。また、この型の型指定修飾子はstringです。

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

namespace Alice;
public class string;

説明

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

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

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

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

var str = "Hello,World";

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

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

• 文字列補間または複合書式指定を使用する。次の例では、文字列補間を使用してa + bの値を出力しています。

number a = 1;
number b = 2;

string str = $"{a} + {b} = {a + b}";
print(str);
// 出力: 1 + 2 = 3

• variable.ToStringメソッドを使用する。次の例では、数値型の変数aをToStringメソッドを使用して文字列に変換しています。

number a = 1;
string str = a.ToString();

文字列リテラル

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

var str = "Hello,World";

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

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

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

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

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

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

コラム: 改行

文字列の内部で改行したい場合が時々あります。文字列の中で改行するには、\rや\n、\r\nのいずれか環境に応じたものを使用します。

元々\r\nのそれぞれの文字は、タイプライターで別々の意味を表していました。

タイプライターのEnterキーは、元々\r\n(一番左に移動させた後下に移動させる)役割を持っていました。Windowsの改行コードが\r\n(CRLF)であるのはこのためです。

しかし初期のコンピューターでは、改行に2バイトも使用している余裕はありませんでした。このため、Unixでは改行コードを\nに、XeroxやClassic Mac OSでは改行コードを\rとしました。

話を戻すと、AliceScriptの文字列リテラルで改行を表すには、環境に応じて改行コードを書き換える必要があります。次の例をご覧ください。

//Windows環境
print("ここで\r\n改行されます");

//Unix環境
print("ここで\n改行されます");

これを回避するには、env_newLineを使用して、環境に応じて変化するようにします。 次の例をご覧ください。

using Alice.Environment;

print($"ここで{env_newLine}改行されます");

文字列と文字

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

通常、文字列をUTF-16で表現したひとつの要素はひとつの文字を表します。つまり、string.lengthの値は文字列内に含まれる文字の個数と等しくなります。しかし、特殊な文字の中には複数の要素が必要になる場合があります。（これをサロゲートペアと呼びます）この場合、string.lengthの値は必ずしも文字列内に含まれる文字の個数と一致するとは限りません。表示される文字の個数を取得するには、string.lengthInTextElementsを使用してください。

文字列とUnicode標準

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

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

UTF-8文字列リテラル

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

UTF-8文字列リテラルを使用することで、コード中で文字列をUTF-8データで表現できます。UTF-8リテラルは文字列の先頭にu8をつけることで表現できます。このリテラルは文字列ではなくバイナリ型を表すことにご注意ください。次に例を示します。

var data = u8"あいうえお";

print($"Length: {data.Length}");
print($"Type: {data.Type}");

逐語的文字列リテラル

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

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

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

cs title="AliceScript" 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='"と入力された場合、このクエリを実行するとテーブルのすべてのデータが削除されます。

プロパティ

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,string,bool,bool,bool,bool,bool)	カルチャの名前と文字列比較に関するオプションを指定して、この文字列と指定した文字列を比較して文字列を並べ替えたときにこの文字列が前にくるか、後ろにくるか、または同じであるかを表す整数を取得します。
Contains(string)	現在の文字列内に指定された文字列が含まれているかを判定します。
Contains(string,bool)	大文字小文字を区別するかを指定して、現在の文字列内に指定された文字列が含まれているかを判定します。
Contains(string,bool,bool)	大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列内に指定された文字列が含まれているかを判定します。
Contains(string,string,bool,bool,bool,bool,bool)	カルチャの名前と文字列比較に関するオプションを指定して、現在の文字列内に指定された文字列が含まれているかを判定します。
EndsWith(string)	現在の文字列が指定した文字列で終わるかどうかを判定します
EndsWith(string,bool)	大文字小文字を区別するかを指定して、現在の文字列が指定した文字列で終わるかどうかを判定します
EndsWith(string,bool,bool)	大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列が指定した文字列で終わるかどうかを判定します
EndsWith(string,string,bool,bool,bool,bool,bool)	カルチャの名前と文字列比較に関するオプションを指定して、現在の文字列が指定した文字列で終わるかどうかを判定します
Equals(string)	この文字列と、指定した文字列が同一かどうかを判断します
Equals(string,bool)	大文字小文字の区別と、現在のカルチャを考慮するかを指定して、比較するもう一方の文字列が等価かどうか判断します
Equals(string,bool,bool)	大文字小文字の区別と、現在のカルチャを考慮するかを指定して、この文字列と比較するもう一方の文字列が等価かどうか判断します
Equals(string,string,bool,bool,bool,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)	指定した一致ルールを使用して、現在の文字列内の指定した範囲に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。
Replace(string,string,string,bool,bool,bool,bool,bool)	カルチャの名前と文字列比較に関するオプションを指定して、現在の文字列内の指定した範囲に出現する特定の文字列をすべて指定した文字列に置き換えた新しい文字列を取得します。
ReplaceAt(number, string)	現在の文字列の指定した場所を、指定した文字列で置き換えた新しい文字列を取得します。
ReplaceLineEndings()	現在の文字列中のすべての改行文字を現在の環境の改行文字に置換します。
ReplaceLineEndings(string)	現在の文字列中のすべての改行文字を指定した文字列に置換します。
Split()	現在の文字列を一文字ずつに分割した配列を取得します。
Split(string)	現在の文字列を指定した区切り文字列で分割した配列を取得します。
SplitLines()	現在の文字列を行単位で分割した配列を取得します。
StartsWith(string)	現在の文字列が指定した文字列で始まるかどうかを判定します。
StartsWith(string,bool)	大文字小文字を区別するかを指定して、現在の文字列が指定した文字列で始まるかどうかを判定します。
StartsWith(string,bool,bool)	大文字小文字の区別と、現在のカルチャを考慮するかを指定して、現在の文字列が指定した文字列で始まるかどうかを判定します。
StartsWith(string,string,bool,bool,bool,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