Copyright	Will Thompson Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria (garetxe@gmail.com)
Safe Haskell	None
Language	Haskell2010

GI.GLib.Structs.OptionGroup

Contents

Exported types
Methods

Description

A GOptionGroup struct defines the options in a single group. The struct has only private fields and should not be directly accessed.

All options in a group share the same translation function. Libraries which need to parse commandline options are expected to provide a function for getting a GOptionGroup holding their options, which the application can then add to its OptionContext.

Synopsis

Exported types

newtype OptionGroup #

Constructors

OptionGroup (ManagedPtr OptionGroup)

Instances

BoxedObject OptionGroup #
Methods boxedType :: OptionGroup -> IO GType #
((~) * info (ResolveOptionGroupMethod t OptionGroup), MethodInfo * info OptionGroup p) => IsLabel t (OptionGroup -> p) #
Methods fromLabel :: Proxy# Symbol t -> OptionGroup -> p #
((~) * info (ResolveOptionGroupMethod t OptionGroup), MethodInfo * info OptionGroup p) => IsLabelProxy t (OptionGroup -> p) #
Methods fromLabelProxy :: Proxy Symbol t -> OptionGroup -> p #
HasAttributeList * OptionGroup #

((~) * signature (m ()), MonadIO m) => MethodInfo * OptionGroupUnrefMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupUnrefMethodInfo OptionGroup -> signature -> s #
((~) * signature (Text -> m ()), MonadIO m) => MethodInfo * OptionGroupSetTranslationDomainMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupSetTranslationDomainMethodInfo OptionGroup -> signature -> s #
((~) * signature (Maybe TranslateFunc -> m ()), MonadIO m) => MethodInfo * OptionGroupSetTranslateFuncMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupSetTranslateFuncMethodInfo OptionGroup -> signature -> s #
((~) * signature (m OptionGroup), MonadIO m) => MethodInfo * OptionGroupRefMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupRefMethodInfo OptionGroup -> signature -> s #
((~) * signature (m ()), MonadIO m) => MethodInfo * OptionGroupFreeMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupFreeMethodInfo OptionGroup -> signature -> s #
((~) * signature (OptionEntry -> m ()), MonadIO m) => MethodInfo * OptionGroupAddEntriesMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupAddEntriesMethodInfo OptionGroup -> signature -> s #
type AttributeList OptionGroup #
type AttributeList OptionGroup

noOptionGroup :: Maybe OptionGroup #

Methods

addEntries

data OptionGroupAddEntriesMethodInfo #

Instances

((~) * signature (OptionEntry -> m ()), MonadIO m) => MethodInfo * OptionGroupAddEntriesMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupAddEntriesMethodInfo OptionGroup -> signature -> s #

optionGroupAddEntries #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> OptionEntry	`entries`: a `Nothing`-terminated array of `GOptionEntrys`
-> m ()

Adds the options specified in entries to group.

Since: 2.6

free

data OptionGroupFreeMethodInfo #

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * OptionGroupFreeMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupFreeMethodInfo OptionGroup -> signature -> s #

optionGroupFree #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> m ()

Deprecated: (Since version 2.44)Use optionGroupUnref instead.

Frees a OptionGroup. Note that you must not free groups which have been added to a OptionContext.

Since: 2.6

new

optionGroupNew #

Arguments

:: (HasCallStack, MonadIO m)
=> Text	`name`: the name for the option group, this is used to provide help for the options in this group with `--help-``name`
-> Text	`description`: a description for this group to be shown in `--help`. This string is translated using the translation domain or translation function of the group
-> Text	`helpDescription`: a description for the `--help-``name` option. This string is translated using the translation domain or translation function of the group
-> Ptr ()	`userData`: user data that will be passed to the pre- and post-parse hooks, the error hook and to callbacks of `OptionArgCallback` options, or `Nothing`
-> Maybe DestroyNotify	`destroy`: a function that will be called to free `userData`, or `Nothing`
-> m OptionGroup	Returns: a newly created option group. It should be added to a `OptionContext` or freed with `optionGroupUnref`.

Creates a new OptionGroup.

Since: 2.6

ref

data OptionGroupRefMethodInfo #

Instances

((~) * signature (m OptionGroup), MonadIO m) => MethodInfo * OptionGroupRefMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupRefMethodInfo OptionGroup -> signature -> s #

optionGroupRef #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> m OptionGroup	Returns: a `GoptionGroup`

Increments the reference count of group by one.

Since: 2.44

setTranslateFunc

data OptionGroupSetTranslateFuncMethodInfo #

Instances

((~) * signature (Maybe TranslateFunc -> m ()), MonadIO m) => MethodInfo * OptionGroupSetTranslateFuncMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupSetTranslateFuncMethodInfo OptionGroup -> signature -> s #

optionGroupSetTranslateFunc #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> Maybe TranslateFunc	`func`: the `TranslateFunc`, or `Nothing`
-> m ()

Sets the function which is used to translate user-visible strings, for --help output. Different groups can use different GTranslateFuncs. If func is Nothing, strings are not translated.

If you are using gettext(), you only need to set the translation domain, see optionGroupSetTranslationDomain.

Since: 2.6

setTranslationDomain

data OptionGroupSetTranslationDomainMethodInfo #

Instances

((~) * signature (Text -> m ()), MonadIO m) => MethodInfo * OptionGroupSetTranslationDomainMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupSetTranslationDomainMethodInfo OptionGroup -> signature -> s #

optionGroupSetTranslationDomain #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> Text	`domain`: the domain to use
-> m ()

A convenience function to use gettext() for translating user-visible strings.

Since: 2.6

unref

data OptionGroupUnrefMethodInfo #

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * OptionGroupUnrefMethodInfo OptionGroup signature #
Methods overloadedMethod :: MethodProxy OptionGroupUnrefMethodInfo OptionGroup -> signature -> s #

optionGroupUnref #

Arguments

:: (HasCallStack, MonadIO m)
=> OptionGroup	`group`: a `OptionGroup`
-> m ()

Decrements the reference count of group by one. If the reference count drops to 0, the group will be freed. and all memory allocated by the group is released.

Since: 2.44