Wed 29 April 2020 2 min(s)

Check out vcmpad's latest documentation at https://github.com/dalikewara/vcmpad

npm package

versionbuildlanguagedownloaddependentsissuelast_commitlicense

Fast, lightweight, and customable string padding generator

String padding generator with custom Left/Right-Padding style. It allows you to generate string padding format such as LPS (Left Padding Space), LPZ (Left Padding Zero), RPS (Right Padding Space), and RPZ (Right Padding Zero)—or even you can create your own custom format.

Installation

NPM

npm install vcmpad --save

Browser

// Bower
bower install vcmpad --save

Initialization

NPM

const vcmpad = require('vcmpad');

Browser

// Bower
<script src="bower_components/vcmpad/dist/vcmpad.min.js"></script>

Quickstart

There are two basic functions (vcmpad.left and vcmpad.right) to create String-Padding format using vcmpad, and they're absolutelly easy to use.

vcmpad.left(n, val, format[optional], direction[optional]);

Left-Padding

A simple LPS format can be done like this:

var str = vcmpad.left(10, 'test');

console.log(str); // output '      test'

Next, you may try to make other Left-Padding combinations, for example:

vcmpad.left(10, 'test', '0'); // output '000000test'

vcmpad.left(10, 'test', 'left'); // output 'leftleftle'

vcmpad.left(10, 'test', 'left', false); // output 'ftlefttest'

vcmpad.left(10, 'test1234567890'); // output 'test123456'

Right-Padding

A simple RPS format can be done like this:

var str = vcmpad.right(10, 'test');

console.log(str); // output 'test      '

Next, you may try to make other Right-Padding combinations, for example:

vcmpad.right(10, 'test', '0'); // output 'test000000'

vcmpad.right(10, 'test', 'right'); // output 'testrightr'

vcmpad.right(10, 'test', 'right', false); // output 'rightright'

vcmpad.right(10, 'test1234567890'); // output 'test123456'

Direction

The direction argument gives you option where string position should be returned if length of result or value higger than the number of n argument—basicly, it is first n length characters or last n length charatecrs.

vcmpad.left(10, 'test1234567890'); // output 'test123456'

vcmpad.left(10, 'test1234567890', false); // output '1234567890'

vcmpad.left(10, 'test', 'left'); // output 'leftleftle'

vcmpad.left(10, 'test', 'left', false); // output 'ftlefttest'

Release

Changelog

See https://github.com/dalikewara/vcmpad/blob/master/CHANGELOG.md.

Credits

Copyright © 2019 Dali Kewara.

License

MIT License

Cover image

Article history:

>> Friday 08:41 PM, May 01 2020 | "add articles description"
>> Thursday 07:10 PM, April 30 2020 | "update scripts"