配列操作関数#
配列の変更#
- qsort(var キー配列[, ソート順=QSRT_A, var 連動配列, ...])#
- 配列内の要素を並び替えます
ソート時の値型について
それぞれの値を文字列として扱いソートを行います- パラメータ:
キー配列 (配列 参照渡し) -- ソートする配列
ソート順 (定数 省略可) --
ソート順を示す定数
- QSRT_A
昇順
- QSRT_D
降順
- QSRT_UNICODEA
UNICODE文字列順 昇順
- QSRT_UNICODED
UNICODE文字列順 降順
- QSRT_NATURALA
数値順 昇順
- QSRT_NATURALD
数値順 降順
連動配列 (配列 省略可 参照渡し) --
キー配列のソートに連動してソートされる配列
キー配列よりサイズの小さい配列はソート前にリサイズされEMPTYで埋められます8つまで指定可能
- 戻り値:
なし
サンプルコード
// 連動ソート // キー配列を並び替え、それと同じように別の配列も並び替えます key = [5,2,1,4,3] arr1 = ["お","い","あ","え","う"] arr2 = ["お","い","あ","え","う", "か"] // 余分はソート対象外、この場合「か」は位置が変更されない arr3 = ["お","い","あ","え"] // 不足の場合末尾にEMPTYが追加されてからソート qsort(key, QSRT_A, arr1, arr2, arr3) print key // [1, 2, 3, 4, 5] print arr1 // [あ, い, う, え, お] print arr2 // [あ, い, う, え, お, か] print arr3 // [あ, い, , え, お] qsort(key, QSRT_D, arr1, arr2, arr3) print key // [5, 4, 3, 2, 1] print arr1 // [お, え, う, い, あ] print arr2 // [お, え, う, い, あ, か] print arr3 // [お, え, , い, あ]
- reverse(var 配列)#
- 配列の順序を反転させます
- パラメータ:
配列 (配列 参照渡し) -- 順序を反転させたい配列
- 戻り値:
なし
サンプルコード
arr = [1,2,3] print arr // [1,2,3] reverse(arr) print arr // [3,2,1]
- resize(var 配列[, インデックス値=EMPTY, 初期値=EMPTY])#
- 配列サイズを変更します
- パラメータ:
配列 (配列 参照渡し) -- サイズを変更したい配列
インデックス値 (数値 省略可) --
指定値 + 1 のサイズに変更される省略時は変更なしマイナス指定時はサイズ0の配列になる初期値 (値 省略可) -- 元のサイズより大きくなる場合、追加される要素の初期値
- 戻り値:
配列サイズ - 1 (配列インデックスの最大値)
サンプルコード
arr = [1,2,3] // サイズ指定なしの場合は配列に変更なし print resize(arr) // 2 print length(arr) // 3 // サイズ指定 print resize(arr, 3) // 3 print length(arr) // 4 // マイナス指定でサイズ0になる print resize(arr, -1) // -1 print length(arr) // 0 // サイズ変更+初期値指定 arr = [] print resize(arr, 2, "a") // 2 print length(arr) // 3 print arr // [a, a, a]
- setclear(var 配列[, 値=EMPTY])#
- 指定した値で配列を埋めます
- パラメータ:
配列 (配列 参照渡し) -- 値を埋めたい配列
値 (値 省略可) -- 埋める値
- 戻り値:
なし
サンプルコード
arr = [1,2,3,4,5] print arr // [1, 2, 3, 4, 5] // 値省略時はEMPTYで埋められる setclear(arr) print arr // [, , , , ] setclear(arr, 111) print arr // [111, 111, 111, 111, 111]
- shiftarray(var 配列, シフト値)#
- 指定値分配列内の要素をずらします
- パラメータ:
配列 (配列 参照渡し) -- 対象の配列
シフト値 (数値) -- 正の数なら要素を後方にずらす、負の数なら前方へずらす (空いた場所はEMPTYで埋められる)
- 戻り値:
なし
サンプルコード
arr = [1,2,3,4,5] print arr // [1, 2, 3, 4, 5] shiftarray(arr, 2) print arr // [, , 1, 2, 3] shiftarray(arr, -2) print arr // [1, 2, 3, , ]
配列長を得る#
配列要素を使う#
- slice(配列[, 開始=0, 終了=EMPTY])#
- 配列の一部をコピーし新たな配列を得ます
- パラメータ:
配列 (配列) -- コピー元の配列
開始 (数値 省略可) -- コピーする開始位置のインデックス値
終了 (数値 省略可) -- コピーする終了位置のインデックス値、省略時は最後まで
- 戻り値:
コピーされた配列
サンプルコード
// 開始と終了が未指定の場合は配列がそのまま複製される base = [1,2,3,4,5] new = slice(base) print new // [1, 2, 3, 4, 5] print slice(base, 2) // [3, 4, 5] print slice(base, , 2) // [1, 2, 3] print slice(base, 1, 3) // [2, 3, 4] // 範囲外が指定されたら空配列が返る print slice(base, 5) // []
- calcarray(配列, 計算方法[, 開始=0, 終了=EMPTY])#
- 配列内の数値で計算を行います
- パラメータ:
配列 (配列) -- 数値を含む配列 (数値以外は無視される)
計算方法 (定数) --
計算方法を示す定数
- CALC_ADD
合計値を得る
- CALC_MIN
最小値を得る
- CALC_MAX
最大値を得る
- CALC_AVR
平均値を得る
- 戻り値:
計算結果
サンプルコード
arr = [1,2,3,4,5] print calcarray(arr, CALC_ADD) // 15 print calcarray(arr, CALC_MIN) // 1 print calcarray(arr, CALC_MAX) // 5 print calcarray(arr, CALC_AVR) // 3 // 範囲指定 print calcarray(arr, CALC_ADD, 2, 3) // 7 print calcarray(arr, CALC_MIN, 2, 3) // 3 print calcarray(arr, CALC_MAX, 2, 3) // 4 print calcarray(arr, CALC_AVR, 2, 3) // 3.5 // 数値以外は無視される arr = [1,2,"foo",4,5] print calcarray(arr, CALC_ADD) // 12 print calcarray(arr, CALC_MIN) // 1 print calcarray(arr, CALC_MAX) // 5 print calcarray(arr, CALC_AVR) // 3 ※ 数値要素が4つなので (1+2+4+5) / 4
文字列との相互変換#
- join(配列[, 区切り文字=" ", 空文字除外=FALSE, 開始=0, 終了=(配列長-1)])#
- 配列要素を区切り文字で結合します
- パラメータ:
配列 (配列) -- 結合したい配列
区切り文字 (文字列 省略可) -- 結合時の区切り文字
空文字除外 (真偽値 省略可) -- FALSEなら配列要素が空文字でも結合する、TRUEなら除外
開始 (数値 省略可) -- 結合範囲の開始位置のインデックス値
終了 (数値 省略可) -- 結合範囲の終了位置のインデックス値
- 戻り値:
結合後の文字列
サンプルコード
arr = ["foo", "bar", "baz", "qux"] print join(arr) // foo bar baz qux print join(arr, "+") // foo+bar+baz+qux print join(arr, "+", FALSE, 1, 2) // bar+baz // 空文字除外 print join(["hoge", "","fuga"], "&", FALSE) // hoge&&fuga print join(["hoge", "","fuga"], "&", TRUE) // hoge&fuga
- split(文字列[, 区切り文字=" ", 空文字除外=FALSE, 数値変換=FALSE, CSV分割=FALSE])#
- 文字列を区切り文字で分割して配列にします
- パラメータ:
文字列 (文字列) -- 分割したい文字列
区切り文字 (文字列 省略可) --
分割するための区切り、CSV分割が有効の場合最初の一文字のみ使用される
一文字ずつ分割
区切り文字として空文字を指定すると文字列を一文字ずつ分割できます空文字除外 (真偽値 省略可) -- FALSEなら分割後に空文字があっても配列要素とする、TRUEなら除外
数値変換 (真偽値 省略可) -- TRUEなら分割後の文字列を数値へ変換し、変換できない場合は空文字とする
CSV分割 (真偽値 省略可) -- TRUEならCSVとして分割する (空文字除外と数値変換は無視される)
- 戻り値:
分割された配列
サンプルコード
print split("a b c") // [a, b, c] // 空文字除外 print split("a,,b,,c", ",", FALSE) // [a, , b, , c] print split("a,,b,,c", ",", TRUE) // [a, b, c] // 数値変換 print split("1,2,f,4,5", ",", FALSE, FALSE) // [1, 2, f, 4, 5] print split("1,2,f,4,5", ",", FALSE, TRUE) // [1, 2, , 4, 5] // 空文字除外と組み合わせると数値以外を排除できる print split("1,2,f,4,5", ",", TRUE, TRUE) // [1, 2, 4, 5] // 空文字で分割 print split("12345", "", FALSE) // [, 1, 2, 3, 4, 5, ] print split("12345", "", TRUE) // [1, 2, 3, 4, 5] // CSV分割 // , で区切られる print split('a,b,"c,d",e', ",", , , FALSE) // [a, b, "c, d", e] // "" 内を文字列扱いとし中の , では区切らない print split('a,b,"c,d",e', ",", , , TRUE) // [a, b, c,d, e]