string-saw

0.0.46 • Public • Published

string-saw Build Status

provides an easy way to string together match/replacement operations in an error-free manner

String Saw Sandbox

install

npm install string-saw

or

bower install string-saw

or head over to cdnjs

methods

  • match (Array/String/Function/Saw) -> Saw
  • matchAll (RegExp) -> [Array/Object]
  • replace (Array/RegExp/String match, String/Function replacement) -> Saw
  • remove (String/RegExp [match]) -> Saw
  • map (Function func) -> Saw
  • item (Integer index) -> Saw
  • itemFromRight (Integer offset) -> Saw
  • first () -> Saw
  • last () -> Saw
  • trim () -> Saw
  • uniq () -> Saw
  • join (String separator/Function separator) -> Saw
  • each (Function func) -> Saw
  • find(String/RegExp/Function match) -> Saw
  • filter(String/RegExp/Function match) -> Saw
  • filterNot(String/RegExp/Function match) -> Saw
  • reduce (Function func) -> Saw
  • slice (Integer start, Integer end) -> Saw
  • split (String/RegExp match) -> Saw
  • transform (Function context) -> Saw
  • upperCase () -> Saw
  • lowerCase () -> Saw
  • prepend (String) -> Saw
  • append (String) -> Saw
  • capitalize () -> Saw
  • reverse () -> Saw
  • sort (Function func) -> Saw
  • length () -> Integer
  • has (String/RegExp match/Function match) -> Boolean
  • startsWith(String/[String]) -> Boolean
  • endsWith(String/[String]) -> Boolean
  • toString () -> String
  • toArray (returns an array) -> Array
  • toNumber () -> Integer (0 if no match)
  • toInt () -> Integer (can return NaN)
  • toFloat () -> Float
  • toBoolean () -> Boolean
  • toObject () -> Object
  • indexOf (String/RegExp/Function match) -> Integer
  • indexesOf (String/RegExp/Function match) -> [Integer]

examples

var saw = require('string-saw');

saw('one two three four five six hello 323423 hello')
	.remove(/\d+/g, 'hello')
	.split(' ')
	.slice(3,4)
	.toString(); // returns "four"

saw('1 2 3')
	.match(/\d+$/)
	.toNumber(); // returns the number 3

saw('1 2 3')
	.split(' ')
	.last()
	.toNumber(); // returns the number 3

saw('joe:56, bob:57')
	.matchAll(/(?<name>(\S+)):(?<age>(\d+))/g) 
	/* returns 
	[
		{name: 'joe', age: '56'},
		{name: 'bob', age: '57'}
	]
	*/

saw('joe:56, bob:57')
	.matchAll(/(\S+):(\d+)/g) 
	/* returns 
	[
		['joe', '56'],
		['bob', '57']
	]
	*/


saw('1 2 3 4 5')
	.split(' ')
	.itemFromRight(2)
	.toNumber(); // returns the number 3

saw([' one ', ' two ', ' three '])
	.trim()
	.join(',')
	.toString(); // returns "one,two,three"

saw('John. Smith.')
	.match(/\S+/g)
	.remove('.')
	.toObject('first', 'last'); // returns {first: "John", last: "Smith"}

Readme

Keywords

none

Package Sidebar

Install

npm i string-saw

Weekly Downloads

1,398

Version

0.0.46

License

MIT

Unpacked Size

215 kB

Total Files

15

Last publish

Collaborators

  • icodeforlove