Struct tracker::Resource [−][src]
#[repr(transparent)]pub struct Resource { /* fields omitted */ }
Expand description
The <structname>
TrackerResource</structname>
object represents information
about a given resource.
Implementations
Creates a TrackerResource instance.
identifier
A string containing a URI, or None
.
Returns
a newly created Resource
. Free with g_object_unref()
when done
Creates a new builder-pattern struct instance to construct Resource
objects.
This method returns an instance of ResourceBuilder
which can be used to create Resource
objects.
Adds a boolean object to a multi-valued property.
property_uri
a string identifying the property to modify
value
the property object
Adds a double object to a multi-valued property.
property_uri
a string identifying the property to modify
value
the property object
Add ‘value’ to the list of values for given property.
You can pass any kind of GValue for value
, but serialization functions will
normally only be able to serialize URIs/relationships and fundamental value
types (string, int, etc.).
property_uri
a string identifying the property to set
value
an initialised [glib::Value
][crate::glib::Value]
Adds an integer object to a multi-valued property.
property_uri
a string identifying the property to modify
value
the property object
Adds an integer object to a multi-valued property.
property_uri
a string identifying the property to modify
value
the property object
Adds a resource object to a multi-valued property. This
function produces similar RDF to add_uri()
,
although in this function the URI will depend on the identifier
set on resource
.
property_uri
a string identifying the property to modify
resource
the property object
Adds a string object to a multi-valued property.
property_uri
a string identifying the property to modify
value
the property object
Adds a resource object to a multi-valued property. This
function produces similar RDF to add_uri()
,
although in this function the URI will depend on the identifier
set on resource
. This function takes ownership of resource
.
property_uri
a string identifying the property to modify
resource
the property object
Adds a resource object to a multi-valued property. This function
produces similar RDF to add_relation()
, although
it requires that the URI is previously known.
property_uri
a string identifying the property to modify
value
the property object
Returns the first boolean object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first boolean object
Returns the first double object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first double object
Returns the first integer object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first integer object
Returns the first integer object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first integer object
Returns the first resource object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first resource object
Returns the first string object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first string object
Returns the first resource object previously assigned to a property.
property_uri
a string identifying the property to look up
Returns
the first resource object as an URI.
Returns the identifier of a resource.
If the identifier was set to NULL, the identifier returned will be a unique SPARQL blank node identifier, such as “_:123”.
Returns
a string owned by the resource
Gets the list of properties defined in self
Returns
The list of properties.
The list should be freed with g_list_free()
.
A helper function that compares a Resource
by its identifier
string.
identifier
a string identifying the resource
Returns
an integer less than, equal to, or greater than zero, if the
resource identifier is <, == or > than identifier
Serialize all the information in resource
as a JSON-LD document.
See http://www.jsonld.org/ for more information on the JSON-LD serialization format.
The namespaces
object is used to expand any compact URI values. In most
cases you should pass None
, which means the set of namespaces returned by
NamespaceManager::default()
will be used. This defines the
usual prefixes for all of the ontologies that Tracker ships with by default.
namespaces
a set of prefixed URLs, or None
to use the
default set
Returns
a newly-allocated string containing JSON-LD data.
pub fn print_sparql_update(
&self,
namespaces: Option<&NamespaceManager>,
graph_id: Option<&str>
) -> Option<GString>
pub fn print_sparql_update(
&self,
namespaces: Option<&NamespaceManager>,
graph_id: Option<&str>
) -> Option<GString>
Generates a SPARQL command to update a database with the information
stored in resource
.
The namespaces
object is used to expand any compact URI values. In most
cases you should pass None
, which means the set of namespaces returned by
NamespaceManager::default()
will be used. This defines the
usual prefixes for all of the ontologies that Tracker ships with by default.
namespaces
a set of prefixed URLs, or None
to use the
default set
graph_id
the URN of the graph the data should be added to,
or None
Returns
a newly-allocated string containing a SPARQL update command.
Serialize all the information in resource
as a Turtle document.
The generated Turtle should correspond to this standard: https://www.w3.org/TR/2014/REC-turtle-20140225/
The namespaces
object is used to expand any compact URI values. In most
cases you should pass None
, which means the set of namespaces returned by
NamespaceManager::default()
will be used. This defines the
usual prefixes for all of the ontologies that Tracker ships with by default.
namespaces
a set of prefixed URLs, or None
to use the
default set
Returns
a newly-allocated string
Serializes a Resource
to a [glib::Variant
][struct@crate::glib::Variant] in a lossless way.
All child resources are subsequently serialized. It is implied
that both ends use a common NamespaceManager
.
Returns
A variant describing the resource, the reference is floating.
Sets a single-valued boolean object.
property_uri
a string identifying the property to modify
value
the property object
Sets a single-valued double object.
property_uri
a string identifying the property to modify
value
the property object
State that the only value for the given property is ‘value’. Any existing values for ‘property’ will be removed.
When serialising to SPARQL, any properties that were set with this function will get a corresponding DELETE statement to remove any existing values in the database.
You can pass any kind of GValue for value
, but serialization functions will
normally only be able to serialize URIs/relationships and fundamental value
types (string, int, etc.).
property_uri
a string identifying the property to set
value
an initialised [glib::Value
][crate::glib::Value]
Changes the identifier of a Resource
. The identifier should be a
URI or compact URI, but this is not necessarily enforced. Invalid
identifiers may cause errors when serializing the resource or trying to
insert the results in a database.
If the identifier is set to NULL, a SPARQL blank node identifier such as “_:123” is assigned to the resource.
identifier
a string identifying the resource
Sets a single-valued integer object.
property_uri
a string identifying the property to modify
value
the property object
Sets a single-valued integer object.
property_uri
a string identifying the property to modify
value
the property object
Sets a single-valued resource object as a Resource
. This
function produces similar RDF to set_uri()
,
although in this function the URI will depend on the identifier
set on resource
.
property_uri
a string identifying the property to modify
resource
the property object
Sets a single-valued string object.
property_uri
a string identifying the property to modify
value
the property object
Sets a single-valued resource object as a Resource
. This
function produces similar RDF to set_uri()
,
although in this function the URI will depend on the identifier
set on resource
. This function takes ownership of resource
.
property_uri
a string identifying the property to modify
resource
the property object
Sets a single-valued resource object as a string URI. This function
produces similar RDF to set_relation()
, although
it requires that the URI is previously known.
property_uri
a string identifying the property to modify
value
the property object
Deserializes a Resource
previously serialized with
serialize()
. It is implied that both ends
use a common NamespaceManager
.
variant
a [glib::Variant
][struct@crate::glib::Variant]
Returns
A TrackerResource, or None
if
deserialization fails.
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Returns the type identifier of Self
.
Auto Trait Implementations
impl RefUnwindSafe for Resource
impl UnwindSafe for Resource
Blanket Implementations
Mutably borrows from an owned value. Read more
fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,
fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,
Upcasts an object to a superclass or interface T
. Read more
fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,
fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,
Upcasts an object to a reference of its superclass or interface T
. Read more
Tries to downcast to a subclass or interface implementor T
. Read more
fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,
fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,
Tries to downcast to a reference of its subclass or interface implementor T
. Read more
fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,
fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,
Tries to cast to an object of type T
. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast
and upcast
will do many checks at compile-time already. Read more
fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Tries to cast to reference to an object of type T
. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast
and upcast
will do many checks at compile-time already. Read more
unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,
unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,
Casts to T
unconditionally. Read more
unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,
unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,
Casts to &T
unconditionally. Read more
pub fn parent_class_init<T>(class: &mut Class<U>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
pub fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
<U as ParentClassIs>::Parent: IsSubclassable<T>,
Returns true
if the object is an instance of (can be cast to) T
.
pub fn type_(&self) -> Type
pub fn type_(&self) -> Type
Returns the type of the object.
pub fn object_class(&self) -> &Class<Object>
pub fn object_class(&self) -> &Class<Object>
Returns the [ObjectClass
] of the object. Read more
pub fn class(&self) -> &Class<T> where
T: IsClass,
pub fn class(&self) -> &Class<T> where
T: IsClass,
Returns the class of the object.
Returns the class of the object in the given type T
. Read more
Returns the interface T
of the object. Read more
pub fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,
pub fn try_set_property<V>(
&self,
property_name: &str,
value: V
) -> Result<(), BoolError> where
V: ToValue,
Similar to [Self::set_property
] but fails instead of panicking.
pub fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,
pub fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,
Sets the property property_name
of the object to value value
. Read more
pub fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>
pub fn try_set_property_from_value(
&self,
property_name: &str,
value: &Value
) -> Result<(), BoolError>
Similar to [Self::set_property
] but fails instead of panicking.
pub fn set_property_from_value(&self, property_name: &str, value: &Value)
pub fn set_property_from_value(&self, property_name: &str, value: &Value)
Sets the property property_name
of the object to value value
. Read more
Similar to [Self::set_properties
] but fails instead of panicking.
Sets multiple properties of the object at once. Read more
Similar to [Self::set_properties_from_value
] but fails instead of panicking.
Sets multiple properties of the object at once. Read more
pub fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,
pub fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,
Similar to [Self::property
] but fails instead of panicking.
Gets the property property_name
of the object and cast it to the type V. Read more
pub fn try_property_value(
&self,
property_name: &str
) -> Result<Value, BoolError>
pub fn try_property_value(
&self,
property_name: &str
) -> Result<Value, BoolError>
Similar to [Self::property_value
] but fails instead of panicking.
pub fn property_value(&self, property_name: &str) -> Value
pub fn property_value(&self, property_name: &str) -> Value
Gets the property property_name
of the object. Read more
pub fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool
pub fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool
Check if the object has a property property_name
of the given type_
. Read more
pub fn property_type(&self, property_name: &str) -> Option<Type>
pub fn property_type(&self, property_name: &str) -> Option<Type>
Get the type of the property property_name
of this object. Read more
pub fn find_property(&self, property_name: &str) -> Option<ParamSpec>
pub fn find_property(&self, property_name: &str) -> Option<ParamSpec>
Get the ParamSpec
of the property property_name
of this object.
pub fn list_properties(&self) -> PtrSlice<ParamSpec>
pub fn list_properties(&self) -> PtrSlice<ParamSpec>
Return all ParamSpec
of the properties of this object.
pub fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
pub fn freeze_notify(&self) -> PropertyNotificationFreezeGuard
Freeze all property notifications until the return guard object is dropped. Read more
pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,
pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,
Set arbitrary data on this object with the given key
. Read more
Return previously set arbitrary data of this object with the given key
. Read more
pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,
pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,
Retrieve previously set arbitrary data of this object with the given key
. Read more
Set arbitrary data on this object with the given key
. Read more
Return previously set arbitrary data of this object with the given key
. Read more
pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,
pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,
Retrieve previously set arbitrary data of this object with the given key
. Read more
pub fn block_signal(&self, handler_id: &SignalHandlerId)
pub fn block_signal(&self, handler_id: &SignalHandlerId)
Block a given signal handler. Read more
pub fn unblock_signal(&self, handler_id: &SignalHandlerId)
pub fn unblock_signal(&self, handler_id: &SignalHandlerId)
Unblock a given signal handler.
pub fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
pub fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)
Stop emission of the currently emitted signal.
pub fn stop_signal_emission_by_name(&self, signal_name: &str)
pub fn stop_signal_emission_by_name(&self, signal_name: &str)
Stop emission of the currently emitted signal by the (possibly detailed) signal name.
Similar to [Self::connect
] but fails instead of panicking.
Connect to the signal signal_name
on this object. Read more
Similar to [Self::connect_id
] but fails instead of panicking.
Connect to the signal signal_id
on this object. Read more
Similar to [Self::connect_local
] but fails instead of panicking.
Connect to the signal signal_name
on this object. Read more
Similar to [Self::connect_local_id
] but fails instead of panicking.
Connect to the signal signal_id
on this object. Read more
Similar to [Self::connect_unsafe
] but fails instead of panicking.
Connect to the signal signal_name
on this object. Read more
Similar to [Self::connect_unsafe_id
] but fails instead of panicking.
pub fn try_connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
pub fn try_connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
Similar to [Self::connect_closure
] but fails instead of panicking.
pub fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
pub fn connect_closure(
&self,
signal_name: &str,
after: bool,
closure: RustClosure
) -> SignalHandlerId
Connect a closure to the signal signal_name
on this object. Read more
pub fn try_connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
pub fn try_connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> Result<SignalHandlerId, BoolError>
Similar to [Self::connect_closure_id
] but fails instead of panicking.
pub fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
pub fn connect_closure_id(
&self,
signal_id: SignalId,
details: Option<Quark>,
after: bool,
closure: RustClosure
) -> SignalHandlerId
Connect a closure to the signal signal_id
on this object. Read more
pub fn watch_closure(&self, closure: &impl AsRef<Closure>)
pub fn watch_closure(&self, closure: &impl AsRef<Closure>)
Limits the lifetime of closure
to the lifetime of the object. When
the object’s reference count drops to zero, the closure will be
invalidated. An invalidated closure will ignore any calls to
Closure::invoke
. Read more
Connect to the signal signal_id
on this object. Read more
Similar to [Self::emit
] but fails instead of panicking.
Emit signal by signal id. Read more
pub fn try_emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Result<Option<Value>, BoolError>
pub fn try_emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Result<Option<Value>, BoolError>
Similar to [Self::emit_with_values
] but fails instead of panicking.
pub fn emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Option<Value>
pub fn emit_with_values(
&self,
signal_id: SignalId,
args: &[Value]
) -> Option<Value>
Same as [Self::emit
] but takes Value
for the arguments.
pub fn try_emit_by_name<R>(
&self,
signal_name: &str,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
pub fn try_emit_by_name<R>(
&self,
signal_name: &str,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
Similar to [Self::emit_by_name
] but fails instead of panicking.
pub fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> R where
R: TryFromClosureReturnValue,
pub fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> R where
R: TryFromClosureReturnValue,
Emit signal by its name. Read more
Similar to [Self::emit_by_name_with_values
] but fails instead of panicking.
pub fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
pub fn emit_by_name_with_values(
&self,
signal_name: &str,
args: &[Value]
) -> Option<Value>
Emit signal by its name. Read more
pub fn try_emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
pub fn try_emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> Result<R, BoolError> where
R: TryFromClosureReturnValue,
Similar to [Self::emit_with_details
] but fails instead of panicking.
pub fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> R where
R: TryFromClosureReturnValue,
pub fn emit_with_details<R>(
&self,
signal_id: SignalId,
details: Quark,
args: &[&dyn ToValue]
) -> R where
R: TryFromClosureReturnValue,
Emit signal by signal id with details. Read more
pub fn try_emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Result<Option<Value>, BoolError>
pub fn try_emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Result<Option<Value>, BoolError>
Similar to [Self::emit_with_details_and_values
] but fails instead of panicking.
pub fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
pub fn emit_with_details_and_values(
&self,
signal_id: SignalId,
details: Quark,
args: &[Value]
) -> Option<Value>
Emit signal by signal id with details. Read more
pub fn disconnect(&self, handler_id: SignalHandlerId)
pub fn disconnect(&self, handler_id: SignalHandlerId)
Disconnect a previously connected signal handler.
Connect to the notify
signal of the object. Read more
pub fn connect_notify_local<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),
pub fn connect_notify_local<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),
Connect to the notify
signal of the object. Read more
pub unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
pub unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
Connect to the notify
signal of the object. Read more
Notify that the given property has changed its value. Read more
pub fn notify_by_pspec(&self, pspec: &ParamSpec)
pub fn notify_by_pspec(&self, pspec: &ParamSpec)
Notify that the given property has changed its value. Read more
pub fn downgrade(&self) -> WeakRef<T>
pub fn downgrade(&self) -> WeakRef<T>
Downgrade this object to a weak reference.
pub fn bind_property<O>(
&'a self,
source_property: &'a str,
target: &'a O,
target_property: &'a str
) -> BindingBuilder<'a> where
O: ObjectType,
pub fn bind_property<O>(
&'a self,
source_property: &'a str,
target: &'a O,
target_property: &'a str
) -> BindingBuilder<'a> where
O: ObjectType,
Bind property source_property
on this object to the target_property
on the target
object. Read more
pub fn to_closure_return_value(&self) -> Option<Value>
pub fn to_send_value(&self) -> SendValue
pub fn to_send_value(&self) -> SendValue
Returns a SendValue
clone of self
.