/* Copyright (C) 2004 The glibmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see .
*/
_DEFS(glibmm,glib)
#include
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C" { typedef struct _GOptionEntry GOptionEntry; }
#endif
namespace Glib
{
/** 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.
*/
class OptionEntry
{
_CLASS_GENERIC(OptionEntry, GOptionEntry)
public:
_WRAP_ENUM(Flags, GOptionFlags, NO_GTYPE)
OptionEntry();
OptionEntry(const OptionEntry& src);
OptionEntry(OptionEntry&& other) noexcept;
OptionEntry& operator=(OptionEntry&& other) noexcept;
virtual ~OptionEntry();
OptionEntry& operator=(const OptionEntry& src);
// We do not use nullptr for an empty string in set_long_name(),
// because G_OPTION_REMAINING is actually a "", so it has a distinct meaning.
// TODO: Wrap G_OPTION_REMAINING in C++ somehow, maybe as an overloaded
// set_long_name(void) or set_is_remaining()? murrayc.
#m4 _CONVERSION(`Glib::ustring',`const char*',`($3).c_str()')
_MEMBER_GET(long_name, long_name, Glib::ustring, const char*)
_MEMBER_SET_STR(long_name, long_name, Glib::ustring, const char*)
_MEMBER_GET(short_name, short_name, gchar, gchar)
_MEMBER_SET(short_name, short_name, gchar, gchar)
#m4 _CONVERSION(`int',`Flags',`static_cast($3)')
_MEMBER_GET(flags, flags, Flags, int)
#m4 _CONVERSION(`Flags',`int',`static_cast($3)')
/** Set one or more OptionEntry::Flags.
* Do not set Flags::FILENAME. Character encoding is chosen when the OptionEntry
* is added to an OptionGroup.
*/
_MEMBER_SET(flags, flags, Flags, int)
// We use nullptr for an empty string in set_description() and set_arg_description().
#m4 _CONVERSION(`Glib::ustring',`const char*',`Glib::c_str_or_nullptr($3)')
_MEMBER_GET(description, description, Glib::ustring, const char*)
_MEMBER_SET_STR(description, description, Glib::ustring, const char*)
_MEMBER_GET(arg_description, arg_description, Glib::ustring, const char*)
_MEMBER_SET_STR(arg_description, arg_description, Glib::ustring, const char*)
GOptionEntry* gobj() { return gobject_; }
const GOptionEntry* gobj() const { return gobject_; }
private:
void release_gobject() noexcept;
protected:
GOptionEntry* gobject_;
};
} // namespace Glib