096bc5dc55e1537d1c696d596c6e91ae37a41901
[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / capitalize.rb
1 #
2 #  capitalize.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
6 module Puppet::Parser::Functions
7   newfunction(:capitalize, :type => :rvalue, :doc => <<-EOS
8     Capitalizes the first letter of a string or array of strings.
9     Requires either a single string or an array as an input.
10     EOS
11   ) do |arguments|
12
13     raise(Puppet::ParseError, "capitalize(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.size < 1
14
15     value = arguments[0]
16
17     unless value.is_a?(Array) || value.is_a?(String)
18       raise(Puppet::ParseError, 'capitalize(): Requires either array or string to work with')
19     end
20
21     if value.is_a?(Array)
22       # Numbers in Puppet are often string-encoded which is troublesome ...
23       result = value.collect { |i| i.is_a?(String) ? i.capitalize : i }
24     else
25       result = value.capitalize
26     end
27
28     return result
29   end
30 end