range.1.html

<!DOCTYPE html>
<html>
<head>
    <title>Caltech Library's Digital Library Development Sandbox</title>
    <link href='https://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css'>
    <link rel="stylesheet" href="/css/site.css">
</head>
<body>
<header>
<a href="http://library.caltech.edu"><img src="/assets/liblogo.gif" alt="Caltech Library logo"></a>
</header>
<nav>
<ul>
	<li><a href="/">Home</a></li>
	<li><a href="./">README</a></li>
	<li><a href="LICENSE">LICENSE</a></li>
	<li><a href="INSTALL.html">INSTALL</a></li>
	<li><a href="user-manual.html">User Manual</a></li>
	<li><a href="how-to/">Tutorials</a></li>
    <li><a href="search.html">Search Docs</a></li>
	<li><a href="about.html">About</a></li>
	<li><a href="https://github.com/caltechlibrary/datatools">GitHub</a></li>
</ul>
</nav>

<section>
<h1 id="name">NAME</h1>
<p>range</p>
<h1 id="synopsis">SYNOPSIS</h1>
<p>range <a href="#options">OPTIONS</a> START_INTEGER END_INTEGER
[INCREMENT_INTEGER]</p>
<h1 id="description">DESCRIPTION</h1>
<p>range is a simple utility for shell scripts that emits a list of
integers starting with the first command line argument and ending with
the last integer command line argument. It is a subset of functionality
found in the Unix seq command.</p>
<p>If the first argument is greater than the last then it counts down
otherwise it counts up.</p>
<h1 id="options">OPTIONS</h1>
<dl>
<dt>-help</dt>
<dd>
display help
</dd>
<dt>-license</dt>
<dd>
display license
</dd>
<dt>-version</dt>
<dd>
display version
</dd>
<dt>-e, -end</dt>
<dd>
The ending integer.
</dd>
<dt>-inc, -increment</dt>
<dd>
The non-zero integer increment value.
</dd>
<dt>-nl, -newline</dt>
<dd>
if true add a trailing newline
</dd>
<dt>-quiet</dt>
<dd>
suppress error messages
</dd>
<dt>-random</dt>
<dd>
Pick a range value from range
</dd>
<dt>-s, -start</dt>
<dd>
The starting integer.
</dd>
</dl>
<h1 id="examples">EXAMPLES</h1>
<p>Create a range of integers one through five</p>
<pre><code>    range 1 5</code></pre>
<p>Yields 1 2 3 4 5</p>
<p>Create a range of integer negative two to six</p>
<pre><code>    range -- -2 6</code></pre>
<p>Yields -2 -1 0 1 2 3 4 5 6</p>
<p>Create a range of even integers two to ten</p>
<pre><code>    range -increment=2 2 10</code></pre>
<p>Yields 2 4 6 8 10</p>
<p>Create a descending range of integers ten down to one</p>
<pre><code>    range 10 1</code></pre>
<p>Yields 10 9 8 7 6 5 4 3 2 1</p>
<p>Pick a random integer between zero and ten</p>
<pre><code>    range -random 0 10</code></pre>
<p>Yields a random integer from 0 to 10</p>
<p>range 1.2.1</p>
</section>

<footer>
<span><h1><A href="http://caltech.edu">Caltech</a></h1></span>
<span>&copy; 2023 <a href="https://www.library.caltech.edu/copyright">Caltech library</a></span>
<address>1200 E California Blvd, Mail Code 1-32, Pasadena, CA 91125-3200</address> 
<span>Phone: <a href="tel:+1-626-395-3405">(626)395-3405</a></span>
<span><a href="mailto:library@caltech.edu">Email Us</a></span>
<a class="cl-hide" href="sitemap.xml">Site Map</a>
</footer>
</body>
</html>