Module: Xqsr3::HashUtilities::DeepTransform

Included in:
Hash
Defined in:
lib/xqsr3/doc_.rb,
lib/xqsr3/hash_utilities/deep_transform.rb

Overview

Exception-related utilities

Components of interest

  • ::Xqsr3::Diagnostics::HashUtilities::deep_transform
  • ::Xqsr3::Diagnostics::HashUtilities::deep_transform!

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.do_deep_transform_on_hashlike_(h, &block) ⇒ Object

:nodoc:



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
 
# File 'lib/xqsr3/hash_utilities/deep_transform.rb', line 60

def self.do_deep_transform_on_hashlike_ h, &block # :nodoc:

  ::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :map ]

  case block.arity
  when 1

    h =
    Hash[h.map do |k, v|

      k = k.deep_transform(&block) if ::Hash === k
      v = v.deep_transform(&block) if ::Hash === v

      [yield(k), v]
    end]
  when 2

    h =
    Hash[h.map do |k, v|

      k = k.deep_transform(&block) if ::Hash === k
      v = v.deep_transform(&block) if ::Hash === v

      yield(k, v)
    end]
  else

    raise ArgumentError, "block arity must be 1 or 2"
  end

  h
end

Instance Method Details

#deep_transform(&block) ⇒ Object

Executes the given mandatory 1- or 2-parameter block on the receiving instance, which must be a Hash or a type that responds to the map message, returning a copy of the instance in which keys (1-parameter block) or keys and values (2-parameter block) are transformed.



131
132
133
134
 
# File 'lib/xqsr3/hash_utilities/deep_transform.rb', line 131

def deep_transform &block

  DeepTransform.do_deep_transform_on_hashlike_(self, &block)
end

#deep_transform!(&block) ⇒ Object

Note:

This method is not strongly exception-safe - failure during transformation can result in a partially transformed instance

Executes the given mandatory 1- or 2-parameter block on the receiving instance, whihc must be a Hash or a type that responds to [], delete, and keys messages, changing the keys (1-parameter block) or keys and values (2-parameter block).



143
144
145
146
 
# File 'lib/xqsr3/hash_utilities/deep_transform.rb', line 143

def deep_transform! &block

  do_deep_transform_on_self_(&block)
end