- 1.53.0 (latest)
- 1.52.0
- 1.51.0
- 1.49.0
- 1.48.0
- 1.47.0
- 1.46.0
- 1.45.0
- 1.44.0
- 1.43.0
- 1.42.0
- 1.41.0
- 1.40.0
- 1.39.0
- 1.37.0
- 1.36.0
- 1.35.0
- 1.34.0
- 1.33.0
- 1.32.0
- 1.31.0
- 1.30.0
- 1.29.0
- 1.28.0
- 1.27.0
- 1.24.0
- 1.23.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
- 1.16.0
- 1.15.0
- 1.14.0
- 1.13.0
- 1.12.0
- 1.11.0
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.0
- 1.5.0
- 1.4.0
- 1.1.10
public final class Variable extends GeneratedMessageV3 implements VariableOrBuilder
Represents a variable or an argument possibly of a compound object type.
Note how the following variables are represented:
1) A simple variable:
int x = 5
{ name: "x", value: "5", type: "int" } // Captured variable
2) A compound object:
struct T {
int m1;
int m2;
};
T x = { 3, 7 };
{ // Captured variable
name: "x",
type: "T",
members { name: "m1", value: "3", type: "int" },
members { name: "m2", value: "7", type: "int" }
}
3) A pointer where the pointee was captured:
T x = { 3, 7 };
T* p = &x;
{ // Captured variable
name: "p",
type: "T",
value: "0x00500500",
members { name: "m1", value: "3", type: "int" },
members { name: "m2", value: "7", type: "int" }
}
4) A pointer where the pointee was not captured:
T p = new T;
{ // Captured variable
name: "p",
type: "T",
value: "0x00400400"
status { is_error: true, description { format: "unavailable" } }
}
The status should describe the reason for the missing value,
such as <optimized out>
, <inaccessible>
, <pointers limit reached>
.
Note that a null pointer should not have members.
5) An unnamed value:
int p = new int(7);
{ // Captured variable
name: "p",
value: "0x00500500",
type: "int",
members { value: "7", type: "int" } }
6) An unnamed pointer where the pointee was not captured:
int p = new int(7);
int** pp = &p;
{ // Captured variable
name: "pp",
value: "0x00500500",
type: "int*",
members {
value: "0x00400400",
type: "int"
status {
is_error: true,
description: { format: "unavailable" } }
}
}
}
To optimize computation, memory and network traffic, variables that
repeat in the output multiple times can be stored once in a shared
variable table and be referenced using the var_table_index
field. The
variables stored in the shared table are nameless and are essentially
a partition of the complete variable. To reconstruct the complete
variable, merge the referencing variable with the referenced variable.
When using the shared variable table, the following variables:
T x = { 3, 7 };
T* p = &x;
T& r = x;
{ name: "x", var_table_index: 3, type: "T" } // Captured variables
{ name: "p", value "0x00500500", type="T*", var_table_index: 3 }
{ name: "r", type="T&", var_table_index: 3 }
{ // Shared variable table entry #3:
members { name: "m1", value: "3", type: "int" },
members { name: "m2", value: "7", type: "int" }
}
Note that the pointer address is stored with the referencing variable
and not with the referenced variable. This allows the referenced variable
to be shared between pointers and references.
The type field is optional. The debugger agent may or may not support it.
Protobuf type google.devtools.clouddebugger.v2.Variable
Inheritance
Object > AbstractMessageLite<MessageType,BuilderType> > AbstractMessage > GeneratedMessageV3 > VariableImplements
VariableOrBuilderStatic Fields
MEMBERS_FIELD_NUMBER
public static final int MEMBERS_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
NAME_FIELD_NUMBER
public static final int NAME_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
STATUS_FIELD_NUMBER
public static final int STATUS_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
TYPE_FIELD_NUMBER
public static final int TYPE_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
VALUE_FIELD_NUMBER
public static final int VALUE_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
VAR_TABLE_INDEX_FIELD_NUMBER
public static final int VAR_TABLE_INDEX_FIELD_NUMBER
Field Value | |
---|---|
Type | Description |
int |
Static Methods
getDefaultInstance()
public static Variable getDefaultInstance()
Returns | |
---|---|
Type | Description |
Variable |
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns | |
---|---|
Type | Description |
Descriptor |
newBuilder()
public static Variable.Builder newBuilder()
Returns | |
---|---|
Type | Description |
Variable.Builder |
newBuilder(Variable prototype)
public static Variable.Builder newBuilder(Variable prototype)
Parameter | |
---|---|
Name | Description |
prototype | Variable |
Returns | |
---|---|
Type | Description |
Variable.Builder |
parseDelimitedFrom(InputStream input)
public static Variable parseDelimitedFrom(InputStream input)
Parameter | |
---|---|
Name | Description |
input | InputStream |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
public static Variable parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
input | InputStream |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseFrom(byte[] data)
public static Variable parseFrom(byte[] data)
Parameter | |
---|---|
Name | Description |
data | byte[] |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static Variable parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
data | byte[] |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parseFrom(ByteString data)
public static Variable parseFrom(ByteString data)
Parameter | |
---|---|
Name | Description |
data | ByteString |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static Variable parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
data | ByteString |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parseFrom(CodedInputStream input)
public static Variable parseFrom(CodedInputStream input)
Parameter | |
---|---|
Name | Description |
input | CodedInputStream |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public static Variable parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
input | CodedInputStream |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseFrom(InputStream input)
public static Variable parseFrom(InputStream input)
Parameter | |
---|---|
Name | Description |
input | InputStream |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
public static Variable parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
input | InputStream |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
IOException |
parseFrom(ByteBuffer data)
public static Variable parseFrom(ByteBuffer data)
Parameter | |
---|---|
Name | Description |
data | ByteBuffer |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static Variable parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
data | ByteBuffer |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
Variable |
Exceptions | |
---|---|
Type | Description |
InvalidProtocolBufferException |
parser()
public static Parser<Variable> parser()
Returns | |
---|---|
Type | Description |
Parser<Variable> |
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter | |
---|---|
Name | Description |
obj | Object |
Returns | |
---|---|
Type | Description |
boolean |
getDefaultInstanceForType()
public Variable getDefaultInstanceForType()
Returns | |
---|---|
Type | Description |
Variable |
getMembers(int index)
public Variable getMembers(int index)
Members contained or pointed to by the variable.
repeated .google.devtools.clouddebugger.v2.Variable members = 3;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
Variable |
getMembersCount()
public int getMembersCount()
Members contained or pointed to by the variable.
repeated .google.devtools.clouddebugger.v2.Variable members = 3;
Returns | |
---|---|
Type | Description |
int |
getMembersList()
public List<Variable> getMembersList()
Members contained or pointed to by the variable.
repeated .google.devtools.clouddebugger.v2.Variable members = 3;
Returns | |
---|---|
Type | Description |
List<Variable> |
getMembersOrBuilder(int index)
public VariableOrBuilder getMembersOrBuilder(int index)
Members contained or pointed to by the variable.
repeated .google.devtools.clouddebugger.v2.Variable members = 3;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
VariableOrBuilder |
getMembersOrBuilderList()
public List<? extends VariableOrBuilder> getMembersOrBuilderList()
Members contained or pointed to by the variable.
repeated .google.devtools.clouddebugger.v2.Variable members = 3;
Returns | |
---|---|
Type | Description |
List<? extends com.google.devtools.clouddebugger.v2.VariableOrBuilder> |
getName()
public String getName()
Name of the variable, if any.
string name = 1;
Returns | |
---|---|
Type | Description |
String | The name. |
getNameBytes()
public ByteString getNameBytes()
Name of the variable, if any.
string name = 1;
Returns | |
---|---|
Type | Description |
ByteString | The bytes for name. |
getParserForType()
public Parser<Variable> getParserForType()
Returns | |
---|---|
Type | Description |
Parser<Variable> |
getSerializedSize()
public int getSerializedSize()
Returns | |
---|---|
Type | Description |
int |
getStatus()
public StatusMessage getStatus()
Status associated with the variable. This field will usually stay
unset. A status of a single variable only applies to that variable or
expression. The rest of breakpoint data still remains valid. Variables
might be reported in error state even when breakpoint is not in final
state.
The message may refer to variable name with refers_to
set to
VARIABLE_NAME
. Alternatively refers_to
will be set to VARIABLE_VALUE
.
In either case variable value and members will be unset.
Example of error message applied to name: Invalid expression syntax
.
Example of information message applied to value: Not captured
.
Examples of error message applied to value:
Malformed string
,Field f not found in class C
Null pointer dereference
.google.devtools.clouddebugger.v2.StatusMessage status = 5;
Returns | |
---|---|
Type | Description |
StatusMessage | The status. |
getStatusOrBuilder()
public StatusMessageOrBuilder getStatusOrBuilder()
Status associated with the variable. This field will usually stay
unset. A status of a single variable only applies to that variable or
expression. The rest of breakpoint data still remains valid. Variables
might be reported in error state even when breakpoint is not in final
state.
The message may refer to variable name with refers_to
set to
VARIABLE_NAME
. Alternatively refers_to
will be set to VARIABLE_VALUE
.
In either case variable value and members will be unset.
Example of error message applied to name: Invalid expression syntax
.
Example of information message applied to value: Not captured
.
Examples of error message applied to value:
Malformed string
,Field f not found in class C
Null pointer dereference
.google.devtools.clouddebugger.v2.StatusMessage status = 5;
Returns | |
---|---|
Type | Description |
StatusMessageOrBuilder |
getType()
public String getType()
Variable type (e.g. MyClass
). If the variable is split with
var_table_index
, type
goes next to value
. The interpretation of
a type is agent specific. It is recommended to include the dynamic type
rather than a static type of an object.
string type = 6;
Returns | |
---|---|
Type | Description |
String | The type. |
getTypeBytes()
public ByteString getTypeBytes()
Variable type (e.g. MyClass
). If the variable is split with
var_table_index
, type
goes next to value
. The interpretation of
a type is agent specific. It is recommended to include the dynamic type
rather than a static type of an object.
string type = 6;
Returns | |
---|---|
Type | Description |
ByteString | The bytes for type. |
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Returns | |
---|---|
Type | Description |
UnknownFieldSet |
getValue()
public String getValue()
Simple value of the variable.
string value = 2;
Returns | |
---|---|
Type | Description |
String | The value. |
getValueBytes()
public ByteString getValueBytes()
Simple value of the variable.
string value = 2;
Returns | |
---|---|
Type | Description |
ByteString | The bytes for value. |
getVarTableIndex()
public Int32Value getVarTableIndex()
Reference to a variable in the shared variable table. More than
one variable can reference the same variable in the table. The
var_table_index
field is an index into variable_table
in Breakpoint.
.google.protobuf.Int32Value var_table_index = 4;
Returns | |
---|---|
Type | Description |
Int32Value | The varTableIndex. |
getVarTableIndexOrBuilder()
public Int32ValueOrBuilder getVarTableIndexOrBuilder()
Reference to a variable in the shared variable table. More than
one variable can reference the same variable in the table. The
var_table_index
field is an index into variable_table
in Breakpoint.
.google.protobuf.Int32Value var_table_index = 4;
Returns | |
---|---|
Type | Description |
Int32ValueOrBuilder |
hasStatus()
public boolean hasStatus()
Status associated with the variable. This field will usually stay
unset. A status of a single variable only applies to that variable or
expression. The rest of breakpoint data still remains valid. Variables
might be reported in error state even when breakpoint is not in final
state.
The message may refer to variable name with refers_to
set to
VARIABLE_NAME
. Alternatively refers_to
will be set to VARIABLE_VALUE
.
In either case variable value and members will be unset.
Example of error message applied to name: Invalid expression syntax
.
Example of information message applied to value: Not captured
.
Examples of error message applied to value:
Malformed string
,Field f not found in class C
Null pointer dereference
.google.devtools.clouddebugger.v2.StatusMessage status = 5;
Returns | |
---|---|
Type | Description |
boolean | Whether the status field is set. |
hasVarTableIndex()
public boolean hasVarTableIndex()
Reference to a variable in the shared variable table. More than
one variable can reference the same variable in the table. The
var_table_index
field is an index into variable_table
in Breakpoint.
.google.protobuf.Int32Value var_table_index = 4;
Returns | |
---|---|
Type | Description |
boolean | Whether the varTableIndex field is set. |
hashCode()
public int hashCode()
Returns | |
---|---|
Type | Description |
int |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns | |
---|---|
Type | Description |
FieldAccessorTable |
isInitialized()
public final boolean isInitialized()
Returns | |
---|---|
Type | Description |
boolean |
newBuilderForType()
public Variable.Builder newBuilderForType()
Returns | |
---|---|
Type | Description |
Variable.Builder |
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected Variable.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter | |
---|---|
Name | Description |
parent | BuilderParent |
Returns | |
---|---|
Type | Description |
Variable.Builder |
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter | |
---|---|
Name | Description |
unused | UnusedPrivateParameter |
Returns | |
---|---|
Type | Description |
Object |
toBuilder()
public Variable.Builder toBuilder()
Returns | |
---|---|
Type | Description |
Variable.Builder |
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Parameter | |
---|---|
Name | Description |
output | CodedOutputStream |
Exceptions | |
---|---|
Type | Description |
IOException |