byKeyValue
fn
auto byKeyValue(T : V[K], K, V)(T aa) pure nothrow @nogc @safeReturns a forward range which will iterate over the key-value pairs of the associative array. The returned pairs are represented by an opaque type with .key and .value properties for accessing references to the key and value of the pair, respectively.
If structural changes are made to the array (removing or adding keys), all ranges previously obtained through this function are invalidated. The following example program will dereference a null pointer:
import std.stdio : writeln;
auto dict = ["k1": 1, "k2": 2];
auto kvRange = dict.byKeyValue;
dict.clear;
writeln(kvRange.front.key, ": ", kvRange.front.value); // Segmentation faultNote that this is a low-level interface to iterating over the associative array and is not compatible with the
Tuple type in Phobos.
For compatibility with Tuple, use
Parameters
aa | The associative array. |
Returns
A forward range referencing the pairs of the associative array.
fn
auto byKeyValue(T : V[K], K, V)(T * aa) pure nothrow @nogcditto