Puppet Function: concat

Defined in:
puppet/modules/stdlib/lib/puppet/parser/functions/concat.rb
Function type:
Ruby 3.x API

Overview

concat() ⇒ Any

Appends the contents of multiple arrays into array 1.

Example:

concat(['1','2','3'],['4','5','6'],['7','8','9'])

Would result in:

['1','2','3','4','5','6','7','8','9']

Returns:

  • (Any) 


6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'puppet/modules/stdlib/lib/puppet/parser/functions/concat.rb', line 6

newfunction(:concat, :type => :rvalue, :doc => <<-EOS
Appends the contents of multiple arrays into array 1.

*Example:*

  concat(['1','2','3'],['4','5','6'],['7','8','9'])

Would result in:

['1','2','3','4','5','6','7','8','9']
  EOS
) do |arguments|

  # Check that more than 2 arguments have been given ...
  raise(Puppet::ParseError, "concat(): Wrong number of arguments " +
    "given (#{arguments.size} for < 2)") if arguments.size < 2

  a = arguments[0]

  # Check that the first parameter is an array
  unless a.is_a?(Array)
    raise(Puppet::ParseError, 'concat(): Requires array to work with')
  end

  result = a
  arguments.shift

  arguments.each do |x|
    result = result + (x.is_a?(Array) ? x : [x])
  end

  return result
end