Sha256: c44c43aed6a93ae799a61e47a91e587a80379277a501ce128b5e13427eec49e2

Contents?: true

Size: 1.13 KB

Versions: 20

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

20 entries across 20 versions & 1 rubygems

Version Path
puppet-8.3.0 lib/puppet/functions/convert_to.rb
puppet-8.3.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.3.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.3.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.3.1 lib/puppet/functions/convert_to.rb
puppet-8.3.1-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.3.1-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.3.1-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.2.0 lib/puppet/functions/convert_to.rb
puppet-8.2.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.2.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.2.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.1.0 lib/puppet/functions/convert_to.rb
puppet-8.1.0-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.1.0-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.1.0-universal-darwin lib/puppet/functions/convert_to.rb
puppet-8.0.1 lib/puppet/functions/convert_to.rb
puppet-8.0.1-x86-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.0.1-x64-mingw32 lib/puppet/functions/convert_to.rb
puppet-8.0.1-universal-darwin lib/puppet/functions/convert_to.rb