Name Class |
Namespace: Bloomberglp.Blpapi
The Name type exposes the following members.
Name | Description | |
---|---|---|
Name | Default constructed Name. All default constructed
Name objects are equivalent to NullName.
| |
Name(String) |
Constructs a Name from the specified nameString.
|
Name | Description | |
---|---|---|
Equals | Compares this Name object to the specified Object.
(Overrides ObjectEquals(Object).) | |
FindName | Returns a reference to a Name object for the specified nameString or
null if a Name does not exist.
| |
FreeGlobalNameTable |
Purges all entries from the global name table.
| |
GetHashCode | GetHashCode() override to correspond to
Equals(Object) Equals()
(Overrides ObjectGetHashCode.) | |
GetName | Returns a reference to a Name object for the specified nameString
creating it if it doesn't exist already.
| |
HasName | Returns true if a reference to a Name
object exists for the specified nameString.
| |
ToString | Returns the String this Name object represents.
(Overrides ObjectToString.) |
The Name class is an efficient substitute for a string when used as a key, providing constant time comparison and ordering operations. Two Name objects constructed from Strings for which equals() would return true will always compare equally.
This is where possible Name objects should be initialized once and then reused. Creating a Name object from a String involves a search in a container requiring multiple string comparison operations.
Note: Each Name instance refers to an entry in a global static table. Name instances for identical strings will refer to the same data. There is no provision for removing entries from the static table so Name objects should only be used when the set of input strings is bounded.
For example, creating a Name for every possible field name and type in a data model is reasonable (in fact, the API will do this whenever it receives schema information). However, converting sequence numbers on incoming messages to strings and creating a Name from each one of those strings will cause the static table to grow in an unbounded manner.