string

string.byteToCharIndex()

パラメータ

戻り値

説明

文字列内の特定のバイトインデックスに関連付けられた文字インデックスを返します。

        string text = "Σ=σ";
        int charIndex = text.byteToCharIndex(text.search("="));  // 2
        int numChars = text.byteToCharIndex(text.length); // 3 - the number of characters in the string
      

string.charAt()

パラメータ

戻り値

説明

文字列内の指定されたバイトインデックスにある文字を返します。

string text = "Hello World!";
string e = text.charAt(2);  // "e"

string.charToByteIndex()

パラメータ

戻り値

説明

文字列内の特定の文字インデックスに関連付けられたバイトインデックスを返します。

string text = "Σ=σ";
int byteIndex = text.charToByteIndex(2);  // 3

string.endsWith()

パラメータ

戻り値

説明

文字列が指定の部分文字列で終わっているかどうかをチェックします。

string text = "Hello World!";
int worldEnd = text.endsWith("World!");  // 1

string.includes()

パラメータ

戻り値

説明

文字列に指定の部分文字列が含まれているかどうかをチェックします。

string text = "Hello World!";
int containsWorld = text.includes("World");  // 1

string.indexOf()

パラメータ

戻り値

説明

指定された部分文字列の最初の出現先のインデックスを返します。

        string text = "Hello World!";
        int oIndex = text.indexOf("o");  // 5
      

string.lastIndexOf()

パラメータ

戻り値

説明

指定された部分文字列の最後の出現先のインデックスを返します。

        string text = "Hello World!";
        int oIndex = text.indexOf("o");  // 8
      

string.match()

パラメータ

戻り値

説明

文字列からパターンとの一致を検索します。

string str = "A noisy noise annoys an oyster.";
var result = str.match(/nois/g);
Array matches = [result[1], result[2]]; // ["nois", "nois"]

正規表現の詳細については、replace()メソッドを参照してください。

string.padEnd()

パラメータ

戻り値

説明

文字列が指定の長さになるまで、末尾をpadStringでパディングします。

文字列が指定のtargetLengthになるまで、末尾をpadStringでパディングします。targetLengthが文字列の長さ未満の場合は、パディングせずに文字列を返します。

string s = "abc";
s.padEnd(10);         // "abc       "
s.padEnd(10, "foo");  // "abcfoofoof"
s.padEnd(6,"123465"); // "abc123"
s.padEnd(8, "0");     // "abc00000"
s.padEnd(1);          // "abc"

string.padStart()

パラメータ

戻り値

説明

文字列が指定の長さになるまで、先頭をpadStringでパディングします。

文字列が指定のtargetLengthになるまで、先頭をpadStringでパディングします。targetLengthが文字列の長さ未満の場合は、パディングせずに文字列を返します。

string s = "abc";
s.padStart(10);         // "       abc"
s.padStart(10, "foo");  // "foofoofabc"
s.padStart(6,"123465"); // "123abc"
s.padStart(8, "0");     // "00000abc"
s.padStart(1);          // "abc"

string.repeat()

パラメータ

戻り値

説明

オリジナルのコピーから新しい文字列を作成します。

string str = "Clap";
string applause = str.repeat(3);  // "ClapClapClap"

string.replace()

パラメータ

戻り値

説明

文字列を別の文字列に置き換えます。

正規表現

正規表現は、検索する文字列のパターンを指定する簡潔な方法です。正規表現を前方スラッシュ「/」で囲んで（文字列を引用符で囲むのと同様）から、修飾子を追加します。

/pattern/modifiers
/[0-9]+/g

正規表現構文の簡単な説明を以下に示します。

修飾子

正規表現の終了を示す/の後に配置し、その動作を修飾します。

g - グローバルな一致。最初の出現だけでなく、すべての出現に一致します。

i - 大文字と小文字を区別しない一致。

括弧

[] - 括弧内の任意の文字に一致します。ダッシュを使用して文字の範囲を指定できます。

[abc] - a、b、またはcに一致します。
[a-z] - 任意の小文字に一致します。
[0-9]- 任意の数字に一致します。
[^abc]- a、b、c以外の任意の文字に一致します。

OR

| - |で区切られた任意の選択肢に一致します。

(abc|cba) - 「abc」または「cba」というシーケンスに一致します。
(gray|grey)またはgr(a|e)y - 「gray」と「grey」に一致します。

数量詞

直前の式に一致する文字の反復回数を定義します。

* - 指定された文字の0回以上の繰り返しに一致します。

ab*c - 「ac」、「abc」、「abbc」、「abbbc」などに一致します。基本的に、a、次に任意の数のb、その次にcが続く任意の文字列に一致します。

+ - 指定された文字の1回以上の繰り返しに一致します。

ab+c - ab*cとほぼ同じですが、「ac」には一致しません。

? - 指定された文字が0または1つある任意の文字列に一致します。

colou?r - 「color」と「colour」の両方に一致しますが、「colouur」には一致しません。

繰り返し

{n} - n個の出現と一致します。

{m,n} - m個以上n個以下の出現と一致します。

ピリオド

.- 任意の文字と一致します。

\.- ピリオドと一致します。

キャプチャーグループ

括弧を使用してキャプチャーグループを定義することもできます。文字パターンを括弧で囲むことにより、括弧内に一致する結果が保存され、文字列の置き換えに使用されます。置換文字列内で$1や$2などの項目を使用して、検索パターンで取得された1つ目、2つ目、3つ目などのグループを参照します。

例：

次のコードはすべての数値を削除します。まず、0～9の数字とその繰り返しを長さに関係なく検索するために、[0-9]と指定し、その後ろに+を追加します。最後に、すべての出現と一致するようにg修飾子を追加します。

string text = "300 out of 500 soda cans";
return text.replace(/[0-9]+/g, "");  // " out of  soda cans"
      		

次のコードは、「blue」または「green」を、大文字と小文字を問わず「red」に置き換えます。

string text = "Blue cars are really green.";
return text.replace(/blue|green/gi, "red");  // "red cars are really red."
      		

次のコードは、bで始まりtで終わる3文字の単語をすべて置き換えます。

string text = "My favorite words are: bit bat but bot bet.";
return text.replace(/b[aeiou]t/g, "Money"); // My favorite words are: Money Money Money Money Money.
      		

次のコードは、電子メールアドレスを非表示にします。「\.」は、任意の文字ではなく、ピリオドであることを示したい場合に使用します。

string text = "Email me at [email protected] or [email protected]";
return text.replace(/([a-z0-9_\.-]+)@([0-9a-z\.-]+)\.([a-z\.]{2,6})/g, "###"); //Email me at ### or ###
			

FlexScriptの文字列の正規表現の実装では、その機能にc++の正規表現ライブラリとECMAScript文法が使用されています。当社の設計は、JavaScriptの正規表現の実装からも影響を受けています。string.replace()メソッドの正規表現オーバーロードは、std::regex_replace呼び出しのラッパーです。正規表現の作成の詳細については、該当するドキュメントを参照してください。なお、JavaScriptの正規表現フラグ/m、/y、/uは、（まだ）実装されていません。

string.search()

パラメータ

戻り値

説明

文字列から内部文字列またはパターンを検索します。

string str = "Hello, how are you?";
int howIndex = str.search("how");  // 8

文字列の検索には、正規表現も使用できます。

string str = "Hello, how are you?";
int howIndex = str.search(/h[a-z]+/);  // 8 (first word starting with h)

正規表現の詳細については、replace()メソッドを参照してください。

string.slice()

パラメータ

戻り値

説明

文字列の断片を抽出して、新しい文字列を返します。

string text = "Hello World!";
string subText = text.slice(1, 6);  // "Hello"

負の数字を使用すると、文字列の末尾から開始します。

string text = "Hello World!";
string subText = text.slice(-6); // "World!"

string.split()

パラメータ

戻り値

説明

文字列を部分文字列の配列に分割します。

string str = "Hello, how are you?";
Array subStrings = str.split(" ", 3);  // ["Hello,", "how", "are"]
      		

string csv = "foo,bar,,baz";
Array subStrings = csv.split(",");  // ["foo", "bar", "", "baz"]
      		

区切る文字列の検索には、正規表現も使用できます。このコードは数値を削除します。

string str = "abcd123efg456hij789klm0";
Array subStrings = str.split(/[0-9]+/g);  // ["abcd", "efg", "hij", "klm", ""]
      		

正規表現の詳細については、replace()メソッドを参照してください。

string.startsWith()

パラメータ

戻り値

説明

文字列が指定の部分文字列で始まっているかどうかをチェックします。

string text = "Hello World!";
int worldStart = text.startsWith("Hello");  // 1
      		

string.substr()

パラメータ

戻り値

説明

文字列の断片を抽出して、新しい文字列を返します。

string text = "Hello World!";
string subText = text.substr(1, 5);  // "Hello"

最初のパラメータが負なら、末尾からその数だけの文字をカウントします。

string text = "Hello World!";
string subText = text.substr(-6, 5); // "World" without the "!"

string.toLowerCase()

戻り値

説明

すべての文字を小文字に変換します。

string text = "Hello World!";
string lower = text.toLowerCase();  // "hello world!"
      		

string.toNum()

戻り値

説明

文字列の内容を浮動小数点数として解釈します。

string text = "1.5";
double number = text.toNum(); // 1.500
          

string.toUpperCase()

戻り値

説明

すべての文字を大文字に変換します。

string text = "Hello World!";
string lower = text.toUpperCase();  // "HELLO WORLD!"
      		

string.trim()

戻り値

説明

先行する空白と後続の空白を除去します。

string text = "     Hello World!     ";
string trim = text.trim();  // "Hello World!"
      		

string.fromNum()

パラメータ

戻り値

説明

指定された数値を文字列に変換します。

string text1 = string.fromNum(1.5); // "1.5"
string text2 = string.fromNum(1.5, 2); // "1.50"