safe-strings v1.0.4

safe-strings

A collection of unicode-safe string functions inspired by other programming languages.

Installation

Install using NPM:

$ npm i safe-strings

Usage

Import specific functions:

const { center, capwords } = require('safe-strings');

center('my string', 20);
capwords('this is a test');

Import the entire library:

const stringUtil = require('safe-strings');

stringUtil.center('my string', 20);
stringUtil.capwords('this is a test');

Functions

length(string) ⇒ number

Get string length with unicode support

Kind: global function
Returns: number - The length of the string.

split(string, separator) ⇒ Array.<string>

Return an array of strings split by the separator.

Kind: global function
Returns: Array.<string> - An array of split strings.

ljust(string, width, fillChar) ⇒ string

Left-justify a string in a field of given width.

Kind: global function
Returns: string - The padded string.

rjust(string, width, fillChar) ⇒ string

Right-justify a string in a field of given width.

Kind: global function
Returns: string - The padded string.

center(string, width, fillChar) ⇒ string

Center a string in a field of given width.

Kind: global function
Returns: string - The padded string.

strip(string, trimChar) ⇒ string

Return a copy of the string with leading and trailing characters removed.

Kind: global function
Returns: string - The string with characters removed.

lstrip(string, trimChar) ⇒ string

Return a copy of the string with leading characters removed.

Kind: global function
Returns: string - The string with characters removed.

rstrip(string, trimChar) ⇒ string

Return a copy of the string with trailing characters removed.

Kind: global function
Returns: string - The string with characters removed.

swapcase(string) ⇒ string

Return a copy of the string with lower case letters converted to upper case and vice versa.

Kind: global function
Returns: string - The swapped string

capwords(string, separator) ⇒ string

Return a copy of the string with the first char of each separated word converted to upper case.

Kind: global function
Returns: string - The converted string

ucfirst(string) ⇒ string

Return a copy of the string with the first char converted to upper case.

Kind: global function
Returns: string - The converted string

lcfirst(string) ⇒ string

Return a copy of the string with the first char converted to lower case.

Kind: global function
Returns: string - The converted string

nl2br(string, breakElement) ⇒ string

Return a copy of the string with HTML line breaks () inserted before all newlines.

Kind: global function
Returns: string - The converted string

expandtabs(string, tabsize) ⇒ string

Return a copy of the string with tab chars (\t) replaced by spaces.

Kind: global function
Returns: string - The swapped string