ruby可变参数

在 Ruby 中，可变参数是一种灵活处理方法参数的机制，允许方法接受不确定数量的参数。以下是详细的用法和规则：

---

一、基础用法：*args 收集剩余参数

用 * 符号声明可变参数，会将多余的位置参数收集为数组。

1. 简单示例

def sum(*numbers)
  numbers.sum
end

sum(1, 2, 3)     # => 6
sum(10)           # => 10
sum               # => 0（空数组）

2. 混合位置参数与可变参数

def greet(greeting, *names)
  names.each { |name| puts "#{greeting}, #{name}!" }
end

greet("Hello", "Alice", "Bob")
# 输出：
# Hello, Alice!
# Hello, Bob!

---

二、参数顺序规则

1. 必须参数的优先级

def demo(a, b, *args)
  [a, b, args]
end

demo(1, 2, 3, 4)  # => [1, 2, [3, 4]]
demo(1, 2)        # => [1, 2, []]
# demo(1)         # 错误：缺少参数 b

2. 默认参数与可变参数的结合

def demo(a = 0, b = 1, *args)
  [a, b, args]
end

demo           # => [0, 1, []]
demo(5)        # => [5, 1, []]
demo(5, 6, 7)  # => [5, 6, [7]]

---

三、解包数组作为参数 (* 的逆操作)

在方法调用时，用 * 解包数组为多个参数。

def print_values(a, b, c)
  puts "#{a}, #{b}, #{c}"
end

arr = [1, 2, 3]
print_values(*arr)  # 输出 "1, 2, 3"

# 自动裁剪多余元素
arr = [1, 2, 3, 4]
print_values(*arr)  # 输出 "1, 2, 3"

---

四、关键字参数与 **kwargs

用 ** 收集未声明的关键字参数为哈希。

1. 基础用法

def user_info(name, **options)
  { name: name, **options }
end

user_info("Alice", age: 20, role: "admin")
# => { name: "Alice", age: 20, role: "admin" }

2. 解包哈希作为关键字参数

def connect(host:, port: 80)
  "Connecting to #{host}:#{port}"
end

params = { host: "example.com", port: 3000 }
connect(**params)  # => "Connecting to example.com:3000"

---

五、混合所有参数类型

Ruby 允许组合多种参数类型，但需遵循严格顺序：
位置参数 → 默认参数 → 可变参数 → 关键字参数 → 关键字可变参数

1. 完整示例

def complex_method(a, b=2, *args, c:, d: 4, **kwargs)
  { a: a, b: b, args: args, c: c, d: d, kwargs: kwargs }
end

complex_method(1, 3, 4, 5, c: 6, e: 7)
# => { a: 1, b: 3, args: [4, 5], c: 6, d: 4, kwargs: { e: 7 } }

2. 非法组合示例

# 错误：可变参数 (*args) 必须在关键字参数之前
def invalid(a, *args, b: 1)
end

---

六、特殊场景与技巧

1. 强制要求至少一个可变参数

def at_least_one(*args)
  raise ArgumentError if args.empty?
  # 其他逻辑
end

2. 忽略多余参数

def ignore_extra(*)
  # 不处理多余参数
end
ignore_extra(1, 2, 3)  # 无错误

---

七、代码块参数 (&block)

虽然与可变参数无关，但常结合使用：

def wrap_method(*args, &block)
  puts "Args: #{args}"
  block.call if block_given?
end

wrap_method(1, 2) { puts "Block!" }
# 输出：
# Args: [1, 2]
# Block!

---

总结：Ruby 参数处理优先级

1. 位置参数 （必须参数 → 默认参数 → 可变参数 *args）
2. 关键字参数 （显式关键字 → 默认关键字 → 关键字可变参数 **kwargs）
3. 代码块参数 (&block)

掌握可变参数机制，可以编写出高度灵活且健壮的 Ruby 方法。