Options

GnuCash Options System for Book, Report, and Stylesheet Options. More...

Files
file	gnc-option-date.hpp
	Relative date enumeration and manipulation functions.
file	gnc-option-impl.hpp
	Implementation templates and specializtions for GncOption values.
file	gnc-option-uitype.hpp
	OptionUITypes.
file	gnc-option.hpp
	C++ Public interface for individual options.
file	gnc-optiondb-impl.hpp
	Implementation details for GncOptionDB.
file	gnc-optiondb.h
	C public interface for the Options Database.
file	gnc-optiondb.hpp
	The primary C++ interface to options for books, reports, and stylesheets.

Data Structures
struct	OptionClassifier
	This class is the parent of all option implementations. More...
class	GncOptionValue< ValueType >
	The generic option-value class. More...
struct	GncOwnerDeleter
	class GncOptionGncOwnerValue More...
class	GncOptionGncOwnerValue
class	GncOptionQofInstanceValue
class	GncOptionCommodityValue
	class GncOptionCommodityValue Commodities are stored with their namespace and mnemonic instead of their gncGUID so that they can be correctly retrieved even if they're deleted and recreated. More...
struct	is_GncOwnerValue< T >
struct	is_QofInstanceValue< T >
struct	is_QofQueryValue< T >
class	GncOptionRangeValue< ValueType >
	Used for numeric ranges and plot sizes. More...
class	GncOptionMultichoiceValue
	Multichoice options have a vector of valid options (GncMultichoiceOptionChoices) and validate the selection as being one of those values. More...
class	GncOptionAccountListValue
	Set one or more accounts on which to report, optionally restricted to certain account types. More...
class	GncOptionAccountSelValue
class	GncOptionDateValue
	A legal date value is a pair of either a RelativeDatePeriod, the absolute flag and a time64, or for legacy purposes the absolute flag and a timespec. More...
struct	is_OptionClassifier< T >
struct	is_same_decayed< T, U >
struct	is_RangeValue< T >
class	GncOption
	Represents the public interface for an option. More...
class	GncOptionSection
	class GncOptionSection The upper-level classification implementation. More...
struct	GncOptionDBCallback
class	GncOptionDB
	Holds all of the options for a book, report, or stylesheet, organized by GncOptionSections. More...

Typedefs
using	RelativeDatePeriodVec = std::vector< RelativeDatePeriod >
using	GncOwnerPtr = std::unique_ptr< GncOwner, GncOwnerDeleter >
using	GncItem = std::pair< QofIdTypeConst, GncGUID >
	class GncOptionQofinstanceValue
using	GncMultichoiceOptionEntry = std::tuple< const std::string, const std::string, GncOptionMultichoiceKeyType >
using	GncMultichoiceOptionIndexVec = std::vector< uint16_t >
using	GncMultichoiceOptionChoices = std::vector< GncMultichoiceOptionEntry >
using	GncOptionAccountList = std::vector< GncGUID >
using	GncOptionAccountTypeList = std::vector< GNCAccountType >
using	GncOptionUIItemPtr = std::unique_ptr< GncOptionUIItem >
using	GncOwner = _gncOwner
using	QofQuery = _QofQuery
using	QofInstance = QofInstance_s
using	GncOptionDateFormat = std::tuple< QofDateFormat, GNCDateMonthFormat, bool, std::string >
using	GncOptionReportPlacement = std::tuple< uint32_t, uint32_t, uint32_t >
using	GncOptionReportPlacementVec = std::vector< GncOptionReportPlacement >
using	GncOptionVariant = std::variant< GncOptionValue< std::string >, GncOptionValue< bool >, GncOptionValue< int64_t >, GncOptionQofInstanceValue, GncOptionGncOwnerValue, GncOptionValue< const QofQuery * >, GncOptionValue< GncOptionReportPlacementVec >, GncOptionAccountListValue, GncOptionAccountSelValue, GncOptionMultichoiceValue, GncOptionRangeValue< int >, GncOptionRangeValue< double >, GncOptionCommodityValue, GncOptionDateValue, GncOptionValue< GncOptionDateFormat > >
using	GncOptionVariantPtr = std::unique_ptr< GncOptionVariant >
using	GncOptionVec = std::vector< GncOption >
using	GncOptionSectionPtr = std::shared_ptr< GncOptionSection >
using	GncOptionDBChangeCallback = void(*)(void *user_data)
using	GncCallbackVec = std::vector< GncOptionDBCallback >
using	GncOptionDBPtr = std::unique_ptr< GncOptionDB >
using	GncOptionAccountList = std::vector< GncGUID >
using	GncOptionAccountTypeList = std::vector< GNCAccountType >
using	GncMultichoiceOptionEntry = std::tuple< const std::string, const std::string, GncOptionMultichoiceKeyType >
using	GncMultichoiceOptionChoices = std::vector< GncMultichoiceOptionEntry >

Enumerations
enum class	RelativeDatePeriod : int {   ABSOLUTE = -1 , TODAY , ONE_WEEK_AGO , ONE_WEEK_AHEAD ,   ONE_MONTH_AGO , ONE_MONTH_AHEAD , THREE_MONTHS_AGO , THREE_MONTHS_AHEAD ,   SIX_MONTHS_AGO , SIX_MONTHS_AHEAD , ONE_YEAR_AGO , ONE_YEAR_AHEAD ,   START_THIS_MONTH , END_THIS_MONTH , START_PREV_MONTH , END_PREV_MONTH ,   START_NEXT_MONTH , END_NEXT_MONTH , START_CURRENT_QUARTER , END_CURRENT_QUARTER ,   START_PREV_QUARTER , END_PREV_QUARTER , START_NEXT_QUARTER , END_NEXT_QUARTER ,   START_CAL_YEAR , END_CAL_YEAR , START_PREV_YEAR , END_PREV_YEAR ,   START_NEXT_YEAR , END_NEXT_YEAR , START_ACCOUNTING_PERIOD , END_ACCOUNTING_PERIOD }
	Reporting periods relative to the current date. More...
enum class	GncOptionUIType : unsigned int {   INTERNAL , BOOLEAN , STRING , TEXT ,   CURRENCY , COMMODITY , MULTICHOICE , DATE_ABSOLUTE ,   DATE_RELATIVE , DATE_BOTH , ACCOUNT_LIST , ACCOUNT_SEL ,   LIST , NUMBER_RANGE , COLOR , FONT ,   PLOT_SIZE , BUDGET , PIXMAP , RADIOBUTTON ,   DATE_FORMAT , OWNER , CUSTOMER , VENDOR ,   EMPLOYEE , INVOICE , JOB , TAX_TABLE ,   INV_REPORT , QUERY , REPORT_PLACEMENT , MAX_VALUE }
	Used by GncOptionClassifier to indicate to dialog-options what control should be displayed for the option. More...
enum class	GncOptionMultichoiceKeyType { SYMBOL , STRING , NUMBER }
enum	RelativeDateUI : uint8_t { ABSOLUTE , RELATIVE , BOTH }

Functions
bool	gnc_relative_date_is_single (RelativeDatePeriod)
	Report whether the relative date represents a period offset to today's date rather than the beginning or end of a date range.
bool	gnc_relative_date_is_starting (RelativeDatePeriod)
	Report whether the relative date represents the beginning of a date range.
bool	gnc_relative_date_is_ending (RelativeDatePeriod)
	Report whether the relative date represents the end of a date range.
const char *	gnc_relative_date_storage_string (RelativeDatePeriod)
	Provide the string representation of a relative date for persisting the value.
const char *	gnc_relative_date_display_string (RelativeDatePeriod)
	Provide the string representation of a relative date for displaying value to a user.
const char *	gnc_relative_date_description (RelativeDatePeriod)
	Provide the description of a relative date.
RelativeDatePeriod	gnc_relative_date_from_storage_string (const char *)
	Convert a relative date storage string back to a RelativeDatePeriod value.
time64	gnc_relative_date_to_time64 (RelativeDatePeriod, time64 now_t=static_cast< time64 >(GncDateTime()))
	Convert a RelativeDatePeriod value to a concrete time64 by applying the value to the current time.
std::ostream &	operator<< (std::ostream &, const RelativeDatePeriod)
	Add the display string to the provided std::ostream.
QofInstance *	qof_instance_from_string (const std::string &str, GncOptionUIType type)
QofInstance *	qof_instance_from_guid (GncGUID *, GncOptionUIType type)
std::string	qof_instance_to_string (const QofInstance *inst)
template<class OptType , typename std::enable_if_t< is_OptionClassifier_v< OptType > &&!(is_QofInstanceValue_v< OptType >||is_RangeValue_v< OptType >), int > = 0>
std::ostream &	operator<< (std::ostream &oss, const OptType &opt)
template<>
std::ostream &	operator<<< GncOptionValue< bool > > (std::ostream &oss, const GncOptionValue< bool > &opt)
std::ostream &	operator<< (std::ostream &oss, const GncOptionCommodityValue &opt)
template<class OptType , typename std::enable_if_t< is_OptionClassifier_v< OptType > &&!(is_QofInstanceValue_v< OptType >||is_RangeValue_v< OptType >), int > = 0>
std::istream &	operator>> (std::istream &iss, OptType &opt)
std::istream &	operator>> (std::istream &iss, GncOptionCommodityValue &opt)
template<>
std::istream &	operator>>< GncOptionValue< bool > > (std::istream &iss, GncOptionValue< bool > &opt)
template<>
std::istream &	operator>>< GncOptionValue< GncOptionReportPlacementVec > > (std::istream &iss, GncOptionValue< GncOptionReportPlacementVec > &opt)
template<>
std::ostream &	operator<<< GncOptionMultichoiceValue > (std::ostream &oss, const GncOptionMultichoiceValue &opt)
template<>
std::istream &	operator>>< GncOptionMultichoiceValue > (std::istream &iss, GncOptionMultichoiceValue &opt)
template<>
std::ostream &	operator<<< GncOptionAccountListValue > (std::ostream &oss, const GncOptionAccountListValue &opt)
template<>
std::istream &	operator>>< GncOptionAccountListValue > (std::istream &iss, GncOptionAccountListValue &opt)
template<>
std::ostream &	operator<<< GncOptionAccountSelValue > (std::ostream &oss, const GncOptionAccountSelValue &opt)
template<>
std::istream &	operator>>< GncOptionAccountSelValue > (std::istream &iss, GncOptionAccountSelValue &opt)
template<>
std::ostream &	operator<<< GncOptionDateValue > (std::ostream &oss, const GncOptionDateValue &opt)
template<>
std::istream &	operator>>< GncOptionDateValue > (std::istream &iss, GncOptionDateValue &opt)
bool	operator< (const GncOption &right, const GncOption &left)
std::ostream &	operator<< (std::ostream &oss, const GncOption &opt)
std::istream &	operator>> (std::istream &iss, GncOption &opt)
std::ostream &	output_color_value (std::ostream &oss, const std::string &value)
template<typename ValueType >
GncOption *	gnc_make_option (const char *section, const char *name, const char *key, const char *doc_string, ValueType value, GncOptionUIType ui_type)
	Free function wrapping GncOption's constructor.
bool	operator< (const GncOptionSectionPtr &right, const GncOptionSectionPtr &left)
GncOptionDB *	gnc_option_db_new (void)
	Create an empty option database.
void	gnc_option_db_destroy (GncOptionDB *odb)
	Destruct and release a GncOptionDB.
GList *	gnc_option_db_commit (GncOptionDB *odb)
	Write all changed ui_item values to their options.
void	gnc_option_db_clean (GncOptionDB *odb)
	Reset all ui_items to the option value.
void	gnc_option_db_load (GncOptionDB *odb, QofBook *book)
	Load a book's options into the GncOptionDB.
void	gnc_option_db_save (GncOptionDB *odb, QofBook *book, gboolean clear_options)
	Save the GncOptionDB contents into a book's options store.
void	gnc_option_db_book_options (GncOptionDB *)
	Register the standard option set for a QofBook.
const QofInstance *	gnc_option_db_lookup_qofinstance_value (GncOptionDB *, const char *, const char *)
	Retrieve the QofInstance value of an option in the GncOptionDB.
GncOptionAccountList	gnc_account_list_from_types (QofBook *book, const GncOptionAccountTypeList &types)
	Extract a list of accounts in the book having one of the GNCAccountTypes in types.
void	gnc_register_string_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new string option and register it in the options database.
void	gnc_register_string_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_text_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new text option and register it in the options database.
void	gnc_register_text_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_font_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new font option and register it in the options database.
void	gnc_register_font_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_budget_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, GncBudget *value)
	Create a new budget option and register it in the options database.
void	gnc_register_budget_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, GncBudget *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_commodity_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, gnc_commodity *value)
	Create a new commodity option and register it in the options database.
void	gnc_register_commodity_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, gnc_commodity *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_commodity_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const char *value)
	As above but with a const char* value, which should be the symbol for the commodity.
void	gnc_register_commodity_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const char *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_simple_boolean_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, bool value)
	Create a new simple boolean option and register it in the options database.
void	gnc_register_simple_boolean_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, bool value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_pixmap_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new pixmap option and register it in the options database.
void	gnc_register_pixmap_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_account_list_limited_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const GncOptionAccountList &value, GncOptionAccountTypeList &&allowed)
	Create a new limited account list option and register it in the options database.
void	gnc_register_account_list_limited_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const GncOptionAccountList &value, GncOptionAccountTypeList &&allowed)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_account_list_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const GncOptionAccountList &value)
	Create a new account list option and register it in the options database.
void	gnc_register_account_list_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const GncOptionAccountList &value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_account_sel_limited_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const Account *value, GncOptionAccountTypeList &&allowed)
	Create a limited account selection option and register it in the options database.
void	gnc_register_account_sel_limited_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const Account *value, GncOptionAccountTypeList &&allowed)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_multichoice_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const char *default_val, GncMultichoiceOptionChoices &&value)
	Create a new multichoice option and register it in the options database.
void	gnc_register_multichoice_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const char *default_val, GncMultichoiceOptionChoices &&value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_list_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const char *value, GncMultichoiceOptionChoices &&list)
	Create a new list option and register it in the options database.
void	gnc_register_list_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const char *value, GncMultichoiceOptionChoices &&list)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
template<typename ValueType >
void	gnc_register_number_range_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, ValueType value, ValueType min, ValueType max, ValueType step)
	Create a new number range option and register it in the options database.
template<typename ValueType >
void	gnc_register_number_range_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, ValueType value, ValueType min, ValueType max, ValueType step)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_number_plot_size_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, int value)
	Create a new plot-size option and register it in the options database.
void	gnc_register_number_plot_size_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, float value)
void	gnc_register_number_plot_size_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, int value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_number_plot_size_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, float value)
void	gnc_register_query_option (GncOptionDB *db, const char *section, const char *name, const QofQuery *value)
	Create a new QofQuery option and register it in the options database.
void	gnc_register_query_option (GncOptionDBPtr &db, const char *section, const char *name, const QofQuery *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_owner_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const GncOwner *value, GncOwnerType type)
	Create a new GncOwner option and register it in the options database.
void	gnc_register_owner_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const GncOwner *value, GncOwnerType type)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_color_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new color option and register it in the options database.
void	gnc_register_color_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_internal_option (GncOptionDBPtr &db, const char *section, const char *name, const std::string &value)
void	gnc_register_internal_option (GncOptionDBPtr &db, const char *section, const char *name, bool value)
void	gnc_register_report_placement_option (GncOptionDBPtr &db, const char *section, const char *name)
void	gnc_register_currency_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, gnc_commodity *value)
	Create a new currency option and register it in the options database.
void	gnc_register_currency_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, gnc_commodity *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_currency_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, const char *value)
	As above but with a const char* value, which must be the ISO4217 three-letter symbol for the currency.
void	gnc_register_currency_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, const char *value)
void	gnc_register_invoice_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, GncInvoice *value)
	Create a new invoice option and register it in the options database.
void	gnc_register_invoice_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, GncInvoice *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_taxtable_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, GncTaxTable *value)
	Create a new taxtable option and register it in the options database.
void	gnc_register_taxtable_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, GncTaxTable *value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_invoice_print_report_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new print report option and register it in the options database.
void	gnc_register_invoice_print_report_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_counter_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, int value)
	Create a new counter option and register it in the options database.
void	gnc_register_counter_option (const GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, double value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_counter_format_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	Create a new counter format option and register it in the options database.
void	gnc_register_counter_format_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, std::string value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_dateformat_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, GncOptionDateFormat &&value)
	Create a new date format option and register it in the options database.
void	gnc_register_dateformat_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, GncOptionDateFormat &&value)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_date_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, RelativeDatePeriod period=RelativeDatePeriod::TODAY, RelativeDateUI ui=RelativeDateUI::BOTH)
	Create a new date option and register it in the options database.
void	gnc_register_date_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, RelativeDatePeriod period=RelativeDatePeriod::TODAY, RelativeDateUI ui=RelativeDateUI::BOTH)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_date_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, time64 time, RelativeDateUI ui=RelativeDateUI::BOTH)
	Create a new date option and register it in the options database.
void	gnc_register_date_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, time64 time, RelativeDateUI ui=RelativeDateUI::BOTH)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_date_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, RelativeDatePeriodVec &period_set, bool both=true)
	Create a new date option and register it in the options database.
void	gnc_register_date_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, RelativeDatePeriodVec &period_set, bool both=true)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_start_date_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, bool both=true)
	Create a new start-date option and register it in the options database.
void	gnc_register_start_date_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, bool both=true)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.
void	gnc_register_end_date_option (GncOptionDB *db, const char *section, const char *name, const char *key, const char *doc_string, bool both=true)
	Create a new end-date option and register it in the options database.
void	gnc_register_end_date_option (GncOptionDBPtr &db, const char *section, const char *name, const char *key, const char *doc_string, bool both=true)
	As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Variables
constexpr unsigned	relative_date_periods
size_t constexpr	classifier_size_max {50}
size_t constexpr	sort_tag_size_max {10}
auto constexpr	uint16_t_max = std::numeric_limits<uint16_t>::max()
template<typename T >
constexpr bool	is_GncOwnerValue_v = is_GncOwnerValue<T>::value
template<typename T >
constexpr bool	is_QofInstanceValue_v = is_QofInstanceValue<T>::value
template<typename T >
constexpr bool	is_QofQueryValue_v = is_QofQueryValue<T>::value
template<typename T >
constexpr bool	is_OptionClassifier_v = is_OptionClassifier<T>::value
template<typename T , typename U >
constexpr bool	is_same_decayed_v = is_same_decayed<T, U>::value
template<typename T >
constexpr bool	is_RangeValue_v = is_RangeValue<T>::value

Detailed Description

GnuCash Options System for Book, Report, and Stylesheet Options.

The GnuCash Options System supports two somewhat different purposes:

• File properties, such as business information and whether to use automatic trading accounts.
• Report options for configuring and customizing reports. Most report options are user-configurable through a report options dialog but some are used as a way of passing enumeration values between the scheme modules that generate the report.

The options system is centered on an options database or optiondb. A separate optionsdb is created and instantiated for every use, so the book gets one at the beginning of the session with its values loaded from KVP, and every report gets one when the report is run, as do report stylesheets when they are edited. Customized report and stylesheet options are saved as Scheme code fragments in files in the user's GnuCash Config directory.

Note

Persistence via text scheme code is a security vulnerability as it enables an attacker to make GnuCash execute arbitrary code. The Guile interpreter affords full system access with at least the user's privileges.

Typedef Documentation

GncCallbackVec

using GncCallbackVec = std::vector<GncOptionDBCallback>

Definition at line 101 of file gnc-optiondb-impl.hpp.

GncItem

using GncItem = std::pair<QofIdTypeConst, GncGUID>

class GncOptionQofinstanceValue

QofInstances know what type they are but getting them to tell you is a pain so we put them in a pair with a type identifier.

Definition at line 172 of file gnc-option-impl.hpp.

GncMultichoiceOptionChoices [1/2]

using GncMultichoiceOptionChoices = std::vector<GncMultichoiceOptionEntry>

Definition at line 511 of file gnc-option-impl.hpp.

GncMultichoiceOptionChoices [2/2]

using GncMultichoiceOptionChoices = std::vector<GncMultichoiceOptionEntry>

Definition at line 61 of file gnc-optiondb.hpp.

GncMultichoiceOptionEntry [1/2]

using GncMultichoiceOptionEntry = std::tuple<const std::string, const std::string, GncOptionMultichoiceKeyType>

Definition at line 507 of file gnc-option-impl.hpp.

GncMultichoiceOptionEntry [2/2]

using GncMultichoiceOptionEntry = std::tuple<const std::string, const std::string, GncOptionMultichoiceKeyType>

Definition at line 58 of file gnc-optiondb.hpp.

GncMultichoiceOptionIndexVec

using GncMultichoiceOptionIndexVec = std::vector<uint16_t>

Definition at line 510 of file gnc-option-impl.hpp.

GncOptionAccountList [1/2]

using GncOptionAccountList = std::vector<GncGUID>

Definition at line 793 of file gnc-option-impl.hpp.

GncOptionAccountList [2/2]

using GncOptionAccountList = std::vector<GncGUID>

Definition at line 55 of file gnc-optiondb.hpp.

GncOptionAccountTypeList [1/2]

using GncOptionAccountTypeList = std::vector<GNCAccountType>

Definition at line 795 of file gnc-option-impl.hpp.

GncOptionAccountTypeList [2/2]

using GncOptionAccountTypeList = std::vector<GNCAccountType>

Definition at line 57 of file gnc-optiondb.hpp.

GncOptionDateFormat

using GncOptionDateFormat = std::tuple<QofDateFormat, GNCDateMonthFormat, bool, std::string>

Definition at line 70 of file gnc-option.hpp.

GncOptionDBChangeCallback

using GncOptionDBChangeCallback = void (*)(void* user_data)

Definition at line 83 of file gnc-optiondb-impl.hpp.

GncOptionDBPtr

using GncOptionDBPtr = std::unique_ptr<GncOptionDB>

Definition at line 54 of file gnc-optiondb.hpp.

GncOptionReportPlacement

using GncOptionReportPlacement = std::tuple<uint32_t, uint32_t, uint32_t>

Definition at line 71 of file gnc-option.hpp.

GncOptionReportPlacementVec

using GncOptionReportPlacementVec = std::vector<GncOptionReportPlacement>

Definition at line 72 of file gnc-option.hpp.

GncOptionSectionPtr

using GncOptionSectionPtr = std::shared_ptr<GncOptionSection>

Definition at line 75 of file gnc-optiondb-impl.hpp.

GncOptionUIItemPtr

using GncOptionUIItemPtr = std::unique_ptr<GncOptionUIItem>

Definition at line 52 of file gnc-option.hpp.

GncOptionVariant

using GncOptionVariant = std::variant<GncOptionValue<std::string>, GncOptionValue<bool>, GncOptionValue<int64_t>, GncOptionQofInstanceValue, GncOptionGncOwnerValue, GncOptionValue<const QofQuery*>, GncOptionValue<GncOptionReportPlacementVec>, GncOptionAccountListValue, GncOptionAccountSelValue, GncOptionMultichoiceValue, GncOptionRangeValue<int>, GncOptionRangeValue<double>, GncOptionCommodityValue, GncOptionDateValue, GncOptionValue<GncOptionDateFormat> >

Definition at line 105 of file gnc-option.hpp.

GncOptionVariantPtr

using GncOptionVariantPtr = std::unique_ptr<GncOptionVariant>

Definition at line 121 of file gnc-option.hpp.

GncOptionVec

using GncOptionVec = std::vector<GncOption>

Definition at line 52 of file gnc-optiondb-impl.hpp.

GncOwner

using GncOwner = _gncOwner

Definition at line 55 of file gnc-option.hpp.

GncOwnerPtr

using GncOwnerPtr = std::unique_ptr<GncOwner, GncOwnerDeleter>

Definition at line 135 of file gnc-option-impl.hpp.

QofInstance

using QofInstance = QofInstance_s

Definition at line 60 of file gnc-option.hpp.

QofQuery

using QofQuery = _QofQuery

Definition at line 57 of file gnc-option.hpp.

RelativeDatePeriodVec

using RelativeDatePeriodVec = std::vector<RelativeDatePeriod>

Definition at line 83 of file gnc-option-date.hpp.

Enumeration Type Documentation

GncOptionMultichoiceKeyType

enum class GncOptionMultichoiceKeyType

strong

Definition at line 123 of file gnc-option.hpp.

{
    SYMBOL,
    STRING,
    NUMBER,
};

GncOptionUIType

enum class GncOptionUIType : unsigned int

strong

Used by GncOptionClassifier to indicate to dialog-options what control should be displayed for the option.

Definition at line 39 of file gnc-option-uitype.hpp.

{
    INTERNAL,
    BOOLEAN,
    STRING,
    TEXT,
    CURRENCY,
    COMMODITY,
    MULTICHOICE,
    DATE_ABSOLUTE,
    DATE_RELATIVE,
    DATE_BOTH,
    ACCOUNT_LIST,
    ACCOUNT_SEL,
    LIST,
    NUMBER_RANGE,
    COLOR,
    FONT,
    PLOT_SIZE,
    BUDGET,
    PIXMAP,
    RADIOBUTTON,
    DATE_FORMAT,
    OWNER,
    CUSTOMER,
    VENDOR,
    EMPLOYEE,
    INVOICE,
    JOB,
    TAX_TABLE,
    INV_REPORT,
    QUERY,
    REPORT_PLACEMENT,
    MAX_VALUE,  //Nake sure this one is always last
};

RelativeDatePeriod

enum class RelativeDatePeriod : int

strong

Reporting periods relative to the current date.

The original design allowed custom RelativeDatePeriods, but that facility is unused so we'll go with compiled-in enums.

Definition at line 44 of file gnc-option-date.hpp.

{
    ABSOLUTE = -1,
    TODAY,
    ONE_WEEK_AGO,
    ONE_WEEK_AHEAD,
    ONE_MONTH_AGO,
    ONE_MONTH_AHEAD,
    THREE_MONTHS_AGO,
    THREE_MONTHS_AHEAD,
    SIX_MONTHS_AGO,
    SIX_MONTHS_AHEAD,
    ONE_YEAR_AGO,
    ONE_YEAR_AHEAD,
    START_THIS_MONTH,
    END_THIS_MONTH,
    START_PREV_MONTH,
    END_PREV_MONTH,
    START_NEXT_MONTH,
    END_NEXT_MONTH,
    START_CURRENT_QUARTER,
    END_CURRENT_QUARTER,
    START_PREV_QUARTER,
    END_PREV_QUARTER,
    START_NEXT_QUARTER,
    END_NEXT_QUARTER,
    START_CAL_YEAR,
    END_CAL_YEAR,
    START_PREV_YEAR,
    END_PREV_YEAR,
    START_NEXT_YEAR,
    END_NEXT_YEAR,
    START_ACCOUNTING_PERIOD,
    END_ACCOUNTING_PERIOD,
};

RelativeDateUI

enum RelativeDateUI : uint8_t

Definition at line 825 of file gnc-optiondb.hpp.

{
    ABSOLUTE,
    RELATIVE,
    BOTH
};

Function Documentation

gnc_account_list_from_types()

GncOptionAccountList gnc_account_list_from_types	(	QofBook *	book,
		const GncOptionAccountTypeList &	types
	)

Extract a list of accounts in the book having one of the GNCAccountTypes in types.

Note that in Scheme it's important to use this function and not to create a list of accounts using gnc-get-descendants-sorted because the latter method produces a SWIGTYPE for the accounts that's incompatible with the SWIGTYPE used in this module.

Parameters

book	The book whose accounts to search
types	A std::vector of GNCAccountType containing the Account types to include in ther result

Returns

A std::vector<const Account*> of all accounts in the book having the Account types in the types parameter.

Definition at line 780 of file gnc-optiondb.cpp.

{
    GncOptionAccountList list;
    AccountPair funcdata{list, types};
    Account* base_acct = gnc_book_get_root_account(book);
    gnc_account_foreach_descendant(base_acct, (AccountCb)find_children,
                                   &funcdata);
    return list;
}

gnc_make_option()

template<typename ValueType >

GncOption * gnc_make_option	(	const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		ValueType	value,
		GncOptionUIType	ui_type
	)

Free function wrapping GncOption's constructor.

The type of GncOptionValue to create is determined from the UI type. Some GncOptionValue types require more parameters for their constructors and can't be created with this function.

Definition at line 264 of file gnc-option.hpp.

{
    return new GncOption(section, name, key, doc_string, value, ui_type);
}

gnc_option_db_book_options()

void gnc_option_db_book_options

(

GncOptionDB *

odb

)

Register the standard option set for a QofBook.

Parameters

odb	The GncOptionDB

Definition at line 1199 of file gnc-optiondb.cpp.

{
    constexpr const char* business_section{N_("Business")};
    constexpr const char* counter_section{N_("Counters")};
    static const std::string empty_string{""};
 
//Accounts Tab
 
    gnc_register_number_range_option<double>(odb, OPTION_SECTION_ACCOUNTS,
                                     OPTION_NAME_AUTO_READONLY_DAYS, "a",
                                     N_("Choose the number of days after which transactions will be read-only and cannot be edited anymore. This threshold is marked by a red line in the account register windows. If zero, all transactions can be edited and none are read-only."),
                                     0.0, 0.0, 3650.0, 1.0);
 
    gnc_register_simple_boolean_option(odb, OPTION_SECTION_ACCOUNTS,
                                       OPTION_NAME_NUM_FIELD_SOURCE, "b",
                                       N_("Check to have split action field used in registers for 'Num' field in place of transaction number; transaction number shown as 'T-Num' on second line of register. Has corresponding effect on business features, reporting and imports/exports."),
                                       false);
    gnc_register_simple_boolean_option(odb, OPTION_SECTION_ACCOUNTS,
                                       OPTION_NAME_TRADING_ACCOUNTS, "a",
                                       N_("Check to have trading accounts used for transactions involving more than one currency or commodity."),
                                       false);
 
//Budgeting Tab
 
    gnc_register_budget_option(odb, OPTION_SECTION_BUDGETING,
                               OPTION_NAME_DEFAULT_BUDGET, "a",
                               N_("Budget to be used when none has been otherwise specified."),
                               nullptr);
 
//Counters Tab
 
    gnc_register_counter_option(odb, counter_section,
                                N_("Customer number"), "gncCustomera",
                                N_("The previous customer number generated. This number will be incremented to generate the next customer number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Customer number format"),
                                       "gncCustomerb",
                                       N_("The format string to use for generating customer numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Employee number"), "gncEmployeea",
                                N_("The previous employee number generated. This number will be incremented to generate the next employee number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Employee number format"),
                                       "gncEmployeeb",
                                       N_("The format string to use for generating employee numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Invoice number"), "gncInvoicea",
                                N_("The previous invoice number generated. This number will be incremented to generate the next invoice number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Invoice number format"),
                                       "gncInvoiceb",
                                       N_("The format string to use for generating invoice numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Bill number"), "gncBilla",
                                N_("The previous bill number generated. This number will be incremented to generate the next bill number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Bill number format"), "gncBillb",
                                       N_("The format string to use for generating bill numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Expense voucher number"), "gncExpVouchera",
                                N_("The previous expense voucher number generated. This number will be incremented to generate the next voucher number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Expense voucher number format"),
                                       "gncExpVoucherb",
                                       N_("The format string to use for generating expense voucher numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Job number"), "gncJoba",
                                N_("The previous job number generated. This number will be incremented to generate the next job number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Job number format"), "gncJobb",
                                       N_("The format string to use for generating job numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Order number"), "gncOrdera",
                                N_("The previous order number generated. This number will be incremented to generate the next order number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Order number format"), "gncOrderb",
                                       N_("The format string to use for generating order numbers. This is a printf-style format string."),
                                       empty_string);
    gnc_register_counter_option(odb, counter_section,
                                N_("Vendor number"), "gncVendora",
                                N_("The previous vendor number generated. This number will be incremented to generate the next vendor number."),
                                0);
    gnc_register_counter_format_option(odb, counter_section,
                                       N_("Vendor number format"), "gncVendorb",
                                       N_("The format string to use for generating vendor numbers. This is a printf-style format string."),
                                       empty_string);
 
//Business Tab
 
    gnc_register_string_option(odb, business_section, N_("Company Name"), "a",
                               N_("The name of your business."),
                               empty_string);
    gnc_register_text_option(odb, business_section, N_("Company Address"), "b1",
                             N_("The address of your business."),
                             empty_string);
    gnc_register_string_option(odb, business_section,
                               N_("Company Contact Person"), "b2",
                               N_("The contact person to print on invoices."),
                               empty_string);
    gnc_register_string_option(odb, business_section,
                               N_("Company Phone Number"), "c1",
                               N_("The contact person to print on invoices."),
                               empty_string);
    gnc_register_string_option(odb, business_section,
                               N_("Company Fax Number"), "c2",
                               N_("The fax number of your business."),
                               empty_string);
    gnc_register_string_option(odb, business_section,
                               N_("Company Email Address"), "c3",
                               N_ ("The email address of your business."),
                               empty_string);
    gnc_register_string_option(odb, business_section,
                               N_("Company Website URL"), "c4",
                               N_("The URL address of your website."),
                               empty_string);
    gnc_register_string_option(odb, business_section, N_("Company ID"), "c5",
                               N_("The ID for your company (eg 'Tax-ID: 00-000000)."),
                               empty_string);
    gnc_register_invoice_print_report_option(odb, business_section,
                                 OPTION_NAME_DEFAULT_INVOICE_REPORT, "e1",
                                 N_("The invoice report to be used for printing."),
                                 empty_string);
    gnc_register_number_range_option<double>(odb, business_section,
                                     OPTION_NAME_DEFAULT_INVOICE_REPORT_TIMEOUT, "e2",
                                     N_("Length of time to change the used invoice report. A value of 0 means disabled."),
                                     0.0, 0.0, 20.0, 1.0);
    gnc_register_taxtable_option(odb, business_section,
                                 N_("Default Customer Tax Table"), "f1",
                                 N_("The default tax table to apply to customers."),
                                 nullptr);
    gnc_register_taxtable_option(odb, business_section,
                                 N_("Default Vendor Tax Table"), "f2",
                                 N_("The default tax table to apply to vendors."),
                                 nullptr);
 
    gnc_register_dateformat_option(odb, business_section,
                                   N_("Fancy Date Format"), "g",
                                   N_("The default date format used for fancy printed dates."),
                                   {QOF_DATE_FORMAT_UNSET, GNCDATE_MONTH_NUMBER, true, ""});
 
//Tax Tab
 
    gnc_register_string_option(odb, N_("Tax"), N_("Tax Number"), "a",
                               N_("The electronic tax number of your business"),
                               empty_string);
}

gnc_option_db_clean()

void gnc_option_db_clean

(

GncOptionDB *

odb

)

Reset all ui_items to the option value.

Parameters

odb	The GncOptionDB.

Definition at line 1175 of file gnc-optiondb.cpp.

{
        odb->foreach_section(
        [](GncOptionSectionPtr& section){
            section->foreach_option(
                [](GncOption& option) {
                    option.set_ui_item_from_option();
                });
        });
}

gnc_option_db_commit()

GList * gnc_option_db_commit

(

GncOptionDB *

odb

)

Write all changed ui_item values to their options.

Parameters

odb	The GncOptionDB.

Returns

A GList* conatining the names of options that raised exceptions when attempting to set their values. The names are const, free only the list.

Definition at line 1149 of file gnc-optiondb.cpp.

{
    GList* errors{};
    odb->foreach_section(
        [&errors](GncOptionSectionPtr& section){
            section->foreach_option(
                [&errors](GncOption& option) {
                    try
                    {
                        option.set_option_from_ui_item();
                    }
                    catch (const std::invalid_argument& err)
                    {
                        PWARN("Option %s:%s failed to set its value %s",
                              option.get_section().c_str(),
                              option.get_name().c_str(), err.what());
                        errors = g_list_prepend(errors,
                                                (void*)option.get_name().c_str());
                    } });
        });
    if (!errors)
        odb->run_callbacks();
    return errors;
}

gnc_option_db_destroy()

void gnc_option_db_destroy

(

GncOptionDB *

odb

)

Destruct and release a GncOptionDB.

Parameters

odb	The GncOptionDB.

Definition at line 1143 of file gnc-optiondb.cpp.

{
    PWARN("Direct Destroy called on GncOptionDB %" G_GUINT64_FORMAT, (uint64_t)odb);
}

gnc_option_db_load()

void gnc_option_db_load	(	GncOptionDB *	odb,
		QofBook *	book
	)

Load a book's options into the GncOptionDB.

Parameters

odb	The GncOptionDB
book	The book in which the options are saved.

Definition at line 1186 of file gnc-optiondb.cpp.

{
    odb->load_from_kvp(book);
}

gnc_option_db_lookup_qofinstance_value()

const QofInstance * gnc_option_db_lookup_qofinstance_value	(	GncOptionDB *	odb,
		const char *	section,
		const char *	name
	)

Retrieve the QofInstance value of an option in the GncOptionDB.

Parameters

odb	the GncOptionDB
section	the section in which the option is stored
name	the option name

Returns

the const QofInstance* of the value or nullptr if the option isn't found or if its value isn't a QofInstance*.

Definition at line 1359 of file gnc-optiondb.cpp.

{
    auto option{odb->find_option(section, name)};
    if (option)
        return option->get_value<const QofInstance*>();
    else
        return nullptr;
}

gnc_option_db_new()

GncOptionDB * gnc_option_db_new

(

void

)

Create an empty option database.

Returns

A newly allocated GncOptionDB. Use delete to destroy it.

Definition at line 1137 of file gnc-optiondb.cpp.

{
    return new GncOptionDB;
}

gnc_option_db_save()

void gnc_option_db_save	(	GncOptionDB *	odb,
		QofBook *	book,
		gboolean	clear_options
	)

Save the GncOptionDB contents into a book's options store.

Parameters

odb	The GncOptionDB
book	The book in which the options are saved.
clear_options	TRUE if the books existing options should be removed first.

Definition at line 1192 of file gnc-optiondb.cpp.

{
    odb->save_to_kvp(book, static_cast<bool>(clear_options));
}

gnc_register_account_list_limited_option() [1/2]

void gnc_register_account_list_limited_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const GncOptionAccountList &	value,
		GncOptionAccountTypeList &&	allowed
	)

Create a new limited account list option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default values for the option.
allowed	The accounts which are available for selection.

Definition at line 746 of file gnc-optiondb.cpp.

{
    try
    {
        GncOption option{GncOptionAccountListValue{section, name, key, doc_string,
                    GncOptionUIType::ACCOUNT_LIST, value, std::move(allowed)}};
        db->register_option(section, std::move(option));
    }
    catch (const std::invalid_argument& err)
    {
        PWARN("Account List Limited Option, value failed validation, option not registered.");
    }
}

gnc_register_account_list_limited_option() [2/2]

void gnc_register_account_list_limited_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const GncOptionAccountList &  value, GncOptionAccountTypeList &&  allowed  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 308 of file gnc-optiondb.hpp.

{
    gnc_register_account_list_limited_option(db.get(), section, name, key,
                                             doc_string, value,
                                             std::move(allowed));
}

gnc_register_account_list_option() [1/2]

void gnc_register_account_list_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const GncOptionAccountList &	value
	)

Create a new account list option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default values for the option.

Definition at line 735 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionAccountListValue{section, name, key, doc_string,
                GncOptionUIType::ACCOUNT_LIST, value}};
    db->register_option(section, std::move(option));
}

gnc_register_account_list_option() [2/2]

void gnc_register_account_list_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const GncOptionAccountList &  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 339 of file gnc-optiondb.hpp.

{
    gnc_register_account_list_option(db.get(), section, name, key,
                                     doc_string, value);
}

gnc_register_account_sel_limited_option() [1/2]

void gnc_register_account_sel_limited_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const Account *	value,
		GncOptionAccountTypeList &&	allowed
	)

Create a limited account selection option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.
allowed	The accounts which are available for selection.

Definition at line 793 of file gnc-optiondb.cpp.

{
    try
    {
        GncOption option{GncOptionAccountSelValue{section, name, key, doc_string,
                    GncOptionUIType::ACCOUNT_SEL, value, std::move(allowed)}};
    db->register_option(section, std::move(option));
    }
    catch (const std::invalid_argument& err)
    {
        PWARN("Account Sel Limited Option, value failed validation, option not registerd.");
    }
}

gnc_register_account_sel_limited_option() [2/2]

void gnc_register_account_sel_limited_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const Account *  value, GncOptionAccountTypeList &&  allowed  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 370 of file gnc-optiondb.hpp.

{
    gnc_register_account_sel_limited_option(db.get(), section, name, key,
                                            doc_string, value,
                                            std::move(allowed));
}

gnc_register_budget_option() [1/2]

void gnc_register_budget_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, GncBudget *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 175 of file gnc-optiondb.hpp.

{
    gnc_register_budget_option(db.get(), section, name, key, doc_string, value);
}

gnc_register_budget_option() [2/2]

void gnc_register_budget_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		GncBudget *	value
	)

Create a new budget option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 657 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionQofInstanceValue{section, name, key, doc_string,
                                               (const QofInstance*)value,
                                               GncOptionUIType::BUDGET}};
    db->register_option(section, std::move(option));
}

gnc_register_color_option() [1/2]

void gnc_register_color_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new color option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 668 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::COLOR};
    db->register_option(section, std::move(option));
}

gnc_register_color_option() [2/2]

void gnc_register_color_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 597 of file gnc-optiondb.hpp.

{
    gnc_register_color_option(db.get(), section, name, key, doc_string, value);
}

gnc_register_commodity_option() [1/4]

void gnc_register_commodity_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const char *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 223 of file gnc-optiondb.hpp.

{
    gnc_register_commodity_option(db.get(), section, name, key,
                                  doc_string, value);
}

gnc_register_commodity_option() [2/4]

void gnc_register_commodity_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, gnc_commodity *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 201 of file gnc-optiondb.hpp.

{
    gnc_register_commodity_option(db.get(), section, name, key,
                                  doc_string, value);
}

gnc_register_commodity_option() [3/4]

void gnc_register_commodity_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const char *	value
	)

As above but with a const char* value, which should be the symbol for the commodity.

All security editor namespaces will be searched to retrieve it.

Definition at line 689 of file gnc-optiondb.cpp.

{
    gnc_commodity* commodity{};
    const auto book{qof_session_get_book(gnc_get_current_session())};
    const auto commodity_table{gnc_commodity_table_get_table(book)};
    const auto namespaces{gnc_commodity_table_get_namespaces(commodity_table)};
    for (auto node = namespaces; node && commodity == nullptr;
         node = g_list_next(node))
    {
        commodity = gnc_commodity_table_lookup(commodity_table,
                                               (const char*)(node->data),
                                               value);
        if (commodity)
            break;
    }
    GncOption option{GncOptionCommodityValue{section, name, key, doc_string,
                commodity,
                GncOptionUIType::COMMODITY}};
    db->register_option(section, std::move(option));
    g_list_free (namespaces);
}

gnc_register_commodity_option() [4/4]

void gnc_register_commodity_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		gnc_commodity *	value
	)

Create a new commodity option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 678 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionCommodityValue{section, name, key, doc_string,
                                               value,
                                               GncOptionUIType::COMMODITY}};
    db->register_option(section, std::move(option));
}

gnc_register_counter_format_option() [1/2]

void gnc_register_counter_format_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new counter format option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 958 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::STRING};
    db->register_option(section, std::move(option));
}

gnc_register_counter_format_option() [2/2]

void gnc_register_counter_format_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 786 of file gnc-optiondb.hpp.

{
    gnc_register_counter_format_option(db.get(), section, name, key,
                                       doc_string, value);
}

gnc_register_counter_option() [1/2]

void gnc_register_counter_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, double  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 759 of file gnc-optiondb.hpp.

{
    gnc_register_counter_option(db.get(), section, name, key,
                                  doc_string, value);
}

gnc_register_counter_option() [2/2]

void gnc_register_counter_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		int	value
	)

Create a new counter option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 947 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionRangeValue<int>{section, name, key, doc_string,
                value, 0, 999999999, 1}};
    option.set_alternate(true);
    db->register_option(section, std::move(option));
}

gnc_register_currency_option() [1/4]

void gnc_register_currency_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const char *  value  )

inline

Definition at line 653 of file gnc-optiondb.hpp.

{
    gnc_register_currency_option(db.get(), section, name, key,
                                 doc_string, value);
}

gnc_register_currency_option() [2/4]

void gnc_register_currency_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, gnc_commodity *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 633 of file gnc-optiondb.hpp.

{
    gnc_register_currency_option(db.get(), section, name, key,
                                 doc_string, value);
}

gnc_register_currency_option() [3/4]

void gnc_register_currency_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const char *	value
	)

As above but with a const char* value, which must be the ISO4217 three-letter symbol for the currency.

Definition at line 990 of file gnc-optiondb.cpp.

{
    const auto book{qof_session_get_book(gnc_get_current_session())};
    const auto commodity_table{gnc_commodity_table_get_table(book)};
    const auto commodity = gnc_commodity_table_lookup(commodity_table,
                                                      "CURRENCY",
                                                      value);
    GncOption option{GncOptionCommodityValue{
        section, name, key, doc_string, commodity, GncOptionUIType::CURRENCY
        }};
    db->register_option(section, std::move(option));
}

gnc_register_currency_option() [4/4]

void gnc_register_currency_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		gnc_commodity *	value
	)

Create a new currency option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option. It is checked with gnc_commodity_is_currency.

Definition at line 979 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionCommodityValue{
        section, name, key, doc_string, value, GncOptionUIType::CURRENCY
        }};
    db->register_option(section, std::move(option));
}

gnc_register_date_option() [1/6]

void gnc_register_date_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		RelativeDatePeriod	period = RelativeDatePeriod::TODAY,
		RelativeDateUI	ui = RelativeDateUI::BOTH
	)

Create a new date option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
period	The default/starting relative date value for the option.
ui	What UI to display, relative, absolute, or both.

Definition at line 1020 of file gnc-optiondb.cpp.

{
    auto ui_type = ui == RelativeDateUI::BOTH ? GncOptionUIType::DATE_BOTH :
        ui == RelativeDateUI::RELATIVE ? GncOptionUIType::DATE_RELATIVE :
        GncOptionUIType::DATE_ABSOLUTE;
    GncOption option{GncOptionDateValue(section, name, key, doc_string,
                                        ui_type, period)};
    db->register_option(section, std::move(option));
}

gnc_register_date_option() [2/6]

void gnc_register_date_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		RelativeDatePeriodVec &	period_set,
		bool	both = true
	)

Create a new date option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
period_set	A vector of relative date periods to display in the relative control.
both	Whether to display both a relative and absolute control or a onla a relative control.

Definition at line 1034 of file gnc-optiondb.cpp.

{
    auto is_absolute = period_set.size() == 1 &&
                       period_set.front() == RelativeDatePeriod::ABSOLUTE;
    auto ui_type = both ? GncOptionUIType::DATE_BOTH :
        is_absolute ? GncOptionUIType::DATE_ABSOLUTE : GncOptionUIType::DATE_RELATIVE;
    GncOption option{GncOptionDateValue(section, name, key, doc_string,
                                        ui_type, period_set)};
    if (is_absolute)
        option.set_default_value(gnc_time(nullptr));
    db->register_option(section, std::move(option));
}

gnc_register_date_option() [3/6]

void gnc_register_date_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		time64	time,
		RelativeDateUI	ui = RelativeDateUI::BOTH
	)

Create a new date option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
time	The initial time to set in the option.
ui	What UI to display, relative, absolute, or both.

Definition at line 1006 of file gnc-optiondb.cpp.

{
    auto ui_type = ui == RelativeDateUI::BOTH ? GncOptionUIType::DATE_BOTH :
        ui == RelativeDateUI::RELATIVE ? GncOptionUIType::DATE_RELATIVE :
        GncOptionUIType::DATE_ABSOLUTE;
    GncOption option{GncOptionDateValue(section, name, key, doc_string,
                                        ui_type, time)};
    db->register_option(section, std::move(option));
}

gnc_register_date_option() [4/6]

void gnc_register_date_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, RelativeDatePeriod  period = RelativeDatePeriod::TODAY, RelativeDateUI  ui = RelativeDateUI::BOTH  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 853 of file gnc-optiondb.hpp.

{
    gnc_register_date_option(db.get(), section, name, key, doc_string,
                             period, ui);
}

gnc_register_date_option() [5/6]

void gnc_register_date_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, RelativeDatePeriodVec &  period_set, bool  both = true  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 912 of file gnc-optiondb.hpp.

{
    gnc_register_date_option(db.get(), section, name, key, doc_string,
                             period_set, both);
}

gnc_register_date_option() [6/6]

void gnc_register_date_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, time64  time, RelativeDateUI  ui = RelativeDateUI::BOTH  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 883 of file gnc-optiondb.hpp.

{
    gnc_register_date_option(db.get(), section, name, key, doc_string,
                             time, ui);
}

gnc_register_dateformat_option() [1/2]

void gnc_register_dateformat_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		GncOptionDateFormat &&	value
	)

Create a new date format option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 969 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, std::move(value),
            GncOptionUIType::DATE_FORMAT};
    db->register_option(section, std::move(option));
}

gnc_register_dateformat_option() [2/2]

void gnc_register_dateformat_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, GncOptionDateFormat &&  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 815 of file gnc-optiondb.hpp.

{
    gnc_register_dateformat_option(db.get(), section, name, key,
                                   doc_string, std::move(value));
}

gnc_register_end_date_option() [1/2]

void gnc_register_end_date_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		bool	both = true
	)

Create a new end-date option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
both	Whether to display both a relative and absolute control or a onla a relative control.

Definition at line 1089 of file gnc-optiondb.cpp.

{
    auto ui_type = both ? GncOptionUIType::DATE_BOTH :
        GncOptionUIType::DATE_RELATIVE;
    GncOption option{GncOptionDateValue(section, name, key, doc_string,
                                        ui_type, end_dates)};
    db->register_option(section, std::move(option));
}

gnc_register_end_date_option() [2/2]

void gnc_register_end_date_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, bool  both = true  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 966 of file gnc-optiondb.hpp.

{
    gnc_register_end_date_option(db.get(), section, name, key, doc_string,
                                 both);
}

gnc_register_font_option() [1/2]

void gnc_register_font_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 150 of file gnc-optiondb.hpp.

{
    gnc_register_font_option(db.get(), section, name, key, doc_string, value);
}

gnc_register_font_option() [2/2]

void gnc_register_font_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new font option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 647 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::FONT};
    db->register_option(section, std::move(option));
}

gnc_register_internal_option() [1/2]

void gnc_register_internal_option	(	GncOptionDBPtr &	db,
		const char *	section,
		const char *	name,
		bool	value
	)

Definition at line 1126 of file gnc-optiondb.cpp.

{
    GncOption option{
        GncOptionValue<bool>{section, name, "", "", value,
                             GncOptionUIType::INTERNAL}};
    db->register_option(section, std::move(option));
}

gnc_register_internal_option() [2/2]

void gnc_register_internal_option	(	GncOptionDBPtr &	db,
		const char *	section,
		const char *	name,
		const std::string &	value
	)

Definition at line 1115 of file gnc-optiondb.cpp.

{
    GncOption option{
        GncOptionValue<std::string>{section, name, "", "", value,
                                    GncOptionUIType::INTERNAL}};
    db->register_option(section, std::move(option));
}

gnc_register_invoice_option() [1/2]

void gnc_register_invoice_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, GncInvoice *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 680 of file gnc-optiondb.hpp.

{
    gnc_register_invoice_option(db.get(), section, name, key,
                                doc_string, value);
}

gnc_register_invoice_option() [2/2]

void gnc_register_invoice_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		GncInvoice *	value
	)

Create a new invoice option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 915 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionQofInstanceValue{section, name, key, doc_string,
                                               (const QofInstance*)value,
                                               GncOptionUIType::INVOICE}};
    db->register_option(section, std::move(option));
}

gnc_register_invoice_print_report_option() [1/2]

void gnc_register_invoice_print_report_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 733 of file gnc-optiondb.hpp.

{
    gnc_register_invoice_print_report_option(db.get(), section, name, key,
                                             doc_string, value);
}

gnc_register_invoice_print_report_option() [2/2]

void gnc_register_invoice_print_report_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new print report option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 937 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string,
                     value, GncOptionUIType::INV_REPORT};
    db->register_option(section, std::move(option));
}

gnc_register_list_option() [1/2]

void gnc_register_list_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const char *	value,
		GncMultichoiceOptionChoices &&	list
	)

Create a new list option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.
list	The values available for selection. Note that this parameter will be moved from so using it after this call will result in undefined behavior.

Definition at line 831 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionMultichoiceValue{section, name, key, doc_string,
                value,  std::move(list), GncOptionUIType::LIST}};
    db->register_option(section, std::move(option));
}

gnc_register_list_option() [2/2]

void gnc_register_list_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const char *  value, GncMultichoiceOptionChoices &&  list  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 431 of file gnc-optiondb.hpp.

{
    gnc_register_list_option(db.get(), section, name, key, doc_string,
                             value, std::move(list));
}

gnc_register_multichoice_option() [1/2]

void gnc_register_multichoice_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const char *	default_val,
		GncMultichoiceOptionChoices &&	value
	)

Create a new multichoice option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The set of possible values for the option. Only one can be selected. Note that the value will be moved from the parameter and using the parameter after this call will result in undefined behavior.

Definition at line 812 of file gnc-optiondb.cpp.

{
    std::string defval{default_val};
    auto found{std::find_if(choices.begin(), choices.end(),
                            [&defval](auto& choice)->bool {
                                return defval == std::get<0>(choice);
                            })};
    if (found == choices.end())
        defval = (choices.empty() ? std::string{"None"} :
                  std::get<0>(choices.at(0)));
    GncOption option{GncOptionMultichoiceValue{section, name, key, doc_string,
                defval.c_str(), std::move(choices)}};
    db->register_option(section, std::move(option));
}

gnc_register_multichoice_option() [2/2]

void gnc_register_multichoice_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const char *  default_val, GncMultichoiceOptionChoices &&  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 401 of file gnc-optiondb.hpp.

{
    gnc_register_multichoice_option(db.get(), section, name,
                                    key, doc_string, default_val,
                                    std::move(value));
}

gnc_register_number_plot_size_option() [1/4]

void gnc_register_number_plot_size_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, float  value  )

inline

Definition at line 518 of file gnc-optiondb.hpp.

{
    gnc_register_number_plot_size_option(db.get(), section, name, key,
                                         doc_string, static_cast<int>(value));
}

gnc_register_number_plot_size_option() [2/4]

void gnc_register_number_plot_size_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, int  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 507 of file gnc-optiondb.hpp.

{
    gnc_register_number_plot_size_option(db.get(), section, name, key,
                                         doc_string, value);
}

gnc_register_number_plot_size_option() [3/4]

void gnc_register_number_plot_size_option ( GncOptionDB *  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, float  value  )

inline

Definition at line 493 of file gnc-optiondb.hpp.

{
    gnc_register_number_plot_size_option(db, section, name, key,
                                         doc_string, static_cast<int>(value));
}

gnc_register_number_plot_size_option() [4/4]

void gnc_register_number_plot_size_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		int	value
	)

Create a new plot-size option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 865 of file gnc-optiondb.cpp.

{
//65K is 10x reasonable, but it's a convenient constant.
    GncOption option{GncOptionRangeValue<int>{section, name, key, doc_string,
            value, 10, UINT16_MAX, 1, GncOptionUIType::PLOT_SIZE}};
    db->register_option(section, std::move(option));
}

gnc_register_number_range_option() [1/2]

template<typename ValueType >

void gnc_register_number_range_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		ValueType	value,
		ValueType	min,
		ValueType	max,
		ValueType	step
	)

Create a new number range option and register it in the options database.

These are normally associated with spin controls and ValueType is normally double, but it's templated to permit other numeric types if needed.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.
min	The minimum value for the spin control.
max	The maximum value for the spin control.
step	The step size (increment) of the spin control.

Definition at line 845 of file gnc-optiondb.cpp.

{
    try
    {
        GncOption option{GncOptionRangeValue<ValueType>{section, name, key,
                                                        doc_string, value, min,
                                                        max, step}};
        db->register_option(section, std::move(option));
    }
    catch(const std::invalid_argument& err)
    {
        PWARN("Number Range Option %s, option not registerd.",
              err.what());
    }
}

gnc_register_number_range_option() [2/2]

template<typename ValueType >

void gnc_register_number_range_option	(	GncOptionDBPtr &	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		ValueType	value,
		ValueType	min,
		ValueType	max,
		ValueType	step
	)

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 466 of file gnc-optiondb.hpp.

{
    gnc_register_number_range_option<ValueType>(db.get(), section, name,
                                                key, doc_string, value,
                                                min, max, step);
}

gnc_register_owner_option() [1/2]

void gnc_register_owner_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		const GncOwner *	value,
		GncOwnerType	type
	)

Create a new GncOwner option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.
type	The type of owner, determines the UI type.

Definition at line 886 of file gnc-optiondb.cpp.

{
    GncOptionUIType uitype;
    switch (type)
    {
    case GNC_OWNER_CUSTOMER:
        uitype = GncOptionUIType::CUSTOMER;
        break;
    case GNC_OWNER_EMPLOYEE:
        uitype = GncOptionUIType::EMPLOYEE;
        break;
    case GNC_OWNER_JOB:
        uitype = GncOptionUIType::JOB;
        break;
    case GNC_OWNER_VENDOR:
        uitype = GncOptionUIType::VENDOR;
        break;
    default:
        uitype = GncOptionUIType::INTERNAL;
    };
    GncOption option{GncOptionGncOwnerValue{section, name, key, doc_string,
                                            value, uitype}};
    db->register_option(section, std::move(option));
}

gnc_register_owner_option() [2/2]

void gnc_register_owner_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, const GncOwner *  value, GncOwnerType  type  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 571 of file gnc-optiondb.hpp.

{
    gnc_register_owner_option(db.get(), section, name, key, doc_string, value, type);
}

gnc_register_pixmap_option() [1/2]

void gnc_register_pixmap_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new pixmap option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 725 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::PIXMAP};
    db->register_option(section, std::move(option));
}

gnc_register_pixmap_option() [2/2]

void gnc_register_pixmap_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 279 of file gnc-optiondb.hpp.

{
    gnc_register_pixmap_option(db.get(), section, name, key, doc_string, value);
}

gnc_register_query_option() [1/2]

void gnc_register_query_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const QofQuery *	value
	)

Create a new QofQuery option and register it in the options database.

Query options have no UI component so they don't get a key or a docstring.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
value	The initial and default value for the option.

Definition at line 877 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, "", "", value,
            GncOptionUIType::INTERNAL};
    db->register_option(section, std::move(option));
}

gnc_register_query_option() [2/2]

void gnc_register_query_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const QofQuery *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 545 of file gnc-optiondb.hpp.

{
    gnc_register_query_option(db.get(), section, name, value);
}

gnc_register_report_placement_option()

void gnc_register_report_placement_option	(	GncOptionDBPtr &	db,
		const char *	section,
		const char *	name
	)

Definition at line 1101 of file gnc-optiondb.cpp.

{
    /* This is a special option with it's own UI file so we have fake values to pass
     * to the template creation function.
     */
    GncOptionReportPlacementVec value;
    GncOption option{GncOptionValue<GncOptionReportPlacementVec>{section, name,
                                                              "no_key", "nodoc_string",
                                                              value,GncOptionUIType::REPORT_PLACEMENT}};
    db->register_option(section, std::move(option));
}

gnc_register_simple_boolean_option() [1/2]

void gnc_register_simple_boolean_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, bool  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 251 of file gnc-optiondb.hpp.

{
    gnc_register_simple_boolean_option(db.get(), section, name, key,
                                       doc_string, value);
}

gnc_register_simple_boolean_option() [2/2]

void gnc_register_simple_boolean_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		bool	value
	)

Create a new simple boolean option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 714 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::BOOLEAN};
    db->register_option(section, std::move(option));
}

gnc_register_start_date_option() [1/2]

void gnc_register_start_date_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		bool	both = true
	)

Create a new start-date option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
both	Whether to display both a relative and absolute control or a onla a relative control.

Definition at line 1065 of file gnc-optiondb.cpp.

{
    auto ui_type = both ? GncOptionUIType::DATE_BOTH :
        GncOptionUIType::DATE_RELATIVE;
    GncOption option{GncOptionDateValue(section, name, key, doc_string,
                                        ui_type, begin_dates)};
    db->register_option(section, std::move(option));
}

gnc_register_start_date_option() [2/2]

void gnc_register_start_date_option ( GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, bool  both = true  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 940 of file gnc-optiondb.hpp.

{
    gnc_register_start_date_option(db.get(), section, name, key, doc_string,
                                   both);
}

gnc_register_string_option() [1/2]

void gnc_register_string_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 99 of file gnc-optiondb.hpp.

{
    gnc_register_string_option(db.get(), section, name, key,
                               doc_string, value);
}

gnc_register_string_option() [2/2]

void gnc_register_string_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new string option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 626 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::STRING};
    db->register_option(section, std::move(option));
}

gnc_register_taxtable_option() [1/2]

void gnc_register_taxtable_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, GncTaxTable *  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 707 of file gnc-optiondb.hpp.

{
    gnc_register_taxtable_option(db.get(), section, name, key,
                                 doc_string, value);
}

gnc_register_taxtable_option() [2/2]

void gnc_register_taxtable_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		GncTaxTable *	value
	)

Create a new taxtable option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 926 of file gnc-optiondb.cpp.

{
    GncOption option{GncOptionQofInstanceValue{section, name, key, doc_string,
                                               (const QofInstance*)value,
                                               GncOptionUIType::TAX_TABLE}};
    db->register_option(section, std::move(option));
}

gnc_register_text_option() [1/2]

void gnc_register_text_option ( const GncOptionDBPtr &  db, const char *  section, const char *  name, const char *  key, const char *  doc_string, std::string  value  )

inline

As above but takes a const GncOptionDBPtr& (const std::unique_ptr<GncOptionDB>&) for calling from C++.

Definition at line 125 of file gnc-optiondb.hpp.

{
    gnc_register_text_option(db.get(), section, name, key, doc_string, value);
}

gnc_register_text_option() [2/2]

void gnc_register_text_option	(	GncOptionDB *	db,
		const char *	section,
		const char *	name,
		const char *	key,
		const char *	doc_string,
		std::string	value
	)

Create a new text option and register it in the options database.

Parameters

db	A GncOptionDB* for calling from C. Caller retains ownership.
section	The database section for the option.
name	The option name.
key	A short tag used to sort the controls in the dialog.
doc_string	A description of the option. This will be used in tooltips and should be marked for translation.
value	The initial and default value for the option.

Definition at line 636 of file gnc-optiondb.cpp.

{
    GncOption option{section, name, key, doc_string, value,
            GncOptionUIType::TEXT};
    db->register_option(section, std::move(option));
 
}

gnc_relative_date_description()

const char * gnc_relative_date_description

(

RelativeDatePeriod

per

)

Provide the description of a relative date.

This string is localizable.

Parameters

period

The relative date period.

Returns

A constant string or nullptr if the period is ABSOLUTE. The string's lifetime will be that of the Relative Date Period. It must not be freed and should be copied if the period might be destroyed before the using code is finished.

Definition at line 374 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return nullptr;
    return checked_reldate(per).m_description;
}

gnc_relative_date_display_string()

const char * gnc_relative_date_display_string

(

RelativeDatePeriod

per

)

Provide the string representation of a relative date for displaying value to a user.

This string is localizable.

Parameters

period

The relative date period.

Returns

A constant string or nullptr if the period is ABSOLUTE. The string's lifetime will be that of the Relative Date Period. It must not be freed and should be copied if the period might be destroyed before the using code is finished.

Definition at line 367 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return nullptr;
    return checked_reldate(per).m_display;
}

gnc_relative_date_from_storage_string()

RelativeDatePeriod gnc_relative_date_from_storage_string

(

const char *

str

)

Convert a relative date storage string back to a RelativeDatePeriod value.

Parameters

A	string representation obtained from gnc_relative_date_storage_string.

Returns

A RelativeDatePeriod value.

Definition at line 382 of file gnc-option-date.cpp.

{
    auto per = std::find_if(reldates.begin(), reldates.end(),
                         [str](auto rel) -> bool
                         {
                             return strcmp(str, rel.m_storage) == 0;
                         });
    return per != reldates.end() ? per->m_period : RelativeDatePeriod::ABSOLUTE;
}

gnc_relative_date_is_ending()

bool gnc_relative_date_is_ending

(

RelativeDatePeriod

per

)

Report whether the relative date represents the end of a date range.

For example END_LAST_MONTH is the end of a range.

Parameters

period

The Relative Date Period to check.

Returns

true if the date is the end of a date range.

Definition at line 351 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return false;
    return checked_reldate(per).m_type == RelativeDateType::END;
}

gnc_relative_date_is_single()

bool gnc_relative_date_is_single

(

RelativeDatePeriod

per

)

Report whether the relative date represents a period offset to today's date rather than the beginning or end of a date range.

For example ONE_MONTH_AGO will be made concrete as the same day as today in the previous month.

Parameters

period

The Relative Date Period to check.

Returns

true if the date is stand-alone.

Definition at line 333 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return false;
    auto reldate = checked_reldate(per);
    return reldate.m_type == RelativeDateType::LAST ||
        reldate.m_type == RelativeDateType::NEXT;
}

gnc_relative_date_is_starting()

bool gnc_relative_date_is_starting

(

RelativeDatePeriod

per

)

Report whether the relative date represents the beginning of a date range.

For example START_LAST_MONTH is the beginning of a range.

Parameters

period

The Relative Date Period to check.

Returns

true if the date is the beginning of a date range

Definition at line 343 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return false;
    return checked_reldate(per).m_type == RelativeDateType::START;
}

gnc_relative_date_storage_string()

const char * gnc_relative_date_storage_string

(

RelativeDatePeriod

per

)

Provide the string representation of a relative date for persisting the value.

This string is not localizable.

Parameters

period

The relative date period.

Returns

A constant string or nullptr if the period is ABSOLUTE. The string's lifetime will be that of the Relative Date Period. It must not be freed and should be copied if the period might be destroyed before the using code is finished.

Definition at line 359 of file gnc-option-date.cpp.

{
    if (per == RelativeDatePeriod::ABSOLUTE)
        return nullptr;
    return checked_reldate(per).m_storage;
}

gnc_relative_date_to_time64()

time64 gnc_relative_date_to_time64	(	RelativeDatePeriod	period,
		time64	now_t = static_cast< time64 >(GncDateTime())
	)

Convert a RelativeDatePeriod value to a concrete time64 by applying the value to the current time.

For example if it is now 3:15:42 PM local time 3 June, calling this with a period RelativeDatePeriod::ONE_WEEK_AHEAD will return a time64 representing 3:15:42 PM local time 10 June of this year. Times for START periods are changed to midnight local time and for END periods to 23:59:59 local time so for example if the period is instead RelativeDatePeriod::START_THIS_MONTH the time64 will represent 00:00:00 1 June and if it is RelativeDatePeriod::END_THIS_MONTH the time64 will be for 23:59:59 30 June, both in the current time zone.

Parameters

period	The relative date period to use to calculate the concrete date.
now_t	Optional "now" date. Primarily for testing.

Returns

a time64.

Definition at line 519 of file gnc-option-date.cpp.

{
    if (period == RelativeDatePeriod::TODAY)
        return now_t;
    if (period == RelativeDatePeriod::START_ACCOUNTING_PERIOD)
        return gnc_accounting_period_fiscal_start();
    if (period == RelativeDatePeriod::END_ACCOUNTING_PERIOD)
        return gnc_accounting_period_fiscal_end();
 
    auto now{static_cast<tm>(GncDateTime(now_t))};
    struct tm acct_per =
        static_cast<tm>(GncDateTime(gnc_accounting_period_fiscal_start()));
    auto offset = reldate_offset(period);
    bool is_offset_quarter =
        offset == RelativeDateOffset::QUARTER && acct_per.tm_mday > 1;
 
    switch(offset)
    {
        case RelativeDateOffset::NONE:
            // Report on today so nothing to do
            break;
        case RelativeDateOffset::YEAR:
            if (reldate_is_prev(period))
                --now.tm_year;
            else if (reldate_is_next(period))
                ++now.tm_year;
            if (gnc_relative_date_is_starting(period))
                now.tm_mon = 0;
            else if (gnc_relative_date_is_ending(period))
                now.tm_mon = 11;
            break;
        case RelativeDateOffset::SIX:
            if (reldate_is_prev(period))
                now.tm_mon -= 6;
            else if (reldate_is_next(period))
                now.tm_mon += 6;
            break;
        case RelativeDateOffset::QUARTER:
        {
            auto delta = (12 + now.tm_mon - acct_per.tm_mon) % 3;
            if (is_offset_quarter)
            {
                if (delta == 0 && !is_last_day_in_month(now) && 
                    (is_last_day_in_month(acct_per) ||
                     now.tm_mday < acct_per.tm_mday))
                    delta = 3;
                if (gnc_relative_date_is_ending(period))
                    --delta;
            }
            now.tm_mon -= delta;
        }
            [[fallthrough]];
        case RelativeDateOffset::THREE:
            if (reldate_is_prev(period))
                now.tm_mon -= 3;
            else if (reldate_is_next(period))
                now.tm_mon += 3;
            if (gnc_relative_date_is_ending(period))
                now.tm_mon += 2;
            break;
        case RelativeDateOffset::MONTH:
            if (reldate_is_prev(period))
                --now.tm_mon;
            else if (reldate_is_next(period))
                ++now.tm_mon;
            break;
        case RelativeDateOffset::WEEK:
            if (reldate_is_prev(period))
                now.tm_mday -= 7;
            else if (reldate_is_next(period))
                now.tm_mday += 7;
    }
    reldate_set_day_and_time( now,
                              checked_reldate(period).m_type,
                              is_offset_quarter,
                              acct_per);
    normalize_reldate_tm(now);
    return static_cast<time64>(GncDateTime(now));
}

operator<() [1/2]

bool operator< ( const GncOption &  right, const GncOption &  left  )

inline

Definition at line 221 of file gnc-option.hpp.

{
    return right.get_key() < left.get_key();
}

operator<() [2/2]

bool operator< ( const GncOptionSectionPtr &  right, const GncOptionSectionPtr &  left  )

inline

Definition at line 77 of file gnc-optiondb-impl.hpp.

{
    return right->get_name() < left->get_name();
}

operator<<() [1/4]

std::ostream & operator<<	(	std::ostream &	ostr,
		const RelativeDatePeriod	per
	)

Add the display string to the provided std::ostream.

Parameters

stream	the std::ostream to which to write the period value
period	the period value to write

Returns

A reference to stream so that the operator can be chained.

Definition at line 599 of file gnc-option-date.cpp.

{
    ostr << "'reldate . " << gnc_relative_date_display_string(per);
    return ostr;
}

operator<<() [2/4]

std::ostream & operator<< ( std::ostream &  oss, const GncOption &  opt  )

inline

Definition at line 227 of file gnc-option.hpp.

{
    oss << opt.serialize();
    return oss;
}

operator<<() [3/4]

std::ostream & operator<< ( std::ostream &  oss, const GncOptionCommodityValue &  opt  )

inline

Definition at line 322 of file gnc-option-impl.hpp.

{
    oss << opt.serialize();
    return oss;
}

operator<<() [4/4]

template<class OptType , typename std::enable_if_t< is_OptionClassifier_v< OptType > &&!(is_QofInstanceValue_v< OptType >||is_RangeValue_v< OptType >), int > = 0>

std::ostream & operator<< ( std::ostream &  oss, const OptType &  opt  )

inline

Definition at line 308 of file gnc-option-impl.hpp.

{
    oss << opt.get_value();
    return oss;
}

operator<<< GncOptionAccountListValue >()

template<>

std::ostream & operator<<< GncOptionAccountListValue > ( std::ostream &  oss, const GncOptionAccountListValue &  opt  )

inline

Definition at line 892 of file gnc-option-impl.hpp.

{
    auto values{opt.get_value()};
    bool first = true;
    for (auto value : values)
    {
        if (first)
            first = false;
        else
            oss << " ";
        char strbuff[GUID_ENCODING_LENGTH+1];
        guid_to_string_buff (&value, strbuff);
        oss << strbuff;
    }
    return oss;
}

operator<<< GncOptionAccountSelValue >()

template<>

std::ostream & operator<<< GncOptionAccountSelValue > ( std::ostream &  oss, const GncOptionAccountSelValue &  opt  )

inline

Definition at line 1010 of file gnc-option-impl.hpp.

{
    auto value{opt.get_value()};
    oss << qof_instance_to_string(QOF_INSTANCE(value));
    return oss;
}

operator<<< GncOptionDateValue >()

template<>

std::ostream & operator<<< GncOptionDateValue > ( std::ostream &  oss, const GncOptionDateValue &  opt  )

inline

Definition at line 1167 of file gnc-option-impl.hpp.

{
    return opt.out_stream(oss);
}

operator<<< GncOptionMultichoiceValue >()

template<>

std::ostream & operator<<< GncOptionMultichoiceValue > ( std::ostream &  oss, const GncOptionMultichoiceValue &  opt  )

inline

Definition at line 745 of file gnc-option-impl.hpp.

{
    auto vec{opt.get_multiple()};
    bool first{true};
    for (auto index : vec)
    {
        if (first)
            first = false;
        else
            oss << " ";
        oss << opt.permissible_value(index);
    }
    return oss;
}

operator<<< GncOptionValue< bool > >()

template<>

std::ostream & operator<<< GncOptionValue< bool > > ( std::ostream &  oss, const GncOptionValue< bool > &  opt  )

inline

Definition at line 314 of file gnc-option-impl.hpp.

{
    oss << (opt.get_value() ? "#t" : "#f");
    return oss;
}

operator>>() [1/3]

std::istream & operator>> ( std::istream &  iss, GncOption &  opt  )

inline

Definition at line 235 of file gnc-option.hpp.

{
    return opt.in_stream(iss);
}

operator>>() [2/3]

std::istream & operator>>	(	std::istream &	iss,
		GncOptionCommodityValue &	opt
	)

Definition at line 1023 of file gnc-option-impl.cpp.

{
    std::string instr;
    iss >> instr;
    if (!opt.deserialize(instr))
        throw std::invalid_argument("Invalid commodity string in stream.");
    return iss;
}

operator>>() [3/3]

template<class OptType , typename std::enable_if_t< is_OptionClassifier_v< OptType > &&!(is_QofInstanceValue_v< OptType >||is_RangeValue_v< OptType >), int > = 0>

std::istream & operator>> ( std::istream &  iss, OptType &  opt  )

inline

Definition at line 343 of file gnc-option-impl.hpp.

{
    if constexpr (std::is_same_v<std::decay_t<decltype(opt.get_value())>, const _gncOwner*> ||
                  std::is_same_v<std::decay_t<decltype(opt.get_value())>, const _QofQuery*> ||
                  std::is_same_v<std::decay_t<decltype(opt.get_value())>, GncOptionDateFormat>)
        return iss;
    else
    {
        std::decay_t<decltype(opt.get_value())> value;
        iss >> value;
        opt.set_value(value);
        return iss;
    }
}

operator>>< GncOptionAccountListValue >()

template<>

std::istream & operator>>< GncOptionAccountListValue > ( std::istream &  iss, GncOptionAccountListValue &  opt  )

inline

Definition at line 912 of file gnc-option-impl.hpp.

{
    GncOptionAccountList values;
    while (true)
    {
        std::string str;
        std::getline(iss, str, ' ');
        if (!str.empty())
        {
            auto guid{qof_entity_get_guid(qof_instance_from_string(str, opt.get_ui_type()))};
            values.push_back(*guid);
        }
        else
            break;
    }
    opt.set_value(values);
    iss.clear();
    return iss;
}

operator>>< GncOptionAccountSelValue >()

template<>

std::istream & operator>>< GncOptionAccountSelValue > ( std::istream &  iss, GncOptionAccountSelValue &  opt  )

inline

Definition at line 1020 of file gnc-option-impl.hpp.

{
    Account* value{nullptr};
    std::string str;
    std::getline(iss, str, ' ');
    if (!str.empty())
        value = (Account*)qof_instance_from_string(str, opt.get_ui_type());
    opt.set_value(value);
    iss.clear();
    return iss;
}

operator>>< GncOptionDateValue >()

template<>

std::istream & operator>>< GncOptionDateValue > ( std::istream &  iss, GncOptionDateValue &  opt  )

inline

Definition at line 1175 of file gnc-option-impl.hpp.

{
    return opt.in_stream(iss);
}

operator>>< GncOptionMultichoiceValue >()

template<>

std::istream & operator>>< GncOptionMultichoiceValue > ( std::istream &  iss, GncOptionMultichoiceValue &  opt  )

inline

Definition at line 763 of file gnc-option-impl.hpp.

{
    GncMultichoiceOptionIndexVec values;
    while (true)
    {
        std::string str;
        std::getline(iss, str, ' ');
        if (!str.empty())
        {
            auto index = opt.permissible_value_index(str.c_str());
            if (index != uint16_t_max)
                values.push_back(index);
            else
            {
                std::string err = str + " is not one of ";
                err += opt.m_name;
                err += "'s permissible values.";
                throw std::invalid_argument(err);
            }
        }
        else
            break;
    }
    opt.set_multiple(values);
    iss.clear();
    return iss;
}

operator>>< GncOptionValue< bool > >()

template<>

std::istream & operator>>< GncOptionValue< bool > > ( std::istream &  iss, GncOptionValue< bool > &  opt  )

inline

Definition at line 372 of file gnc-option-impl.hpp.

{
    std::string instr;
    iss >> instr;
    opt.set_value(instr == "#t" ? true : false);
    return iss;
}

operator>>< GncOptionValue< GncOptionReportPlacementVec > >()

template<>

std::istream & operator>>< GncOptionValue< GncOptionReportPlacementVec > > ( std::istream &  iss, GncOptionValue< GncOptionReportPlacementVec > &  opt  )

inline

Definition at line 382 of file gnc-option-impl.hpp.

{
    uint32_t id, wide, high;
    iss >> id >> wide >> high;
        opt.set_value(GncOptionReportPlacementVec{{id, wide, high}});
    return iss;
}

output_color_value()

std::ostream & output_color_value ( std::ostream &  oss, const std::string &  value  )

inline

Definition at line 241 of file gnc-option.hpp.

{
    oss << "'(";
    oss << std::fixed << std::showpoint << std::setprecision(1);
    auto len{value.length() > 8 ? 8 : value.length()};
    for (size_t i{}; i < len; i += 2)
    {
        oss << static_cast<float>(stoi(value.substr(i, 2), nullptr, 16));
        if (i < 6)
            oss << " ";
    }
    if (len < 8)
        oss << 256.0;
    oss << ")";
    return oss;
}

qof_instance_from_guid()

QofInstance * qof_instance_from_guid	(	GncGUID *	guid,
		GncOptionUIType	type
	)

Definition at line 671 of file gnc-option-impl.cpp.

{
    QofIdType qof_type;
    switch(type)
    {
        case GncOptionUIType::BUDGET:
            qof_type = "Budget";
            break;
        case GncOptionUIType::JOB:
            qof_type = "gncJob";
            break;
        case GncOptionUIType::CUSTOMER:
            qof_type = "gncCustomer";
            break;
        case GncOptionUIType::VENDOR:
            qof_type = "gncVendor";
            break;
        case GncOptionUIType::EMPLOYEE:
            qof_type = "gncEmployee";
            break;
        case GncOptionUIType::INVOICE:
            qof_type = "gncInvoice";
            break;
        case GncOptionUIType::TAX_TABLE:
            qof_type = "gncTaxTable";
            break;
        case GncOptionUIType::ACCOUNT_LIST:
        case GncOptionUIType::ACCOUNT_SEL:
        default:
            qof_type = "Account";
            break;
    }
    auto book{get_current_book()};
    auto col{qof_book_get_collection(book, qof_type)};
    return QOF_INSTANCE(qof_collection_lookup_entity(col, guid));
}

qof_instance_from_string()

QofInstance * qof_instance_from_string	(	const std::string &	str,
		GncOptionUIType	type
	)

Definition at line 709 of file gnc-option-impl.cpp.

{
    QofInstance* retval{nullptr};
    try {
        auto guid{static_cast<GncGUID>(gnc::GUID::from_string(str))};
        retval = qof_instance_from_guid(&guid, type);
    }
    catch (const gnc::guid_syntax_exception& err)
    {
        PWARN("Failed to convert %s to a GUID", str.c_str());
    }
    return retval;
}

qof_instance_to_string()

std::string qof_instance_to_string

(

const QofInstance *

inst

)

Definition at line 724 of file gnc-option-impl.cpp.

{
    std::string retval;
    gnc::GUID guid{*qof_instance_get_guid(inst)};
    retval = guid.to_string();
    return retval;
}

Variable Documentation

classifier_size_max

size_t constexpr classifier_size_max {50}

constexpr

Definition at line 59 of file gnc-option-impl.hpp.

{50};

is_GncOwnerValue_v

template<typename T >

constexpr bool is_GncOwnerValue_v = is_GncOwnerValue<T>::value

inlineconstexpr

Definition at line 274 of file gnc-option-impl.hpp.

is_OptionClassifier_v

template<typename T >

constexpr bool is_OptionClassifier_v = is_OptionClassifier<T>::value

inlineconstexpr

Definition at line 81 of file gnc-option.hpp.

is_QofInstanceValue_v

template<typename T >

constexpr bool is_QofInstanceValue_v = is_QofInstanceValue<T>::value

inlineconstexpr

Definition at line 284 of file gnc-option-impl.hpp.

is_QofQueryValue_v

template<typename T >

constexpr bool is_QofQueryValue_v = is_QofQueryValue<T>::value

inlineconstexpr

Definition at line 294 of file gnc-option-impl.hpp.

is_RangeValue_v

template<typename T >

constexpr bool is_RangeValue_v = is_RangeValue<T>::value

inlineconstexpr

Definition at line 102 of file gnc-option.hpp.

is_same_decayed_v

template<typename T , typename U >

constexpr bool is_same_decayed_v = is_same_decayed<T, U>::value

inlineconstexpr

Definition at line 91 of file gnc-option.hpp.

relative_date_periods

constexpr unsigned relative_date_periods

constexpr

Initial value:

=
    static_cast<unsigned>(RelativeDatePeriod::END_ACCOUNTING_PERIOD) + 2

Definition at line 80 of file gnc-option-date.hpp.

sort_tag_size_max

size_t constexpr sort_tag_size_max {10}

constexpr

Definition at line 60 of file gnc-option-impl.hpp.

{10};

uint16_t_max

auto constexpr uint16_t_max = std::numeric_limits<uint16_t>::max()

constexpr

Definition at line 80 of file gnc-option-impl.hpp.