【GAS】配列処理のメソッドまとめ（shift / unshift / push / pop）

GASで配列（Arrayオブジェクト）を操作するメソッドの使い方をまとめておきます。

いずれも、元の配列自体を変更する「変更メソッド」です。

shiftメソッド
unshiftメソッド
pushメソッド
popメソッド

Contents

shiftメソッド：配列の最初の要素を取り出す
unshiftメソッド：配列の先頭に新しい要素を追加する
pushメソッド：配列の末尾に新しい要素を追加する
popメソッド：配列の最後の要素を取り出す

shiftメソッド：配列の最初の要素を取り出す

function shiftSample1() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  var ele = arr.shift();
  
  Logger.log(ele); //a1
  
  //元の配列
  Logger.log(arr); //[a2, a3, a4, a5]

}

function shiftSample1() {

var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];

var ele = arr.shift();

Logger.log(ele); //a1

//元の配列

Logger.log(arr); //[a2, a3, a4, a5]

}

while文を使って、配列の中身を先頭から順番に取り出す方法です。

function shiftSample2() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  
  //配列の中身を先頭から順番に取り出す
  while (arr.length) {
    
    var ele = arr.shift();
    
    Logger.log('ele => %s', ele);
    Logger.log('arr => %s', arr);
    
    /*
    
    [20-03-13 22:22:30:930 JST] ele => a1
    [20-03-13 22:22:30:934 JST] arr => [a2, a3, a4, a5]
    [20-03-13 22:22:30:936 JST] ele => a2
    [20-03-13 22:22:30:937 JST] arr => [a3, a4, a5]
    [20-03-13 22:22:30:938 JST] ele => a3
    [20-03-13 22:22:30:939 JST] arr => [a4, a5]
    [20-03-13 22:22:30:941 JST] ele => a4
    [20-03-13 22:22:30:944 JST] arr => [a5]
    [20-03-13 22:22:30:946 JST] ele => a5
    [20-03-13 22:22:30:948 JST] arr => []
    
    */
    
  }
}

function shiftSample2() {

var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];

//配列の中身を先頭から順番に取り出す

while (arr.length) {

var ele = arr.shift();

Logger.log('ele => %s', ele);

Logger.log('arr => %s', arr);

[20-03-13 22:22:30:930 JST] ele => a1

[20-03-13 22:22:30:934 JST] arr => [a2, a3, a4, a5]

[20-03-13 22:22:30:936 JST] ele => a2

[20-03-13 22:22:30:937 JST] arr => [a3, a4, a5]

[20-03-13 22:22:30:938 JST] ele => a3

[20-03-13 22:22:30:939 JST] arr => [a4, a5]

[20-03-13 22:22:30:941 JST] ele => a4

[20-03-13 22:22:30:944 JST] arr => [a5]

[20-03-13 22:22:30:946 JST] ele => a5

[20-03-13 22:22:30:948 JST] arr => []

}

unshiftメソッド：配列の先頭に新しい要素を追加する

function unshiftSample1() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  var len = arr.unshift('a0');
  
  Logger.log(arr); //[a0, a1, a2, a3, a4, a5]
  Logger.log(len); //6
  
}

function unshiftSample1() {

var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];

var len = arr.unshift('a0');

Logger.log(arr); //[a0, a1, a2, a3, a4, a5]

Logger.log(len); //6

}

pushメソッド：配列の末尾に新しい要素を追加する

function pushSample1() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  var len = arr.push('a6');
  
  Logger.log(arr); //[a1, a2, a3, a4, a5, a6]
  Logger.log(len); //6
  
}

function pushSample1() {

var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];

var len = arr.push('a6');

Logger.log(arr); //[a1, a2, a3, a4, a5, a6]

Logger.log(len); //6

}

配列の末尾に配列を追加することもできます。

function pushSample2() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  var len = arr.push(['a6','a7','a8']);
  
  Logger.log(arr); //[a1, a2, a3, a4, a5, [a6, a7, a8]]
  Logger.log(len); //6
  
}

function pushSample2() {

var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];

var len = arr.push(['a6','a7','a8']);

Logger.log(arr); //[a1, a2, a3, a4, a5, [a6, a7, a8]]

Logger.log(len); //6

}

※[一次元配列]と[一次元配列]を結合して[一次元配列]にする方法はこちら

【GAS】複数の配列を結合して一次元配列または二次元配列を作るGASの配列の結合処理をまとめています。「複数の配列を結合して一次元配列にする方法」「複数の配列を結合して二次元配列にする方法」などを紹介しています。...

popメソッド：配列の最後の要素を取り出す

function popSample1() {
  
  var arr = ['a1', 'a2', 'a3', 'a4', 'a5'];
  var ele = arr.pop();
  
  Logger.log(ele); //a5
  
  //元の配列
  Logger.log(arr); //[a1, a2, a3, a4]
  
}