hiArrays (OtsuLibrary)

java.lang.Object
- otsu.hiNote.hiArrays

```
public class hiArrays
extends Object
```
配列用のユーティリティーメソッド.

フィールドのサマリー

フィールド
修飾子とタイプフィールドと説明

static String _v_
ライブラリのバージョン

フィールド
修飾子とタイプ	フィールドと説明
`static String`	`_v_` ライブラリのバージョン

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

hiArrays()

コンストラクタ
コンストラクタと説明
`hiArrays()`

メソッドのサマリー

すべてのメソッド staticメソッド concreteメソッド非推奨のメソッド
修飾子とタイプ	メソッドと説明
`static <T> T[]`	`asArray(T... ts_)` ジェネリッククラスの配列を得る.
`static LinkedHashMap<String,Object>`	`asDict(Object obj_)` ObjectをLinkedHashMap<String,Object>にキャストします.
`static ArrayList<Object>`	`asList(Object obj_)` ObjectをArrayList<Object>にキャストします.
`static String[]`	`atoa(ArrayList<String> arrayList_)` ArrayList<String>をString[]に変換する
`static ArrayList<String>`	`atoa(String[] array_)` String[]をArrayList<String>に変換する
`static int`	`bytesToInt(byte... vals_)` byte並びを下位からintにまとめる.
`static int`	`bytesToIntFromTop(byte... vals_)` byte並びを上位からintにまとめる.
`static long`	`bytesToLong(byte... vals_)` byte並びを下位からlongにまとめる.
`static long`	`bytesToLongFromTop(byte... vals_)` byte並びを上位からlongにまとめる.
`static short`	`bytesToShort(byte... vals_)` byte並びを下位からshortにまとめる.
`static int`	`bytesToShortFromTop(byte... vals_)` byte並びを上位からshortにまとめる.
`static <T> boolean`	`equals(T[] obj1_, T[] obj2_)` オブジェクトの比較(null可,equals使用)(試験中).
`static <T> T`	`get(List<T> list_, int idx_, T default_)` Listの指定位置の要素を取得する（デフォルト値あり）.
`static <T> T`	`get(T[] list_, int idx_, T default_)` 配列の指定位置の要素を取得する（デフォルト値あり）.
`static long`	`intsToLong(int... vals_)` int並びを下位からlongにまとめる.
`static long`	`intsToLongFromTop(int... vals_)` int並びを上位からlongにまとめる.
`static short[]`	`intToShorts(int val_)` intを2個のshortに分ける.
`static boolean`	`isNull(List list_)` リストがnullまたは空であるかチェックする
`static boolean`	`isNull(Map map_)` Mapがnullまたは空であるかチェックする
`static boolean`	`isNull(String str_)` 文字列がnullまたは空文字列であるかをチェックする.
`static String`	`itoa3(int i_)` intの３桁区切りの文字列を得る.
`static StringBuilder`	`join(StringBuilder sb_, Iterable objs_, String dlmt_)` Objectのリストを文字列連結しStringBuilderに付加する.
`static <T> T`	`lastOf(List<T> list_, T default_)` Listの最後の要素を取得する（デフォルト値あり）.
`static <T> T`	`lastOf(T[] list_, T default_)` 配列の最後の要素を取得する（デフォルト値あり）.
`static int[]`	`longToInts(long val_)` longを2個のintに分ける.
`static int[]`	`parseInts(String str_, char dlmt_)` 整数文字列並びをパーズする.
`static int[]`	`parseInts(String str_, char pre_, char dlmt_, char post_)` 前後に囲みがある整数文字列並びをパーズする.
`static int[]`	`parseInts(String str_, char dlmt_, int n_)` 整数文字列並びをパーズする.
`static int[]`	`parseInts(String str_, char dlmt_, int n_, String msg_)` 整数文字列並びをパーズする.
`static byte[]`	`resize(byte[] org_, int new_len_)` バイト配列のlengthを変更した配列を得る.
`static int[]`	`resize(int[] org_, int new_len_)` int配列のlengthを変更した配列を得る.
`static int`	`shortsToInt(short... vals_)` short並びを下位からintにまとめる.
`static int`	`shortsToIntFromTop(short... vals_)` short並びを上位からintにまとめる.
`static long`	`shortsToLong(short... vals_)` short並びを下位からlongにまとめる.
`static long`	`shortsToLongFromTop(short... vals_)` short並びを上位からlongにまとめる.
`static int[]`	`shuffled_ints(int size_)` シャッフルされた整数列を得る。
`static int[]`	`shuffled_ints(int seed_, int size_)` シャッフルされた整数列を得る(seed指定により同じものを得る事ができる)。
`static <T> T[]`	`toArray(List<T> list_)` 非推奨です。
`static <T> T[]`	`toArray(List<T> list_, Class<?> class_)` Listから配列を得る.
`static <T> T[]`	`toArray(Set<T> set_)` 非推奨です。
`static <T> T[]`	`toArray(Set<T> set_, Class<?> class_)` Setから配列を得る.
`static <T> ArrayList<T>`	`toList(T[] array_)` 配列からArrayListを得る.
`static String[]`	`toStrArray(List<String> arrayList_)` 非推奨です。
`static ArrayList<String>`	`toStrArrayList(String[] array_)` 非推奨です。

クラスから継承されたメソッド java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - _v_
```
public static final String _v_
```
    ライブラリのバージョン
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - hiArrays
```
public hiArrays()
```
- メソッドの詳細
  - parseInts
```
public static final int[] parseInts(String str_,
                                    char dlmt_)
```
    整数文字列並びをパーズする. デリミタを挟んで並ぶ整数文字列をパーズします。数値の前後の空白は無視されます。
```
    String values = "4,12,10,9";
    String values2=" 4 , 0x0C , 0x0A , 9 ";
    String values3=" 500x600 ";
    int[] ints = hiU.parseInts(values,',');  ->[4,12,10,9]
    int[] ints2= hiU.parseInts(values2,','); ->[4,12,10,9]
    int[] ints3= hiU.parseInts(values3,'x'); ->[500,600]
```
    パラメータ:
    
    str_ - 整数文字列並び
    
    dlmt_ - 区切り記号
    
    戻り値:
    
    整数並び
  - parseInts
```
public static final int[] parseInts(String str_,
                                    char dlmt_,
                                    int n_)
```
    整数文字列並びをパーズする. デリミタを挟んで並ぶ整数文字列をパーズします。数値の前後の空白は無視されます。
```
    String values = "4,12,10,9";
    String values2=" 4 , 0x0C , 0x0A , 9 ";
    String values3=" 500x600 ";
    int[] ints = hiU.parseInts(values,',',4);  ->[4,12,10,9]
    int[] ints2= hiU.parseInts(values2,',',4); ->[4,12,10,9]
    int[] ints3= hiU.parseInts(values3,'x',2); ->[500,600]
    int[] ints4= hiU.parseInts(values3,'x',3); -> Exception(illegal format)
```
    パラメータ:
    
    str_ - 整数文字列並び
    
    dlmt_ - 区切り記号
    
    n_ - 個数（この個数が得られない場合は例外発生）
    
    戻り値:
    
    整数並び
  - parseInts
```
public static final int[] parseInts(String str_,
                                    char dlmt_,
                                    int n_,
                                    String msg_)
```
    整数文字列並びをパーズする.
    parseInts(String,char,int)に例外用文字列を付加したものです。
    
    パラメータ:
    
    str_ - 整数文字列並び
    
    dlmt_ - 区切り記号
    
    n_ - 個数（この個数が得られない場合は例外発生）
    
    msg_ - 例外のmessageの先頭に付加する文字列
    
    戻り値:
    
    整数並び
  - parseInts
```
public static final int[] parseInts(String str_,
                                    char pre_,
                                    char dlmt_,
                                    char post_)
```
    前後に囲みがある整数文字列並びをパーズする. デリミタを挟んで並ぶ整数文字列をパーズします。数値の前後の空白は無視されます。
```
    String values = " [4,12,10,9]";
    String values2=" (4 , 0x0C , 0x0A , 9 )";
    String values3=" {500x600} ";
    int[] ints = hiU.parseInts(values,'[',',',']');  ->[4,12,10,9]
    int[] ints2= hiU.parseInts(values2,'(',',',')'); ->[4,12,10,9]
    int[] ints3= hiU.parseInts(values3,'{','x','}'); ->[500,600]
```
    パラメータ:
    
    str_ - 整数文字列並び
    
    pre_ - 開始文字
    
    dlmt_ - 区切り記号
    
    post_ - 終了文字
    
    戻り値:
    
    整数並び
  - itoa3
```
public static final String itoa3(int i_)
```
    intの３桁区切りの文字列を得る.
    
    パラメータ:
    
    i_ - 数値
    
    戻り値:
    
    文字列
  - intsToLong
```
public static final long intsToLong(int... vals_)
```
    int並びを下位からlongにまとめる.
    
    パラメータ:
    
    vals_ - int並び
    
    戻り値:
    
    long値
  - shortsToLong
```
public static final long shortsToLong(short... vals_)
```
    short並びを下位からlongにまとめる.
    
    パラメータ:
    
    vals_ - short並び
    
    戻り値:
    
    long値
  - shortsToInt
```
public static final int shortsToInt(short... vals_)
```
    short並びを下位からintにまとめる.
    
    パラメータ:
    
    vals_ - short並び
    
    戻り値:
    
    int値
  - bytesToLong
```
public static final long bytesToLong(byte... vals_)
```
    byte並びを下位からlongにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    long値
  - bytesToInt
```
public static final int bytesToInt(byte... vals_)
```
    byte並びを下位からintにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    int値
  - bytesToShort
```
public static final short bytesToShort(byte... vals_)
```
    byte並びを下位からshortにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    short値
  - intsToLongFromTop
```
public static final long intsToLongFromTop(int... vals_)
```
    int並びを上位からlongにまとめる.
    
    パラメータ:
    
    vals_ - int並び
    
    戻り値:
    
    long値
  - shortsToLongFromTop
```
public static final long shortsToLongFromTop(short... vals_)
```
    short並びを上位からlongにまとめる.
    
    パラメータ:
    
    vals_ - short並び
    
    戻り値:
    
    long値
  - bytesToLongFromTop
```
public static final long bytesToLongFromTop(byte... vals_)
```
    byte並びを上位からlongにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    long値
  - shortsToIntFromTop
```
public static final int shortsToIntFromTop(short... vals_)
```
    short並びを上位からintにまとめる.
    
    パラメータ:
    
    vals_ - short並び
    
    戻り値:
    
    int値
  - bytesToIntFromTop
```
public static final int bytesToIntFromTop(byte... vals_)
```
    byte並びを上位からintにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    int値
  - bytesToShortFromTop
```
public static final int bytesToShortFromTop(byte... vals_)
```
    byte並びを上位からshortにまとめる.
    
    パラメータ:
    
    vals_ - byte並び
    
    戻り値:
    
    short値
  - longToInts
```
public static final int[] longToInts(long val_)
```
    longを2個のintに分ける.
    次の操作と同じです。
```
   _ret[0]= (int)(val_ >> 32);
   _ret[1]= (int)(val_&0xFFFFFFFFL);
```
    パラメータ:
    
    val_ - パックされた値
    
    戻り値:
    
    [0]:高位の値、[1]:低位の値
  - intToShorts
```
public static final short[] intToShorts(int val_)
```
    intを2個のshortに分ける.
    次の操作と同じです。
```
      _ret[0]= (short)((val_ >> 6)&0xFFFF);
      _ret[1]= (short)(val_&0xFFFF);
```
    パラメータ:
    
    val_ - パックされた値
    
    戻り値:
    
    [0]:高位の値、[1]:低位の値
  - isNull
```
public static final boolean isNull(String str_)
```
    文字列がnullまたは空文字列であるかをチェックする.
    文字列が空であることのプログラム上の表現はnullと""が混在します。
    この関数は極めて単純なものですが、バグ回避に大きく貢献する現実重視のものです。
```
   // String strとして
   if( hiU.isNull(str) ) {...}              // は
   if( sts==null || str.length()==0 ) {...} // と同じ
```
    パラメータ:
    
    str_ - 文字列
    
    戻り値:
    
    true:nullまたは空、else:文字内容あり
  - isNull
```
public static final boolean isNull(List list_)
```
    リストがnullまたは空であるかチェックする
    
    パラメータ:
    
    list_ - チェックするリスト
    
    戻り値:
    
    true:nullまたはempty、else：要素あり
  - isNull
```
public static final boolean isNull(Map map_)
```
    Mapがnullまたは空であるかチェックする
    
    パラメータ:
    
    map_ - チェックするマップ
    
    戻り値:
    
    true:nullまたはempty、else：要素あり
  - atoa
```
public static ArrayList<String> atoa(String[] array_)
```
    String[]をArrayList<String>に変換する
    
    パラメータ:
    
    array_ - 文字列の配列
    
    戻り値:
    
    文字列のリスト
  - atoa
```
public static String[] atoa(ArrayList<String> arrayList_)
```
    ArrayList<String>をString[]に変換する
    
    パラメータ:
    
    arrayList_ - 文字列のリスト
    
    戻り値:
    
    文字列の配列
  - toStrArrayList
```
@Deprecated
public static ArrayList<String> toStrArrayList(String[] array_)
```
    非推奨です。
    
    Stringの配列をArrayList<String>にする. 単純ですが、頻度が高くかつ間違いやすいので関数化しました。
    
    パラメータ:
    
    array_ - String配列
    
    戻り値:
    
    引数と同内容のArrayList<String>
  - toStrArray
```
@Deprecated
public static String[] toStrArray(List<String> arrayList_)
```
    非推奨です。
    StringのListを配列にする.
    次の処理と同じです。単純ですが、頻度が高くかつ間違いやすいので関数化しました。
```
  ArrayList<String> strList=new ArrayList<String>();
  String[] result={}; // nullは許されない
  result = strList.toArray(result);
```
    パラメータ:
    
    arrayList_ - StringのList
    
    戻り値:
    
    引数と同内容のString配列
  - join
```
public static StringBuilder join(StringBuilder sb_,
                                 Iterable objs_,
                                 String dlmt_)
```
    Objectのリストを文字列連結しStringBuilderに付加する. 各ObjectはhiU.str(obj)を用いて文字列化されStringBuilderに追加されます。
    ２番目以降はその前に指定デリミタが付加されます。
    
    パラメータ:
    
    sb_ - ここに追加される
    
    objs_ - オブジェクトのリスト
    
    dlmt_ - 区切り記号
    
    戻り値:
    
    変更後のsb_
  - asDict
```
public static final LinkedHashMap<String,Object> asDict(Object obj_)
```
    ObjectをLinkedHashMap<String,Object>にキャストします.
    "無検査キャスト"ワーニングを避けるためだけに用意しました
    
    パラメータ:
    
    obj_ - 辞書Object
    
    戻り値:
    
    キャストされた辞書
  - asList
```
public static final ArrayList<Object> asList(Object obj_)
```
    ObjectをArrayList<Object>にキャストします.
    "無検査キャスト"ワーニングを避けるためだけに用意しました
    
    パラメータ:
    
    obj_ - リストObject
    
    戻り値:
    
    キャストされたリスト
  - shuffled_ints
```
public static int[] shuffled_ints(int seed_,
                                  int size_)
```
    シャッフルされた整数列を得る(seed指定により同じものを得る事ができる)。
    
    パラメータ:
    
    seed_ - シャッフル用乱数の種値。
    
    size_ - 生成する列のサイズ
    
    戻り値:
    
    生成された整数列。0～size_-1の値がシャッフルされて並ぶ
  - shuffled_ints
```
public static int[] shuffled_ints(int size_)
```
    シャッフルされた整数列を得る。
    
    パラメータ:
    
    size_ - 生成する列のサイズ
    
    戻り値:
    
    生成された整数列。0～size_-1の値がシャッフルされて並ぶ
  - get
```
public static <T> T get(List<T> list_,
                        int idx_,
                        T default_)
```
    Listの指定位置の要素を取得する（デフォルト値あり）.
    Listの指定位置の要素を取得します。範囲外を指定した場合は指定のデフォルト値が返ります。
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    list_ - リスト
    
    idx_ - 位置指定（0オリジン)
    
    default_ - デフォルト値
    
    戻り値:
    
    指定位置の値またはデフォルト値
  - lastOf
```
public static <T> T lastOf(List<T> list_,
                           T default_)
```
    Listの最後の要素を取得する（デフォルト値あり）.
    Listの最後の用を取得します。空の場合はデフォルト値が戻ります
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    list_ - リスト
    
    default_ - デフォルト値
    
    戻り値:
    
    指定位置の値またはデフォルト値
  - get
```
public static <T> T get(T[] list_,
                        int idx_,
                        T default_)
```
    配列の指定位置の要素を取得する（デフォルト値あり）.
    配列の指定位置の要素を取得します。範囲外を指定した場合は指定のデフォルト値が返ります。
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    list_ - 配列ト
    
    idx_ - 位置指定（0オリジン)
    
    default_ - デフォルト値
    
    戻り値:
    
    指定位置の値またはデフォルト値
  - lastOf
```
public static <T> T lastOf(T[] list_,
                           T default_)
```
    配列の最後の要素を取得する（デフォルト値あり）.
    配列の最後の用を取得します。空の場合はデフォルト値が戻ります
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    list_ - 配列
    
    default_ - デフォルト値
    
    戻り値:
    
    指定位置の値またはデフォルト値
  - equals
```
public static <T> boolean equals(T[] obj1_,
                                 T[] obj2_)
```
    オブジェクトの比較(null可,equals使用)(試験中).
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    obj1_ - オブジェクト
    
    obj2_ - オブジェクト
    
    戻り値:
    
    一致していればtrue
  - resize
```
public static final byte[] resize(byte[] org_,
                                  int new_len_)
```
    バイト配列のlengthを変更した配列を得る.
    配列を指定サイズにします。
    元々指定サイズだった場合はそのまま返ります。
    元々のサイズと異なる場合は新たな配列が作成されます。
    元々のサイズより指定サイズが小さい場合は後ろが捨てられます
    元々のサイズより大きい場合は後ろの値は不定です。
    
    パラメータ:
    
    org_ - 元の配列
    
    new_len_ - 新しい長さ
    
    戻り値:
    
    指定サイズの配列
  - resize
```
public static final int[] resize(int[] org_,
                                 int new_len_)
```
    int配列のlengthを変更した配列を得る.
    配列を指定サイズにします。
    元々指定サイズだった場合はそのまま返ります。
    元々のサイズと異なる場合は新たな配列が作成されます。
    元々のサイズより指定サイズが小さい場合は後ろが捨てられます
    元々のサイズより大きい場合は後ろの値は不定です。
    
    パラメータ:
    
    org_ - 元の配列
    
    new_len_ - 新しい長さ
    
    戻り値:
    
    指定サイズの配列
  - toList
```
public static <T> ArrayList<T> toList(T[] array_)
```
    配列からArrayListを得る.
    配列から可変長のArrayListを作成します。
```
   String[]     _array= new String[]{....};
   List<String> _list = hiU.toList(_array);
   _list.add("abc"); // 可
```
    Java標準のasListで得られるのは可変長ではありませ。推奨しません。
```
   String[]     _array= new String[]{....};
   List<String> _list = Array.asList(_array);
   _list.add("abc"); // java.lang.UnsupportedOperationException
```
    型パラメータ:
    
    T - 要素の型
    
    パラメータ:
    
    array_ - 配列
    
    戻り値:
    
    ArrayList
  - asArray
```
public static <T> T[] asArray(T... ts_)
```
    ジェネリッククラスの配列を得る.
    
    型パラメータ:
    
    T - 型
    
    パラメータ:
    
    ts_ - 配列に入れるオブジェクト
    
    戻り値:
    
    配列
  - toArray
```
@Deprecated
public static <T> T[] toArray(List<T> list_)
```
    非推奨です。
    Listから配列を得る.
    引数の要素数が0の場合戻り値はnullとなります。
    
    出来るだけtoArray(List,Class)を使ってください
```
   ArrayList<String> _list  = new ArrayList<>();
   // _listに要素設定
   String[]          _array = hiU.toArray(_list); // 非推奨
   String[]          _array2= hiU.toArray(_list,String.class);// 推奨
   String[]          _array3= _list.toArray(new String[0]);// Java標準
```
    型パラメータ:
    
    T - 要素の型
    
    パラメータ:
    
    list_ - リストデータ
    
    戻り値:
    
    配列引数が要素数0の場合はnullとなる
  - toArray
```
public static <T> T[] toArray(List<T> list_,
                              Class<?> class_)
```
    Listから配列を得る. リストから配列を得ます。
```
   ArrayList<String> _list = new ArrayList<>();
   // _listに要素設定
   String[]          _array= hiU.toArray(_list,String.class);
```
    本メソッドの代わりにJavaの標準の方法をとっても構いませんが推奨しません。
```
   ArrayList<String> _list = new ArrayList<>();
   // _listに要素設定
   String[]          _array= _list.toArray(new String[0]);
```
    型パラメータ:
    
    T - 要素の型
    
    パラメータ:
    
    list_ - リストデータ
    
    class_ - 要素の型
    
    戻り値:
    
    配列引数が要素数0の場合は空の配列となる
  - toArray
```
@Deprecated
public static <T> T[] toArray(Set<T> set_)
```
    非推奨です。
    Setから配列を得る.
    引数の要素数が0の場合戻り値はnullとなります。
    
    出来るだけtoArray(List,Class)を使ってください
```
   ArrayList<String> _list  = new ArrayList<>();
   // _listに要素設定
   String[]          _array = hiU.toArray(_list); // 非推奨
   String[]          _array2= hiU.toArray(_list,String.class);// 推奨
   String[]          _array3= _list.toArray(new String[0]);// Java標準
```
    型パラメータ:
    
    T - 要素の型
    
    パラメータ:
    
    set_ - セットデータ
    
    戻り値:
    
    配列引数が要素数0の場合はnullとなる
  - toArray
```
public static <T> T[] toArray(Set<T> set_,
                              Class<?> class_)
```
    Setから配列を得る. Setから配列を得ます。
```
   HashMap<String,String> _map=new HashMap<>();
   //　・・・_mapに要素設定
   String[]  _array= hiU.toArray(_map.keySet(),String.class);
```
    本メソッドの代わりにJavaの標準の方法をとっても構いませんが推奨しません。
```
   ArrayList<String> _list = new ArrayList<>();
   // _listに要素設定
   String[]          _array= _listtoArray(new String[0]);
```
    型パラメータ:
    
    T - 要素の型
    
    パラメータ:
    
    set_ - セットデータ
    
    class_ - 要素の型
    
    戻り値:
    
    配列引数が要素数0の場合はnullとなる

クラス hiArrays

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

フィールドの詳細

_v_

コンストラクタの詳細

hiArrays

メソッドの詳細

parseInts

parseInts

parseInts

parseInts

itoa3

intsToLong

shortsToLong

shortsToInt

bytesToLong

bytesToInt

bytesToShort

intsToLongFromTop

shortsToLongFromTop

bytesToLongFromTop

shortsToIntFromTop

bytesToIntFromTop

bytesToShortFromTop

longToInts

intToShorts

isNull

isNull

isNull

atoa

atoa

toStrArrayList

toStrArray

join

asDict

asList

shuffled_ints

shuffled_ints

get

lastOf

get

lastOf

equals

resize

resize

toList

asArray

toArray

toArray

toArray

toArray