Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

method libtmux-rs latest

Server.typed_option

Read one server option, decoded according to its declared kind.

Source and package
Qualified name
libtmux::server::Server::typed_option
Module
server
Declared in
Server
Package
libtmux
Source
crates/libtmux/src/server/settings.rs
Other languages
Perlmethod Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby Lua TypeScript Go Java C# C++ Swift Kotlin Scala OCamlfunction F# Clojure
pub async fn typed_option(&self, name: &str) -> Result< Option<OptionValue>, Error >

Description#

The one way to read a single option; OptionValue says how reads and writes fit together. TmuxText::from(value) recovers the exact bytes tmux stored.

None means the option holds nothing: a built-in option that is unset, or a user option that was never set. tmux prints nothing for an option set to the empty string either, so that also reads as None.

Errors

Returns an error when tmux does not recognize the option name.

Parameters

tmux options#

Settings for the server, sessions, windows and panes, with their types, defaults and allowed values.

In other ports#

Read one server option

Equivalents of Read one server option in other languages
Language Equivalent
Python libtmux.Server.show_option
Lua libtmux.Server:get_option
Haskell No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript no single-option read; Server.showOptions returns them all
Go tmux.Server.RawOption
Java reached through Server.options, whose Options.get reads one
C# reached through Server.Options, whose TmuxOptions.GetAsync reads one
C++ no single-option read; Server::options returns them all
Swift Server.option(_:scope:)
OCaml Libtmux_unix.Client.read_option Pass the corresponding explicit Options scope; captured tables preserve their source and inheritance policy.
Perl LibTmux::Server::get_option Pass scope => 'server' and the explicit target ID where applicable; inherited and global reads are deliberate options.

No equivalent is recorded in Ruby, PowerShell, Julia, Erlang, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.

Esc

Type to search.

Reference previewOpen reference