0.1.0 • Published 4 years ago

@arrows/string v0.1.0

Weekly downloads
2
License
ISC
Repository
github
Last release
4 years ago

arrows - string

@arrows/string

npm (scoped) CircleCI David (path) Codecov npm bundle size (scoped) GitHub

Table of contents

  1. Introduction
  2. Installation
  3. API reference
  4. License

Introduction

The purpose of the library is to provide functional wrappers for String.prototype methods and provide some additional functions for common tasks.

All wrappers try to mimic original methods as close as possible while providing composable, auto-curried versions of the string methods.

For convenience, some functions have additional methods to execute the most common use cases of the function.

Functions that do not have a native equivalent contain _ suffix. That way we can implement native-like version in the future (if an equivalent method will be added to the language), without potentially breaking backward-compatibility of the library.

The library has built-in type definitions, which provide an excellent IDE support.

Installation

Via NPM:

npm i @arrows/string

Via Yarn:

yarn add @arrows/string

All modules can be imported independently (to reduce bundle size), here are some import methods (you can use either CommonJS or ES modules):

import arr from '@arrows/string'
import { charAt } from '@arrows/string'
import charAt from '@arrows/string/charAt'

API reference

Index

charAt

Functional wrapper for String.prototype.charAt

Retrieves the character at the specified index.

Parameters

  • index Specific index
  • str Initial string

Returns: Character or empty string if out of bound.

License

Project is under open, non-restrictive ISC license.