#
# empty.rb
#
-
module Puppet::Parser::Functions
- newfunction(:empty, :type => :rvalue, :doc => <<-EOS
-Returns true if the variable is empty.
- EOS
- ) do |arguments|
+ newfunction(:empty, :type => :rvalue, :doc => <<-DOC
+ @summary
+ **Deprecated:** Returns true if the variable is empty.
+
+ @return
+ Returns `true` if the argument is an array or hash that contains no elements,
+ or an empty string. Returns `false` when the argument is a numerical value.
- raise(Puppet::ParseError, "empty(): Wrong number of arguments " +
- "given (#{arguments.size} for 1)") if arguments.size < 1
+ > *Note*: **Deprecated** from Puppet 5.5.0, the built-in
+ [`empty`](https://puppet.com/docs/puppet/6.4/function.html#empty) function will be used instead.
+ DOC
+ ) do |arguments|
+ raise(Puppet::ParseError, "empty(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.empty?
value = arguments[0]
- unless value.is_a?(Array) || value.is_a?(Hash) || value.is_a?(String)
- raise(Puppet::ParseError, 'empty(): Requires either ' +
- 'array, hash or string to work with')
+ unless value.is_a?(Array) || value.is_a?(Hash) || value.is_a?(String) || value.is_a?(Numeric)
+ raise(Puppet::ParseError, 'empty(): Requires either array, hash, string or integer to work with')
end
+ return false if value.is_a?(Numeric)
result = value.empty?
-
return result
end
end