Sha256: cd7b6e38fd2082fd072464b27d98b24edee77ba0c34589b8a71da62b32c9bb0b

Contents?: true

Size: 1.13 KB

Versions: 32

Compression:

Stored size: 1.13 KB

Contents

# frozen_string_literal: true

# The `convert_to(value, type)` is a convenience function that does the same as `new(type, value)`.
# The difference in the argument ordering allows it to be used in chained style for
# improved readability "left to right".
#
# When the function is given a lambda, it is called with the converted value, and the function
# returns what the lambda returns, otherwise the converted value.
#
# @example 'convert_to' instead of 'new'
#
# ```puppet
#   # The harder to read variant:
#   # Using new operator - that is "calling the type" with operator ()
#   Hash(Array("abc").map |$i,$v| { [$i, $v] })
#
#   # The easier to read variant:
#   # using 'convert_to'
#   "abc".convert_to(Array).map |$i,$v| { [$i, $v] }.convert_to(Hash)
# ```
#
# @since 5.4.0
#
Puppet::Functions.create_function(:convert_to) do
  dispatch :convert_to do
    param 'Any', :value
    param 'Type', :type
    optional_repeated_param 'Any', :args
    optional_block_param 'Callable[1,1]', :block
  end

  def convert_to(value, type, *args, &block)
    result = call_function('new', type, value, *args)
    block_given? ? yield(result) : result
  end
end

Version data entries

32 entries across 32 versions & 1 rubygems

Version Path
puppet-8.10.0 lib/puppet/functions/convert_to.rb
puppet-8.10.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.10.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.10.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.9.0 lib/puppet/functions/convert_to.rb
puppet-8.9.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.9.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.9.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.8.1 lib/puppet/functions/convert_to.rb
puppet-8.8.1-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.8.1-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.8.1-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.7.0 lib/puppet/functions/convert_to.rb
puppet-8.7.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.7.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.7.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.6.0 lib/puppet/functions/convert_to.rb
puppet-8.6.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.6.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.6.0-universal-darwin lib/puppet/functions/convert_to.rb