# tf.strings.join

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 1 version](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/strings/join) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.6.0/tensorflow/python/ops/string_ops.py#L542-L575) |

Perform element-wise concatenation of a list of string tensors.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.string_join`](https://www.tensorflow.org/api_docs/python/tf/strings/join), [`tf.compat.v1.strings.join`](https://www.tensorflow.org/api_docs/python/tf/strings/join)

<br />

    tf.strings.join(
        inputs, separator='', name=None
    )

Given a list of string tensors of same shape, performs element-wise
concatenation of the strings of the same index in all tensors.

    tf.strings.join(['abc','def']).numpy()
    b'abcdef'
    tf.strings.join([['abc','123'],
                     ['def','456'],
                     ['ghi','789']]).numpy()
    array([b'abcdefghi', b'123456789'], dtype=object)
    tf.strings.join([['abc','123'],
                     ['def','456']],
                     separator=" ").numpy()
    array([b'abc def', b'123 456'], dtype=object)

The reduction version of this elementwise operation is
[`tf.strings.reduce_join`](https://www.tensorflow.org/versions/r2.6/api_docs/python/tf/strings/reduce_join)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `inputs` | A list of [`tf.Tensor`](https://www.tensorflow.org/versions/r2.6/api_docs/python/tf/Tensor) objects of same size and [`tf.string`](https://www.tensorflow.org/versions/r2.6/api_docs/python/tf#string) dtype. |
| `separator` | A string added between each string being joined. |
| `name` | A name for the operation (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A [`tf.string`](https://www.tensorflow.org/versions/r2.6/api_docs/python/tf#string) tensor. ||

<br />