# Insert (String)

| **Name**    | ***Insert***                                                                                                                                                                                                                              |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax      | Insert (String insertInto, String insertString, Integer position)                                                                                                                                                                         |
| Purpose     | To return the resulting string after the insertion of another string within, at a specified position.                                                                                                                                     |
| Description | Inserts a string at a specified position within the string. If position is >= string length, string is appended.                                                                                                                          |
| Return Type | String                                                                                                                                                                                                                                    |
| Parameters  | <p>insertInto \[System.String] – String in which the other string will be inserted</p><p>insertString \[System.string] – String which will be inserted</p><p>position \[System.Int64] – Position at which the string will be inserted</p> |

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FacJob3LPSIXNdzsMHi53%2F0.png?alt=media)

**Example**

In this example, we are passing the required parameters to the function transformation object using a *Variables* object.

Where,

*insertInto* = ABEF

*insertString* = CD

*position* = 2

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FsjGKAXbKFrAs1eb1xS98%2F1.png?alt=media)

Right-click on the function transformation object and select *Preview Output.* You can see that Astera Data Stack has returned a string value with the specified string inserted in the specified position.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2Fnyj7E4RGAJ4KyXdMV8ks%2F2.png?alt=media)