Bash ฟังก์ชัน



ฟังก์ชันช่วยให้สคริปต์ยาว ๆ อ่านได้ ไม่ซ้ำโค้ด แต่ฟังก์ชัน Bash ทำงานไม่เหมือนภาษาอื่น — ไม่มี “return value” แบบส่งข้อมูล มีแต่ exit status เข้าใจจุดนี้แล้วจะใช้ถูก

นิยามและเรียกใช้

# สองรูปแบบ — ใช้แบบแรก (POSIX-compatible)
greet() {
    echo "สวัสดี $1"
}

function greet {          # แบบ bash เท่านั้น — เลี่ยง
    echo "สวัสดี $1"
}

greet "Somchai"          # เรียก — ไม่มีวงเล็บ ส่งอาร์กิวเมนต์แบบคำสั่ง
greet "Somsri"

ต้องนิยามก่อนเรียก — Bash อ่านไฟล์บนลงล่าง ฟังก์ชันที่ยังไม่เจอ = “command not found” นิยมวางฟังก์ชันไว้บนสุด เรียกจริงใน main ล่างสุด (บทที่ 32)

อาร์กิวเมนต์ — เหมือนสคริปต์

ในฟังก์ชัน $1 $2 $@ $# $* หมายถึงอาร์กิวเมนต์ของ ฟังก์ชัน ไม่ใช่ของสคริปต์ (แต่ $0 ยังเป็นชื่อสคริปต์)

deploy() {
    local env=$1
    local version=$2
    shift 2
    local extra_args=("$@")          # ที่เหลือ

    echo "deploy $version ไป $env"
    echo "options เพิ่ม: ${extra_args[*]}"
}

deploy prod v2.1.0 --force --skip-tests
deploy v2.1.0 ไป prod
options เพิ่ม: --force --skip-tests

local — สำคัญมาก

โดยปริยาย ตัวแปรในฟังก์ชันเป็น global — เขียนทับตัวแปรข้างนอกได้โดยไม่ตั้งใจ

result="สำคัญมาก"

process() {
    result="เปลี่ยนแล้ว"        # ← เขียนทับ global!
    i=0                        # ← ตัว i ข้างนอกก็โดนด้วย
}

process
echo "$result"                 # เปลี่ยนแล้ว — ข้อมูลเดิมหาย

ใส่ local ให้ทุกตัวแปรในฟังก์ชันเสมอ

process() {
    local result="เปลี่ยนแล้ว"   # อยู่แค่ในฟังก์ชัน
    local i
    for (( i = 0; i < 10; i++ )); do :; done
}

process
echo "$result"                 # สำคัญมาก — ปลอดภัย

local ประกาศหลายตัวได้: local a b c หรือ local x=1 y=2

คืนค่า — ผ่าน exit status (0–255)

return N ตั้ง exit status ของฟังก์ชัน (เหมือน exit แต่ไม่ปิดสคริปต์)

is_valid_port() {
    local port=$1
    [[ "$port" =~ ^[0-9]+$ ]] || return 1
    (( port >= 1 && port <= 65535 )) || return 1
    return 0
}

if is_valid_port "$user_input"; then
    echo "พอร์ตใช้ได้"
else
    echo "พอร์ตไม่ถูกต้อง" >&2
    exit 1
fi

return เฉย ๆ = return $? (ใช้รหัสของคำสั่งล่าสุดในฟังก์ชัน)

return คืนได้แค่ตัวเลข 0–255 — ส่งข้อความหรือตัวเลขใหญ่กลับไม่ได้ทางนี้

ส่งผลลัพธ์กลับ — ผ่าน stdout + $()

อยากให้ฟังก์ชัน “คืนค่า” เป็นข้อมูล → ให้มัน echo ออก stdout แล้วผู้เรียกดักด้วย $(...)

get_timestamp() {
    date '+%Y%m%d-%H%M%S'
}

backup_name() {
    local prefix=$1
    echo "${prefix}-$(get_timestamp).tar.gz"
}

archive=$(backup_name "myapp")
echo "$archive"                 # myapp-20260907-143022.tar.gz

ฟังก์ชันควร echo เฉพาะผลลัพธ์ — ข้อความ log/progress ส่งไป stderr ไม่งั้นมันปนกับค่าที่ผู้เรียกดัก

fetch_config() {
    echo "กำลังดาวน์โหลด config..." >&2      # log → stderr
    curl -fsS "https://example.com/config"   # ผลลัพธ์ → stdout
}

config=$(fetch_config)          # $config ได้เฉพาะเนื้อ config ไม่มีข้อความ log

กับดัก: local x=$(cmd) กลบ exit status

set -e

get_data() {
    curl -fsS "https://might-fail.example.com"     # ถ้าล้มเหลว...
}

process() {
    local data=$(get_data)      # ← exit status ที่นี่คือของ `local` (สำเร็จเสมอ!)
    echo "$data"                # get_data ล้มเหลวแต่สคริปต์ไม่หยุด
}

local เป็นคำสั่ง — มันคืน exit status ของตัวมันเอง (0) กลบของ $(get_data) ทิ้ง set -e เลยไม่จับ

ทางแก้: แยกประกาศกับกำหนดค่า

process() {
    local data
    data=$(get_data)            # ← ตอนนี้ exit status เป็นของ get_data → set -e จับได้
    echo "$data"
}

กฎ: local var; var=$(cmd) — อย่ารวมเป็นบรรทัดเดียวเมื่อฝั่งขวาเป็นคำสั่งที่อาจล้มเหลว

ส่งผลลัพธ์ผ่าน nameref (bash 4.3+)

หลีกเลี่ยง subshell ของ $() ด้วยการให้ฟังก์ชันเขียนลงตัวแปรที่ผู้เรียกระบุ

split_path() {
    local -n _dir=$1            # -n = nameref ชี้ไปตัวแปรที่ชื่อตรงกับ $1
    local -n _base=$2
    local path=$3
    _dir=${path%/*}
    _base=${path##*/}
}

split_path d b "/var/log/syslog"
echo "$d / $b"                  # /var/log / syslog

มีประโยชน์เมื่อฟังก์ชันต้องคืนหลายค่า หรือคืน array — แต่ต้องระวังชื่อชนกัน (ขึ้นต้นด้วย _)

recursion

factorial() {
    local n=$1
    (( n <= 1 )) && { echo 1; return; }
    echo $(( n * $(factorial $(( n - 1 )) ) ))
}

factorial 5          # 120

ทำได้แต่แต่ละชั้นสร้าง subshell — ช้าและกิน memory ถ้าลึกมาก งานจริงหลีกเลี่ยง recursion ใน bash

FUNCNAME และ debugging

log() {
    echo "[${FUNCNAME[1]}:${BASH_LINENO[0]}] $*" >&2
}

do_work() {
    log "เริ่มทำงาน"           # [do_work:42] เริ่มทำงาน
}

FUNCNAME เป็น array — [0] คือฟังก์ชันปัจจุบัน, [1] คือผู้เรียก

เรื่องที่คนมักพลาด

  • ลืม local — ตัวแปรในฟังก์ชันเขียนทับ global ใส่ local ให้ทุกตัวเสมอ
  • local x=$(cmd) กับ set -e — local กลบ exit status แยกเป็น local x; x=$(cmd)
  • return "ข้อความ" หรือ return 1000 — return รับแค่ 0–255 ส่งข้อมูลผ่าน echo + $()
  • echo ข้อความ log ปนกับผลลัพธ์ — ผู้เรียกที่ใช้ $(func) ได้ข้อความ log ติดมาด้วย ส่ง log ไป >&2
  • เรียกฟังก์ชันก่อนนิยาม — “command not found” นิยามก่อน เรียกทีหลัง
  • เรียกด้วย myfunc(arg) หรือ myfunc($x) — ผิด syntax ใช้ myfunc "$x" แบบคำสั่ง
  • ชื่อฟังก์ชันชนกับคำสั่งจริง — ls() { ... } ทำให้ ls ปกติใช้ไม่ได้ (ต้อง command ls) ตั้งชื่อให้ต่าง

สรุป

  • นิยาม name() { ...; } — นิยามก่อนเรียก เรียกแบบคำสั่ง name arg1 arg2
  • อาร์กิวเมนต์: $1 $2 "$@" $# = ของฟังก์ชัน (แต่ $0 ยังเป็นชื่อสคริปต์)
  • ใส่ local ให้ทุกตัวแปร — ไม่งั้นเขียนทับ global
  • คืนค่า = exit status (return 0–255) ใช้กับ if func; then
  • ส่งข้อมูลกลับ = echo ออก stdout + ผู้เรียกดัก result=$(func) — log ไป >&2
  • local x=$(cmd) กลบ exit status — แยก local x; x=$(cmd) เมื่อใช้กับ set -e
  • nameref (local -n) สำหรับคืนหลายค่า/array (bash 4.3+)

จบเฟส 2 — บทถัดไปเข้าเฟส 3 เรื่องข้อมูล เริ่มจาก parameter expansion ชุดค่าปริยายและความยาว