Learn how companies like Phone2Action are using npm in their front-end developmentJoin the conversation »

@pelevesque/has-required-substrings-after-sums

0.0.1 • Public • Published

Build Status Coverage Status JavaScript Style Guide

has-required-substrings-after-sums

Checks if a string has required substrings after given sums.

Related Packages

https://github.com/pelevesque/has-required-substrings
https://github.com/pelevesque/has-required-substrings-at-indexes
https://github.com/pelevesque/has-prohibited-substring
https://github.com/pelevesque/has-prohibited-substring-at-indexes
https://github.com/pelevesque/has-prohibited-substring-after-sums

Node Repository

https://www.npmjs.com/package/@pelevesque/has-required-substrings-after-sums

Installation

npm install @pelevesque/has-required-substrings-after-sums

Tests

Standard Style & Unit Tests

npm test

Unit Tests & Coverage

npm run cover

Usage

Parameters

str                (required)
requiredSubstrings (required)
options            (optional) default = { substringsToDigits = null, sumPlainDigits = true,  allowSubstringBleeding = false }

Requiring

const hasRequiredSubstringsAfterSums = require('@pelevesque/has-required-substrings-after-sums')

Basic Usage

@see https://github.com/pelevesque/sum-digits to understand how the sum is calculated.

requiredSubstrings is an object of sum -> substring pairs. true is returned if all substrings are found directly following their associated sums.

const str = '123a45'
const requiredSubstrings = { 1: 'a' }
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings)
// result === false
const str = '123a45'
const requiredSubstrings = { 6: 'a' }
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings)
// result === true
const str = '123man45dinosaur'
const requiredSubstrings = { 6: 'man', 15: 'dinosaur' }
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings)
// result === true
// the substring must come directly after the sum (here b is directly after the sum, not a)
const str = '123ba45'
const requiredSubstrings = { 6: 'a' }
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings)
// result === false

Options

substringsToDigits

You can use the substringsToDigits object to give numeric values to substrings so that they are counted during summing.

const str = '123!$$$a'
const requiredSubstrings = { 15: 'a' }
const substringsToDigits = { '!': 4, '$$$': 5 }
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings, {
  substringsToDigits: substringsToDigits
})
// result === true

sumPlainDigits

You can set the sumPlainDigits flag to false if you only want to sum substringsToDigits.

In the following example, 1, 2, and 3 are not summed.

const str = '123!a'
const requiredSubstrings = { 4: 'a' }
const substringsToDigits = { '!': 4 }
const sumPlainDigits = false
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings, {
  substringsToDigits: substringsToDigits,
  sumPlainDigits: sumPlainDigits
})
// result === true

allowSubstringBleeding

The allowSubstringBleeding flag is false by default. It it used when you want to allow the last substring to be incomplete if the string is too short. In the following example, the last substring canal starts at the correct index, but remains incomplete since the string ends. Normally this would return false. With allowSubstringBleeding set to true, it returns true.

const str = '123can'
const requiredSubstrings = { 6: 'canal' }
const allowSubstringBleeding = true
const result = hasRequiredSubstringsAfterSums(str, requiredSubstrings, {
  allowSubstringBleeding: allowSubstringBleeding
})
// result === true

Install

npm i @pelevesque/has-required-substrings-after-sums

DownloadsWeekly Downloads

1

Version

0.0.1

License

MIT

Unpacked Size

36.9 kB

Total Files

6

Last publish

Collaborators

  • avatar