Packagejp.naggg.utils
Classpublic class ArrayUtil
InheritanceArrayUtil Inheritance Object

配列ユーティリティ



Public Methods
 MethodDefined By
  
静的クラスなのでインスタンスを作りません.必ずエラーを返します.
ArrayUtil
  
average(array:Array):Number
[static] 数値でのみで構成された配列を対象として、その数値の平均値を求めます. 配列に undefined や数値以外の値が含まれた場合は NaN を返します.
ArrayUtil
  
clone(array:Array, useDeepClone:Boolean = false):Array
[static] 引数で渡された配列をコピーします. 2番目の引数を指定することで浅いコピーか深いコピーかを指定することができます. もとの配列に格納する値が Number や String などのプリミティブ型の場合は浅いコピーで問題はありませんが、 複合データ型は実体が複製されずにその参照が複製されます. 複合データの中身までコピーしたい場合は深いコピーを指定して下さい.
ArrayUtil
  
max(array:Array):Number
[static] 数値でのみで構成された配列を対象として、その最大値を求めます.
ArrayUtil
  
min(array:Array):Number
[static] 数値でのみで構成された配列を対象として、その最小値を求めます.
ArrayUtil
  
shuffle(array:Array):Array
[static] 引数で渡された配列をランダムに並び替え、その結果を配列で返します. 配列をコピーしてから並び替えをしますので、引数で渡された配列自体には影響はありません.
ArrayUtil
  
sum(array:Array):Number
[static] 数値でのみで構成された配列を対象として、その合計を求めます. 配列に undefined や数値以外の値が含まれた場合は NaN を返します.
ArrayUtil
Constructor Detail
ArrayUtil()Constructor
public function ArrayUtil()

静的クラスなのでインスタンスを作りません.必ずエラーを返します.


Throws
Error — #2012: ArrayUtil クラスをインスタンス化することはできません。
Method Detail
average()method
public static function average(array:Array):Number

数値でのみで構成された配列を対象として、その数値の平均値を求めます. 配列に undefined や数値以外の値が含まれた場合は NaN を返します.

Parameters

array:Array — 数値を格納している配列

Returns
Number — 平均値
clone()method 
public static function clone(array:Array, useDeepClone:Boolean = false):Array

引数で渡された配列をコピーします. 2番目の引数を指定することで浅いコピーか深いコピーかを指定することができます. もとの配列に格納する値が Number や String などのプリミティブ型の場合は浅いコピーで問題はありませんが、 複合データ型は実体が複製されずにその参照が複製されます. 複合データの中身までコピーしたい場合は深いコピーを指定して下さい.

Parameters

array:Array — コピーしたい配列
 
useDeepClone:Boolean (default = false) — 深いコピーを行うかどうか

Returns
Array — 複製した配列

See also


Example
         import jp.naggg.utils.ArrayUtil;
         
         // 浅いコピー
         var list1:Array = [1,2,3,4,5,6,7,8,9];
         var copy1:Array = ArrayUtil.clone(list1);
         copy1[0] = "new";
         // 結果
         trace(list1); // 1,2,3,4,5,6,7,8,9
         trace(copy1); // new,2,3,4,5,6,7,8,9
         trace("---------------------");
         
         // 深いコピー
         var h:Array = ["(","a","b","c",")"];
         var list2:Array = [1,h,3,4,5,6,7,h,9];
         var copy2_1:Array = ArrayUtil.clone(list2);
         var copy2_2:Array = ArrayUtil.clone(list2, true); // 深い
         copy2_1[0] = "#";    // 浅いコピーの方を変更
         copy2_1[1][1] = "?"; // 浅いコピーの中の複合データを変更
         copy2_2[1][2] = "!"; // 深いコピーの法を変更
         // 結果
         trace(list2);   // 1,(,?,b,c,),3,4,5,6,7,(,?,b,c,),9
         trace(copy2_1); // #,(,?,b,c,),3,4,5,6,7,(,?,b,c,),9
         trace(copy2_2); // 1,(,a,!,c,),3,4,5,6,7,(,a,!,c,),9
         trace("---------------------");
         
max()method 
public static function max(array:Array):Number

数値でのみで構成された配列を対象として、その最大値を求めます.

Parameters

array:Array — 数値を格納している配列

Returns
Number — 最大値
min()method 
public static function min(array:Array):Number

数値でのみで構成された配列を対象として、その最小値を求めます.

Parameters

array:Array — 数値を格納している配列

Returns
Number — 最小値
shuffle()method 
public static function shuffle(array:Array):Array

引数で渡された配列をランダムに並び替え、その結果を配列で返します. 配列をコピーしてから並び替えをしますので、引数で渡された配列自体には影響はありません.

Parameters

array:Array — 対象配列

Returns
Array — ランダムに並べ替えた配列

See also

sum()method 
public static function sum(array:Array):Number

数値でのみで構成された配列を対象として、その合計を求めます. 配列に undefined や数値以外の値が含まれた場合は NaN を返します.

Parameters

array:Array — 数値を格納している配列

Returns
Number — 合計値