# Variable

public final class **Variable** Holds state in the form of a tensor that persists across steps.


Outputs a ref to the tensor state so it may be read or modified.
TODO(zhifengc/mrry): Adds a pointer to a more detail document
about sharing states in tensorflow.

<br />

### Nested Classes

|---|---|---|---|
| class | [Variable.Options](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options) || Optional attributes for `https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable` |

### Public Methods

|---|---|
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable#asOutput())() Returns the symbolic handle of a tensor. |
| static [Variable.Options](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options) | [container](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable#container(java.lang.String))(String container) |
| static \<T\> [Variable](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable#create(org.tensorflow.op.Scope,%20org.tensorflow.Shape,%20java.lang.Class<T>,%20org.tensorflow.op.core.Variable.Options...))([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Shape](https://www.tensorflow.org/api_docs/java/org/tensorflow/Shape) shape, Class\<T\> dtype, [Options...](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options) options) Factory method to create a class wrapping a new Variable operation. |
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [ref](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable#ref())() A reference to the variable tensor. |
| static [Variable.Options](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options) | [sharedName](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable#sharedName(java.lang.String))(String sharedName) |

### Inherited Methods

From class [org.tensorflow.op.PrimitiveOp](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp)

|---|---|
| final boolean | [equals](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |
| final int | [hashCode](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |
| [Operation](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation) | [op](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying `https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation` |
| final String | [toString](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)

|---|---|
| abstract [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |

## Public Methods

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**asOutput**
()

Returns the symbolic handle of a tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is
used to obtain a symbolic handle that represents the computation of the input.

<br />

#### public static [Variable.Options](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options)
**container**
(String container)

<br />

##### Parameters

| container | If non-empty, this variable is placed in the given container. Otherwise, a default container is used. |
|---|---|

#### public static [Variable](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable)\<T\>
**create**
([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Shape](https://www.tensorflow.org/api_docs/java/org/tensorflow/Shape) shape, Class\<T\> dtype, [Options...](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options) options)

Factory method to create a class wrapping a new Variable operation.

##### Parameters

| scope | current scope |
| shape | The shape of the variable tensor. |
| dtype | The type of elements in the variable tensor. |
| options | carries optional attributes values |
|---|---|

##### Returns

- a new instance of Variable

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**ref**
()

A reference to the variable tensor.

#### public static [Variable.Options](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Variable.Options)
**sharedName**
(String sharedName)

<br />

##### Parameters

| sharedName | If non-empty, this variable is named in the given bucket with this shared_name. Otherwise, the node name is used instead. |
|---|---|