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

Copyright (c) 2014, 2019-2020 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

PUBLIC Clear ()

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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PRIVATE 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

PRIVATE 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

PUBLIC LONGCHAR Get (character)

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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PROTECTED 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

PUBLIC 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

PUBLIC 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

PUBLIC PutAll (IMap)

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

PUBLIC PutAll (IStringStringMap)

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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC 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

PUBLIC StringStringMap ()

/* Default constructor
Top

PUBLIC StringStringMap (IMap)

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


Property Detail
Top

PUBLIC OpenEdge.Core.Collections.ISet EntrySet

Returns OpenEdge.Core.Collections.ISet
Top

PRIVATE CHARACTER HASH_ALGORITHM

Returns CHARACTER
Top

PUBLIC OpenEdge.Core.Collections.ISet KeySet

Returns OpenEdge.Core.Collections.ISet
Top

PUBLIC INTEGER Size

Returns INTEGER
Top

PUBLIC OpenEdge.Core.Collections.ICollection Values

Returns OpenEdge.Core.Collections.ICollection


Copyright © 2020 Progress Software Corporation. All rights Reserved.

Progress® OpenEdge® Release 12.2.0