Puppet Function: is_string

Defined in:
puppet/modules/stdlib/lib/puppet/parser/functions/is_string.rb
Function type:
Ruby 3.x API

Overview

is_string() ⇒ Any

Returns true if the variable passed to this function is a string.

Returns:

  • (Any) 


6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
 
# File 'puppet/modules/stdlib/lib/puppet/parser/functions/is_string.rb', line 6

newfunction(:is_string, :type => :rvalue, :doc => <<-EOS
Returns true if the variable passed to this function is a string.
  EOS
) do |arguments|

  function_deprecation([:is_string, 'This method is deprecated, please use the stdlib validate_legacy function, with Stdlib::Compat::String. There is further documentation for validate_legacy function in the README.'])

  raise(Puppet::ParseError, "is_string(): Wrong number of arguments " +
    "given (#{arguments.size} for 1)") if arguments.size < 1

  type = arguments[0]

  # when called through the v4 API shim, undef gets translated to nil
  result = type.is_a?(String) || type.nil?

  if result and (type == type.to_f.to_s or type == type.to_i.to_s) then
    return false
  end

  return result
end