Sha256: 5e6ee177d66ebcb7f0897e280e68bc704e6582b6a5a0dc3ae1b3ba62b6adb062

Contents?: true

Size: 1.42 KB

Versions: 16

Compression:

Stored size: 1.42 KB

Contents

Puppet::Parser::Functions::newfunction(
  :type,
  :type => :rvalue,
  :arity => -1,
  :doc => <<-DOC
Returns the data type of a given value with a given degree of generality.

```puppet
type InferenceFidelity = Enum[generalized, reduced, detailed]

function type(Any $value, InferenceFidelity $fidelity = 'detailed') # returns Type
```

 **Example:** Using `type`

 ``` puppet
 notice type(42) =~ Type[Integer]
 ```

 Would notice `true`.

 By default, the best possible inference is made where all details are retained.
 This is good when the type is used for further type calculations but is overwhelmingly
 rich in information if it is used in a error message.

 The optional argument `$fidelity` may be given as (from lowest to highest fidelity):

 * `generalized` - reduces to common type and drops size constraints
 * `reduced` - reduces to common type in collections
 * `detailed` - (default) all details about inferred types is retained

 **Example:** Using `type()` with different inference fidelity:

 ``` puppet
 notice type([3.14, 42], 'generalized')
 notice type([3.14, 42], 'reduced'')
 notice type([3.14, 42], 'detailed')
 notice type([3.14, 42])
 ```

 Would notice the four values:

 1. 'Array[Numeric]'
 2. 'Array[Numeric, 2, 2]'
 3. 'Tuple[Float[3.14], Integer[42,42]]]'
 4. 'Tuple[Float[3.14], Integer[42,42]]]'

 * Since 4.4.0

DOC
) do |args|
  function_fail(["type() is only available when parser/evaluator future is in effect"])
end

Version data entries

16 entries across 16 versions & 1 rubygems

Version Path
puppet-4.7.1 lib/puppet/parser/functions/type.rb
puppet-4.7.1-x86-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.7.1-x64-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.7.1-universal-darwin lib/puppet/parser/functions/type.rb
puppet-4.7.0 lib/puppet/parser/functions/type.rb
puppet-4.7.0-x86-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.7.0-x64-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.7.0-universal-darwin lib/puppet/parser/functions/type.rb
puppet-4.6.2 lib/puppet/parser/functions/type.rb
puppet-4.6.2-x86-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.6.2-x64-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.6.2-universal-darwin lib/puppet/parser/functions/type.rb
puppet-4.6.1-x86-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.6.1 lib/puppet/parser/functions/type.rb
puppet-4.6.1-x64-mingw32 lib/puppet/parser/functions/type.rb
puppet-4.6.1-universal-darwin lib/puppet/parser/functions/type.rb