---
name: "numround"
section: "1"
platform: "linux"
package: "num-utils"
version: "0.5-15"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/numround"
---

# numround(1)

A program that rounds off numbers it encounters.

## NAME

numround - A program that rounds off numbers it encounters.

## SYNOPSIS

**numround** \[-cdfhV\] \<FILE\>

\| **numround** \[-cdfhV\]   (Input on STDIN from pipeline.)

**numround** \[-cdfhV\]     (Input on STDIN.  Use Ctrl-D to stop.)

## DESCRIPTION

**numround** will simply round decimal numbers to the nearest integer or to a factor of any number using the -n option.  You can also force it to round up (ceiling) or round down(floor) using the -c and -f options.

## OPTIONS

```
    -c      Force the number to be rounded up. Ceiling.
    -f      Force the number to be rounded down. Floor.
    -n <n>  Round numbers to the nearest factor of <n>.
    -h      Print out some helpful information about numround.
    -V      Increase verbosity.  This will print out numbers as it finds them.
    -d      Debug mode.  For developers only.
```

## BUGS

**numround** currently only rounds the first number on each line.  Eventually this will be changed as all the numeric utilities are developed.

**numround** will drop off the decimal places in decimal numbers.  This may cause some calculations to be in error, depending on how you are using the data.

## SEE ALSO

[**numaverage**(1)](/numaverage/1.md), [**numbound**(1)](/numbound/1.md), [**numinterval**(1)](/numinterval/1.md), [**numnormalize**(1)](/numnormalize/1.md), [**numgrep**(1)](/numgrep/1.md), [**numprocess**(1)](/numprocess/1.md), [**numsum**(1)](/numsum/1.md), [**numrandom**(1)](/numrandom/1.md), [**numrange**(1)](/numrange/1.md)

## COPYRIGHT

numround is part of the num-utils package, which is copyrighted by Suso Banderas and released under the GPL license.  Please read the COPYING and LICENSE files that came with the num-utils package

```
  Developers can read the GOALS file and contact me about providing
submitions or help for the project.
```

## MORE INFO

More info on numround can be found at:

- **http://suso.suso.org/xulu/Num-utils**