Struct Quota 

pub struct Quota {
    pub free: i64,
    pub used: i64,
    pub total: i64,
    pub relative: f64,
}

User storage quota metrics and capacity constraints.

In Nextcloud, when a quota is set to unlimited, negative integer codes (typically -3 or -2) are returned for free and total.

Official documentation: https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/ocs-api-overview.html#user-metadata

Fields

free: i64

Space remaining in bytes, or negative code when unlimited.

used: i64

Space consumed by user files in bytes.

total: i64

Total storage capacity allocated in bytes, or negative code when unlimited.

relative: f64

Storage usage ratio or percentage (e.g. 0.96 or 96.0).

Implementations

impl Quota

pub const fn new(free: i64, used: i64, total: i64, relative: f64) -> Self

Creates a quota descriptor with explicit byte measurements.

pub const fn free(&self) -> i64

Available free space in bytes, or a negative status code when unlimited.

pub const fn used(&self) -> i64

Bytes consumed by user files.

pub const fn total(&self) -> i64

Total storage allocation in bytes, or a negative status code when unlimited.

pub const fn relative(&self) -> f64

Relative storage utilization metric.

pub const fn is_unlimited(&self) -> bool

Whether the user has an unlimited storage allocation.

pub fn free_bytes(&self) -> Option<u64>

Available free storage in bytes, or None if quota is unlimited.

pub fn total_bytes(&self) -> Option<u64>

Total allocated storage capacity in bytes, or None if quota is unlimited.

pub fn used_bytes(&self) -> u64

Bytes currently consumed by user files.

pub fn relative_percentage(&self) -> f64

Percentage of storage utilized (0.0 to 100.0).

Trait Implementations

impl Clone for Quota

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Quota

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

Formats the value using the given formatter.

impl Default for Quota

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Quota

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Quota

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Quota

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Quota