Update stdlib
[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / member.rb
1 #
2 # member.rb
3 #
4
5 # TODO(Krzysztof Wilczynski): We need to add support for regular expression ...
6 # TODO(Krzysztof Wilczynski): Support for strings and hashes too ...
7
8 module Puppet::Parser::Functions
9   newfunction(:member, :type => :rvalue, :doc => <<-EOS
10 This function determines if a variable is a member of an array.
11 The variable can be a string, fixnum, or array.
12
13 *Examples:*
14
15     member(['a','b'], 'b')
16
17 Would return: true
18
19     member(['a', 'b', 'c'], ['a', 'b'])
20
21 would return: true
22
23     member(['a','b'], 'c')
24
25 Would return: false
26
27     member(['a', 'b', 'c'], ['d', 'b'])
28
29 would return: false
30     EOS
31   ) do |arguments|
32
33     raise(Puppet::ParseError, "member(): Wrong number of arguments given (#{arguments.size} for 2)") if arguments.size < 2
34
35     array = arguments[0]
36
37     unless array.is_a?(Array)
38       raise(Puppet::ParseError, 'member(): Requires array to work with')
39     end
40
41     unless arguments[1].is_a? String or arguments[1].is_a? Fixnum or arguments[1].is_a? Array
42       raise(Puppet::ParseError, 'member(): Item to search for must be a string, fixnum, or array')
43     end
44
45     if arguments[1].is_a? String or arguments[1].is_a? Fixnum
46       item = [arguments[1]]
47     else
48       item = arguments[1]
49     end
50
51
52     raise(Puppet::ParseError, 'member(): You must provide item to search for within array given') if item.respond_to?('empty?') && item.empty?
53
54     result = (item - array).empty?
55
56     return result
57   end
58 end
59
60 # vim: set ts=2 sw=2 et :