Struct x11rb::protocol::xproto::InternAtomRequest
source · pub struct InternAtomRequest<'input> {
pub only_if_exists: bool,
pub name: Cow<'input, [u8]>,
}
Expand description
Get atom identifier by name.
Retrieves the identifier (xcb_atom_t TODO) for the atom with the specified
name. Atoms are used in protocols like EWMH, for example to store window titles
(_NET_WM_NAME
atom) as property of a window.
If only_if_exists
is 0, the atom will be created if it does not already exist.
If only_if_exists
is 1, XCB_ATOM_NONE
will be returned if the atom does
not yet exist.
§Fields
name
- The name of the atom.only_if_exists
- Return a valid atom id only if the atom already exists.
§Errors
Alloc
- TODO: reasons?Value
- A value other than 0 or 1 was specified foronly_if_exists
.
§See
xlsatoms
: programGetAtomName
: request
§Example
/*
* Resolves the _NET_WM_NAME atom.
*
*/
void my_example(xcb_connection_t *c) {
xcb_intern_atom_cookie_t cookie;
xcb_intern_atom_reply_t *reply;
cookie = xcb_intern_atom(c, 0, strlen("_NET_WM_NAME"), "_NET_WM_NAME");
/* ... do other work here if possible ... */
if ((reply = xcb_intern_atom_reply(c, cookie, NULL))) {
printf("The _NET_WM_NAME atom has ID %u\n", reply->atom);
free(reply);
}
}
Fields§
§only_if_exists: bool
§name: Cow<'input, [u8]>
Implementations§
source§impl<'input> InternAtomRequest<'input>
impl<'input> InternAtomRequest<'input>
sourcepub fn serialize(self) -> ([Cow<'input, [u8]>; 3], Vec<OwnedFd>)
pub fn serialize(self) -> ([Cow<'input, [u8]>; 3], Vec<OwnedFd>)
Serialize this request into bytes for the provided connection
sourcepub fn into_owned(self) -> InternAtomRequest<'static>
pub fn into_owned(self) -> InternAtomRequest<'static>
Clone all borrowed data in this InternAtomRequest.
Trait Implementations§
source§impl<'input> Clone for InternAtomRequest<'input>
impl<'input> Clone for InternAtomRequest<'input>
source§fn clone(&self) -> InternAtomRequest<'input>
fn clone(&self) -> InternAtomRequest<'input>
Returns a copy of the value. Read more
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moresource§impl Debug for InternAtomRequest<'_>
impl Debug for InternAtomRequest<'_>
source§impl<'input> Default for InternAtomRequest<'input>
impl<'input> Default for InternAtomRequest<'input>
source§fn default() -> InternAtomRequest<'input>
fn default() -> InternAtomRequest<'input>
Returns the “default value” for a type. Read more
source§impl<'input> ReplyRequest for InternAtomRequest<'input>
impl<'input> ReplyRequest for InternAtomRequest<'input>
§type Reply = InternAtomReply
type Reply = InternAtomReply
The kind of reply that this request generates.
source§impl<'input> Request for InternAtomRequest<'input>
impl<'input> Request for InternAtomRequest<'input>
Auto Trait Implementations§
impl<'input> Freeze for InternAtomRequest<'input>
impl<'input> RefUnwindSafe for InternAtomRequest<'input>
impl<'input> Send for InternAtomRequest<'input>
impl<'input> Sync for InternAtomRequest<'input>
impl<'input> Unpin for InternAtomRequest<'input>
impl<'input> UnwindSafe for InternAtomRequest<'input>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
🔬This is a nightly-only experimental API. (
clone_to_uninit
)