Struct Expr 

#[non_exhaustive]
pub struct Expr {
    pub description: Option<String>,
    pub expression: Option<String>,
    pub location: Option<String>,
    pub title: Option<String>,
    /* private fields */
}

Available on crate features backend-buckets or backend-services or disks or firewall-policies or images or instance-templates or instances or instant-snapshots or interconnect-attachment-groups or interconnect-groups or licenses or machine-images or network-attachments or network-firewall-policies or node-groups or node-templates or organization-security-policies or region-backend-services or region-disks or region-instant-snapshots or region-network-firewall-policies or region-security-policies or reservation-blocks or reservation-sub-blocks or reservations or resource-policies or routers or security-policies or service-attachments or snapshots or storage-pools or subnetworks only.

Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec.

Example (Comparison):

title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"

Example (Equality):

title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"

Example (Logic):

title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"

Example (Data Manipulation):

title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"

The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.

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.

description: Option<String>

Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.

expression: Option<String>

Textual representation of an expression in Common Expression Language syntax.

location: Option<String>

Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.

title: Option<String>

Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.

Implementations

impl Expr

pub fn new() -> Self

pub fn set_description<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of description.

Example

let x = Expr::new().set_description("example");

pub fn set_or_clear_description<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of description.

Example

let x = Expr::new().set_or_clear_description(Some("example"));
let x = Expr::new().set_or_clear_description(None::<String>);

pub fn set_expression<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of expression.

Example

let x = Expr::new().set_expression("example");

pub fn set_or_clear_expression<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of expression.

Example

let x = Expr::new().set_or_clear_expression(Some("example"));
let x = Expr::new().set_or_clear_expression(None::<String>);

pub fn set_location<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of location.

Example

let x = Expr::new().set_location("example");

pub fn set_or_clear_location<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of location.

Example

let x = Expr::new().set_or_clear_location(Some("example"));
let x = Expr::new().set_or_clear_location(None::<String>);

pub fn set_title<T>(self, v: T) -> Self

where T: Into<String>,

Sets the value of title.

Example

let x = Expr::new().set_title("example");

pub fn set_or_clear_title<T>(self, v: Option<T>) -> Self

where T: Into<String>,

Sets or clears the value of title.

Example

let x = Expr::new().set_or_clear_title(Some("example"));
let x = Expr::new().set_or_clear_title(None::<String>);

Trait Implementations

impl Clone for Expr

fn clone(&self) -> Expr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Expr

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

Formats the value using the given formatter.

impl Default for Expr

fn default() -> Expr

Returns the “default value” for a type.

impl Message for Expr

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Expr

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Expr