> For the complete documentation index, see [llms.txt](https://jscula.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jscula.gitbook.io/docs/utils/inserttextseparator.md).

# insertTextSeparator

Inserts a specified separator character after every group of characters in a given string.

The `insertTextSeparator` function is designed to format a string by inserting a specified separator character at defined intervals.

This utility can be particularly useful for formatting phone numbers, credit card numbers, or any other series of characters where readability is improved by adding separators.

## Parameters

* **char** `(string | InputEvent)`: The string to be formatted or an InputEvent object containing a string.
* **separator** `(string) [default: ' ']`: The character used to separate groups of characters. The default separator is a space.
* **inPosition** `(number) [default: 4]`: The number of characters between each separator. Default is 4.

## Returns

* **string**: The resulting string with separators inserted at specified positions.

## Examples

```javascript
const formattedString1 = insertTextSeparator('HelloWorld', '-', 5);
console.log(formattedString1); // Outputs: 'Hello-World'
```

#### Using the default separator (space) and position

```javascript
const formattedString2 = insertTextSeparator('07085010189');
console.log(formattedString2); // Outputs: '0708 5010 189'
```

```javascript
const formattedString2 = insertTextSeparator('1234567890','/');
console.log(formattedString2); // Outputs: '1234/5678/90'
```

#### Formating with a custom separator and position

```javascript
const formattedString3 = insertTextSeparator('ABCDEFGHI',':',3); 
console.log(formattedString3); // Outputs: 'ABC:DEF:GHI'
```

#### Handling input from an event object

```javascript
$('#inputField').addEventListener('input', function(event) { 
  const formattedEventString = insertTextSeparator(event); 
  console.log(formattedEventString); 
});
```

```javascript
$('#inputField').addEventListener('input', function(event) { 
    event.target.val(insertTextSeparator(event)); 
  });
```

***

This function is useful for enhancing readability in various string formats by efficiently managing separator insertion across