WOLFRAM

Lookup[assoc,key]

looks up the value associated with key in the association assoc; if the key is not present, Missing["KeyAbsent",key] is returned.

Lookup[assoc,{key1,key2,}]

gives a list of the values associated with the keyi.

Lookup[{assoc1,assoc2,},key]

gives a list corresponding to the value of key in each associ.

Lookup[assoc,key,default]

gives default if the key is not present.

Lookup[assoc,keys,default,h]

looks up the values associated with keys, wrapping each of them with head h before evaluation.

Lookup[key]

represents an operator form of Lookup that can be applied to an expression.

Details

  • In Lookup[assoc,key,default], default is only evaluated if key is not found in assoc.
  • Lookup can be applied not only to Association objects, but also to lists of rules.
  • Lookup[assoc,Key[list]] treats the list list as a single key rather than a list of keys.
  • Lookup[{assoc1,assoc2,},{key1,key2,}] gives an array of the form {{assoc1[key1],assoc1[key2],},}.
  • Lookup[key][assoc] is equivalent to Lookup[assoc,key].

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Look up the value associated with the key:

Out[1]=1

When a key is not found, a Missing object is returned by default:

Out[1]=1

Provide a default value to be used when the key is not found:

Out[1]=1

Use the operator form of Lookup:

Out[1]=1

Scope  (5)Survey of the scope of standard use cases

Look up multiple keys at once:

Out[1]=1

Lookup threads over lists of associations:

Out[2]=2

Query multiple keys from multiple associations:

Out[3]=3

Lookup can be used to look up keys in lists of rules:

Out[1]=1
Out[2]=2

Wrap the result in Hold to prevent it from evaluating:

Out[1]=1

Apply the operator form to a list of lists:

Out[1]=1

Applications  (1)Sample problems that can be solved with this function

You can use constructs such as Throw and Return in the third argument of Lookup to abort a computation when a required key is missing:

Out[2]=2
Out[3]=3

Properties & Relations  (4)Properties of the function, and connections to other functions

When the key is present, the default is not evaluated:

Out[2]=2

Even when it appears in a result multiple times, the default value is only evaluated once:

Out[1]=1
Out[2]=2

Applying an association to a key is typically equivalent to using Lookup on that key:

Out[1]=1
Out[2]=2

Lists are handled differently by Lookup, however:

Out[3]=3
Out[4]=4

Wrap the list in Key to make Lookup treat it as a single key:

Out[5]=5

Lookup automatically strips up to one level of Key from its second argument:

Out[2]=2
Out[3]=3

Similarly, lists of keys are stripped of any Key wrappers they contain:

Out[4]=4

This stripping allows looking up expressions of the form Key[{}] and Key[Key[]]:

Out[5]=5
Out[6]=6

Possible Issues  (1)Common pitfalls and unexpected behavior

When the key to be looked up is a list or an expression with head Key, it must be wrapped in a Key to avoid ambiguity:

Out[1]=1
Out[2]=2
Out[3]=3
Out[4]=4
Out[5]=5
Wolfram Research (2014), Lookup, Wolfram Language function, https://reference.wolfram.com/language/ref/Lookup.html (updated 2020).
Wolfram Research (2014), Lookup, Wolfram Language function, https://reference.wolfram.com/language/ref/Lookup.html (updated 2020).

Text

Wolfram Research (2014), Lookup, Wolfram Language function, https://reference.wolfram.com/language/ref/Lookup.html (updated 2020).

Wolfram Research (2014), Lookup, Wolfram Language function, https://reference.wolfram.com/language/ref/Lookup.html (updated 2020).

CMS

Wolfram Language. 2014. "Lookup." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/Lookup.html.

Wolfram Language. 2014. "Lookup." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/Lookup.html.

APA

Wolfram Language. (2014). Lookup. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Lookup.html

Wolfram Language. (2014). Lookup. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Lookup.html

BibTeX

@misc{reference.wolfram_2025_lookup, author="Wolfram Research", title="{Lookup}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/Lookup.html}", note=[Accessed: 24-March-2025 ]}

@misc{reference.wolfram_2025_lookup, author="Wolfram Research", title="{Lookup}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/Lookup.html}", note=[Accessed: 24-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_lookup, organization={Wolfram Research}, title={Lookup}, year={2020}, url={https://reference.wolfram.com/language/ref/Lookup.html}, note=[Accessed: 24-March-2025 ]}

@online{reference.wolfram_2025_lookup, organization={Wolfram Research}, title={Lookup}, year={2020}, url={https://reference.wolfram.com/language/ref/Lookup.html}, note=[Accessed: 24-March-2025 ]}