Puppet Function: convert_base

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

Overview

convert_base() ⇒ Any

Converts a given integer or base 10 string representing an integer to a specified base, as a string.

Usage:

$binary_repr = convert_base(5, 2)  # $binary_repr is now set to "101"
$hex_repr = convert_base("254", "16")  # $hex_repr is now set to "fe"

Returns:

  • (Any) 


3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'puppet/modules/stdlib/lib/puppet/parser/functions/convert_base.rb', line 3

newfunction(:convert_base, :type => :rvalue, :arity => 2, :doc => <<-'ENDHEREDOC') do |args|

  Converts a given integer or base 10 string representing an integer to a specified base, as a string.

  Usage:

    $binary_repr = convert_base(5, 2)  # $binary_repr is now set to "101"
    $hex_repr = convert_base("254", "16")  # $hex_repr is now set to "fe"

  ENDHEREDOC

  raise Puppet::ParseError, ("convert_base(): First argument must be either a string or an integer") unless (args[0].is_a?(Integer) or args[0].is_a?(String))
  raise Puppet::ParseError, ("convert_base(): Second argument must be either a string or an integer") unless (args[1].is_a?(Integer) or args[1].is_a?(String))

  if args[0].is_a?(String)
    raise Puppet::ParseError, ("convert_base(): First argument must be an integer or a string corresponding to an integer in base 10") unless args[0] =~ /^[0-9]+$/
  end

  if args[1].is_a?(String)
    raise Puppet::ParseError, ("convert_base(): First argument must be an integer or a string corresponding to an integer in base 10") unless args[1] =~ /^[0-9]+$/
  end

  number_to_convert = args[0]
  new_base = args[1]

  number_to_convert = number_to_convert.to_i()
  new_base = new_base.to_i()

  raise Puppet::ParseError, ("convert_base(): base must be at least 2 and must not be greater than 36") unless new_base >= 2 and new_base <= 36

  return number_to_convert.to_s(new_base)
end