/**
* Allows to search for specific data values via JMESPath expressions.
*
* Some example expressions as a quick start:
*
* - "nested.key" returns the value of the nested "key"
* - "nested.*" returns all values available under the "nested" key
* - "*.key" returns all values of "key"s on any second level array
* - "[key, nested.key]" returns first level "key" value and the first value of the "nested" key array
* - "[key, nested[0]" returns first level "key" value and the first value of the "nested" key array
* - "nested.key || key" returns the value of the first matching expression
*
* @see http://jmespath.readthedocs.org/en/latest/ and https://github.com/mtdowling/jmespath.php
*
* @param string $expression JMESPath expression to evaluate on stored data
*
* @return mixed|null data in various types (scalar, array etc.) depending on the found results
*
* @throws \JmesPath\SyntaxErrorException on invalid expression syntax
* @throws \RuntimeException e.g. if JMESPath cache directory cannot be written
* @throws \InvalidArgumentException e.g. if JMESPath builtin functions can't be called
*/
public function getOptionValues($expression = '*')
{
return $this->options->getValues($expression);
}
