projects
/
mirror
/
dsa-puppet.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Update stdlib and concat to 6.1.0 both
[mirror/dsa-puppet.git]
/
3rdparty
/
modules
/
stdlib
/
lib
/
puppet
/
parser
/
functions
/
dig44.rb
diff --git
a/3rdparty/modules/stdlib/lib/puppet/parser/functions/dig44.rb
b/3rdparty/modules/stdlib/lib/puppet/parser/functions/dig44.rb
index
91724f4
..
ff1d9df
100644
(file)
--- a/
3rdparty/modules/stdlib/lib/puppet/parser/functions/dig44.rb
+++ b/
3rdparty/modules/stdlib/lib/puppet/parser/functions/dig44.rb
@@
-7,14
+7,14
@@
module Puppet::Parser::Functions
:type => :rvalue,
:arity => -2,
:doc => <<-DOC
:type => :rvalue,
:arity => -2,
:doc => <<-DOC
- DEPRECATED: This function has been replaced in Puppet 4.5.0.
-
- Looks up into a complex structure of arrays and hashes and returns a value
- or the default value if nothing was found.
+ @summary
+ **DEPRECATED**: Looks up into a complex structure of arrays and hashes and returns a value
+ or the default value if nothing was found.
Key can contain slashes to describe path components. The function will go down
the structure and try to extract the required value.
Key can contain slashes to describe path components. The function will go down
the structure and try to extract the required value.
+ ```
$data = {
'a' => {
'b' => [
$data = {
'a' => {
'b' => [
@@
-25,19
+25,24
@@
module Puppet::Parser::Functions
}
}
}
}
- $value = dig44($data, ['a', 'b', '2'], 'not_found')
- => $value = 'b3'
+ $value = dig44($data, ['a', 'b', 2])
+ # $value = 'b3'
+
+ # with all possible options
+ $value = dig44($data, ['a', 'b', 2], 'not_found')
+ # $value = 'b3'
- a -> first hash key
- b -> second hash key
- 2 -> array index starting with 0
+ # using the default value
+ $value = dig44($data, ['a', 'b', 'c', 'd'], 'not_found')
+ # $value = 'not_found'
+ ```
- not_found -> (optional) will be returned if there is no value or the path
- did not match. Defaults to nil.
+ > **Note:* **Deprecated** This function has been replaced with a built-in
+ [`dig`](https://puppet.com/docs/puppet/latest/function.html#dig) function as of
+ Puppet 4.5.0.
- In addition to the required "key" argument, the function accepts a default
- argument. It will be returned if no value was found or a path component is
- missing. And the fourth argument can set a variable path separator.
+ @return [String] 'not_found' will be returned if nothing is found
+ @return [Any] the value that was searched for
DOC
) do |arguments|
# Two arguments are required
DOC
) do |arguments|
# Two arguments are required