# tf.strings.unsorted_segment_join

<br />

|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/strings/unsorted_segment_join) |

Joins the elements of `inputs` based on `segment_ids`.

#### View aliases


**Compat aliases for migration**

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

[`tf.compat.v1.strings.unsorted_segment_join`](https://www.tensorflow.org/api_docs/python/tf/strings/unsorted_segment_join), \`tf.compat.v2.strings.unsorted_segment_join\`

<br />

    tf.strings.unsorted_segment_join(
        inputs, segment_ids, num_segments, separator='', name=None
    )

Computes the string join along segments of a tensor.
Given `segment_ids` with rank `N` and `data` with rank `N+M`:

    `output[i, k1...kM] = strings.join([data[j1...jN, k1...kM])`

where the join is over all \[j1...jN\] such that segment_ids\[j1...jN\] = i.
Strings are joined in row-major order.

#### For example:

    inputs = [['Y', 'q', 'c'], ['Y', '6', '6'], ['p', 'G', 'a']]
    output_array = string_ops.unsorted_segment_join(inputs=inputs,
                                                    segment_ids=[1, 0, 1],
                                                    num_segments=2,
                                                    separator=':'))
    # output_array ==> [['Y', '6', '6'], ['Y:p', 'q:G', 'c:a']]


    inputs = ['this', 'is', 'a', 'test']
    output_array = string_ops.unsorted_segment_join(inputs=inputs,
                                                    segment_ids=[0, 0, 0, 0],
                                                    num_segments=1,
                                                    separator=':'))
    # output_array ==> ['this:is:a:test']

<br />

<br />

<br />

| ## Args ||
|---|---|
| `inputs` | A `Tensor` of type `string`. The input to be joined. |
| `segment_ids` | A `Tensor`. Must be one of the following types: `int32`, `int64`. A tensor whose shape is a prefix of data.shape. Negative segment ids are not supported. |
| `num_segments` | A `Tensor`. Must be one of the following types: `int32`, `int64`. A scalar. |
| `separator` | An optional `string`. Defaults to `""`. The separator to use when joining. |
| `name` | A name for the operation (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `Tensor` of type `string`. ||

<br />