insert

Associates the specified value with the specified key in the specified associative array. If the associative array previously contained a mapping for the key, the existing value associated for the given key will be return and the associative array is unchanged. (An associative array <tt>aa</tt> is said to contain a mapping for a key <tt>k</tt> if and only if m.containsKey(k) would return <tt>true</tt>.)

  1. V insert(V[K] aa, K key, V value)
    V
    insert
    (
    K
    V
    )
    (
    V[K] aa
    ,
    K key
    ,)
  2. V insert(V[][K] mm, K key, V value)

Parameters

aa V[K]

the associative array to add the key/value pair to

key K

key with which the specified value is to be associated

value V

value to be associated with the specified key

Return Value

Type: V

the previous value associated with <tt>key</tt>, or or the newly associated value.

Meta