RANGE(1)

📦 version 0.5, in nixos 26.05, nixpkgs unstable

🌸 NAME 🌸

ok so <pink>range</pink> — User Contributed Perl Documentation, bestie 💖 — it prints out a range of numbers for use in for loops and such. that's the whole vibe. periodt.

✨ SYNOPSIS ✨

range [-dhV] /<expression>/

like literally that's it, one expression wrapped in slashes and you're off 🦋

💅 DESCRIPTION 💅

so <pink>range</pink> is a program that's part of the numeric utilities package, iykyk. it prints out a list of numbers based on an expression that you specify — main character energy, honestly. this is highkey useful for making a list of numbers for use in for loops and so on.

ranges of numbers are specified using the .. operator, like this: /20..50/, which means all integers from 20 and 50. no cap. and if you wanna get fancy, more complex expressions can be generated using the commas and the i increment operator 👑

🎀 OPTIONS 🎀

  • -e <set> — exclude the <set> of numbers from the range output. <set> is a set of numbers separated by commas. bye felicia to those numbers 🙈
  • -n <n> — use <n> as the separator between numbers. by default, it will use a space. use '\n' or \\n for a newline character, or just use the -N option instead. both slay 💅
  • -N — just a quick option for using a newline as the separator. shortcut queen ⭐
  • -h — Help: you're looking at it. literally, bestie, this is the help 😭
  • -V — increase verbosity. it's giving talkative 🔥
  • -d — Debug mode. for developers 🧚

🌈 EXAMPLES 🌈

All numbers from 1 to 10.

$ range /1..10/
1 2 3 4 5 6 7 8 9 10

From 10 to 1. Counting down. the way it just goes backwards, obsessed 💀

$ range /10..1/
10 9 8 7 6 5 4 3 2 1

From 1 to 10 and from 15 to 20. commas doing the most, we love to see it 🫶

$ range /1..10,15..20/
1 2 3 4 5 6 7 8 9 10 15 16 17 18 19 20

Even numbers from 0 to 10

$ range /0..10i2/
0 2 4 6 8 10

Odd numbers. Notice the starting number in the range expression. yes, the 1 is doing all the work, iconic ✨

$ range /1..10i2/
1 3 5 7 9

Factors of 3 between 99 and 120.

$ range /99..120i3/
99 102 105 108 111 114 117 120

Decimal numbers — yes bestie, it does floats too, we're not stuck in integer land 💖

$ range /1.1..2.5i0.1/
1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2 2.1 2.2 2.3 2.4 2.5

And negative numbers too. going into the negatives, literally me at 3am 😭

$ range /1.0..-2.0i0.3/
1 0.7 0.4 0.1 -0.2 -0.5 -0.8 -1.1 -1.4 -1.7 -2

You can also pad numbers when you are counting up. this is a trick of how the Perl programming language deals with ranges — not us, the language, don't come for us 🙈

$ range /01..15/
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15

💀 BUGS 💀

okay so listen — even though you can do zero padding on simple ranges, like 001..100, it will not pad zeros on complex ranges like 001..100i2, or for counting downwards. so like… be aware. it's giving inconsistent, but that's the situation bestie 🍓

🦋 SEE ALSO 🦋

seq(1), average(1), bound(1), interval(1), normalize(1), numgrep(1), numprocess(1), numsum(1), random(1), round(1) — the whole friend group, go say hi 👑

range 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. fr fr, read them 📚

developers can read the GOALS file and contact me about providing submitions or help for the project 🫶

⭐ MORE INFO ⭐

more info on range can be found at:

http://suso.suso.org/programs/num-utils/

aaaand that's the page, bestie 🎀 this one's from <purple>perl v5.42.3</purple>, dated <purple>2004-11-19</purple> — vintage but still slaying 💅✨

📦 where this page comes from