glibmm 2.84.0
Glib::OptionEntry Class Reference

An OptionEntry defines a single option. More...

#include <glibmm/optionentry.h>

Public Types

enum class  Flags {
  Flags::NONE = 0x0 ,
  Flags::HIDDEN = 1 << 0 ,
  Flags::IN_MAIN = 1 << 1 ,
  Flags::REVERSE = 1 << 2 ,
  Flags::NO_ARG = 1 << 3 ,
  Flags::FILENAME = 1 << 4 ,
  Flags::OPTIONAL_ARG = 1 << 5 ,
  Flags::NOALIAS = 1 << 6 ,
  Flags::DEPRECATED = 1 << 7
}
 Flags which modify individual options. More...

Public Member Functions

 OptionEntry ()
 OptionEntry (const OptionEntry & src)
 OptionEntry (OptionEntry && other) noexcept
OptionEntryoperator= (OptionEntry && other) noexcept
virtual ~OptionEntry ()
OptionEntryoperator= (const OptionEntry & src)
Glib::ustring get_long_name () const
void set_long_name (const Glib::ustring & value)
gchar get_short_name () const
void set_short_name (const gchar & value)
Flags get_flags () const
void set_flags (const Flags & value)
 Set one or more OptionEntry::Flags.
Glib::ustring get_description () const
void set_description (const Glib::ustring & value)
Glib::ustring get_arg_description () const
void set_arg_description (const Glib::ustring & value)
GOptionEntry * gobj ()
const GOptionEntry * gobj () const

Protected Attributes

GOptionEntry * gobject_

Detailed Description

An OptionEntry defines a single option.

To have an effect, it must be added to an OptionGroup with OptionGroup::add_entry().

The long name of an option can be used to specify it in a commandline as –long_name. Every option must have a long name. To resolve conflicts if multiple option groups contain the same long name, it is also possible to specify the option as –groupname-long_name.

If an option has a short name, it can be specified as -short_name in a commandline.

The description for the option is shown in the –help output.

The arg_descripton is the placeholder to use for the extra argument parsed by the option in –help output.

Examples
options/main.cc.

Constructor & Destructor Documentation

◆ OptionEntry() [1/3]

Glib::OptionEntry::OptionEntry ( )

◆ OptionEntry() [2/3]

Glib::OptionEntry::OptionEntry ( const OptionEntry & src)

◆ OptionEntry() [3/3]

Glib::OptionEntry::OptionEntry ( OptionEntry && other)
noexcept

◆ ~OptionEntry()

virtual Glib::OptionEntry::~OptionEntry ( )
virtual

Member Function Documentation

◆ get_arg_description()

Glib::ustring Glib::OptionEntry::get_arg_description ( ) const

◆ get_description()

Glib::ustring Glib::OptionEntry::get_description ( ) const

◆ get_flags()

Flags Glib::OptionEntry::get_flags ( ) const

◆ get_long_name()

Glib::ustring Glib::OptionEntry::get_long_name ( ) const

◆ get_short_name()

gchar Glib::OptionEntry::get_short_name ( ) const

◆ gobj() [1/2]

GOptionEntry * Glib::OptionEntry::gobj ( )
inline

◆ gobj() [2/2]

const GOptionEntry * Glib::OptionEntry::gobj ( ) const
inline

◆ operator=() [1/2]

OptionEntry & Glib::OptionEntry::operator= ( const OptionEntry & src)

◆ operator=() [2/2]

OptionEntry & Glib::OptionEntry::operator= ( OptionEntry && other)
noexcept

◆ set_arg_description()

void Glib::OptionEntry::set_arg_description ( const Glib::ustring & value)

◆ set_description()

void Glib::OptionEntry::set_description ( const Glib::ustring & value)
Examples
options/main.cc.

◆ set_flags()

void Glib::OptionEntry::set_flags ( const Flags & value)

Set one or more OptionEntry::Flags.

Do not set Flags::FILENAME. Character encoding is chosen when the OptionEntry is added to an OptionGroup.

Examples
options/main.cc.

◆ set_long_name()

void Glib::OptionEntry::set_long_name ( const Glib::ustring & value)
Examples
options/main.cc.

◆ set_short_name()

void Glib::OptionEntry::set_short_name ( const gchar & value)
Examples
options/main.cc.

Member Data Documentation

◆ gobject_

GOptionEntry* Glib::OptionEntry::gobject_
protected