.. _op_ai_onnx_StringConcat:

StringConcat
============

- **Domain**: ``ai.onnx``
- **Since version**: 20

StringConcat concatenates string tensors elementwise (with NumPy-style broadcasting support)

**Inputs**

- **X** (*T*): Tensor to prepend in concatenation
- **Y** (*T*): Tensor to append in concatenation

**Outputs**

- **Z** (*T*): Concatenated string tensor

**Type Constraints**

- **T**: Inputs and outputs must be UTF-8 strings
  Allowed types: tensor(string).

Examples
--------

**test_cc_string_concat**

.. code-block:: text

    Inputs:
      x: shape=(3,), dtype=object
        ['abc', '', 'hello ']
      y: shape=(3,), dtype=object
        ['def', 'xyz', 'world']

    Outputs:
      z: shape=(3,), dtype=object
        ['abcdef', 'xyz', 'hello world']

**test_cc_string_concat_bcast**

.. code-block:: text

    Inputs:
      x: shape=(2, 2), dtype=object
        [['a', 'b'],
         ['c', 'd']]
      y: shape=(), dtype=object
        '!'

    Outputs:
      z: shape=(2, 2), dtype=object
        [['a!', 'b!'],
         ['c!', 'd!']]