Namespace: OpenEdge.Core.Collections
Type: Class StringStringMap
Parent Classes:
Inherits: Progress.Lang.Object
Implements: OpenEdge.Core.Collections.IStringStringMap


Copyright (c) 2014, 2019-2021 by Progress Software Corporation. All rights reserved.
File:StringStringMap
Purpose:A map containing String keys and String values.
Author(s):pjudge
Created:Wed Dec 18 13:55:14 EST 2013
/* Hash algorithm used to determine the index value for the String value



Method Summary
  Options Name Purpose
  Clear () /* Removes all mappings from this map (optional operation). */
  LOGICAL ContainsAllKeys (ICollection) /* Returns true if this map contains all of the keys in a collection. @param ICollection A collection of keys. Must be a valid object. @return logical TRUE if all the keys in the input collection are in this map */
  LOGICAL ContainsAllValues (ICollection) /* Returns true if this map maps one or more keys to the specified value. @param ICollection A collection of values @return logical TRUE if all of the values in the source collection are values in the map's Values */
  LOGICAL ContainsKey (character) /** Indicates whether a map exists for this key @param character the key value. May be unknown @return logical True if this key exists; FALSE otherwise */
  LOGICAL ContainsKey (Object) /* Returns true if this map contains a mapping for the specified key. @param Object A key value. Must be valid and of type OE.Core.String @return logical TRUE of the map contains an entry with the specified key; FALSE otherwise */
  LOGICAL ContainsKey (String) /* Returns true if this map contains a mapping for the specified key. @param String A key value. Must be valid @return logical TRUE of the map contains an entry with the specified key; FALSE otherwise */
  LOGICAL ContainsValue (character) /** Indicates whether there is at least one value represented by the parameter in the map. @param character The value to find. May be unknown. @return logical TRUE if at least one value exists in the map; FALSE otherwise. */
  LOGICAL ContainsValue (Object) /* Returns true if this map contains all of the values in a collection. @param ICollection A collection of values. Must be a valid object. @return logical TRUE if all the values in the input collection are in this map */
  LOGICAL ContainsValue (String) /* Returns TRUS if there's at least one value in the map that equals the input value. @param String The value to find. May be null. @return logical TRUE if at least one value exists in the map; FALSE otherwise. */
  LOGICAL FindMapRecord (character, buffer) /* Helper method to find a map entry by key @param character The key value to find @param buffer for StrStrMap @return logical TRUE if a record exists with the given key; FALSE if there are no matching entries */
  LOGICAL FindMapRecordByVal (raw, buffer) /* Helper method to find a map entry by value @param raw The hash value of the value being sought @param buffer for StrStrMap @return logical TRUE if at least one record exists with that value; FALSE if there are no matching entries */
  LONGCHAR Get (character) /** Retrieves the value for a particular key @param character The key value @return longchar The associated value */
  Progress.Lang.Object Get (Object) /** Retrieves the value for a particular key @param Object The key value. The value object must be valid and of type OpenEdge.Core.String @return Object The associated value, or unknown if the entry does not exist. If the value exists, it will be of type OpenEdge.Core.String */
  OpenEdge.Core.String Get (String) /** Retrieves the value for a particular key @param String The key value. The value object must be valid. @return String The associated value, or unknown if the entry does not exist */
  LOGICAL IsEmpty () /* Returns true if this map contains no key-value mappings. @return logical TRUE if the map has no entries; FALSE otherwise */
  CHARACTER Put (character, character) /* Adds a value and/or key to the map. @param character The key for the map entry. May be empty or unknown. Is unique in the map. @param character The value matching the key. May be empty or unknown. @return character The previous value, or unknown if none. Unknown is a valid value too. */
  LONGCHAR Put (character, longchar) /* Adds a value and/or key to the map. @param character The key for the map entry. May be empty or unknown. Is unique in the map. @param longchar The value matching the key. May be empty or unknown. @return character The previous value, or unknown if none. Unknown is a valid value too. */
  OpenEdge.Core.String Put (character, String) /* Adds a value and/or key to the map. Does the actual addition into the StrStrMap table. @param character The key for the map entry. May be empty or unknown. Is unique in the map. @param String The value matching the key. May be empty or unknown. @return String The previous value, or unknown if none. Unknown is a valid value too. */
  Progress.Lang.Object Put (Object, Object) /* Adds a value and/or key to the map. @param Object The key for the map entry. Must be a valid value and must be of type OpenEdge.Core.String, but may have an empty or unknown value. Is unique in the map. @param Object The value matching the key. If it is a valid value, it must be of type OpenEdge.Core.String, but may have an empty or unknown value. @return String The previous value, or unknown if none. If a valid value, will be of type OpenEdge.Core.String. Unknown is a valid value too. */
  OpenEdge.Core.String Put (String, String) /* Adds a value and/or key to the map. @param String The key for the map entry. Must be a valid value, but may have an empty or unknown value. Is unique in the map. @param String The value matching the key. Must be a valid value, but may have an empty or unknown value. @return String The previous value, or unknown if none. Unknown is a valid value too. */
  PutAll (IMap) /* Copies all of the mappings from the specified map to this map (optional operation). @param IMap A valid map */
  PutAll (IStringStringMap) /* Adds all the values from an input map @param IStringStringMap A valid map */
  LONGCHAR Remove (character) /** Removes the value for a particular key @param character The key value @return longchar The associated value, or unknown if there is no entry. */
  Progress.Lang.Object Remove (Object) /** Removes the value for a particular key @param Object The key value. Must be a valid object, and must be of type OpenEdge.Core.String @return Object The associated value (of type OpenEdge.Core.String), or unknown if there is no entry. */
  OpenEdge.Core.String Remove (String) /** Removes the value for a particular key @param String The key value. Must be a valid object. @return String The associated value, or unknown if there is no entry. */
  RemoveAll (ICollection) /** Removes the mappings for all key from this map if it is present (optional operation). @param ICollection A collection of keys to remove */

Constructor Summary
  Options Name Purpose
  StringStringMap () /* Default constructor */
  StringStringMap (IMap) /* Constructor. Populates the map with the contents of another map. @param IMap Contains entries to add to this map. Entries are just added to this map, and are not cloned/duplicated */

Property Summary
  Options Name Purpose
  OpenEdge.Core.Collections.ISet EntrySet
  CHARACTER HASH_ALGORITHM
  OpenEdge.Core.Collections.ISet KeySet
  INTEGER Size
  OpenEdge.Core.Collections.ICollection Values


Method Detail
Top

Clear ()

/* Removes all mappings from this map (optional operation).
Top

LOGICAL ContainsAllKeys (ICollection)

/* Returns true if this map contains all of the keys in a collection.
Parameters:
pKeys OpenEdge.Core.Collections.ICollection
 
Returns LOGICAL
  logical TRUE if all the keys in the input collection are in this map
Top

LOGICAL ContainsAllValues (ICollection)

/* Returns true if this map maps one or more keys to the specified value.
Parameters:
pValues OpenEdge.Core.Collections.ICollection
 
Returns LOGICAL
  logical TRUE if all of the values in the source collection are values in the map's Values
Top

LOGICAL ContainsKey (character)

Purpose: Indicates whether a map exists for this key
Parameters:
pcKey CHARACTER
 
Returns LOGICAL
  logical True if this key exists; FALSE otherwise
Top

LOGICAL ContainsKey (Object)

/* Returns true if this map contains a mapping for the specified key.
Parameters:
pKey Progress.Lang.Object
 
Returns LOGICAL
  logical TRUE of the map contains an entry with the specified key; FALSE otherwise
Top

LOGICAL ContainsKey (String)

/* Returns true if this map contains a mapping for the specified key.
Parameters:
pKey OpenEdge.Core.String
 
Returns LOGICAL
  logical TRUE of the map contains an entry with the specified key; FALSE otherwise
Top

LOGICAL ContainsValue (character)

Purpose: Indicates whether there is at least one value represented
by the parameter in the map.
Parameters:
pValue CHARACTER
 
Returns LOGICAL
  logical TRUE if at least one value exists in the map; FALSE otherwise.
Top

LOGICAL ContainsValue (Object)

/* Returns true if this map contains all of the values in a collection.
Parameters:
pValue Progress.Lang.Object
 
Returns LOGICAL
  logical TRUE if all the values in the input collection are in this map
Top

LOGICAL ContainsValue (String)

/* Returns TRUS if there's at least one value in the map that equals the input value.
Parameters:
pValue OpenEdge.Core.String
 
Returns LOGICAL
  logical TRUE if at least one value exists in the map; FALSE otherwise.
Top

LOGICAL FindMapRecord (character, buffer)

/* Helper method to find a map entry by key
Parameters:
pKey CHARACTER
 
pMap buffer
 
Returns LOGICAL
  logical TRUE if a record exists with the given key; FALSE if there are no matching entries
Top

LOGICAL FindMapRecordByVal (raw, buffer)

/* Helper method to find a map entry by value
Parameters:
pVal RAW
 
pMap buffer
 
Returns LOGICAL
  logical TRUE if at least one record exists with that value; FALSE if there are no matching entries
Top

LONGCHAR Get (character)

Purpose: Retrieves the value for a particular key
Parameters:
pKey CHARACTER
 
Returns LONGCHAR
  longchar The associated value
Top

Progress.Lang.Object Get (Object)

Purpose: Retrieves the value for a particular key
Parameters:
pKey Progress.Lang.Object
 
Returns Progress.Lang.Object
  Object The associated value, or unknown if the entry does not exist. If the value exists, it will be of type OpenEdge.Core.String
Top

OpenEdge.Core.String Get (String)

Purpose: Retrieves the value for a particular key
Parameters:
pKey OpenEdge.Core.String
 
Returns OpenEdge.Core.String
  String The associated value, or unknown if the entry does not exist
Top

LOGICAL IsEmpty ()

/* Returns true if this map contains no key-value mappings.
Returns LOGICAL
  logical TRUE if the map has no entries; FALSE otherwise
Top

CHARACTER Put (character, character)

/* Adds a value and/or key to the map.
Parameters:
pcKey CHARACTER
 
pcValue CHARACTER
 
Returns CHARACTER
  character The previous value, or unknown if none. Unknown is a valid value too.
Top

LONGCHAR Put (character, longchar)

/* Adds a value and/or key to the map.
Parameters:
pcKey CHARACTER
 
pcValue LONGCHAR
 
Returns LONGCHAR
  character The previous value, or unknown if none. Unknown is a valid value too.
Top

OpenEdge.Core.String Put (character, String)

/* Adds a value and/or key to the map.
Does the actual addition into the StrStrMap table.
Parameters:
pKey CHARACTER
 
pValue OpenEdge.Core.String
 
Returns OpenEdge.Core.String
  String The previous value, or unknown if none. Unknown is a valid value too.
Top

Progress.Lang.Object Put (Object, Object)

/* Adds a value and/or key to the map.
Parameters:
pKey Progress.Lang.Object
 
pValue Progress.Lang.Object
 
Returns Progress.Lang.Object
  String The previous value, or unknown if none. If a valid value, will be of type OpenEdge.Core.String. Unknown is a valid value too.
Top

OpenEdge.Core.String Put (String, String)

/* Adds a value and/or key to the map.
Parameters:
pKey OpenEdge.Core.String
 
pValue OpenEdge.Core.String
 
Returns OpenEdge.Core.String
  String The previous value, or unknown if none. Unknown is a valid value too.
Top

PutAll (IMap)

/* Copies all of the mappings from the specified map to this map (optional operation).
Parameters:
pMap OpenEdge.Core.Collections.IMap
 
Top

PutAll (IStringStringMap)

/* Adds all the values from an input map
Parameters:
pMap OpenEdge.Core.Collections.IStringStringMap
 
Top

LONGCHAR Remove (character)

Purpose: Removes the value for a particular key
Parameters:
pcKey CHARACTER
 
Returns LONGCHAR
  longchar The associated value, or unknown if there is no entry.
Top

Progress.Lang.Object Remove (Object)

Purpose: Removes the value for a particular key
Parameters:
pKey Progress.Lang.Object
 
Returns Progress.Lang.Object
  Object The associated value (of type OpenEdge.Core.String), or unknown if there is no entry.
Top

OpenEdge.Core.String Remove (String)

Purpose: Removes the value for a particular key
Parameters:
pKey OpenEdge.Core.String
 
Returns OpenEdge.Core.String
  String The associated value, or unknown if there is no entry.
Top

RemoveAll (ICollection)

Purpose: Removes the mappings for all key from this map if it is present (optional operation).
Parameters:
pKeys OpenEdge.Core.Collections.ICollection
 


Constructor Detail
Top

StringStringMap ()

/* Default constructor
Top

StringStringMap (IMap)

/* Constructor. Populates the map with the contents of another map.
Parameters:
pMap OpenEdge.Core.Collections.IMap
 


Property Detail
Top

OpenEdge.Core.Collections.ISet EntrySet

Returns OpenEdge.Core.Collections.ISet
 
Top

CHARACTER HASH_ALGORITHM

Returns CHARACTER
 
Top

OpenEdge.Core.Collections.ISet KeySet

Returns OpenEdge.Core.Collections.ISet
 
Top

INTEGER Size

Returns INTEGER
 
Top

OpenEdge.Core.Collections.ICollection Values

Returns OpenEdge.Core.Collections.ICollection