View source on GitHub |

Joins a string Tensor across the given dimensions.

tf.strings.reduce_join( inputs, axis=None, keep_dims=None, separator='', name=None, reduction_indices=None, keepdims=None )

Computes the string join across dimensions in the given string Tensor of shape `[\\(d_0, d_1, ..., d_{n-1}\\)]`

. Returns a new Tensor created by joining the input strings with the given separator (default: empty string). Negative indices are counted backwards from the end, with `-1`

being equivalent to `n - 1`

. If indices are not specified, joins across all dimensions beginning from `n - 1`

through `0`

.

# tensor `a` is [["a", "b"], ["c", "d"]] tf.strings.reduce_join(a, 0) ==> ["ac", "bd"] tf.strings.reduce_join(a, 1) ==> ["ab", "cd"] tf.strings.reduce_join(a, -2) = tf.strings.reduce_join(a, 0) ==> ["ac", "bd"] tf.strings.reduce_join(a, -1) = tf.strings.reduce_join(a, 1) ==> ["ab", "cd"] tf.strings.reduce_join(a, 0, keep_dims=True) ==> [["ac", "bd"]] tf.strings.reduce_join(a, 1, keep_dims=True) ==> [["ab"], ["cd"]] tf.strings.reduce_join(a, 0, separator=".") ==> ["a.c", "b.d"] tf.strings.reduce_join(a, [0, 1]) ==> "acbd" tf.strings.reduce_join(a, [1, 0]) ==> "abcd" tf.strings.reduce_join(a, []) ==> [["a", "b"], ["c", "d"]] tf.strings.reduce_join(a) = tf.strings.reduce_join(a, [1, 0]) ==> "abcd"

Args | |
---|---|

`inputs` | A `Tensor` of type `string` . The input to be joined. All reduced indices must have non-zero size. |

`axis` | A `Tensor` of type `int32` . The dimensions to reduce over. Dimensions are reduced in the order specified. Omitting `axis` is equivalent to passing `[n-1, n-2, ..., 0]` . Negative indices from `-n` to `-1` are supported. |

`keep_dims` | An optional `bool` . Defaults to `False` . If `True` , retain reduced dimensions with length `1` . |

`separator` | An optional `string` . Defaults to `""` . The separator to use when joining. |

`name` | A name for the operation (optional). |

Returns | |
---|---|

A `Tensor` of type `string` . |

© 2020 The TensorFlow Authors. All rights reserved.

Licensed under the Creative Commons Attribution License 3.0.

Code samples licensed under the Apache 2.0 License.

https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/strings/reduce_join