unibi_get_aliases - Man Page

access the aliases of a terminal object

Synopsis

 #include <unibilium.h>
 
 const char **unibi_get_aliases(const unibi_term *ut);
 void unibi_set_aliases(unibi_term *ut, const char **v);

Description

unibi_get_aliases returns the list of aliases from ut; unibi_set_aliases sets it to v. The format of this list is like argv: a null-terminated vector of strings.

The contents of this list come from the ('|'-separated) name section in terminfo entries. It's supposed to be a list of lowercase words or abbreviations that refer to this terminal, the first one being the most common name. The last part of the name section can be more verbose and is not stored in the aliases list; it can be accessed with unibi_get_name.

Note that unibi_set_aliases simply stores the pointer it is given; it will not free v or make a copy of it (or any of the strings it points to).

Return Value

unibi_get_aliases returns a pointer to a null-terminated vector of strings.

See Also

unibilium.h(3), unibi_get_name(3), unibi_set_name(3)

Referenced By

unibi_get_name(3), unibilium.h(3), unibi_set_name(3).

The man page unibi_set_aliases(3) is an alias of unibi_get_aliases(3).

2024-01-27 unibilium-2.1.1