@compactjs/cap
v1.1.0
Published
Caps a value when out of a defined range
Downloads
13
Maintainers
Readme
Table of Contents
What it does
@compactjs/cap limits any number to a given range. Similar to @compactjs/limit but caps it when out of range.
Install
NPM:
npm install @compactjs/cap
Or download manually: https://unpkg.com/@compactjs/cap/dist/index.umd.js
Usage
As module:
import { cap } from '@compactjs/cap';
Else:
const { cap } = cap;
Example:
const min = 1;
const max = 5;
cap(7, min, max); // returns: 5
cap(3, 0, 6); // returns: 3
cap(-5, 1, -4); // returns: -4
Function declaration
/**
* Limits value to range from min to max.
* If max is omitted min will be used as max, without a min range limit.
* @value value to limit
* @min minimum value
* @max maximum value (optional)
*/
function cap(value: number, min: number, max?: number): number;
Run tests
npm run test
Contact
👤 Timo Bechtel
- Website: https://timobechtel.com
- Twitter: @TimoBechtel
- GitHub: @TimoBechtel
🤝 Contributing
Contributions, issues and feature requests are welcome!
- Check issues
- Fork the Project
- Create your Feature Branch (
git checkout -b feat/AmazingFeature
) - Test your changes
npm run test
- Commit your Changes (
git commit -m 'feat: add amazingFeature'
) - Push to the Branch (
git push origin feat/AmazingFeature
) - Open a Pull Request
Commit messages
This project uses semantic-release for automated release versions. So commits in this project follow the Conventional Commits guidelines. I recommend using commitizen for automated commit messages.
Show your support
Give a ⭐️ if this project helped you!
📝 License
Distributed under the MIT License.
This README was generated with ❤️ by readme-md-generator