123456789_123456789_123456789_123456789_123456789_

Class: Layout::Dictionary

Relationships
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, Enumerable
Inherits: Object

Overview

This is the interface to a LayOut dictionary. A Dictionary wraps key/value pairs.

Examples:

dict = Layout::Dictionary.new

Version:

  • LayOut 2026.0

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new ⇒ Dictionary .new(dict) ⇒ Dictionary

The #initialize method creates a new Dictionary.

Examples:

doc = Layout::Dictionary.new
doc2 = Layout::Dictionary.new({"String key" => "string value", "Number key" => 42})

Overloads:

  • .new ⇒ Dictionary
  • .new(dict) ⇒ Dictionary

    Parameters:

    • hash (Hash, Dictionary)

Raises:

  • (ArgumentError) —

    if dict isn’t a dictionary or hash

Version:

  • LayOut 2026.0

Instance Attribute Details

#empty? ⇒ Boolean (readonly)

The #empty? method checks if the dictionary is empty.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attribute_one"] = "1"
dictionary.empty? # Returns false

Version:

  • LayOut 2026.0

Instance Method Details

#[](key) ⇒ String, ...

The #[] method retrieves the value for a given key.

Examples:

dictionary = Layout::Dictionary.new
dictionary['test'] = 115

# value will contain 115
value = dictionary["test"]

Parameters:

  • key (String) —

    The name of the attribute.

Version:

  • LayOut 2026.0

#[]=(key, value)

The #[]= method sets a value for a given key.

Creates a new dictionary entry for the given key if needed.

Examples:

dictionary = Layout::Dictionary.new
dictionary['test'] = 110
value = dictionary['test2'] = 120
p value

Parameters:

  • key (String) —

    The valid key.

  • value (String, Boolean, Integer, Float, Hash, Dictionary, nil)

Version:

  • LayOut 2026.0

#delete_key(key) ⇒ String, ...

The #delete_key method deletes a key/value pair from the dictionary.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# Delete a key/value pair and get the deleted value.
value = dictionary.delete_key("attr_one")

Parameters:

  • key (String) —

    The key to be deleted.

Version:

  • LayOut 2026.0

#each {|key, value| ... }

The #each_pair method is an alias for #each.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# iterates through all attributes and prints the key to the screen
dictionary.each_pair { | key, value |
  puts "#{key} = #{value}"
}

Yields:

  • (key, value)

Yield Parameters:

See Also:

  • #each

Version:

  • LayOut 2026.0

#each_key {|key| ... }

The #each_key method iterates through all of the dictionary keys.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# iterates through all attributes and prints the key to the screen
dictionary.each_key { |key| puts key }

Yield Parameters:

Version:

  • LayOut 2026.0

#each_pair {|key, value| ... }

The #each_pair method is an alias for #each.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# iterates through all attributes and prints the key to the screen
dictionary.each_pair { | key, value |
  puts "#{key} = #{value}"
}

Yields:

  • (key, value)

Yield Parameters:

See Also:

Version:

  • LayOut 2026.0

#keys ⇒ Array<String>

The #keys method retrieves an array with all of the dictionary keys.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# Gets an array of keys
keys = dictionary.keys

Returns:

  • (Array<String>) —

    an array of keys within the dictionary if successful

Version:

  • LayOut 2026.0

#length ⇒ Integer

The #length method retrieves the size (number of elements) of a dictionary.

Examples:

dictionary = Layout::Dictionary.new
dictionary['Hello'] = 'World'
number = dictionary.length

See Also:

Version:

  • LayOut 2026.0

#size ⇒ Integer

The #length method retrieves the size (number of elements) of a dictionary.

Examples:

dictionary = Layout::Dictionary.new
dictionary['Hello'] = 'World'
number = dictionary.length

See Also:

  • #size

Version:

  • LayOut 2026.0

#values ⇒ Array<Object>

The #values method retrieves an array with all of the dictionary values.

Examples:

dictionary = Layout::Dictionary.new
dictionary["attr_one"] = "one"
dictionary["attr_two"] = "two"

# Gets an array of values
values = dictionary.values

Returns:

  • (Array<Object>) —

    an array of values within the dictionary if successful

Version:

  • LayOut 2026.0