#
module Puppet::Parser::Functions
newfunction(:hash, :type => :rvalue, :doc => <<-DOC
- This function converts an array into a hash.
+ @summary
+ **Deprecated:** This function converts an array into a hash.
- *Examples:*
+ @return
+ the converted array as a hash
+ @example Example Usage:
+ hash(['a',1,'b',2,'c',3]) # Returns: {'a'=>1,'b'=>2,'c'=>3}
- hash(['a',1,'b',2,'c',3])
-
- Would return: {'a'=>1,'b'=>2,'c'=>3}
-
- Note: Since Puppet 5.0.0 type conversions can in general be performed by using the Puppet Type System.
- See the function new() in Puppet for a wide range of available type conversions.
+ > **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`](https://puppet.com/docs/puppet/latest/function.html#conversion-to-hash-and-struct) 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]])
+ ```
+ Hash(['a',1,'b',2,'c',3])
+ Hash([['a',1],['b',2],['c',3]])
+ ```
DOC
) do |arguments|