Puppet Function: is_ipv4_address

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

Overview

is_ipv4_address() ⇒ Any

Returns true if the string passed to this function is a valid IPv4 address.

Returns:

  • (Any) 


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

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

  require 'ipaddr'

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

  if (arguments.size != 1) then
    raise(Puppet::ParseError, "is_ipv4_address(): Wrong number of arguments "+
      "given #{arguments.size} for 1")
  end

  begin
    ip = IPAddr.new(arguments[0])
  rescue ArgumentError
    return false
  end

  return ip.ipv4?
end