NUMPROCESS(1)

📦
version 0.5 · 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

💖 NUMPROCESS(1) 💖

okay bestie, welcome to the User Contributed Perl Documentation section, this is numprocess and she is literally the glow-up artist for numbers ✨

🌸 NAME 🌸

numprocess — this program mutates numbers as it encounters them. no cap, it just grabs every number it sees and ✨transforms✨ it.

🦋 SYNOPSIS 🦋

numprocess [-dhV] /<expression>/ [FILE or STDIN]

| numprocess [-dhV] /<expression>/  (Input on STDIN from pipeline.)

numprocess [-dhV] /<expression>/    (Input on STDIN.  Use Ctrl-D to
stop.)

so you can feed her a file, pipe into her, or just vibe at the terminal and hit Ctrl-D when you're done 🫶

🎀 DESCRIPTION 🎀

numprocess takes, as one argument, a list of operations to be performed on the numbers she encounters. she does those operations on each number and drops the result back in place of the original number. like a makeover but for digits 💅

🌈 USAGE EXAMPLES 🌈

Add 1 to all numbers.

$ numprocess /+1/ file1

Convert all numbers from miles to kilometers. Multiply by 8 and divide by 5.

$ cat file1 | numprocess /*8,%5/

Convert from celcius to fahreheit degrees. Multiply by 9, divide by 5 and add 32.

$ numprocess /*9,%5,+32/ temperatures

Find the area of each circle from the given radius.

$ numprocess /^2,*pi/ radii

👑 KEYWORDS AND OPERATORS 👑

For operators, the modifying number goes directly after the operator, with the exception of functions like sqrt, sin, cos, etc.

  • + — Addition
  • - — Subtraction
  • * — Multiplication
  • % — Division
  • ^ — Power function
  • sqrt — Square Root (*)
  • sin — Sine function
  • cos — Cosine function

Constants and keywords that can be used:

  • pi — 3.141592654
  • e — 2.718281828
(*) When using the sqrt operation on negative numbers, it will take the absolute value of the number, sqrt it and then tack an i on the end of the result to signify that the resulting number is imaginary. iconic behaviour honestly 🧚

✨ OPTIONS ✨

  • -h — Help: You're looking at it. hi bestie 👋
  • -V — Increase verbosity.
  • -d — Debug mode. For developers 🔥

💜 SEE ALSO 💜

numaverage(1), numbound(1), numinterval(1), numnormalize(1), numgrep(1), numsum(1), numrandom(1), numrange(1), numround(1)

the whole friend group fr fr 🫶

💀 BUGS 💀

There is currently no way to take the number found in the text stream and use it as the numerator instead of the denominator of a division operation.

Workaround: https://bugs.debian.org/553913

not me crying over a numerator 😭

numprocess 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 numprocess can be found at:

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

okay that's the whole page bestie, ily, go mutate some numbers 💖

this was brought to you by perl v5.30.3, dated 2020-06-09, and the NUMPROCESS(1) manual — stay slay, stay processing 🎀✨

📦 where this page comes from