3rdparty/modules/stdlib/lib/puppet/parser/functions/empty.rb

   1 #
   2 # empty.rb
   3 #
   4 module Puppet::Parser::Functions
   5   newfunction(:empty, :type => :rvalue, :doc => <<-DOC
   6     @summary
   7       **Deprecated:** Returns true if the variable is empty.
   8
   9     @return
  10       Returns `true` if the argument is an array or hash that contains no elements,
  11       or an empty string. Returns `false` when the argument is a numerical value.
  12
  13     > *Note*: **Deprecated** from Puppet 5.5.0, the built-in
  14     [`empty`](https://puppet.com/docs/puppet/6.4/function.html#empty) function will be used instead.
  15   DOC
  16              ) do |arguments|
  17
  18     raise(Puppet::ParseError, "empty(): Wrong number of arguments given (#{arguments.size} for 1)") if arguments.empty?
  19     value = arguments[0]
  20
  21     unless value.is_a?(Array) || value.is_a?(Hash) || value.is_a?(String) || value.is_a?(Numeric)
  22       raise(Puppet::ParseError, 'empty(): Requires either array, hash, string or integer to work with')
  23     end
  24
  25     return false if value.is_a?(Numeric)
  26     result = value.empty?
  27     return result
  28   end
  29 end
  30
  31 # vim: set ts=2 sw=2 et :