Reference

Table of Contents

Classes

• stdlib: This module manages stdlib.
• stdlib::stages: This class manages a standard set of run stages for Puppet. It is managed by the stdlib class, and should not be declared independently.

Resource types

• anchor: A simple resource type intended to be used as an anchor in a composite class.
• file_line: Ensures that a given line is contained within a file.

Functions

• abs: Deprecated: Returns the absolute value of a number
• any2array: This converts any object to an array containing that object.
• any2bool: Converts 'anything' to a boolean.
• assert_private: Sets the current class or definition as private.
• base64: Base64 encode or decode a string based on the command and the string submitted
• basename: Strips directory (and optional suffix) from a filename
• bool2num: Converts a boolean to a number.
• bool2str: Converts a boolean to a string using optionally supplied arguments.
• camelcase: Deprecated Converts the case of a string or all strings in an array to camel case.
• capitalize: Deprecated Capitalizes the first letter of a string or array of strings.
• ceiling: Deprecated Returns the smallest integer greater or equal to the argument.
• chomp: Deprecated Removes the record separator from the end of a string or an array of strings.
• chop: Deprecated Returns a new string with the last character removed.
• clamp: Keeps value within the range [Min, X, Max] by sort based on integer value (parameter order doesn't matter).
• concat: Appends the contents of multiple arrays into array 1.
• convert_base: Converts a given integer or base 10 string representing an integer to a specified base, as a string.
• count: Counts the number of elements in array.
• deep_merge: Recursively merges two or more hashes together and returns the resulting hash.
• defined_with_params
• delete: Deletes all instances of a given element from an array, substring from a string, or key from a hash.
• delete_at: Deletes a determined indexed value from an array.
• delete_regex: Deletes all instances of a given element that match a regular expression from an array or key from a hash.
• delete_undef_values: Returns a copy of input hash or array with all undefs deleted.
• delete_values: Deletes all instances of a given value from a hash.
• deprecation: Function to print deprecation warnings, Logs a warning once for a given key. The uniqueness key - can appear once. The msg is the message te
• deprecation: Function to print deprecation warnings (this is the 3.X version of it).
• difference: This function returns the difference between two arrays.
• dig: DEPRECATED Retrieves a value within multiple layers of hashes and arrays via an array of keys containing a path.
• dig44
• dirname: Returns the dirname of a path.
• dos2unix: Returns the Unix version of the given string.
• downcase: Deprecated: Converts the case of a string or all strings in an array to lower case.
• empty: Deprecated: Returns true if the variable is empty.
• enclose_ipv6: Takes an array of ip addresses and encloses the ipv6 addresses with square brackets.
• ensure_packages: Takes a list of packages and only installs them if they don't already exist.
• ensure_resource
• ensure_resources
• fact: Digs into the facts hash using dot-notation
• flatten: This function flattens any deeply nested arrays and returns a single flat array as a result.
• floor: Returns the largest integer less or equal to the argument.
• fqdn_rand_string
• fqdn_rotate: fqdn_rotate.rb
• fqdn_uuid: Returns a RFC 4122 valid version 5 UUID based on an FQDN string under the DNS namespace
• get_module_path: Returns the absolute path of the specified module for the current environment.
• getparam
• getvar: Lookup a variable in a given namespace.
• glob: Uses same patterns as Dir#glob.
• grep: This function searches through an array and returns any elements that match the provided regular expression.
• has_interface_with: Returns boolean based on kind and value.
• has_ip_address: Returns true if the client has the requested IP address on some interface.
• has_ip_network: Returns true if the client has an IP address within the requested network.
• has_key: Deprecated: Determine if a hash has a certain key value.
• hash: Deprecated: This function converts an array into a hash.
• intersection: This function returns an array of the intersection of two.
• is_a: Boolean check to determine whether a variable is of a given data type. This is equivalent to the =~ type checks.
• is_absolute_path: Wrapper that calls the Puppet 3.x function of the same name.
• is_absolute_path: Deprecated: Returns boolean true if the string represents an absolute path in the filesystem.
• is_array: Wrapper that calls the Puppet 3.x function of the same name.
• is_array: Deprecated: Returns true if the variable passed to this function is an array.
• is_bool: Wrapper that calls the Puppet 3.x function of the same name.
• is_bool: Deprecated: Returns true if the variable passed to this function is a boolean.
• is_domain_name: Deprecated: Returns true if the string passed to this function is a syntactically correct domain name.
• is_email_address: Deprecated: Returns true if the string passed to this function is a valid email address.
• is_float: Wrapper that calls the Puppet 3.x function of the same name.
• is_float: Deprecated: Returns true if the variable passed to this function is a float.
• is_function_available: Deprecated: Determines whether the Puppet runtime has access to a function by that name.
• is_hash: Deprecated: Returns true if the variable passed to this function is a hash.
• is_integer: Deprecated: Returns true if the variable passed to this function is an Integer or a decimal (base 10) integer in String form.
• is_ip_address: Wrapper that calls the Puppet 3.x function of the same name.
• is_ip_address: Deprecated: Returns true if the string passed to this function is a valid IP address.
• is_ipv4_address: Wrapper that calls the Puppet 3.x function of the same name.
• is_ipv4_address: Deprecated: Returns true if the string passed to this function is a valid IPv4 address.
• is_ipv6_address: Wrapper that calls the Puppet 3.x function of the same name.
• is_ipv6_address: Deprecated: Returns true if the string passed to this function is a valid IPv6 address.
• is_mac_address: Deprecated: Returns true if the string passed to this function is a valid mac address.
• is_numeric: Wrapper that calls the Puppet 3.x function of the same name.
• is_numeric: Deprecated: Returns true if the given value is numeric.
• is_string: Wrapper that calls the Puppet 3.x function of the same name.
• is_string: Deprecated: Returns true if the variable passed to this function is a string.
• join: Deprecated: This function joins an array into a string using a separator.
• join_keys_to_values: This function joins each key of a hash to that key's corresponding value with a separator.
• keys: Deprecated: Returns the keys of a hash as an array.
• length: Deprecated: A function to eventually replace the old size() function for stdlib
• load_module_metadata: This function loads the metadata of a given module.
• loadjson: Load a JSON file containing an array, string, or hash, and return the data in the corresponding native data type.
• loadyaml: Load a YAML file containing an array, string, or hash, and return the data in the corresponding native data type.
• lstrip: Deprecated: Strips leading spaces to the left of a string.
• max: Deprecated: Returns the highest value of all arguments.
• member: This function determines if a variable is a member of an array.
• merge: Merges two or more hashes together or hashes resulting from iteration, and returns the resulting hash.
• merge: Merges two or more hashes together and returns the resulting hash.
• min: Deprecated: Returns the lowest value of all arguments.
• num2bool: This function converts a number or a string representation of a number into a true boolean.
• os_version_gte: Checks if the OS version is at least a certain version.
• parsehocon: This function accepts HOCON as a string and converts it into the correct Puppet structure
• parsejson: This function accepts JSON as a string and converts it into the correct Puppet structure.
• parseyaml: This function accepts YAML as a string and converts it into the correct Puppet structure.
• pick: This function is similar to a coalesce function in SQL in that it will return the first value in a list of values that is not undefined or an empty string.
• pick_default: This function will return the first value in a list of values that is not undefined or an empty string.
• prefix: This function applies a prefix to all elements in an array or a hash.
• private: Deprecated: Sets the current class or definition as private. Calling the class or definition from outside the current module will fail.
• pry: This function invokes a pry debugging session in the current scope object.
• pw_hash: Please note: This function is an implementation of a Ruby class and as such may not be entirely UTF8 compatible. To ensure compatibility ple
• range: When given range in the form of (start, stop) it will extrapolate a range as an array.
• regexpescape: Regexp escape a string or array of strings. Requires either a single string or an array as an input.
• reject: This function searches through an array and rejects all elements that match the provided regular expression.
• reverse: Reverses the order of a string or array.
• round: Rounds a number to the nearest integer
• rstrip: Strips leading spaces to the right of the string.
• seeded_rand: seeded_rand.rb
• seeded_rand_string: Generates a consistent random string of specific length based on provided seed.
• shell_escape: Escapes a string so that it can be safely used in a Bourne shell command line.
• shell_join: Builds a command line string from the given array of strings. Each array item is escaped for Bourne shell. All items are then joined together
• shell_split: Splits a string into an array of tokens in the same way the Bourne shell does.
• shuffle: @summary Randomizes the order of a string or array elements.
• size: Returns the number of elements in a string, an array or a hash
• sort: Sorts strings and arrays lexically.
• sprintf_hash: Uses sprintf with named references.
• squeeze: Returns a new string where runs of the same character that occur in this set are replaced by a single character.
• stdlib::end_with: Returns true if str ends with one of the prefixes given. Each of the prefixes should be a String.
• stdlib::ensure: function to cast ensure parameter to resource specific value
• stdlib::extname: Returns the Extension (the Portion of Filename in Path starting from the last Period).
• stdlib::ip_in_range: Returns true if the ipaddress is within the given CIDRs
• stdlib::start_with: Returns true if str starts with one of the prefixes given. Each of the prefixes should be a String.
• str2bool: This converts a string to a boolean.
• str2saltedpbkdf2: Convert a string into a salted SHA512 PBKDF2 password hash like requred for OS X / macOS 10.8+
• str2saltedsha512: This converts a string to a salted-SHA512 password hash (which is used for OS X versions >= 10.7).
• strip: This function removes leading and trailing whitespace from a string or from every string inside an array.
• suffix: This function applies a suffix to all elements in an array, or to the keys in a hash.
• swapcase: This function will swap the existing case of a string.
• time: This function will return the current time since epoch as an integer.
• to_bytes: Converts the argument into bytes, for example 4 kB becomes 4096.
• to_json: }
• to_json_pretty: Convert data structure and output to pretty JSON
• to_python: Convert an object into a String containing its Python representation
• to_ruby: Convert an object into a String containing its Ruby representation
• to_toml: Convert a data structure and output to TOML.
• to_yaml: }
• try_get_value
• type: DEPRECATED: This function will cease to function on Puppet 4;
• type3x: DEPRECATED: This function will be removed when Puppet 3 support is dropped; please migrate to the new parser's typing system.
• type_of: Returns the type of the passed value.
• union: This function returns a union of two or more arrays.
• unique: This function will remove duplicates from strings and arrays.
• unix2dos: Returns the DOS version of the given string.
• upcase: Converts a string or an array of strings to uppercase.
• uriescape: Urlencodes a string or array of strings. Requires either a single string or an array as an input.
• validate_absolute_path: Validate the string represents an absolute path in the filesystem.
• validate_absolute_path: Validate the string represents an absolute path in the filesystem. This function works for windows and unix style paths.
• validate_array: Validate the passed value represents an array.
• validate_array: Validate that all passed values are array data structures. Abort catalog compilation if any value fails this check.
• validate_augeas: Perform validation of a string using an Augeas lens
• validate_bool: Validate the passed value represents a boolean.
• validate_bool: Validate that all passed values are either true or false. Abort catalog compilation if any value fails this check.
• validate_cmd: Perform validation of a string with an external command.
• validate_domain_name: Validate that all values passed are syntactically correct domain names. Fail compilation if any value fails this check.
• validate_email_address: Validate that all values passed are valid email addresses. Fail compilation if any value fails this check.
• validate_hash: Validate the passed value represents a hash.
• validate_hash: Validate that all passed values are hash data structures. Abort catalog compilation if any value fails this check.
• validate_integer: Validate the passed value represents an integer.
• validate_integer: Validate that the first argument is an integer (or an array of integers). Abort catalog compilation if any of the checks fail.
• validate_ip_address: Validate the passed value represents an ip_address.
• validate_ip_address: Validate that all values passed are valid IP addresses, regardless they are IPv4 or IPv6 Fail compilation if any value fails this check.
• validate_ipv4_address: Validate the passed value represents an ipv4_address.
• validate_ipv4_address: Validate that all values passed are valid IPv4 addresses. Fail compilation if any value fails this check.
• validate_ipv6_address: Validate the passed value represents an ipv6_address.
• validate_ipv6_address: Validate that all values passed are valid IPv6 addresses. Fail compilation if any value fails this check.
• validate_legacy: Validate a value against both the target_type (new) and the previous_validation function (old).
• validate_numeric: Validate the passed value represents a numeric value.
• validate_numeric: Validate that the first argument is a numeric value (or an array of numeric values). Abort catalog compilation if any of the checks fail.
• validate_re: Perform validation of a string against one or more regular expressions.
• validate_re: Perform simple validation of a string against one or more regular expressions.
• validate_slength: Validate that a passed string has length less/equal with the passed value
• validate_slength: Validate that the first argument is a string (or an array of strings), and less/equal to than the length of the second argument. An optional third parameter can be given the minimum length. It fails if the first argument is not a string or array of strings, and if arg 2 and arg 3 are not convertable to a number.
• validate_string: Validate that all passed values are string data structures.
• validate_string: Validate that all passed values are string data structures
• validate_x509_rsa_key_pair: Validates a PEM-formatted X.509 certificate and RSA private key using OpenSSL. Verifies that the certficate's signature was created from the supplied key.
• values: When given a hash this function will return the values of that hash.
• values_at: Finds value inside an array based on location.
• zip: Takes one element from first array and merges corresponding elements from second array.

Data types

• Stdlib::Absolutepath: A strict absolutepath type
• Stdlib::Base32: Type to match base32 String
• Stdlib::Base64: Type to match base64 String
• Stdlib::Compat::Absolute_path: Emulate the is_absolute_path and validate_absolute_path functions The first pattern is originally from is_absolute_path, which had it from 2
• Stdlib::Compat::Array: Emulate the is_array and validate_array functions
• Stdlib::Compat::Bool: Emulate the is_bool and validate_bool functions
• Stdlib::Compat::Float: Emulate the is_float function The regex is what's currently used in is_float To keep your development moving forward, you can also add a depr
• Stdlib::Compat::Hash: Emulate the is_hash and validate_hash functions
• Stdlib::Compat::Integer: Emulate the is_integer and validate_integer functions The regex is what's currently used in is_integer validate_numeric also allows range che
• Stdlib::Compat::Ip_address
• Stdlib::Compat::Ipv4: Emulate the validate_ipv4_address and is_ipv4_address functions
• Stdlib::Compat::Ipv6
• Stdlib::Compat::Numeric: Emulate the is_numeric and validate_numeric functions The regex is what's currently used in is_numeric validate_numeric also allows range che
• Stdlib::Compat::String: Emulate the is_string and validate_string functions
• Stdlib::Datasize
• Stdlib::Email: https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address lint:ignore:140chars
• Stdlib::Ensure::File
• Stdlib::Ensure::File::Directory
• Stdlib::Ensure::File::File
• Stdlib::Ensure::File::Link
• Stdlib::Ensure::Service
• Stdlib::Filemode: See man chmod.1 for the regular expression for symbolic mode lint:ignore:140chars
• Stdlib::Filesource: Validate the source parameter on file types
• Stdlib::Fqdn
• Stdlib::HTTPSUrl
• Stdlib::HTTPUrl
• Stdlib::Host
• Stdlib::HttpStatus
• Stdlib::IP::Address
• Stdlib::IP::Address::Nosubnet
• Stdlib::IP::Address::V4
• Stdlib::IP::Address::V4::CIDR: lint:ignore:140chars
• Stdlib::IP::Address::V4::Nosubnet: lint:ignore:140chars
• Stdlib::IP::Address::V6
• Stdlib::IP::Address::V6::Alternative: lint:ignore:140chars
• Stdlib::IP::Address::V6::CIDR: lint:ignore:140chars
• Stdlib::IP::Address::V6::Compressed
• Stdlib::IP::Address::V6::Full
• Stdlib::IP::Address::V6::Nosubnet
• Stdlib::IP::Address::V6::Nosubnet::Alternative: lint:ignore:140chars
• Stdlib::IP::Address::V6::Nosubnet::Compressed
• Stdlib::IP::Address::V6::Nosubnet::Full
• Stdlib::MAC: A type for a MAC address
• Stdlib::ObjectStore
• Stdlib::ObjectStore::GSUri
• Stdlib::ObjectStore::S3Uri
• Stdlib::Port
• Stdlib::Port::Dynamic
• Stdlib::Port::Ephemeral
• Stdlib::Port::Privileged
• Stdlib::Port::Registered
• Stdlib::Port::Unprivileged
• Stdlib::Port::User
• Stdlib::Syslogfacility
• Stdlib::Unixpath: this regex rejects any path component that does not start with "/" or is NUL
• Stdlib::Windowspath
• Stdlib::Yes_no

Classes

stdlib

Most of stdlib's features are automatically loaded by Puppet, but this class should be declared in order to use the standardized run stages.

Declares all other classes in the stdlib module. Currently, this consists of stdlib::stages.

stdlib::stages

Declares various run-stages for deploying infrastructure, language runtimes, and application layers.

The high level stages are (in order):

• setup
• main
• runtime
• setup_infra
• deploy_infra
• setup_app
• deploy_app
• deploy

Examples

node default {
  include ::stdlib
  class { java: stage => 'runtime' }
}

Resource types

anchor

Note: this has been replaced by core puppet contain() method. Please see https://puppet.com/docs/puppet/latest/lang_containment.html for more information.

In Puppet 2.6, when a class declares another class, the resources in the interior class are not contained by the exterior class. This interacts badly with the pattern of composing complex modules from smaller classes, as it makes it impossible for end users to specify order relationships between the exterior class and other modules.

The anchor type lets you work around this. By sandwiching any interior classes between two no-op resources that are contained by the exterior class, you can ensure that all resources in the module are contained.

class ntp {
  # These classes will have the correct order relationship with each
  # other. However, without anchors, they won't have any order
  # relationship to Class['ntp'].
  class { 'ntp::package': }
  -> class { 'ntp::config': }
  -> class { 'ntp::service': }

  # These two resources "anchor" the composed classes within the ntp
  # class.
  anchor { 'ntp::begin': } -> Class['ntp::package']
  Class['ntp::service']    -> anchor { 'ntp::end': }
}

This allows the end user of the ntp module to establish require and before relationships with Class['ntp']:

class { 'ntp': } -> class { 'mcollective': }
class { 'mcollective': } -> class { 'ntp': }

Parameters

The following parameters are available in the anchor type.

• name

name

namevar

The name of the anchor resource.

file_line

The implementation matches the full line, including whitespace at the beginning and end. If the line is not contained in the given file, Puppet will append the line to the end of the file to ensure the desired state. Multiple resources may be declared to manage multiple lines in the same file.

• Ensure Example

file_line { 'sudo_rule':
  path => '/etc/sudoers',
  line => '%sudo ALL=(ALL) ALL',
}

file_line { 'sudo_rule_nopw':
  path => '/etc/sudoers',
  line => '%sudonopw ALL=(ALL) NOPASSWD: ALL',
}

In this example, Puppet will ensure both of the specified lines are contained in the file /etc/sudoers.

• Match Example

file_line { 'bashrc_proxy':
  ensure => present,
  path   => '/etc/bashrc',
  line   => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
  match  => '^export\ HTTP_PROXY\=',
}

In this code example match will look for a line beginning with export followed by HTTP_PROXY and replace it with the value in line.

• Examples With ensure => absent:

This type has two behaviors when ensure => absent is set.

One possibility is to set match => ... and match_for_absence => true, as in the following example:

file_line { 'bashrc_proxy':
  ensure            => absent,
  path              => '/etc/bashrc',
  match             => '^export\ HTTP_PROXY\=',
  match_for_absence => true,
}

In this code example match will look for a line beginning with export followed by HTTP_PROXY and delete it. If multiple lines match, an error will be raised unless the multiple => true parameter is set.

Note that the line => ... parameter would be accepted BUT IGNORED in the above example.

The second way of using ensure => absent is to specify a line => ..., and no match:

file_line { 'bashrc_proxy':
  ensure => absent,
  path   => '/etc/bashrc',
  line   => 'export HTTP_PROXY=http://squid.puppetlabs.vm:3128',
}

Note: When ensuring lines are absent this way, the default behavior this time is to always remove all lines matching, and this behavior can't be disabled.

• Encoding example:

file_line { "XScreenSaver":
  ensure   => present,
  path     => '/root/XScreenSaver',
  line     => "*lock: 10:00:00",
  match    => '^*lock:',
  encoding => "iso-8859-1",
}

Files with special characters that are not valid UTF-8 will give the error message "invalid byte sequence in UTF-8". In this case, determine the correct file encoding and specify the correct encoding using the encoding attribute, the value of which needs to be a valid Ruby character encoding.

Autorequires: If Puppet is managing the file that will contain the line being managed, the file_line resource will autorequire that file.

Properties

The following properties are available in the file_line type.

ensure

Valid values: present, absent

Manage the state of this type.

Default value: present

line

The line to be appended to the file or used to replace matches found by the match attribute.

Parameters

The following parameters are available in the file_line type.

• after
• append_on_no_match
• encoding
• match
• match_for_absence
• multiple
• name
• path
• provider
• replace
• replace_all_matches_not_matching_line

after

An optional value used to specify the line after which we will add any new lines. (Existing lines are added in place) This is also takes a regex.

append_on_no_match

Valid values: true, false

If true, append line if match is not found. If false, do not append line if a match is not found

Default value: true

encoding

For files that are not UTF-8 encoded, specify encoding such as iso-8859-1

Default value: UTF-8

match

An optional ruby regular expression to run against existing lines in the file. If a match is found, we replace that line rather than adding a new line. A regex comparison is performed against the line value and if it does not match an exception will be raised.

match_for_absence

Valid values: true, false

An optional value to determine if match should be applied when ensure => absent. If set to true and match is set, the line that matches match will be deleted. If set to false (the default), match is ignored when ensure => absent. When ensure => present, match_for_absence is ignored.

Default value: false

multiple

Valid values: true, false

An optional value to determine if match can change multiple lines. If set to false, an exception will be raised if more than one line matches

name

namevar

An arbitrary name used as the identity of the resource.

path

The file Puppet will ensure contains the line specified by the line parameter.

provider

The specific backend to use for this file_line resource. You will seldom need to specify this --- Puppet will usually discover the appropriate provider for your platform.

replace

Valid values: true, false

If true, replace line that matches. If false, do not write line if a match is found

Default value: true

replace_all_matches_not_matching_line

Valid values: true, false

Configures the behavior of replacing all lines in a file which match the match parameter regular expression, regardless of whether the specified line is already present in the file.

Default value: false

Functions

abs

Type: Ruby 3.x API

For example -34.56 becomes 34.56. Takes a single integer or float value as an argument.

Note: Deprected from Puppet 6.0.0, the built-in 'abs'function will be used instead.

abs()

For example -34.56 becomes 34.56. Takes a single integer or float value as an argument.

Note: Deprected from Puppet 6.0.0, the built-in 'abs'function will be used instead.

Returns: Any The absolute value of the given number if it was an Integer

any2array

Type: Ruby 3.x API

Empty argument lists are converted to an empty array. Arrays are left untouched. Hashes are converted to arrays of alternating keys and values.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in Array.new function is used to create a new Array..

$hsh = {'key' => 42, 'another-key' => 100}
notice(Array($hsh))

Would notice [['key', 42], ['another-key', 100]]

The Array data type also has a special mode to "create an array if not already an array"

notice(Array({'key' => 42, 'another-key' => 100}, true))

Would notice [{'key' => 42, 'another-key' => 100}], as the true flag prevents the hash from being transformed into an array.

any2array()

Empty argument lists are converted to an empty array. Arrays are left untouched. Hashes are converted to arrays of alternating keys and values.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in Array.new function is used to create a new Array..

$hsh = {'key' => 42, 'another-key' => 100}
notice(Array($hsh))

Would notice [['key', 42], ['another-key', 100]]

The Array data type also has a special mode to "create an array if not already an array"

notice(Array({'key' => 42, 'another-key' => 100}, true))

Would notice [{'key' => 42, 'another-key' => 100}], as the true flag prevents the hash from being transformed into an array.

Returns: Array The new array containing the given object

any2bool

Type: Ruby 3.x API

In practise it does the following:

• Strings such as Y,y,1,T,t,TRUE,yes,'true' will return true
• Strings such as 0,F,f,N,n,FALSE,no,'false' will return false
• Booleans will just return their original value
• Number (or a string representation of a number) > 0 will return true, otherwise false
• undef will return false
• Anything else will return true

Also see the built-in Boolean.new function.

any2bool()

In practise it does the following:

• Strings such as Y,y,1,T,t,TRUE,yes,'true' will return true
• Strings such as 0,F,f,N,n,FALSE,no,'false' will return false
• Booleans will just return their original value
• Number (or a string representation of a number) > 0 will return true, otherwise false
• undef will return false
• Anything else will return true

Also see the built-in Boolean.new function.

Returns: Boolean The boolean value of the object that was given

assert_private

Type: Ruby 3.x API

Calling the class or definition from outside the current module will fail.

assert_private()

Calling the class or definition from outside the current module will fail.

Returns: Any set the current class or definition as private.

base64

Type: Ruby 3.x API

*Note: Since Puppet 4.8.0, the Binary data type can be used to produce base 64 encoded strings. See the new() function for the Binary and String types for documentation. Also see binary_file() function for reading a file with binary (non UTF-8) content.

Examples

Example usage

Encode and decode a string

  $encodestring = base64('encode', 'thestring')
  $decodestring = base64('decode', 'dGhlc3RyaW5n')

Explicitly define encode/decode method: default, strict, urlsafe

  $method = 'default'
  $encodestring = base64('encode', 'thestring', $method)
  $decodestring = base64('decode', 'dGhlc3RyaW5n', $method)

Encode a string as if it was binary

 $encodestring = String(Binary('thestring', '%s'))

Decode a Binary assuming it is an UTF-8 String

 $decodestring = String(Binary("dGhlc3RyaW5n"), "%s")

base64()

*Note: Since Puppet 4.8.0, the Binary data type can be used to produce base 64 encoded strings. See the new() function for the Binary and String types for documentation. Also see binary_file() function for reading a file with binary (non UTF-8) content.

Returns: String The encoded/decoded va

Examples

Example usage

Encode and decode a string

  $encodestring = base64('encode', 'thestring')
  $decodestring = base64('decode', 'dGhlc3RyaW5n')

Explicitly define encode/decode method: default, strict, urlsafe

  $method = 'default'
  $encodestring = base64('encode', 'thestring', $method)
  $decodestring = base64('decode', 'dGhlc3RyaW5n', $method)

Encode a string as if it was binary

 $encodestring = String(Binary('thestring', '%s'))

Decode a Binary assuming it is an UTF-8 String

 $decodestring = String(Binary("dGhlc3RyaW5n"), "%s")

basename

Type: Ruby 3.x API

Strips directory (and optional suffix) from a filename

basename()

The basename function.

Returns: String The stripped filename

bool2num

Type: Ruby 3.x API

Converts the values:

false, f, 0, n, and no to 0
true, t, 1, y, and yes to 1

Requires a single boolean or string as an input.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in Numeric.new, Integer.new, and Float.new function are used to convert to numeric values.

notice(Integer(false)) # Notices 0
notice(Float(true))    # Notices 1.0

bool2num()

Converts the values:

false, f, 0, n, and no to 0
true, t, 1, y, and yes to 1

Requires a single boolean or string as an input.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in Numeric.new, Integer.new, and Float.new function are used to convert to numeric values.

notice(Integer(false)) # Notices 0
notice(Float(true))    # Notices 1.0

Returns: Integer The converted value as a number

bool2str

Type: Ruby 3.x API

The optional second and third arguments represent what true and false will be converted to respectively. If only one argument is given, it will be converted from a boolean to a string containing 'true' or 'false'.

Examples of usage

  bool2str(true)                    => 'true'
  bool2str(true, 'yes', 'no')       => 'yes'
  bool2str(false, 't', 'f')         => 'f'

Requires a single boolean as an input.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in String.new function is used to convert to String with many different format options.

  notice(String(false))         # Notices 'false'
  notice(String(true))          # Notices 'true'
  notice(String(false, '%y'))   # Notices 'yes'
  notice(String(true, '%y'))    # Notices 'no'

bool2str()

The optional second and third arguments represent what true and false will be converted to respectively. If only one argument is given, it will be converted from a boolean to a string containing 'true' or 'false'.

Examples of usage

  bool2str(true)                    => 'true'
  bool2str(true, 'yes', 'no')       => 'yes'
  bool2str(false, 't', 'f')         => 'f'

Requires a single boolean as an input.

Note: since Puppet 5.0.0 it is possible to create new data types for almost any datatype using the type system and the built-in String.new function is used to convert to String with many different format options.

  notice(String(false))         # Notices 'false'
  notice(String(true))          # Notices 'true'
  notice(String(false, '%y'))   # Notices 'yes'
  notice(String(true, '%y'))    # Notices 'no'

Returns: Any The converted value to string of the given Boolean

camelcase

Type: Ruby 3.x API

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in camelcase function.

camelcase()

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in camelcase function.

Returns: String The converted String, if it was a String that was given

capitalize

Type: Ruby 3.x API

Requires either a single string or an array as an input.

Note: Deprecated from Puppet 6.0.0, yhis function has been replaced with a built-in capitalize function.

capitalize()

Requires either a single string or an array as an input.

Note: Deprecated from Puppet 6.0.0, yhis function has been replaced with a built-in capitalize function.

Returns: String The converted String, if it was a String that was given

ceiling

Type: Ruby 3.x API

Takes a single numeric value as an argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in ceiling function.

ceiling()

Takes a single numeric value as an argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in ceiling function.

Returns: Integer The rounded value

chomp

Type: Ruby 3.x API

For example hello\n becomes hello. Requires a single string or array as an input.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in chomp function.

chomp()

For example hello\n becomes hello. Requires a single string or array as an input.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in chomp function.

Returns: String The converted String, if it was a String that was given

chop

Type: Ruby 3.x API

If the string ends with \r\n, both characters are removed. Applying chop to an empty string returns an empty string. If you wish to merely remove record separators then you should use the chomp function. Requires a string or array of strings as input.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in chop function.

chop()

If the string ends with \r\n, both characters are removed. Applying chop to an empty string returns an empty string. If you wish to merely remove record separators then you should use the chomp function. Requires a string or array of strings as input.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in chop function.

Returns: String The given String, sans the last character.

clamp

Type: Ruby 3.x API

Strings are converted and compared numerically. Arrays of values are flattened into a list for further handling.

Note: From Puppet 6.0.0 this can be done with only core Puppet like this: [$minval, $maxval, $value_to_clamp].sort[1]

Examples

Example usage

clamp('24', [575, 187])` returns 187.
clamp(16, 88, 661)` returns 88.
clamp([4, 3, '99'])` returns 4.

clamp()

Strings are converted and compared numerically. Arrays of values are flattened into a list for further handling.

Note: From Puppet 6.0.0 this can be done with only core Puppet like this: [$minval, $maxval, $value_to_clamp].sort[1]

Returns: Array[Integer] The sorted Array

Examples

Example usage

clamp('24', [575, 187])` returns 187.
clamp(16, 88, 661)` returns 88.
clamp([4, 3, '99'])` returns 4.

concat

Type: Ruby 3.x API

Note: Since Puppet 4.0, you can use the +`` operator for concatenation of arrays and merge of hashes, and the <<`` operator for appending:

['1','2','3'] + ['4','5','6'] + ['7','8','9'] returns ['1','2','3','4','5','6','7','8','9'] [1, 2, 3] << 4 returns [1, 2, 3, 4] [1, 2, 3] << [4, 5] returns [1, 2, 3, [4, 5]]

Examples

Example usage

concat(['1','2','3'],'4') returns ['1','2','3','4']
concat(['1','2','3'],'4',['5','6','7']) returns ['1','2','3','4','5','6','7']

concat()

Note: Since Puppet 4.0, you can use the +`` operator for concatenation of arrays and merge of hashes, and the <<`` operator for appending:

['1','2','3'] + ['4','5','6'] + ['7','8','9'] returns ['1','2','3','4','5','6','7','8','9'] [1, 2, 3] << 4 returns [1, 2, 3, 4] [1, 2, 3] << [4, 5] returns [1, 2, 3, [4, 5]]

Returns: Array The single concatenated array

Examples

Example usage

concat(['1','2','3'],'4') returns ['1','2','3','4']
concat(['1','2','3'],'4',['5','6','7']) returns ['1','2','3','4','5','6','7']

convert_base

Type: Ruby 3.x API

convert_base(5, 2)results in:'101' convert_base('254', '16') results in: 'fe'

Note: Since Puppet 4.5.0 this can be done with the built-in String.new function and its many formatting options:

$binary_repr = String(5, '%b') return "101" $hex_repr = String(254, "%x") return "fe" $hex_repr = String(254, "%#x") return "0xfe"

@return [String] The converted value as a Str

Examples

Example usage

convert_base()

convert_base(5, 2)results in:'101' convert_base('254', '16') results in: 'fe'

Note: Since Puppet 4.5.0 this can be done with the built-in String.new function and its many formatting options:

$binary_repr = String(5, '%b') return "101" $hex_repr = String(254, "%x") return "fe" $hex_repr = String(254, "%#x") return "0xfe"

@return [String] The converted value as a Str

Returns: Any converted value as a string

Examples

Example usage

count

Type: Ruby 3.x API

Takes an array as first argument and an optional second argument. Counts the number of elements in array that is equal to the second argument. If called with only an array, it counts the number of elements that are not nil/undef/empty-string.

Note: equality is tested with a Ruby method and it is therefore subject to what Ruby considers to be equal. For strings this means that equality is case sensitive.

In Puppet core, counting can be done in general by using a combination of the core functions filter() (since Puppet 4.0.0) and length() (since Puppet 5.5.0, before that in stdlib).

Example below shows counting values that are not undef.

notice([42, "hello", undef].filter |$x| { $x =~ NotUndef }.length)

Would notice the value 2.

count()

Takes an array as first argument and an optional second argument. Counts the number of elements in array that is equal to the second argument. If called with only an array, it counts the number of elements that are not nil/undef/empty-string.

Note: equality is tested with a Ruby method and it is therefore subject to what Ruby considers to be equal. For strings this means that equality is case sensitive.

In Puppet core, counting can be done in general by using a combination of the core functions filter() (since Puppet 4.0.0) and length() (since Puppet 5.5.0, before that in stdlib).

Example below shows counting values that are not undef.

notice([42, "hello", undef].filter |$x| { $x =~ NotUndef }.length)

Would notice the value 2.

Returns: Integer The amount of elements counted within the array

deep_merge

Type: Ruby 3.x API

Recursively merges two or more hashes together and returns the resulting hash.

Examples

Example usage

$hash1 = {'one' => 1, 'two' => 2, 'three' => { 'four' => 4 } }
$hash2 = {'two' => 'dos', 'three' => { 'five' => 5 } }
$merged_hash = deep_merge($hash1, $hash2)

The resulting hash is equivalent to:

$merged_hash = { 'one' => 1, 'two' => 'dos', 'three' => { 'four' => 4, 'five' => 5 } }

When there is a duplicate key that is a hash, they are recursively merged.
When there is a duplicate key that is not a hash, the key in the rightmost hash will "win."

deep_merge()

The deep_merge function.

Returns: Hash The merged h

Examples

Example usage

$hash1 = {'one' => 1, 'two' => 2, 'three' => { 'four' => 4 } }
$hash2 = {'two' => 'dos', 'three' => { 'five' => 5 } }
$merged_hash = deep_merge($hash1, $hash2)

The resulting hash is equivalent to:

$merged_hash = { 'one' => 1, 'two' => 'dos', 'three' => { 'four' => 4, 'five' => 5 } }

When there is a duplicate key that is a hash, they are recursively merged.
When there is a duplicate key that is not a hash, the key in the rightmost hash will "win."

defined_with_params

Type: Ruby 3.x API

The defined_with_params function.

defined_with_params()

The defined_with_params function.

Returns: Any

delete

Type: Ruby 3.x API

Note: From Puppet 4.0.0 the minus (-) operator deletes values from arrays and keys from a hash {'a'=>1,'b'=>2,'c'=>3} - ['b','c'])

A global delete from a string can be performed with the regsubst function: 'abracadabra'.regsubst(/bra/, '', 'G')

In general, the built-in filter function can filter out entries from arrays and hashes based on keys and/or values.

Examples

Example usage

delete(['a','b','c','b'], 'b')
Would return: ['a','c']

delete({'a'=>1,'b'=>2,'c'=>3}, 'b')
Would return: {'a'=>1,'c'=>3}

delete({'a'=>1,'b'=>2,'c'=>3}, ['b','c'])
Would return: {'a'=>1}

delete('abracadabra', 'bra')
Would return: 'acada'

['a', 'b', 'c', 'b'] - 'b'
Would return: ['a', 'c']

{'a'=>1,'b'=>2,'c'=>3} - ['b','c'])
Would return: {'a' => '1'}

'abracadabra'.regsubst(/bra/, '', 'G')
Would return: 'acada'

delete()

Note: From Puppet 4.0.0 the minus (-) operator deletes values from arrays and keys from a hash {'a'=>1,'b'=>2,'c'=>3} - ['b','c'])

A global delete from a string can be performed with the regsubst function: 'abracadabra'.regsubst(/bra/, '', 'G')

In general, the built-in filter function can filter out entries from arrays and hashes based on keys and/or values.

Returns: String The filtered String, if one was given.

Examples

Example usage

delete(['a','b','c','b'], 'b')
Would return: ['a','c']

delete({'a'=>1,'b'=>2,'c'=>3}, 'b')
Would return: {'a'=>1,'c'=>3}

delete({'a'=>1,'b'=>2,'c'=>3}, ['b','c'])
Would return: {'a'=>1}

delete('abracadabra', 'bra')
Would return: 'acada'

['a', 'b', 'c', 'b'] - 'b'
Would return: ['a', 'c']

{'a'=>1,'b'=>2,'c'=>3} - ['b','c'])
Would return: {'a' => '1'}

'abracadabra'.regsubst(/bra/, '', 'G')
Would return: 'acada'

delete_at

Type: Ruby 3.x API

For example delete_at(['a','b','c'], 1)

Would return: ['a','c']

Note: Since Puppet 4 this can be done in general with the built-in filter function:

['a', 'b', 'c'].filter |$pos, $val | { $pos != 1 }

Or if a delete is wanted from the beginning or end of the array, by using the slice operator [ ]:

$array[0, -1] # the same as all the values
$array[2, -1] # all but the first 2 elements
$array[0, -3] # all but the last 2 elements
$array[1, -2] # all but the first and last element

delete_at()

For example delete_at(['a','b','c'], 1)

Would return: ['a','c']

Note: Since Puppet 4 this can be done in general with the built-in filter function:

['a', 'b', 'c'].filter |$pos, $val | { $pos != 1 }

Or if a delete is wanted from the beginning or end of the array, by using the slice operator [ ]:

$array[0, -1] # the same as all the values
$array[2, -1] # all but the first 2 elements
$array[0, -3] # all but the last 2 elements
$array[1, -2] # all but the first and last element

Returns: Array The given array, now missing the tar

delete_regex

Type: Ruby 3.x API

Multiple regular expressions are assumed to be matched as an OR.

Note: Since Puppet 4 this can be done in general with the built-in filter function: ["aaa", "aba", "aca"].filter |$val| { $val !~ /b/ } Would return: ['aaa', 'aca']

Examples

Example usage

delete_regex(['a','b','c','b'], 'b')
Would return: ['a','c']

delete_regex(['a','b','c','b'], ['b', 'c'])
Would return: ['a']

delete_regex({'a'=>1,'b'=>2,'c'=>3}, 'b')
Would return: {'a'=>1,'c'=>3}

delete_regex({'a'=>1,'b'=>2,'c'=>3}, '^a$')
Would return: {'b'=>2,'c'=>3}

delete_regex()

Multiple regular expressions are assumed to be matched as an OR.

Note: Since Puppet 4 this can be done in general with the built-in filter function: ["aaa", "aba", "aca"].filter |$val| { $val !~ /b/ } Would return: ['aaa', 'aca']

Returns: Array The given array now missing all targeted values.

Examples

Example usage

delete_regex(['a','b','c','b'], 'b')
Would return: ['a','c']

delete_regex(['a','b','c','b'], ['b', 'c'])
Would return: ['a']

delete_regex({'a'=>1,'b'=>2,'c'=>3}, 'b')
Would return: {'a'=>1,'c'=>3}

delete_regex({'a'=>1,'b'=>2,'c'=>3}, '^a$')
Would return: {'b'=>2,'c'=>3}

delete_undef_values

Type: Ruby 3.x API

Note: Since Puppet 4.0.0 the equivalent can be performed with the built-in filter function: $array.filter |$val| { $val =~ NotUndef } $hash.filter |$key, $val| { $val =~ NotUndef }

Examples

Example usage

$hash = delete_undef_values({a=>'A', b=>'', c=>undef, d => false})
Would return: {a => 'A', b => '', d => false}

While:
$array = delete_undef_values(['A','',undef,false])
Would return: ['A','',false]

delete_undef_values()

Note: Since Puppet 4.0.0 the equivalent can be performed with the built-in filter function: $array.filter |$val| { $val =~ NotUndef } $hash.filter |$key, $val| { $val =~ NotUndef }

Returns: Array The given array now issing of undefined values.

Examples

Example usage

$hash = delete_undef_values({a=>'A', b=>'', c=>undef, d => false})
Would return: {a => 'A', b => '', d => false}

While:
$array = delete_undef_values(['A','',undef,false])
Would return: ['A','',false]

delete_values

Type: Ruby 3.x API

Note: Since Puppet 4.0.0 the equivalent can be performed with the built-in filter function: $array.filter |$val| { $val != 'B' } $hash.filter |$key, $val| { $val != 'B' }

Examples

Example usage

delete_values({'a'=>'A','b'=>'B','c'=>'C','B'=>'D'}, 'B')
Would return: {'a'=>'A','c'=>'C','B'=>'D'}

delete_values()

Note: Since Puppet 4.0.0 the equivalent can be performed with the built-in filter function: $array.filter |$val| { $val != 'B' } $hash.filter |$key, $val| { $val != 'B' }

Returns: Hash The given hash now missing all instances of the targeted value

Examples

Example usage

delete_values({'a'=>'A','b'=>'B','c'=>'C','B'=>'D'}, 'B')
Would return: {'a'=>'A','c'=>'C','B'=>'D'}

deprecation

Type: Ruby 4.x API

Function to print deprecation warnings, Logs a warning once for a given key.

The uniqueness key - can appear once. The msg is the message text including any positional information that is formatted by the user/caller of the method. It is affected by the puppet setting 'strict', which can be set to :error (outputs as an error message), :off (no message / error is displayed) and :warning (default, outputs a warning) Type: String, String.

deprecation(String $key, String $message)

Function to print deprecation warnings, Logs a warning once for a given key.

The uniqueness key - can appear once. The msg is the message text including any positional information that is formatted by the user/caller of the method. It is affected by the puppet setting 'strict', which can be set to :error (outputs as an error message), :off (no message / error is displayed) and :warning (default, outputs a warning) Type: String, String.

Returns: Any deprecated warnings

key

Data type: String

message

Data type: String

deprecation

Type: Ruby 3.x API

The uniqueness key - can appear once. The msg is the message text including any positional information that is formatted by the user/caller of the method.).

deprecation()

The uniqueness key - can appear once. The msg is the message text including any positional information that is formatted by the user/caller of the method.).

Returns: String return deprecation warnings

difference

Type: Ruby 3.x API

The returned array is a copy of the original array, removing any items that also appear in the second array.

Note: Since Puppet 4 the minus (-) operator in the Puppet language does the same thing: ['a', 'b', 'c'] - ['b', 'c', 'd'] Would return: ['a']

Examples

Example usage

difference(["a","b","c"],["b","c","d"])
Would return: `["a"]`

difference()

The returned array is a copy of the original array, removing any items that also appear in the second array.

Note: Since Puppet 4 the minus (-) operator in the Puppet language does the same thing: ['a', 'b', 'c'] - ['b', 'c', 'd'] Would return: ['a']

Returns: Array The difference between the two given arrays

Examples

Example usage

difference(["a","b","c"],["b","c","d"])
Would return: `["a"]`

dig

Type: Ruby 3.x API

In addition to the required path argument, the function accepts the default argument. It is returned if the path is not correct, if no value was found, or if any other error has occurred.

$data = {
  'a' => {
    'b' => [
      'b1',
      'b2',
      'b3',
    ]
  }
}

$value = dig($data, ['a', 'b', 2])
# $value = 'b3'

# with all possible options
$value = dig($data, ['a', 'b', 2], 'not_found')
# $value = 'b3'

# using the default value
$value = dig($data, ['a', 'b', 'c', 'd'], 'not_found')
# $value = 'not_found'

1. $data The data structure we are working with.
2. ['a', 'b', 2] The path array.
3. not_found The default value. It is returned if nothing is found.

Note:* Deprecated** This function has been replaced with a built-in dig function as of Puppet 4.5.0. Use dig44() for backwards compatibility or use the new version.

dig()

In addition to the required path argument, the function accepts the default argument. It is returned if the path is not correct, if no value was found, or if any other error has occurred.

$data = {
  'a' => {
    'b' => [
      'b1',
      'b2',
      'b3',
    ]
  }
}

$value = dig($data, ['a', 'b', 2])
# $value = 'b3'

# with all possible options
$value = dig($data, ['a', 'b', 2], 'not_found')
# $value = 'b3'

# using the default value
$value = dig($data, ['a', 'b', 'c', 'd'], 'not_found')
# $value = 'not_found'

1. $data The data structure we are working with.
2. ['a', 'b', 2] The path array.
3. not_found The default value. It is returned if nothing is found.

Note:* Deprecated** This function has been replaced with a built-in dig function as of Puppet 4.5.0. Use dig44() for backwards compatibility or use the new version.

Returns: Any The function goes through the structure by each path component and tries to return the value at the end of the path.

dig44

Type: Ruby 3.x API

The dig44 function.

dig44()

The dig44 function.

Returns: Any

dirname

Type: Ruby 3.x API

Returns the dirname of a path.

dirname()

The dirname function.

Returns: String the given path's dirname

dos2unix

Type: Ruby 3.x API

Takes a single string argument.

dos2unix()

Takes a single string argument.

Returns: Any The retrieved version

downcase

Type: Ruby 3.x API

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in downcase function.

This function is an implementation of a Ruby class and might not be UTF8 compatible. To ensure compatibility, use this function with Ruby 2.4.0 or greater.

downcase()

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in downcase function.

This function is an implementation of a Ruby class and might not be UTF8 compatible. To ensure compatibility, use this function with Ruby 2.4.0 or greater.

Returns: String The converted String, if it was a String that was given

empty

Type: Ruby 3.x API

Note: Deprecated from Puppet 5.5.0, the built-in empty function will be used instead.

empty()

Note: Deprecated from Puppet 5.5.0, the built-in empty function will be used instead.

Returns: Any 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.

enclose_ipv6

Type: Ruby 3.x API

Takes an array of ip addresses and encloses the ipv6 addresses with square brackets.

enclose_ipv6()

The enclose_ipv6 function.

Returns: Any encloses the ipv6 addresses with square brackets.

ensure_packages

Type: Ruby 3.x API

It optionally takes a hash as a second parameter that will be passed as the third argument to the ensure_resource() function.

ensure_packages()

It optionally takes a hash as a second parameter that will be passed as the third argument to the ensure_resource() function.

Returns: Any install the passed packages

ensure_resource

Type: Ruby 3.x API

The ensure_resource function.

ensure_resource()

The ensure_resource function.

Returns: Any

ensure_resources

Type: Ruby 3.x API

The ensure_resources function.

ensure_resources()

The ensure_resources function.

Returns: Any

fact

Type: Ruby 4.x API

Supports the use of dot-notation for referring to structured facts. If a fact requested does not exist, returns Undef.

Examples

Example usage:

fact('osfamily')
fact('os.architecture')

Array indexing:

fact('mountpoints."/dev".options.1')

Fact containing a "." in the name:

fact('vmware."VRA.version"')

fact(String $fact_name)

Supports the use of dot-notation for referring to structured facts. If a fact requested does not exist, returns Undef.

Returns: Any All information retrieved on the given fact_name

Examples

Example usage:

fact('osfamily')
fact('os.architecture')

Array indexing:

fact('mountpoints."/dev".options.1')

Fact containing a "." in the name:

fact('vmware."VRA.version"')

fact_name

Data type: String

The name of the fact to check

flatten

Type: Ruby 3.x API

Note: Deprecated from Puppet 5.5.0, this function has been replaced with a built-in flatten function.

Examples

Example usage

flatten(['a', ['b', ['c']]])` returns: `['a','b','c']

flatten()

Note: Deprecated from Puppet 5.5.0, this function has been replaced with a built-in flatten function.

Returns: Any convert nested arrays into a single flat array

Examples

Example usage

flatten(['a', ['b', ['c']]])` returns: `['a','b','c']

floor

Type: Ruby 3.x API

Takes a single numeric value as an argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in floor function.

floor()

Takes a single numeric value as an argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in floor function.

Returns: Any the largest integer less or equal to the argument.

fqdn_rand_string

Type: Ruby 3.x API

The fqdn_rand_string function.

fqdn_rand_string()

The fqdn_rand_string function.

Returns: Any

fqdn_rotate

Type: Ruby 3.x API

fqdn_rotate.rb

fqdn_rotate()

fqdn_rotate.rb

Returns: Any

fqdn_uuid

Type: Ruby 3.x API

Returns a RFC 4122 valid version 5 UUID based on an FQDN string under the DNS namespace

Examples

Example Usage:

fqdn_uuid('puppetlabs.com') # Returns '9c70320f-6815-5fc5-ab0f-debe68bf764c'
fqdn_uuid('google.com') # Returns '64ee70a4-8cc1-5d25-abf2-dea6c79a09

fqdn_uuid()

The fqdn_uuid function.

Returns: Any Returns a RFC 4122 valid version 5 UUID

Examples

Example Usage:

fqdn_uuid('puppetlabs.com') # Returns '9c70320f-6815-5fc5-ab0f-debe68bf764c'
fqdn_uuid('google.com') # Returns '64ee70a4-8cc1-5d25-abf2-dea6c79a09

get_module_path

Type: Ruby 3.x API

Note: that since Puppet 5.4.0 the built-in module_directory function in Puppet does the same thing and will return the path to the first found module if given multiple values or an array.

Examples

Example Usage:

$module_path = get_module_path('stdlib')

get_module_path()

Note: that since Puppet 5.4.0 the built-in module_directory function in Puppet does the same thing and will return the path to the first found module if given multiple values or an array.

Returns: Any Returns the absolute path of the specified module for the current environment.

Examples

Example Usage:

$module_path = get_module_path('stdlib')

getparam

Type: Ruby 3.x API

The getparam function.

getparam()

The getparam function.

Returns: Any

getvar

Type: Ruby 3.x API

Note: from Puppet 6.0.0, the compatible function with the same name in Puppet core will be used instead of this function. The new function also has support for digging into a structured value. See the built-in getvar funct

Examples

Example usage

$foo = getvar('site::data::foo') # Equivalent to $foo = $site::data::foo

Where namespace is stored in a string

$datalocation = 'site::data'
$bar = getvar("${datalocation}::bar") # Equivalent to $bar = $site::data::bar

getvar()

Note: from Puppet 6.0.0, the compatible function with the same name in Puppet core will be used instead of this function. The new function also has support for digging into a structured value. See the built-in getvar funct

Returns: Any undef - if variable does not exist

Examples

Example usage

$foo = getvar('site::data::foo') # Equivalent to $foo = $site::data::foo

Where namespace is stored in a string

$datalocation = 'site::data'
$bar = getvar("${datalocation}::bar") # Equivalent to $bar = $site::data::bar

glob

Type: Ruby 3.x API

Uses same patterns as Dir#glob.

Examples

Example Usage:

$confs = glob(['/etc/**/*.conf', '/opt/**/*.conf'])

glob()

The glob function.

Returns: Any Returns an Array of file entries of a directory or an Array of directories.

Examples

Example Usage:

$confs = glob(['/etc/**/*.conf', '/opt/**/*.conf'])

grep

Type: Ruby 3.x API

Note: that since Puppet 4.0.0, the built-in filter function does the "same" - as any logic can be used to filter, as opposed to just regular expressions: ['aaa', 'bbb', 'ccc', 'aaaddd']. filter |$x| { $x =~ 'aaa' }

Examples

Example Usage:

grep(['aaa','bbb','ccc','aaaddd'], 'aaa') # Returns ['aaa','aaaddd']

grep()

Note: that since Puppet 4.0.0, the built-in filter function does the "same" - as any logic can be used to filter, as opposed to just regular expressions: ['aaa', 'bbb', 'ccc', 'aaaddd']. filter |$x| { $x =~ 'aaa' }

Returns: Any array of elements that match the provided regular expression.

Examples

Example Usage:

grep(['aaa','bbb','ccc','aaaddd'], 'aaa') # Returns ['aaa','aaaddd']

has_interface_with

Type: Ruby 3.x API

Valid kinds are macaddress, netmask, ipaddress and network.

Examples

Usage

has_interface_with("macaddress", "x:x:x:x:x:x") # Returns `false`
has_interface_with("ipaddress", "127.0.0.1") # Returns `true`

If no "kind" is given, then the presence of the interface is checked:

has_interface_with("lo") # Returns `true`

has_interface_with()

Valid kinds are macaddress, netmask, ipaddress and network.

Returns: Any boolean values true or false

Examples

Usage

has_interface_with("macaddress", "x:x:x:x:x:x") # Returns `false`
has_interface_with("ipaddress", "127.0.0.1") # Returns `true`

If no "kind" is given, then the presence of the interface is checked:

has_interface_with("lo") # Returns `true`

has_ip_address

Type: Ruby 3.x API

This function iterates through the 'interfaces' fact and checks the 'ipaddress_IFACE' facts, performing a simple string comparison.

has_ip_address()

This function iterates through the 'interfaces' fact and checks the 'ipaddress_IFACE' facts, performing a simple string comparison.

Returns: Boolean true or false

has_ip_network

Type: Ruby 3.x API

This function iterates through the 'interfaces' fact and checks the 'network_IFACE' facts, performing a simple string comparision.

has_ip_network()

This function iterates through the 'interfaces' fact and checks the 'network_IFACE' facts, performing a simple string comparision.

Returns: Any Boolean value, true if the client has an IP address within the requested network.

has_key

Type: Ruby 3.x API

Note: Deprecated since Puppet 4.0.0, this can now be achieved in the Puppet language with the following equivalent expression: $my_hash = {'key_one' => 'value_one'} if 'key_one' in $my_hash { notice('this will be printed')

Examples

Example Usage:

$my_hash = {'key_one' => 'value_one'}
if has_key($my_hash, 'key_two') {
  notice('we will not reach here')
}
if has_key($my_hash, 'key_one') {
  notice('this will be printed')
}

has_key()

Note: Deprecated since Puppet 4.0.0, this can now be achieved in the Puppet language with the following equivalent expression: $my_hash = {'key_one' => 'value_one'} if 'key_one' in $my_hash { notice('this will be printed')

Returns: Any Boolean value

Examples

Example Usage:

$my_hash = {'key_one' => 'value_one'}
if has_key($my_hash, 'key_two') {
  notice('we will not reach here')
}
if has_key($my_hash, 'key_one') {
  notice('this will be printed')
}

hash

Type: Ruby 3.x API

Note: This function has been replaced with the built-in ability to create a new value of almost any data type - see the built-in Hash.new function in Puppet. This example shows the equivalent expression in the Puppet language:

Hash(['a',1,'b',2,'c',3])
Hash([['a',1],['b',2],['c',3]])

Examples

Example Usage:

hash(['a',1,'b',2,'c',3]) # Returns: {'a'=>1,'b'=>2,'c'=>3}

hash()

Note: This function has been replaced with the built-in ability to create a new value of almost any data type - see the built-in Hash.new function in Puppet. This example shows the equivalent expression in the Puppet language:

Hash(['a',1,'b',2,'c',3])
Hash([['a',1],['b',2],['c',3]])

Returns: Any the converted array as a hash

Examples

Example Usage:

hash(['a',1,'b',2,'c',3]) # Returns: {'a'=>1,'b'=>2,'c'=>3}

intersection

Type: Ruby 3.x API

This function returns an array of the intersection of two.

Examples

Example Usage:

intersection(["a","b","c"],["b","c","d"])  # returns ["b","c"]
intersection(["a","b","c"],[1,2,3,4])      # returns [] (true, when evaluated as a Boolean)

intersection()

The intersection function.

Returns: Any an array of the intersection of two.

Examples

Example Usage:

intersection(["a","b","c"],["b","c","d"])  # returns ["b","c"]
intersection(["a","b","c"],[1,2,3,4])      # returns [] (true, when evaluated as a Boolean)

is_a

Type: Ruby 4.x API

See the documentation for "The Puppet Type System" for more information about types. See the assert_type() function for flexible ways to assert the type of a value.

Examples

Example Usage:

# check a data type
  foo = 3
  $bar = [1,2,3]
  $baz = 'A string!'

  if $foo.is_a(Integer) {
    notify  { 'foo!': }
  }
  if $bar.is_a(Array) {
    notify { 'bar!': }
  }
  if $baz.is_a(String) {
    notify { 'baz!': }
  }

is_a(Any $value, Type $type)

See the documentation for "The Puppet Type System" for more information about types. See the assert_type() function for flexible ways to assert the type of a value.

Returns: Boolean Return's true or false.

Examples

Example Usage:

# check a data type
  foo = 3
  $bar = [1,2,3]
  $baz = 'A string!'

  if $foo.is_a(Integer) {
    notify  { 'foo!': }
  }
  if $bar.is_a(Array) {
    notify { 'bar!': }
  }
  if $baz.is_a(String) {
    notify { 'baz!': }
  }

value

Data type: Any

The value to be checked

type

Data type: Type

The expected type

is_absolute_path

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_absolute_path(Any $scope, Any *$args)

The is_absolute_path function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_absolute_path

Type: Ruby 3.x API

This function works for windows and unix style paths.

Note:* Deprecated** Will be removed in a future version of stdlib. See [validate_legacy](#validate_leg

Examples

The following values will return true:

$my_path = 'C:/Program Files (x86)/Puppet Labs/Puppet'
is_absolute_path($my_path)
$my_path2 = '/var/lib/puppet'
is_absolute_path($my_path2)
$my_path3 = ['C:/Program Files (x86)/Puppet Labs/Puppet']
is_absolute_path($my_path3)
$my_path4 = ['/var/lib/puppet']
is_absolute_path($my_path4)

The following values will return false:

is_absolute_path(true)
is_absolute_path('../var/lib/puppet')
is_absolute_path('var/lib/puppet')
$undefined = undef
is_absolute_path($undefined)

is_absolute_path()

This function works for windows and unix style paths.

Note:* Deprecated** Will be removed in a future version of stdlib. See [validate_legacy](#validate_leg

Returns: Boolean Returns true or false

Examples

The following values will return true:

$my_path = 'C:/Program Files (x86)/Puppet Labs/Puppet'
is_absolute_path($my_path)
$my_path2 = '/var/lib/puppet'
is_absolute_path($my_path2)
$my_path3 = ['C:/Program Files (x86)/Puppet Labs/Puppet']
is_absolute_path($my_path3)
$my_path4 = ['/var/lib/puppet']
is_absolute_path($my_path4)

The following values will return false:

is_absolute_path(true)
is_absolute_path('../var/lib/puppet')
is_absolute_path('var/lib/puppet')
$undefined = undef
is_absolute_path($undefined)

is_array

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_array(Any $scope, Any *$args)

The is_array function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_array

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_array()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_bool

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_bool(Any $scope, Any *$args)

The is_bool function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_bool

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_bool()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_domain_name

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_domain_name()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_email_address

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_email_address()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_float

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_float(Any $scope, Any *$args)

The is_float function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_float

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_float()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_function_available

Type: Ruby 3.x API

This function accepts a string as an argument.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_function_available()

This function accepts a string as an argument.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_hash

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_hash()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_integer

Type: Ruby 3.x API

The string may start with a '-' (minus). A value of '0' is allowed, but a leading '0' digit may not be followed by other digits as this indicates that the value is octal (base 8).

If given any other argument false is returned.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_integer()

The string may start with a '-' (minus). A value of '0' is allowed, but a leading '0' digit may not be followed by other digits as this indicates that the value is octal (base 8).

If given any other argument false is returned.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_ip_address

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_ip_address(Any $scope, Any *$args)

The is_ip_address function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_ip_address

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_ip_address()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_ipv4_address

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_ipv4_address(Any $scope, Any *$args)

The is_ipv4_address function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_ipv4_address

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_ipv4_address()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_ipv6_address

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_ipv6_address(Any $scope, Any *$args)

The is_ipv6_address function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_ipv6_address

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_ipv6_address()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_mac_address

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_mac_address()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_numeric

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_numeric(Any $scope, Any *$args)

The is_numeric function.

Returns: Boolea A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_numeric

Type: Ruby 3.x API

Returns true if the given argument is a Numeric (Integer or Float), or a String containing either a valid integer in decimal base 10 form, or a valid floating point string representation.

The function recognizes only decimal (base 10) integers and float but not integers in hex (base 16) or octal (base 8) form.

The string representation may start with a '-' (minus). If a decimal '.' is used, it must be followed by at least one digit.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_numeric()

Returns true if the given argument is a Numeric (Integer or Float), or a String containing either a valid integer in decimal base 10 form, or a valid floating point string representation.

The function recognizes only decimal (base 10) integers and float but not integers in hex (base 16) or octal (base 8) form.

The string representation may start with a '-' (minus). If a decimal '.' is used, it must be followed by at least one digit.

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

is_string

Type: Ruby 4.x API

Wrapper that calls the Puppet 3.x function of the same name.

is_string(Any $scope, Any *$args)

The is_string function.

Returns: Boolean A boolean value returned from the called 3.x function.

scope

Data type: Any

The main value that will be passed to the wrapped method

*args

Data type: Any

Any additional values that are to be passed to the wrapped method

is_string

Type: Ruby 3.x API

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

is_string()

Note:* Deprecated** Will be removed in a future version of stdlib. See validate_legacy.

Returns: Boolean Returns true or false

join

Type: Ruby 3.x API

Note: Deprecated from Puppet 5.4.0 this function has been replaced with a built-in join function.

Examples

Example Usage:

join(['a','b','c'], ",") # Results in: "a,b,c"

join()

Note: Deprecated from Puppet 5.4.0 this function has been replaced with a built-in join function.

Returns: String The String containing each of the array values

Examples

Example Usage:

join(['a','b','c'], ",") # Results in: "a,b,c"

join_keys_to_values

Type: Ruby 3.x API

Keys are cast to strings. If values are arrays, multiple keys are added for each element. The return value is an array in which each element is one joined key/value pair.

Note: Since Puppet 5.0.0 - for more detailed control over the formatting (including indentations and line breaks, delimiters around arrays and hash entries, between key/values in hash entries, and individual formatting of values in the array) - see the new function for String and its formatting options for Array and Hash.

Examples

Example Usage:

join_keys_to_values({'a'=>1,'b'=>2}, " is ") # Results in: ["a is 1","b is 2"]
join_keys_to_values({'a'=>1,'b'=>[2,3]}, " is ") # Results in: ["a is 1","b is 2","b is 3"]

join_keys_to_values()

Keys are cast to strings. If values are arrays, multiple keys are added for each element. The return value is an array in which each element is one joined key/value pair.

Note: Since Puppet 5.0.0 - for more detailed control over the formatting (including indentations and line breaks, delimiters around arrays and hash entries, between key/values in hash entries, and individual formatting of values in the array) - see the new function for String and its formatting options for Array and Hash.

Returns: Hash The joined hash

Examples

Example Usage:

join_keys_to_values({'a'=>1,'b'=>2}, " is ") # Results in: ["a is 1","b is 2"]
join_keys_to_values({'a'=>1,'b'=>[2,3]}, " is ") # Results in: ["a is 1","b is 2","b is 3"]

keys

Type: Ruby 3.x API

Note: Deprecated from Puppet 5.5.0, the built-in keys function will be used instead of this function.

keys()

Note: Deprecated from Puppet 5.5.0, the built-in keys function will be used instead of this function.

Returns: Array An array containing each of the hashes key values.

length

Type: Ruby 4.x API

The original size() function did not handle Puppets new type capabilities, so this function is a Puppet 4 compatible solution.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in length function.

length(Variant[String,Array,Hash] $value)

The original size() function did not handle Puppets new type capabilities, so this function is a Puppet 4 compatible solution.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in length function.

Returns: Integer The length of the given object

value

Data type: Variant[String,Array,Hash]

The value whose length is to be found

load_module_metadata

Type: Ruby 3.x API

This function loads the metadata of a given module.

Examples

Example USage:

$metadata = load_module_metadata('archive')
notify { $metadata['author']: }

load_module_metadata()

The load_module_metadata function.

Returns: Any The modules metadata

Examples

Example USage:

$metadata = load_module_metadata('archive')
notify { $metadata['author']: }

loadjson

Type: Ruby 3.x API

The first parameter can be a file path or a URL. The second parameter is the default value. It will be returned if the file was not found or could not be parsed.

Examples

Example Usage:

$myhash = loadjson('/etc/puppet/data/myhash.json')
$myhash = loadjson('https://example.local/my_hash.json')
$myhash = loadjson('https://username:password@example.local/my_hash.json')
$myhash = loadjson('no-file.json', {'default' => 'val

loadjson()

The first parameter can be a file path or a URL. The second parameter is the default value. It will be returned if the file was not found or could not be parsed.

Returns: Array|String|Hash The data stored in the JSON file, the type depending on the type of data that was stored.

Examples

Example Usage:

$myhash = loadjson('/etc/puppet/data/myhash.json')
$myhash = loadjson('https://example.local/my_hash.json')
$myhash = loadjson('https://username:password@example.local/my_hash.json')
$myhash = loadjson('no-file.json', {'default' => 'val

loadyaml

Type: Ruby 3.x API

The first parameter can be a file path or a URL. The second parameter is the default value. It will be returned if the file was not found or could not be parsed.

Examples

Example Usage:

$myhash = loadyaml('/etc/puppet/data/myhash.yaml')
$myhash = loadyaml('https://example.local/my_hash.yaml')
$myhash = loadyaml('https://username:password@example.local/my_hash.yaml')
$myhash = loadyaml('no-file.yaml', {'default' => 'val

loadyaml()

The first parameter can be a file path or a URL. The second parameter is the default value. It will be returned if the file was not found or could not be parsed.

Returns: Array|String|Hash The data stored in the YAML file, the type depending on the type of data that was stored.

Examples

Example Usage:

$myhash = loadyaml('/etc/puppet/data/myhash.yaml')
$myhash = loadyaml('https://example.local/my_hash.yaml')
$myhash = loadyaml('https://username:password@example.local/my_hash.yaml')
$myhash = loadyaml('no-file.yaml', {'default' => 'val

lstrip

Type: Ruby 3.x API

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in lstrip function.

lstrip()

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in lstrip function.

Returns: String The stripped string

max

Type: Ruby 3.x API

Requires at least one argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in max function.

max()

Requires at least one argument.

Note: Deprecated from Puppet 6.0.0, this function has been replaced with a built-in max function.

Returns: Any The highest value among those passed in

member

Type: Ruby 3.x API

The variable can be a string, fixnum, or array.

Note: This function does not support nested arrays. If the first argument contains nested arrays, it will not recurse through them.

Note: Since Puppet 4.0.0 the same can be performed in the Puppet language. For single values the operator in can be used: 'a' in ['a', 'b'] # true For arrays by using operator - to compute a diff: ['d', 'b'] - ['a', 'b', 'c'] == [] # false because 'd' is not subtracted ['a', 'b'] - ['a', 'b', 'c'] == [] # true because both 'a' and 'b' are subtracted

Note that since Puppet 5.2.0, the general form to test the content of an array or hash is to use the built-in any and all functions.

Examples

Usage

member(['a','b'], 'b') # Returns: true
member(['a', 'b', 'c'], ['a', 'b']) # Returns: true
member(['a','b'], 'c') # Returns: false
member(['a', 'b', 'c'], ['d', 'b']) # Returns: false

member()

The variable can be a string, fixnum, or array.

Note: This function does not support nested arrays. If the first argument contains nested arrays, it will not recurse through them.