Struct serenity::builder::CreateMessage

pub struct CreateMessage(pub VecMap<&'static str, Value>, pub Option<Vec<ReactionType>>);

A builder to specify the contents of an http::send_message request, primarily meant for use through ChannelId::send_message.

There are two situations where different field requirements are present:

1. When sending an embed, no other field is required;
2. Otherwise, content is the only required field that is required to be set.

Note that if you only need to send the content of a message, without specifying other fields, then ChannelId::say may be a more preferable option.

Examples

Sending a message with a content of "test" and applying text-to-speech:

use serenity::model::id::ChannelId;

let channel_id = ChannelId(7);

let _ = channel_id.send_message(|m| m
    .content("test")
    .tts(true)
    .embed(|e| e
        .title("This is an embed")
        .description("With a description")));

Methods

impl CreateMessage

pub fn content<D: Display>(self, content: D) -> Self

Set the content of the message.

Note: Message contents must be under 2000 unicode code points.

pub fn embed<F>(self, f: F) -> Self where     F: FnOnce(CreateEmbed) -> CreateEmbed,

Set an embed for the message.

pub fn tts(self, tts: bool) -> Self

Set whether the message is text-to-speech.

Think carefully before setting this to true.

Defaults to false.

pub fn reactions<R: Into<ReactionType>, It: IntoIterator<Item = R>>(     self,     reactions: It ) -> Self

Adds a list of reactions to create after the message's sent.

Trait Implementations

impl Clone for CreateMessage

fn clone(&self) -> CreateMessage

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CreateMessage

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for CreateMessage

fn default() -> CreateMessage

Creates a map for sending a Message, setting tts to false by default.