0c763752e880a80f0242482819be05409cb4b1fd
[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / downcase.rb
1 #
2 #  downcase.rb
3 #  Please note: This function is an implementation of a Ruby class and as such may not be entirely UTF8 compatible. To ensure compatibility please use this function with Ruby 2.4.0 or greater - https://bugs.ruby-lang.org/issues/10085.
4 #
5 module Puppet::Parser::Functions
6   newfunction(:downcase, :type => :rvalue, :doc => <<-DOC
7     Converts the case of a string or all strings in an array to lower case.
8
9     Note: from Puppet 6.0.0, the compatible function with the same name in Puppet core
10     will be used instead of this function.
11   DOC
12              ) do |arguments|
13
14     raise(Puppet::ParseError, "downcase(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.empty?
15
16     value = arguments[0]
17
18     unless value.is_a?(Array) || value.is_a?(String)
19       raise(Puppet::ParseError, 'downcase(): Requires either array or string to work with')
20     end
21
22     result = if value.is_a?(Array)
23                # Numbers in Puppet are often string-encoded which is troublesome ...
24                value.map { |i| i.is_a?(String) ? i.downcase : i }
25              else
26                value.downcase
27              end
28
29     return result
30   end
31 end
32
33 # vim: set ts=2 sw=2 et :