Struct ruma_common::events::room::power_levels::RoomPowerLevels

#[non_exhaustive]
pub struct RoomPowerLevels {
    pub ban: Int,
    pub events: BTreeMap<RoomEventType, Int>,
    pub events_default: Int,
    pub invite: Int,
    pub kick: Int,
    pub redact: Int,
    pub state_default: Int,
    pub users: BTreeMap<OwnedUserId, Int>,
    pub users_default: Int,
    pub notifications: NotificationPowerLevels,
}

The effective power levels of a room.

This struct contains the same fields as RoomPowerLevelsEventContent and be created from that using a From trait implementation, but it is also implements From<RedactedRoomPowerLevelsEventContent>, so can be used when wanting to inspect the power levels of a room, regardless of whether the most recent power-levels event is redacted or not.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ban: Int

The level required to ban a user.

events: BTreeMap<RoomEventType, Int>

The level required to send specific event types.

This is a mapping from event type to power level required.

events_default: Int

The default level required to send message events.

invite: Int

The level required to invite a user.

kick: Int

The level required to kick a user.

redact: Int

The level required to redact an event.

state_default: Int

The default level required to send state events.

users: BTreeMap<OwnedUserId, Int>

The power levels for specific users.

This is a mapping from user_id to power level for that user.

users_default: Int

The default power level for every user in the room.

notifications: NotificationPowerLevels

The power level requirements for specific notification types.

This is a mapping from key to power level for that notifications key.

Implementations

impl RoomPowerLevels

pub fn for_user(&self, user_id: &UserId) -> Int

Get the power level of a specific user.

pub fn user_can_do(&self, user_id: &UserId, action: PowerLevelAction) -> bool

Whether the given user can do the given action based on the power levels.

pub fn max(&self) -> Int

Get the maximum power level of any user.

Trait Implementations

impl Clone for RoomPowerLevels

fn clone(&self) -> RoomPowerLevels

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RoomPowerLevels

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

Formats the value using the given formatter.

impl From<RedactedRoomPowerLevelsEventContent> for RoomPowerLevels

fn from(c: RedactedRoomPowerLevelsEventContent) -> Self

Converts to this type from the input type.

impl From<RoomPowerLevels> for RoomPowerLevelsEventContent

fn from(c: RoomPowerLevels) -> Self

Converts to this type from the input type.

impl From<RoomPowerLevelsEventContent> for RoomPowerLevels

fn from(c: RoomPowerLevelsEventContent) -> Self

Converts to this type from the input type.