# _CP_insert

_CP_insert is equivalent to the `*result* = insert(*string1*, *ac.expression*, *vc.expression*, *sc.expression*, *string2*)` BASIC
statement.

## Syntax

```
int _CP_insert(CPSTR** result, CPSTR* string1, int ac.expression, int vc.expression,
int sc.expression, CPSTR* string2)
```

## Description

This function returns -1 if
an error occurs. The error code is contained in _CP_errno.

## Example(s)

```
/* Prints "a^b^c". */

CPSTR * s = _CP_mkstr("a\376b");
CPSTR * t = _CP_mkstr("c");

_CP_insert(&s,s,3,0,0,t);
_CP_print(s);
```

## See also

- [C functions overview](https://d3codex.com/cfunctions/c-functions-overview/)

---
Source: https://d3codex.com/cfunctions/cp-insert/ - part of the D3Codex reference.
