<?php
# Generated by the protocol buffer compiler.  DO NOT EDIT!
# source: google/type/expr.proto

namespace Google\Type;

use Google\Protobuf\Internal\GPBType;
use Google\Protobuf\Internal\GPBUtil;
use Google\Protobuf\RepeatedField;

/**
 * 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.
 *
 * Generated from protobuf message <code>google.type.Expr</code>
 */
class Expr extends \Google\Protobuf\Internal\Message
{
    /**
     * Textual representation of an expression in Common Expression Language
     * syntax.
     *
     * Generated from protobuf field <code>string expression = 1;</code>
     */
    protected $expression = '';
    /**
     * 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.
     *
     * Generated from protobuf field <code>string title = 2;</code>
     */
    protected $title = '';
    /**
     * Optional. Description of the expression. This is a longer text which
     * describes the expression, e.g. when hovered over it in a UI.
     *
     * Generated from protobuf field <code>string description = 3;</code>
     */
    protected $description = '';
    /**
     * Optional. String indicating the location of the expression for error
     * reporting, e.g. a file name and a position in the file.
     *
     * Generated from protobuf field <code>string location = 4;</code>
     */
    protected $location = '';

    /**
     * Constructor.
     *
     * @param array $data {
     *     Optional. Data for populating the Message object.
     *
     *     @type string $expression
     *           Textual representation of an expression in Common Expression Language
     *           syntax.
     *     @type string $title
     *           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.
     *     @type string $description
     *           Optional. Description of the expression. This is a longer text which
     *           describes the expression, e.g. when hovered over it in a UI.
     *     @type string $location
     *           Optional. String indicating the location of the expression for error
     *           reporting, e.g. a file name and a position in the file.
     * }
     */
    public function __construct($data = NULL) {
        \GPBMetadata\Google\Type\Expr::initOnce();
        parent::__construct($data);
    }

    /**
     * Textual representation of an expression in Common Expression Language
     * syntax.
     *
     * Generated from protobuf field <code>string expression = 1;</code>
     * @return string
     */
    public function getExpression()
    {
        return $this->expression;
    }

    /**
     * Textual representation of an expression in Common Expression Language
     * syntax.
     *
     * Generated from protobuf field <code>string expression = 1;</code>
     * @param string $var
     * @return $this
     */
    public function setExpression($var)
    {
        GPBUtil::checkString($var, True);
        $this->expression = $var;

        return $this;
    }

    /**
     * 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.
     *
     * Generated from protobuf field <code>string title = 2;</code>
     * @return string
     */
    public function getTitle()
    {
        return $this->title;
    }

    /**
     * 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.
     *
     * Generated from protobuf field <code>string title = 2;</code>
     * @param string $var
     * @return $this
     */
    public function setTitle($var)
    {
        GPBUtil::checkString($var, True);
        $this->title = $var;

        return $this;
    }

    /**
     * Optional. Description of the expression. This is a longer text which
     * describes the expression, e.g. when hovered over it in a UI.
     *
     * Generated from protobuf field <code>string description = 3;</code>
     * @return string
     */
    public function getDescription()
    {
        return $this->description;
    }

    /**
     * Optional. Description of the expression. This is a longer text which
     * describes the expression, e.g. when hovered over it in a UI.
     *
     * Generated from protobuf field <code>string description = 3;</code>
     * @param string $var
     * @return $this
     */
    public function setDescription($var)
    {
        GPBUtil::checkString($var, True);
        $this->description = $var;

        return $this;
    }

    /**
     * Optional. String indicating the location of the expression for error
     * reporting, e.g. a file name and a position in the file.
     *
     * Generated from protobuf field <code>string location = 4;</code>
     * @return string
     */
    public function getLocation()
    {
        return $this->location;
    }

    /**
     * Optional. String indicating the location of the expression for error
     * reporting, e.g. a file name and a position in the file.
     *
     * Generated from protobuf field <code>string location = 4;</code>
     * @param string $var
     * @return $this
     */
    public function setLocation($var)
    {
        GPBUtil::checkString($var, True);
        $this->location = $var;

        return $this;
    }

}

