[−][src]Struct serenity::builder::GetMessages
Builds a request for a request to the API to retrieve messages.
This can have 2 different sets of parameters. The first set is around where to get the messages:
after
around
before
most_recent
These can not be mixed, and the first in the list alphabetically will be
used. If one is not specified, most_recent
will be used.
The fourth parameter is to specify the number of messages to retrieve. This does not need to be called and defaults to a value of 50.
This should be used only for retrieving messages; see
GuildChannel::messages
for examples.
Examples
Creating a GetMessages
builder to retrieve the first 25 messages after the
message with an Id of 158339864557912064
:
use serenity::builder::GetMessages; use serenity::model::id::{ChannelId, MessageId}; let retriever = GetMessages::default() .after(MessageId(158339864557912064)) .limit(25); // you can then pass it into a function which retrieves messages: let channel_id = ChannelId(81384788765712384); let _messages = channel_id.messages(|_| retriever)?;
Methods
impl GetMessages
[src]
impl GetMessages
pub fn after<M: Into<MessageId>>(self, message_id: M) -> Self
[src]
pub fn after<M: Into<MessageId>>(self, message_id: M) -> Self
Indicates to retrieve the messages after a specific message, given by its Id.
pub fn around<M: Into<MessageId>>(self, message_id: M) -> Self
[src]
pub fn around<M: Into<MessageId>>(self, message_id: M) -> Self
Indicates to retrieve the messages around a specific message in either direction (before+after) the given message.
pub fn before<M: Into<MessageId>>(self, message_id: M) -> Self
[src]
pub fn before<M: Into<MessageId>>(self, message_id: M) -> Self
Indicates to retrieve the messages before a specific message, given by its Id.
pub fn limit(self, limit: u64) -> Self
[src]
pub fn limit(self, limit: u64) -> Self
The maximum number of messages to retrieve for the query.
If this is not specified, a default value of 50 is used.
Note: This field is capped to 100 messages due to a Discord limitation. If an amount larger than 100 is supplied, it will be reduced.
pub fn most_recent(self) -> Self
[src]
pub fn most_recent(self) -> Self
This is a function that is here for completeness. You do not need to
call this - except to clear previous calls to after
, around
, and
before
- as it is the default value.
Trait Implementations
impl Default for GetMessages
[src]
impl Default for GetMessages
fn default() -> GetMessages
[src]
fn default() -> GetMessages
Returns the "default value" for a type. Read more
impl Clone for GetMessages
[src]
impl Clone for GetMessages
fn clone(&self) -> GetMessages
[src]
fn clone(&self) -> GetMessages
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl Debug for GetMessages
[src]
impl Debug for GetMessages
Auto Trait Implementations
impl Send for GetMessages
impl Send for GetMessages
impl Sync for GetMessages
impl Sync for GetMessages
Blanket Implementations
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
type Owned = T
fn to_owned(&self) -> T
[src]
fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)
[src]
fn clone_into(&self, target: &mut T)
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
try_from
)Performs the conversion.
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
try_from
)Performs the conversion.
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more
impl<T> Erased for T
impl<T> Erased for T
impl<T> Typeable for T where
T: Any,
impl<T> Typeable for T where
T: Any,
impl<T> DebugAny for T where
T: Any + Debug,
[src]
impl<T> DebugAny for T where
T: Any + Debug,
impl<T> CloneAny for T where
T: Clone + Any,
[src]
impl<T> CloneAny for T where
T: Clone + Any,
fn clone_any(&self) -> Box<dyn CloneAny + 'static>
[src]
fn clone_any(&self) -> Box<dyn CloneAny + 'static>
fn clone_any_send(&self) -> Box<dyn CloneAny + 'static + Send> where
T: Send,
[src]
fn clone_any_send(&self) -> Box<dyn CloneAny + 'static + Send> where
T: Send,
fn clone_any_sync(&self) -> Box<dyn CloneAny + 'static + Sync> where
T: Sync,
[src]
fn clone_any_sync(&self) -> Box<dyn CloneAny + 'static + Sync> where
T: Sync,
fn clone_any_send_sync(&self) -> Box<dyn CloneAny + 'static + Sync + Send> where
T: Send + Sync,
[src]
fn clone_any_send_sync(&self) -> Box<dyn CloneAny + 'static + Sync + Send> where
T: Send + Sync,
impl<T> UnsafeAny for T where
T: Any,
impl<T> UnsafeAny for T where
T: Any,