Flash CS3 ドキュメンテーション

ActionScript 2.0 リファレンスガイド > ActionScript クラス > Array > join (Array.join メソッド)

join (Array.join メソッド)

public join([delimiter: String ]) : String

配列内のエレメントをストリングに変換し、指定されたセパレータをエレメント間に挿入し、エレメントを連結して、その結果をストリングとして返します。ネストされた配列は、join() メソッドに渡されるセパレータで区切るのではなく、常にカンマ (,) で区切ります。

対応バージョン : ActionScript 1.0、Flash Player 5

パラメータ

delimiter:String (オプション) - 返されるストリング内の配列エレメントを区切る文字またはストリング。このパラメータを省略すると、デフォルトのセパレータとしてカンマ (,) が使用されます。

戻り値

String - ストリング。

例

次の例では、3 つのエレメント Earth、Moon、Sun を含む配列を作成した後、配列を 3 回結合します。--1 回目はデフォルトのセパレータ (カンマ (,) とスペース) を使い、2 回目はダッシュ (-) を使い、最後はプラス記号 (+) を使います。

var a_array:Array = new Array("Earth","Moon","Sun")
trace(a_array.join()); 
// Displays Earth,Moon,Sun.
trace(a_array.join(" - ")); 
// Displays Earth - Moon - Sun.
trace(a_array.join(" + ")); 
// Displays Earth + Moon + Sun.

次の例では、2 つの配列がネストされた配列を作成します。1 番目の配列には、Europa、Io、および Callisto という 3 つのエレメントを格納します。2 番目の配列には、Titan および Rhea という 2 つのエレメントを格納します。配列をプラス記号 (+) で結合しても、ネストされた配列内の各エレメントはカンマ (,) で区切られたままになります。

var a_nested_array:Array = new Array(["Europa", "Io", "Callisto"], ["Titan", "Rhea"]);
trace(a_nested_array.join(" + "));
// Returns Europa,Io,Callisto + Titan,Rhea.

join (Array.join メソッド)

パラメータ

戻り値

例

関連項目