Manupilate strings of all types to get desired output

• Usage
  • splitText
  • countOccurance
  • mergeObjects
  • injectDupObj
  • transformList

Usage

import the js-fns library

1const { splitText, countOccurance } = require('simple-fns');
2
3// or
4
5const jsFns = require('simple-fns');

splitText

Split a string into an array as well as the count for the length using a specified delimiter

• options

  1. With option 0 (optional)

  1const result = splitText('test test test', ' ');
  2
  3// result -> { total: 3, list: ['test', 'test', 'test']}
  4
  5// or
  6const result = splitText('test test test', ' ', 0);
  7
  8// result -> {total: 3,list: ['test', 'test', 'test']}

  2. With option 1

  1const result = splitText('test test test', ' ', 1);
  2
  3// result -> { total: 3}
  4
  5// or
  6const result = splitText('test , test , test', ',', 1);
  7
  8// result -> { total: 3}

  3. With option 2

  1const result = splitText('test test test', ' ', 2);
  2
  3// result -> {list: ['test', 'test', 'test']}
  4
  5// or
  6const result = splitText('test , test , test', ',', 2);
  7
  8//result -> {list: ['test', 'test', 'test']}
  9// Note: if the delimeter is other than ' ' (space), then all whitespaces will be trimmed from the string before the array is returned.

countOccurance

Count the number of times a character occurs in a string

• options

  1. With option 0 (optional) -> count Uppercases

  1const result1 = countOccurance('Home-work-Space-');
  2// result1 -> 2
  3
  4const result2 = countOccurance('homeworkspace');
  5// result2 -> 0
  6
  7const result3 = countOccurance('homeworkSpace', 0);
  8// result3 -> 1
  9
  10const result4 = countOccurance('homeworkSpace', 0, '');
  11// result4 -> 1
  12
  13const result5 = countOccurance('homeworkSpace', 0, ' ');
  14// result5 -> 1
  15
  16const result6 = countOccurance('homeworkSpace', 0, ',');
  17// result6 -> 1

  2. With option 1 -> count Lowercases

  1const result1 = countOccurance('Home-work-Space-', 1);
  2// result1 -> 11
  3
  4const result2 = countOccurance('Home work Space', 1);
  5// result2 -> 11
  6
  7const result3 = countOccurance('Home work Space ', 1);
  8// result3 -> 11
  9
  10const result4 = countOccurance('Home, work , Space ', 1);
  11// result4 -> 11
  12
  13const result5 = countOccurance('homeworkspace', 1, ',');
  14// result5 -> 13

  3. With option 2 -> digits/ numbers

  1const result1 = countOccurance('1ome-2ork-3pace-', 2);
  2// result1 -> 3
  3
  4const result2 = countOccurance('1234', 2);
  5// result2 -> 4
  6
  7const result3 = countOccurance('-1', 2);
  8// result3 -> 1
  9
  10const result4 = countOccurance('1,2,3,4,5', 2);
  11// result4 -> 5
  12
  13const result5 = countOccurance('4  6  . 7', 2);
  14// result5 -> 3

  4. With option 3 -> whitespaces in a string

  1const result1 = countOccurance('1ome-2ork-3pace-', 3, ' ');
  2// result1 -> 0
  3
  4const result2 = countOccurance('1 2 3 4', 3);
  5// result2 -> 3
  6
  7const result3 = countOccurance(' 1 2 3 4 ', 3);
  8// result3 -> 5
  9
  10const result4 = countOccurance(' 0 ', 3);
  11// result4 -> 2
  12
  13const result5 = countOccurance('Home Work  Space ', 3, ' ');
  14// result5 -> 4

  5. With option 4 -> delimiter in a string

  1const result1 = countOccurance('1ome-2ork-3pace-', 4, '-');
  2// result1 -> 3
  3
  4const result2 = countOccurance('1ome-2ork-3pace-', 4, '- ');
  5// result2 -> 3
  6
  7const result3 = countOccurance('1ome-2ork-3pace-', 4, ' - ');
  8// result3 -> 3
  9
  10const result4 = countOccurance('1ome/2ork/3pace/', 4, '/');
  11// result4 -> 3
  12
  13const result5 = countOccurance('boy , girl , kid , child', 4, ',');
  14// result5 -> 3
  15
  16const result5 = countOccurance('boy , girl , kid , child', 4, '/');
  17// result5 -> 0

  mergeObjects

  Combine two objects in different arrays using their shared identifier

1"with 'd' specified, you indicate that you want 'my_id' as a key to be deleted from the returned array objects";
2
3const result1 = mergeObjects(
4  [{ id: 1, name: 'Isaac', age: 20 }],
5  [{ my_id: 1, address: 'Kampala' }],
6  'id',
7  'my_id',
8  'd'
9);
10
11// output -> [{id: 1, name: 'Isaac', age: 20, address: 'Kampala'}]
12
13const result2 = mergeObjects(
14  [{ id: 1, name: 'Isaac', age: 20 }],
15  [{ my_id: 1, address: 'Kampala' }],
16  'id',
17  'my_id'
18);
19
20// output -> [{id: 1, name: 'Isaac', age: 20, my_id: 1, address: 'Kampala'}]
21
22const result3 = mergeObjects(
23  [{ id: 1, name: 'Isaac', age: 20 }],
24  [{ id: 1, address: 'Kampala' }],
25  'id',
26  'id'
27);
28// output -> [{id: 1, name: 'Isaac', age: 20, address: 'Kampala'}]
29
30const result4 = mergeObjects(
31  [{ id: 1, name: 'Isaac', age: 20 }],
32  [{ id: 1, address: 'Kampala' }],
33  'id',
34  'id',
35  'd'
36);
37// output -> [{'Isaac', age: 20, address: 'Kampala'}]

injectDupObj

Inject objects from one array with duplicate id into the main array

1const result1 = injectDupObj(
2  [
3    { id: 1, name: 'john1', age: 30 },
4    { id: 2, name: 'john2', age: 30 },
5    { id: 3, name: 'john3', age: 30 },
6    { id: 4, name: 'john4', age: 30 },
7    { id: 5, name: 'john5', age: 30 },
8  ],
9  [
10    { id: 1, user_id: 1, course: 'SST' },
11    { id: 2, user_id: 2, course: 'English' },
12    { id: 3, user_id: 1, course: 'Science' },
13    { id: 8, user_id: 1, course: 'Christianity' },
14    { id: 4, user_id: 2, course: 'Luganda' },
15    { id: 5, user_id: 3, course: 'Runyankole' },
16    { id: 6, user_id: 4, course: 'Swahili' },
17    { id: 7, user_id: 7, course: 'Luo' },
18  ],
19  'id',
20  'user_id',
21  'courses'
22);
23// lookupKey is optional, if not give, the inner array will have 'lookup' as its key
24// output
25[
26  {
27    id: 1,
28    name: 'john1',
29    age: 30,
30    courses: [
31      { id: 1, user_id: 1, course: 'SST' },
32      { id: 3, user_id: 1, course: 'Science' },
33      { id: 8, user_id: 1, course: 'Christianity' },
34    ],
35  },
36  {
37    id: 2,
38    name: 'john2',
39    age: 30,
40    courses: [
41      { id: 2, user_id: 2, course: 'English' },
42      { id: 4, user_id: 2, course: 'Luganda' },
43    ],
44  },
45  {
46    id: 3,
47    name: 'john3',
48    age: 30,
49    courses: [{ id: 5, user_id: 3, course: 'Runyankole' }],
50  },
51  {
52    id: 4,
53    name: 'john4',
54    age: 30,
55    courses: [{ id: 6, user_id: 4, course: 'Swahili' }],
56  },
57  { id: 5, name: 'john5', age: 30 },
58];

Note

• Added type definitions on version 0.1.0, if you experience any issue, runnpm i simple-fns@0.0.1 to install a previous version without types
• As well raise an issue here