length

Description:

[ Version ( since = "0.1.10" ) ]
public uint length (KeyID key)

Returns how many values key or related keys have in this: if key has no value, but a related key has, then it is counted as positive.

As example, let's think in three related keys, K1, K2 and K3, and then thinks we have added several values for those keys, as:

(V10, V20, V30), (V11, NULL, V31), (V12, NULL, V32)

Therefore, when invoking grl_data_length (data, K2) it will return 3: considering K2 and the related keys (K1 and K3), there are 3 values.

Parameters:

this

a data
key

a metadata key

Returns:

number of values