2.0.1 • Published 2 years ago

west-pad v2.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

west-pad

Behold, a far superior alternative to left-pad.

Inserts padding to the West of a string.

Install

npm install west-pad

Usage

  1. First grab the cardinal direction from your device. This direction can be the cardinal char value or a number value representing degrees from North.
type Direction = "N" | "S" | "E" | "W" | number;
  1. west-pad exports a class to hold cardinal state for your repeated padding convenience
import WestPad from 'west-pad';

const direction = getDeviceDirection(); // "N" or 0
const westPad = new WestPad(direction);

const s = "Hello World";

console.log(westPad(s)); // " Hello World"

console.log(westPad(s, 5)); // "     Hello World"

console.log(westPad(s, 5, "+")); // "+++++Hello World"

const newDirection = "E";
westPad.updateDirection(newDirection);

console.log(westPad(s, 2)); // "Hello World\n \n"
  1. alternatively you can use the standalone function
import { westPad } from 'west-pad';

const direction = getDeviceDirection(); // "N"
const s = "Hello World";

console.log(westPad(direction, s, 3)); // "   Hello World"
console.log(westPad("S", s, 3, "+")); // "Hello World+++"
console.log(westPad(220, s, 3)); // " \n \n \nHello World"

What if I want to East pad?

Don't worry, west-pad has you covered. There is both a class method and a standalone function for you East-ers!

import WestPad from 'west-pad';

const direction = "N";
const s = "Hello World";

const westPad = new WestPad(direction);

const paddedEastFromMethod = westPad.turnAroundThenPad(s, 3);
console.log(paddedEastFromMethod); // "Hello World   "
import { notWestPad } from 'west-pad';

const direction = "N";
const s = "Hello World";

const paddedEast = notWestPad(direction, s, 3);
console.log(paddedEast); // "Hello World   "

Troubleshooting

Padding is being added in the wrong direction?

Step 1. Try turning your computer/device in a different direction.
Step 2. Profit

Parameters

Class constructor

ParamTypeRequiredDescription
directionDirection or numberyes"N", "S", "E" or "W", or a number representing degrees from North

Class Method updateDirection

ParamTypeRequiredDescription
directionDirection or numberyes"N", "S", "E" or "W", or a number representing degrees from North

Class Method pad

ParamTypeRequiredDescription
sstringyesthe target string to pad
multiplicandnumberno; default = 1the number of times parameter p will be padded
pstringno; default = " "the string that will pad target string s multiplicand times

Class Method turnAroundThenPad

ParamTypeRequiredDescription
sstringyesthe target string to pad
multiplicandnumberno; default = 1the number of times parameter p will be padded
pstringno; default = " "the string that will pad target string s multiplicand times

Function westPad

ParamTypeRequiredDescription
directionDirection or numberyes"N", "S", "E" or "W", or a number representing degrees from North
sstringyesthe target string to pad
multiplicandnumberno; default = 1the number of times parameter p will be padded
pstringno; default = " "the string that will pad target string s multiplicand times

Function notWestPad

ParamTypeRequiredDescription
directionDirection or numberyes"N", "S", "E" or "W", or a number representing degrees from North
sstringyesthe target string to pad
multiplicandnumberno; default = 1the number of times parameter p will be padded
pstringno; default = " "the string that will pad target string s multiplicand times
2.0.1

2 years ago

2.0.0

2 years ago

1.1.0

2 years ago

1.0.0

2 years ago

0.1.0

2 years ago