    {- |
    Copyright  : Will Thompson, Iñaki García Etxebarria and Jonas Platte
    License    : LGPL-2.1
    Maintainer : Iñaki García Etxebarria (garetxe@gmail.com)

    'GI.Gio.Structs.IOExtension.IOExtension' is an opaque data structure and can only be accessed
    using the following functions.
    -}

    #define ENABLE_OVERLOADING \
           (!defined(__HADDOCK_VERSION__))

    module GI.Gio.Structs.IOExtension
        (

    -- * Exported types
        IOExtension(..)                         ,
        noIOExtension                           ,

     -- * Methods
    -- ** getName #method:getName#

    #if ENABLE_OVERLOADING
        IOExtensionGetNameMethodInfo            ,
    #endif
        iOExtensionGetName                      ,

    -- ** getPriority #method:getPriority#

    #if ENABLE_OVERLOADING
        IOExtensionGetPriorityMethodInfo        ,
    #endif
        iOExtensionGetPriority                  ,

    -- ** getType #method:getType#

    #if ENABLE_OVERLOADING
        IOExtensionGetTypeMethodInfo            ,
    #endif
        iOExtensionGetType                      ,

        ) where

    import Data.GI.Base.ShortPrelude
    import qualified Data.GI.Base.ShortPrelude as SP
    import qualified Data.GI.Base.Overloading as O
    import qualified Prelude as P

    import qualified Data.GI.Base.Attributes as GI.Attributes
    import qualified Data.GI.Base.ManagedPtr as B.ManagedPtr
    import qualified Data.GI.Base.GError as B.GError
    import qualified Data.GI.Base.GVariant as B.GVariant
    import qualified Data.GI.Base.GValue as B.GValue
    import qualified Data.GI.Base.GParamSpec as B.GParamSpec
    import qualified Data.GI.Base.CallStack as B.CallStack
    import qualified Data.Text as T
    import qualified Data.ByteString.Char8 as B
    import qualified Data.Map as Map
    import qualified Foreign.Ptr as FP

    -- | Memory-managed wrapper type.
    newtype IOExtension = IOExtension (ManagedPtr IOExtension)
    -- XXX Wrapping a foreign struct/union with no known destructor or size, leak?
    instance WrappedPtr IOExtension where
        wrappedPtrCalloc = return nullPtr
        wrappedPtrCopy = return
        wrappedPtrFree = Nothing

    -- | A convenience alias for `Nothing` :: `Maybe` `IOExtension`.
    noIOExtension :: Maybe IOExtension
    noIOExtension = Nothing

    #if ENABLE_OVERLOADING
    instance O.HasAttributeList IOExtension
    type instance O.AttributeList IOExtension = IOExtensionAttributeList
    type IOExtensionAttributeList = ('[ ] :: [(Symbol, *)])
    #endif

    -- method IOExtension::get_name
    -- method type : OrdinaryMethod
    -- Args : [Arg {argCName = "extension", argType = TInterface (Name {namespace = "Gio", name = "IOExtension"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GIOExtension", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
    -- Lengths : []
    -- returnType : Just (TBasicType TUTF8)
    -- throws : False
    -- Skip return : False

    foreign import ccall "g_io_extension_get_name" g_io_extension_get_name ::
        Ptr IOExtension ->                      -- extension : TInterface (Name {namespace = "Gio", name = "IOExtension"})
        IO CString

    {- |
    Gets the name under which /@extension@/ was registered.

    Note that the same type may be registered as extension
    for multiple extension points, under different names.
    -}
    iOExtensionGetName ::
        (B.CallStack.HasCallStack, MonadIO m) =>
        IOExtension
        {- ^ /@extension@/: a 'GI.Gio.Structs.IOExtension.IOExtension' -}
        -> m T.Text
        {- ^ __Returns:__ the name of /@extension@/. -}
    iOExtensionGetName extension = liftIO $ do
        extension' <- unsafeManagedPtrGetPtr extension
        result <- g_io_extension_get_name extension'
        checkUnexpectedReturnNULL "iOExtensionGetName" result
        result' <- cstringToText result
        touchManagedPtr extension
        return result'

    #if ENABLE_OVERLOADING
    data IOExtensionGetNameMethodInfo
    instance (signature ~ (m T.Text), MonadIO m) => O.MethodInfo IOExtensionGetNameMethodInfo IOExtension signature where
        overloadedMethod _ = iOExtensionGetName

    #endif

    -- method IOExtension::get_priority
    -- method type : OrdinaryMethod
    -- Args : [Arg {argCName = "extension", argType = TInterface (Name {namespace = "Gio", name = "IOExtension"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GIOExtension", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
    -- Lengths : []
    -- returnType : Just (TBasicType TInt)
    -- throws : False
    -- Skip return : False

    foreign import ccall "g_io_extension_get_priority" g_io_extension_get_priority ::
        Ptr IOExtension ->                      -- extension : TInterface (Name {namespace = "Gio", name = "IOExtension"})
        IO Int32

    {- |
    Gets the priority with which /@extension@/ was registered.
    -}
    iOExtensionGetPriority ::
        (B.CallStack.HasCallStack, MonadIO m) =>
        IOExtension
        {- ^ /@extension@/: a 'GI.Gio.Structs.IOExtension.IOExtension' -}
        -> m Int32
        {- ^ __Returns:__ the priority of /@extension@/ -}
    iOExtensionGetPriority extension = liftIO $ do
        extension' <- unsafeManagedPtrGetPtr extension
        result <- g_io_extension_get_priority extension'
        touchManagedPtr extension
        return result

    #if ENABLE_OVERLOADING
    data IOExtensionGetPriorityMethodInfo
    instance (signature ~ (m Int32), MonadIO m) => O.MethodInfo IOExtensionGetPriorityMethodInfo IOExtension signature where
        overloadedMethod _ = iOExtensionGetPriority

    #endif

    -- method IOExtension::get_type
    -- method type : OrdinaryMethod
    -- Args : [Arg {argCName = "extension", argType = TInterface (Name {namespace = "Gio", name = "IOExtension"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GIOExtension", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
    -- Lengths : []
    -- returnType : Just (TBasicType TGType)
    -- throws : False
    -- Skip return : False

    foreign import ccall "g_io_extension_get_type" g_io_extension_get_type ::
        Ptr IOExtension ->                      -- extension : TInterface (Name {namespace = "Gio", name = "IOExtension"})
        IO CGType

    {- |
    Gets the type associated with /@extension@/.
    -}
    iOExtensionGetType ::
        (B.CallStack.HasCallStack, MonadIO m) =>
        IOExtension
        {- ^ /@extension@/: a 'GI.Gio.Structs.IOExtension.IOExtension' -}
        -> m GType
        {- ^ __Returns:__ the type of /@extension@/ -}
    iOExtensionGetType extension = liftIO $ do
        extension' <- unsafeManagedPtrGetPtr extension
        result <- g_io_extension_get_type extension'
        let result' = GType result
        touchManagedPtr extension
        return result'

    #if ENABLE_OVERLOADING
    data IOExtensionGetTypeMethodInfo
    instance (signature ~ (m GType), MonadIO m) => O.MethodInfo IOExtensionGetTypeMethodInfo IOExtension signature where
        overloadedMethod _ = iOExtensionGetType

    #endif

    #if ENABLE_OVERLOADING
    type family ResolveIOExtensionMethod (t :: Symbol) (o :: *) :: * where
        ResolveIOExtensionMethod "getName" o = IOExtensionGetNameMethodInfo
        ResolveIOExtensionMethod "getPriority" o = IOExtensionGetPriorityMethodInfo
        ResolveIOExtensionMethod "getType" o = IOExtensionGetTypeMethodInfo
        ResolveIOExtensionMethod l o = O.MethodResolutionFailed l o

    instance (info ~ ResolveIOExtensionMethod t IOExtension, O.MethodInfo info IOExtension p) => O.IsLabelProxy t (IOExtension -> p) where
        fromLabelProxy _ = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)

    #if MIN_VERSION_base(4,9,0)
    instance (info ~ ResolveIOExtensionMethod t IOExtension, O.MethodInfo info IOExtension p) => O.IsLabel t (IOExtension -> p) where
    #if MIN_VERSION_base(4,10,0)
        fromLabel = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
    #else
        fromLabel _ = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
    #endif
    #endif

    #endif