Stackdriver Monitoring V3 Client - Class TextLocator (1.4.0)

Reference documentation and code samples for the Stackdriver Monitoring V3 Client class TextLocator.

A locator for text. Indicates a particular part of the text of a request or of an object referenced in the request.

For example, suppose the request field text contains: text: "The quick brown fox jumps over the lazy dog." Then the locator: source: "text" start_position { line: 1 column: 17 } end_position { line: 1 column: 19 } refers to the part of the text: "fox".

Generated from protobuf message google.monitoring.v3.TextLocator

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ source string

The source of the text. The source may be a field in the request, in which case its format is the format of the google.rpc.BadRequest.FieldViolation.field field in https://cloud.google.com/apis/design/errors#error_details. It may also be be a source other than the request field (e.g. a macro definition referenced in the text of the query), in which case this is the name of the source (e.g. the macro name).

↳ start_position Google\Cloud\Monitoring\V3\TextLocator\Position

The position of the first byte within the text.

↳ end_position Google\Cloud\Monitoring\V3\TextLocator\Position

The position of the last byte within the text.

↳ nested_locator Google\Cloud\Monitoring\V3\TextLocator

If source, start_position, and end_position describe a call on some object (e.g. a macro in the time series query language text) and a location is to be designated in that object's text, nested_locator identifies the location within that object.

↳ nesting_reason string

When nested_locator is set, this field gives the reason for the nesting. Usually, the reason is a macro invocation. In that case, the macro name (including the leading '@') signals the location of the macro call in the text and a macro argument name (including the leading '$') signals the location of the macro argument inside the macro body that got substituted away.

getSource

The source of the text. The source may be a field in the request, in which case its format is the format of the google.rpc.BadRequest.FieldViolation.field field in https://cloud.google.com/apis/design/errors#error_details. It may also be be a source other than the request field (e.g. a macro definition referenced in the text of the query), in which case this is the name of the source (e.g. the macro name).

Returns
TypeDescription
string

setSource

The source of the text. The source may be a field in the request, in which case its format is the format of the google.rpc.BadRequest.FieldViolation.field field in https://cloud.google.com/apis/design/errors#error_details. It may also be be a source other than the request field (e.g. a macro definition referenced in the text of the query), in which case this is the name of the source (e.g. the macro name).

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getStartPosition

The position of the first byte within the text.

Returns
TypeDescription
Google\Cloud\Monitoring\V3\TextLocator\Position|null

hasStartPosition

clearStartPosition

setStartPosition

The position of the first byte within the text.

Parameter
NameDescription
var Google\Cloud\Monitoring\V3\TextLocator\Position
Returns
TypeDescription
$this

getEndPosition

The position of the last byte within the text.

Returns
TypeDescription
Google\Cloud\Monitoring\V3\TextLocator\Position|null

hasEndPosition

clearEndPosition

setEndPosition

The position of the last byte within the text.

Parameter
NameDescription
var Google\Cloud\Monitoring\V3\TextLocator\Position
Returns
TypeDescription
$this

getNestedLocator

If source, start_position, and end_position describe a call on some object (e.g. a macro in the time series query language text) and a location is to be designated in that object's text, nested_locator identifies the location within that object.

Returns
TypeDescription
Google\Cloud\Monitoring\V3\TextLocator|null

hasNestedLocator

clearNestedLocator

setNestedLocator

If source, start_position, and end_position describe a call on some object (e.g. a macro in the time series query language text) and a location is to be designated in that object's text, nested_locator identifies the location within that object.

Parameter
NameDescription
var Google\Cloud\Monitoring\V3\TextLocator
Returns
TypeDescription
$this

getNestingReason

When nested_locator is set, this field gives the reason for the nesting.

Usually, the reason is a macro invocation. In that case, the macro name (including the leading '@') signals the location of the macro call in the text and a macro argument name (including the leading '$') signals the location of the macro argument inside the macro body that got substituted away.

Returns
TypeDescription
string

setNestingReason

When nested_locator is set, this field gives the reason for the nesting.

Usually, the reason is a macro invocation. In that case, the macro name (including the leading '@') signals the location of the macro call in the text and a macro argument name (including the leading '$') signals the location of the macro argument inside the macro body that got substituted away.

Parameter
NameDescription
var string
Returns
TypeDescription
$this