シェルスクリプトの関数に引数を渡す設計｜位置パラメータの一括展開の違いと可変長引数・配列の受け渡し

この記事のポイント

・"$@" を使えばスペース入り引数も1単語として保持されたまま展開される
・"$*" はIFSの先頭文字で全引数を連結した1つの文字列になる（通常は意図しない動作）
・可変長引数は $# で個数確認・shift でずらし・"$@" ループで全引数を処理する
・配列の受け渡しは declare -n nameref で変数名を渡すリファレンス渡しが確実

#!/bin/bash

show_args() {
    local i=1
    for arg in $@; do
        echo "  arg[$i]: $arg"
        i=$((i + 1))
    done
}

# スペースを含む引数を渡す
show_args "hello world" "foo"

  arg[1]: hello
  arg[2]: world
  arg[3]: foo

#!/bin/bash

show_args() {
    local i=1
    for arg in "$@"; do   # ダブルクォートで囲む
        echo "  arg[$i]: $arg"
        i=$((i + 1))
    done
}

show_args "hello world" "foo"

  arg[1]: hello world
  arg[2]: foo

#!/bin/bash

show_args() {
    local i=1
    for arg in "$*"; do   # "$*" は1つの文字列になる
        echo "  arg[$i]: $arg"
        i=$((i + 1))
    done
}

show_args "hello world" "foo"

  arg[1]: hello world foo

#!/bin/bash

backup_files() {
    if [ "$#" -eq 0 ]; then
        echo "エラー: バックアップ対象ファイルを1つ以上指定してください" >&2
        return 1
    fi
    echo "バックアップ対象: $# ファイル"
    for f in "$@"; do
        echo "  処理中: $f"
        # cp "$f" /backup/ などの実処理をここに書く
    done
}

backup_files /etc/nginx/nginx.conf "/var/log/nginx/access.log"

バックアップ対象: 2 ファイル
  処理中: /etc/nginx/nginx.conf
  処理中: /var/log/nginx/access.log

#!/bin/bash

# 第1引数: 出力先ディレクトリ（固定）
# 第2引数以降: コピー対象ファイル（可変）
copy_files() {
    local dest="$1"
    shift  # $1 を取り除く。$2 以降が新たな "$@" になる

    if [ "$#" -eq 0 ]; then
        echo "エラー: コピー元ファイルを指定してください" >&2
        return 1
    fi

    echo "コピー先: $dest  対象: $# ファイル"
    for src in "$@"; do
        echo "  cp $src -> $dest"
    done
}

copy_files /backup/2026-09-09 nginx.conf access.log error.log

コピー先: /backup/2026-09-09  対象: 3 ファイル
  cp nginx.conf -> /backup/2026-09-09
  cp access.log -> /backup/2026-09-09
  cp error.log -> /backup/2026-09-09

#!/bin/bash

count_errors() {
    local total=0
    for logfile in "$@"; do
        if [ ! -f "$logfile" ]; then
            echo "  スキップ（存在しない）: $logfile" >&2
            continue
        fi
        local n
        n=$(grep -c "ERROR" "$logfile" 2>/dev/null || echo 0)
        echo "  $logfile: ${n} 件"
        total=$((total + n))
    done
    echo "合計エラー数: $total"
}

count_errors /var/log/app/app.log /var/log/app/worker.log

  /var/log/app/app.log: 3 件
  /var/log/app/worker.log: 12 件
合計エラー数: 15

#!/bin/bash

print_list() {
    echo "受け取った要素数: $#"
    local i=1
    for item in "$@"; do
        echo "  [$i] $item"
        i=$((i + 1))
    done
}

servers=("web-01" "web-02" "db-01")
print_list "${servers[@]}"

受け取った要素数: 3
  [1] web-01
  [2] web-02
  [3] db-01

#!/bin/bash

# 第1引数: 配列変数名（文字列として渡す）
# 第2引数: 出力ラベル
print_array() {
    declare -n arr_ref="$1"   # nameref: arr_ref は $1 が指す変数の別名
    local label="$2"

    echo "=== ${label} ==="
    echo "要素数: ${#arr_ref[@]}"
    for item in "${arr_ref[@]}"; do
        echo "  - $item"
    done
}

hosts=("web-01" "web-02" "db-01")
print_array hosts "サーバーリスト"

packages=("nginx" "postgresql16" "firewalld")
print_array packages "インストール済みパッケージ"

=== サーバーリスト ===
要素数: 3
  - web-01
  - web-02
  - db-01
=== インストール済みパッケージ ===
要素数: 3
  - nginx
  - postgresql16
  - firewalld

#!/bin/bash

# 使い方: archive_logs [対象ディレクトリ] [保存先] [保存日数]
# 例:     archive_logs /var/log/nginx /backup/logs 30
archive_logs() {
    local src="${1:?エラー: 対象ディレクトリを指定してください}"
    local dest="${2:-/backup/logs}"       # 省略時は /backup/logs
    local days="${3:-30}"                 # 省略時は30日

    echo "対象: $src"
    echo "保存先: $dest"
    echo "保存日数: $days 日"
}

# 必須引数あり、オプション引数は省略
archive_logs /var/log/nginx

対象: /var/log/nginx
保存先: /backup/logs
保存日数: 30 日

#!/bin/bash

service_control() {
    local action="${1:?アクションを指定してください (start|stop|status)}"
    shift
    if [ "$#" -eq 0 ]; then
        echo "エラー: サービス名を1つ以上指定してください" >&2
        return 1
    fi

    for svc in "$@"; do
        echo "systemctl $action $svc"
        # systemctl "$action" "$svc"  # 実際に実行する場合はコメントを外す
    done
}

service_control start nginx postgresql firewalld

systemctl start nginx
systemctl start postgresql
systemctl start firewalld

# 安全な shift: $# より多くずらさない
safe_shift() {
    local n=${1:-1}
    shift $((n < $# ? n : $#))
}

outer() {
    echo "outer の引数: $*"
    inner "$@"   # outer の $@ をそのまま inner に転送
}

inner() {
    echo "inner の引数: $*"
}

outer "hello world" foo

outer の引数: hello world foo
inner の引数: hello world foo