# tmux_option:get/3

- **Package:** libtmux_erlang
- **Language:** Erlang
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-erlang/blob/d1b6308440cf9eb8f6647e7ae434bce60e849368/apps/libtmux_erlang/src/tmux_option.erl#L105
- **Page:** https://libtmux.org/en/erlang/latest/reference/tmux_option-get-3/

```
get(Scope, Key, Options)
-spec get(scope(), key(), read_options()) ->
             {ok, value()} | none | {error, map()}.
```

Read one option or array, performing I/O after validation. Missing local values and array entries return none; known empty strings and arrays return {ok, Value}. inherit = true reads through tmux's parent tables. Unknown fields are rejected. Errors retain backend diagnostics; a missing target never becomes absence. Use `set/4` to write a value and `unset/2` to restore inheritance.

## Parameters

- `Scope` (`scope()`)
- `Key` (`key()`)
- `Options` (`read_options()`)

## tmux command

The tmux commands behind `get/3`.

- [`show-options`](/en/tmux/latest/manual/show-options/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_show_options_entry`](/en/tmux/latest/reference/c-variable-cmd_show_options_entry/) (attribute)
- [`cmd_show_options_exec`](/en/tmux/latest/reference/c-function-cmd-show-options-c-cmd_show_options_exec/) (function)