@pelevesque/insert-string

0.0.6 • Public • Published

Build Status Coverage Status JavaScript Style Guide

insert-string

Inserts a string inside another string.

Node Repository

https://www.npmjs.com/package/@pelevesque/insert-string

Installation

npm install @pelevesque/insert-string

Tests

Command Description
npm test or npm run test All Tests Below
npm run cover Standard Style
npm run standard Coverage
npm run unit Unit Tests

Usage

Requiring the Module

const insertString = require('@pelevesque/insert-string')

Insertion

const str = 'I have an apple.'
const insert = 'an orange and '
const index = 7
const result = insertString(str, insert, index)
// result === 'I have an orange and an apple.'

Substitution

The fourth parameter numCharsToRemove defaults to 0 which permits inserts.

To make a substitution, setting numCharsToRemove to -1 will give it the same length as the string to insert.

const str = 'A nice guy.'
const insert = 'cool'
const index = 2
const numCharsToRemove = -1
const result = insertString(str, insert, index, numCharsToRemove)
// result === 'A cool guy.'

Irregular Substitution

By explicitly setting numCharsToRemove to the number of characters to remove, it's possible to do substitutions where the string to insert does not have the same length as the string that it is replacing.

const str = 'My name is Jack Black and I act.'
const insert = 'Joe'
const index = 11
const numCharsToRemove = 10 // the length of 'Jack Black'
const result = insertString(str, insert, index, numCharsToRemove)
// result === 'My name is Joe and I act.'

A Substitution Using a Negative Index

You can use a negative index to add the insert before the original string.

const str = 'abc'
const substitution = '012'
const index = -3
const result = insertString(str, insert, index)
// result === '012abc'

Package Sidebar

Install

npm i @pelevesque/insert-string

Weekly Downloads

17

Version

0.0.6

License

MIT

Unpacked Size

9.28 kB

Total Files

6

Last publish

Collaborators

  • pelevesque