# 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