How Can I Create and Use a Bidirectional 1-to-1 Dictionary in C#?

Bidirectional one-to-one dictionary in C#

The generic class BiDictionaryOneToOne<TFirst, TSecond> represents a two-way one-to-one dictionary that allows seamless mapping between keys and values ​​in a unique and reciprocal manner. Unlike standard dictionaries, BiDictionaryOneToOne ensures that each key corresponds to only one value and vice versa. This feature is invaluable when you need to establish a bijective relationship between two different data sets.

To create a BiDictionaryOneToOne, simply instantiate it with the desired key and value types:

<code class="language-csharp">var bidirectionalDictionary = new BiDictionaryOneToOne<string, int>();</code>

The bidirectional nature of this dictionary gives you the flexibility to search for keys or values. The following methods support these operations:

• GetByFirst(TFirst first): Gets the value associated with the given key.
• GetBySecond(TSecond second): Get the key associated with the given value.

Again, to ensure uniqueness, the Add method verifies that the key and value already exist in the dictionary. If duplicates are detected, it will throw a ArgumentException exception.

To increase flexibility, the dictionary also provides the following "Try" methods:

• TryAdd(TFirst first, TSecond second): Try to add a pair, returning true if successful or false if duplicates are found.
• TryGetByFirst(TFirst first, out TSecond second): Try to retrieve the value of the key, returning true if successful or false if the key is not found.
• TryGetBySecond(TSecond second, out TFirst first): Try to retrieve the key corresponding to the value, return true if successful, or false if the value is not found.
• TryRemoveByFirst(TFirst first): Try to remove a pair based on the key, returning true if successful or false if the key is not found.
• TryRemoveBySecond(TSecond second): Try to remove a pair based on the value, returning true if successful or false if the value is not found.

As an additional feature, BiDictionaryOneToOne allows you to clear all entries using the Clear method, or determine the number of pairs in the dictionary via the Count attribute.

Using BiDictionaryOneToOne you can easily create bidirectional relationships between data, ensuring uniqueness while providing the flexibility to search, add, and delete pairs.

The above is the detailed content of How Can I Create and Use a Bidirectional 1-to-1 Dictionary in C#?. For more information, please follow other related articles on the PHP Chinese website!