tf.strings.format | TensorFlow v2.16.1 (original) (raw)
Formats a string template using a list of tensors.
View aliases
Compat aliases for migration
SeeMigration guide for more details.
tf.strings.format(
template, inputs, placeholder='{}', summarize=3, name=None
)
Formats a string template using a list of tensors, abbreviating tensors by only printing the first and last summarize elements of each dimension (recursively). If formatting only one tensor into a template, the tensor does not have to be wrapped in a list.
| Example |
|---|
| Formatting a single-tensor template:tensor = tf.range(5) tf.strings.format("tensor: {}, suffix", tensor) <tf.Tensor: shape=(), dtype=string, numpy=b'tensor: [0 1 2 3 4], suffix'> Formatting a multi-tensor template: tensor_a = tf.range(2) tensor_b = tf.range(1, 4, 2) tf.strings.format("a: {}, b: {}, suffix", (tensor_a, tensor_b)) <tf.Tensor: shape=(), dtype=string, numpy=b'a: [0 1], b: [1 3], suffix'> |
| Args | |
|---|---|
| template | A string template to format tensor values into. |
| inputs | A list of Tensor objects, or a single Tensor. The list of tensors to format into the template string. If a solitary tensor is passed in, the input tensor will automatically be wrapped as a list. |
| placeholder | An optional string. Defaults to {}. At each placeholder occurring in the template, a subsequent tensor will be inserted. |
| summarize | An optional int. Defaults to 3. When formatting the tensors, show the first and last summarizeentries of each tensor dimension (recursively). If set to -1, all elements of the tensor will be shown. |
| name | A name for the operation (optional). |
| Returns |
|---|
| A scalar Tensor of type string. |
| Raises | |
|---|---|
| ValueError | if the number of placeholders does not match the number of inputs. |