Method Add

sdks/csharp/src/MultiDictionary.cs:67–86

Add a key-value-pair to the multidictionary. If the key is already present, its associated value must satisfy keyComparer.Equals(value, item.Value). Whether the key is entirely new to the dictionary. If it was already present, we assert that the old value is equal to the new value.

(TKey key, TValue value)

        /// <param name="item"></param>
        /// <returns>Whether the key is entirely new to the dictionary. If it was already present, we assert that the old value is equal to the new value.</returns>
        public bool Add(TKey key, TValue value)
        {
            if (value == null)
            {
                throw new NullReferenceException("Null values are forbidden in multidictionary");
            }
            Debug.Assert(RawDict != null);
            Debug.Assert(key != null);
            if (RawDict.TryGetValue(key, out var result))
            {
                Debug.Assert(ValueComparer.Equals(value, result.Value));
                RawDict[key] = (value, result.Multiplicity + 1);
                return false;
            }
            else
            {
                RawDict[key] = (value, 1);
                return true;
            }
        }

        /// <summary>
        /// Completely clear the multidictionary.