GI.Secret.Structs.Value

A secret value, like a password or other binary secret.

Exported types

newtype Value

Constructors

Value (ManagedPtr Value)

Instances

BoxedObject Value

Methods

boxedType :: Value -> IO GType

((~) * info (ResolveValueMethod t Value), MethodInfo * info Value p) => IsLabel t (Value -> p)

Methods

fromLabel :: Proxy# Symbol t -> Value -> p

((~) * info (ResolveValueMethod t Value), MethodInfo * info Value p) => IsLabelProxy t (Value -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> Value -> p

HasAttributeList * Value

((~) * signature (m ()), MonadIO m) => MethodInfo * ValueUnrefMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueUnrefMethodInfo Value -> signature -> s

((~) * signature (m Value), MonadIO m) => MethodInfo * ValueRefMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueRefMethodInfo Value -> signature -> s

((~) * signature (m (Maybe Text)), MonadIO m) => MethodInfo * ValueGetTextMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetTextMethodInfo Value -> signature -> s

((~) * signature (m Text), MonadIO m) => MethodInfo * ValueGetContentTypeMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetContentTypeMethodInfo Value -> signature -> s

((~) * signature (m ByteString), MonadIO m) => MethodInfo * ValueGetMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetMethodInfo Value -> signature -> s

type AttributeList Value

type AttributeList Value

noValue :: Maybe Value

Methods

get

data ValueGetMethodInfo

Instances

((~) * signature (m ByteString), MonadIO m) => MethodInfo * ValueGetMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetMethodInfo Value -> signature -> s

valueGet

Arguments

:: (HasCallStack, MonadIO m)

=> Value

value: the value

-> m ByteString

Returns: the secret data

Get the secret data in the Value. The value is not necessarily null-terminated unless it was created with valueNew or a null-terminated string was passed to valueNewFull.

getContentType

data ValueGetContentTypeMethodInfo

Instances

((~) * signature (m Text), MonadIO m) => MethodInfo * ValueGetContentTypeMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetContentTypeMethodInfo Value -> signature -> s

valueGetContentType

Arguments

:: (HasCallStack, MonadIO m)

=> Value

value: the value

-> m Text

Returns: the content type

Get the content type of the secret value, such as <literal>text/plain</literal>.

getText

data ValueGetTextMethodInfo

Instances

((~) * signature (m (Maybe Text)), MonadIO m) => MethodInfo * ValueGetTextMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueGetTextMethodInfo Value -> signature -> s

valueGetText

Arguments

:: (HasCallStack, MonadIO m)

=> Value

value: the value

-> m (Maybe Text)

Returns: the content type

Get the secret data in the Value if it contains a textual value. The content type must be <literal>text/plain</literal>.

new

valueNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

secret: the secret data

-> Int64

length: the length of the data

-> Text

contentType: the content type of the data

-> m Value

Returns: the new Value

Create a Value for the secret data passed in. The secret data is copied into non-pageable 'secure' memory.

If the length is less than zero, then secret is assumed to be null-terminated.

newFull

valueNewFull

Arguments

:: (HasCallStack, MonadIO m)

=> Text

secret: the secret data

-> Int64

length: the length of the data

-> Text

contentType: the content type of the data

-> DestroyNotify

destroy: function to call to free the secret data

-> m Value

Returns: the new Value

Create a Value for the secret data passed in. The secret data is not copied, and will later be freed with the destroy function.

If the length is less than zero, then secret is assumed to be null-terminated.

ref

data ValueRefMethodInfo

Instances

((~) * signature (m Value), MonadIO m) => MethodInfo * ValueRefMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueRefMethodInfo Value -> signature -> s

valueRef

Arguments

:: (HasCallStack, MonadIO m)

=> Value

value: value to reference

-> m Value

Returns: the value

Add another reference to the Value. For each reference valueUnref should be called to unreference the value.

unref

data ValueUnrefMethodInfo

Instances

((~) * signature (m ()), MonadIO m) => MethodInfo * ValueUnrefMethodInfo Value signature

Methods

overloadedMethod :: MethodProxy ValueUnrefMethodInfo Value -> signature -> s

valueUnref

Arguments

:: (HasCallStack, MonadIO m)

=> Value

value: value to unreference

-> m ()

Unreference a Value. When the last reference is gone, then the value will be freed.