Click or drag to resize

DictExtensionsSetDefaultK, V Method

Returns a value from the dictionary by a key. If the key is not present yet, then a new default entry is created and returned.

Namespace:  KSPDev.Extensions
Assembly:  KSPDev_Utils.1.2 (in KSPDev_Utils.1.2.dll) Version: 1.2 for KSP v1.6+
Syntax
C#
Copy
public static V SetDefault<K, V>(
	this Dictionary<K, V> dict,
	K key
)
where V : new()
Request Example View Source

Parameters

dict
Type: System.Collections.GenericDictionaryK, V
The dictionary to get value from.
key
Type: K
The key to lookup.

Type Parameters

K
The type of the dictionary key.
V
The type of the dictionary value.

Return Value

Type: V
Either an existing value for the key or a default instance of the value.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type DictionaryK, V. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Examples
If there is a dictionary which values are collections or a class, then a special code is always needed to properly access this dictionary:
Copy
public static void ClassicAddToDict(Dictionary<int, HashSet<string>> dict) {
  if (!dict.ContainsKey(123)) {
    // Create an empty string set if the key is not yet initialized.  
    dict[123] = new HashSet<string>();
  }
  dict[123].Add("abc");  // Add the value.
}
With this extension the key can safely be accessed with just one call:
Copy
public static void SetDefaultAddToDict(Dictionary<int, HashSet<string>> dict) {
  // If key 123 doesn't exist it will be created automatically.
  dict.SetDefault(123).Add("abc");
}
See Also