# NAME
Math::Round::SignificantFigures - Perl package for rounding numbers to a specified number of Significant Figures
# SYNOPSIS
use Math::Round::SignificantFigures qw{roundsigfigs};
print roundsigfigs(555.555, 3), "\n";
# DESCRIPTION
Math::Round::SignificantFigures supplies functions that will round numbers based on significant figures.
This package spans the controversy whether people prefer to call significant figures or significant digits. You may export either or both but, I called the package significant figures since that is the page for Wikipedia.
# FUNCTIONS
The exporter group :figs exports the roundsigfigs, ceilsigfigs, floorsigfigs functions. The exporter group :digs exports the roundsigdigs, ceilsigdigs, floorsigdigs functions. The exporter group :all exports all six functions
## roundsigfigs, roundsigdigs
Rounds a number given the number and a number of significant figures.
## floorsigfigs, floorsigdigs
Rounds a number toward -inf given the number and a number of significant figures.
## ceilsigfigs, ceilsigdigs
Rounds a number toward +inf given the number and a number of significant figures.
# SEE ALSO
[Math::Round](https://metacpan.org/pod/Math::Round) supplies functions that will round numbers in different ways.
[Math::SigDig](https://metacpan.org/pod/Math::SigDig) allows you to edit numbers to a significant number of digits.
[https://en.wikipedia.org/wiki/Significant\_figures#Rounding\_to\_significant\_figures](https://en.wikipedia.org/wiki/Significant_figures#Rounding_to_significant_figures)
[https://stackoverflow.com/questions/202302/rounding-to-an-arbitrary-number-of-significant-digits](https://stackoverflow.com/questions/202302/rounding-to-an-arbitrary-number-of-significant-digits)
# AUTHOR
Michael R. Davis, MRDVT
# COPYRIGHT AND LICENSE
MIT LICENSE
Copyright (C) 2022 by Michael R. Davis