WOLFRAM

Wolfram Language & System Documentation Center

"Range" (Incremental Object)

IncrementalObject["Range"][imax]

creates an object that incrementally returns the values 1, 2, …, imax.

IncrementalObject["Range"] [imin,imax]

creates an object that incrementally returns the values imin, …, imax.

IncrementalObject["Range"] [imin,imax,di]

creates an object that incrementally returns the values that use step di.

Details

  • A "Range" incremental object is useful as a source of numerical values that start with imin, successively adding di until the result is greater than imax.
  • The following functions are also supported:
  • dsi===dsjTrue, if dsi equals dsj
    FullForm[ds]full form of ds
    InputForm[ds]input form of ds

Examples

open all close all

Basic Examples  (3)

Create a new "Range" incremental object:

Wolfram Language code: obj = IncrementalObject["Range"][2]

The first value:

Wolfram Language code: NextValue[obj]

The next value:

Wolfram Language code: NextValue[obj]

There are no more values, and a failure object is returned:

Wolfram Language code: NextValue[obj]

If imin is given this is the first value:

Wolfram Language code: obj = IncrementalObject["Range"][10, 15]; NextValue[obj]

If di is given this used an increment for the values:

Wolfram Language code: obj = IncrementalObject["Range"][1, 15, 2]; NextValue[obj]; NextValue[obj]

Scope  (5)

An incremental object can be used in Table:

Wolfram Language code: obj = IncrementalObject["Range"][5]; Table[e, {e, obj}]

An incremental object can be used in Do:

Wolfram Language code: obj = IncrementalObject["Range"][2]; Do[Echo[e], {e, obj}]

The sequence of incremental values may be long and need to be terminated:

Wolfram Language code: obj = IncrementalObject["Range"][2^30]; TimeConstrained[Do[max = e, {e, obj}], 1]; max

A "Range" incremental object can be used as a source for other incremental objects:

Wolfram Language code: obj = IncrementalObject["Select"][IncrementalObject["Range"][1000], PrimeQ];

Return a list of prime numbers found in the first 1000 integers:

Wolfram Language code: Table[e, {e, obj}]

A "Range" incremental object uses less memory than the equivalent Range:

Wolfram Language code: MaxMemoryUsed[obj = IncrementalObject["Range"][1000];Do[e, {e, obj}]]
Wolfram Language code: MaxMemoryUsed[obj = Range[1000];Do[e, {e, obj}]]

Properties & Relations  (2)

InputForm  (1)

InputForm returns the serialized contents of a "Range" incremental object:

Wolfram Language code: InputForm[IncrementalObject["Range"][2, 5, 2]]

This serialized form can be used to recreate the incremental object:

Wolfram Language code: IncrementalObject["Range", {"Iterator" :> {2, 5, 2}, "Count" :> 0}]

SameQ  (1)

SameQ can be used to test whether two incremental objects contain the same sequence at the same position:

Wolfram Language code: obj1 = IncrementalObject["Range"][10]; obj2 = IncrementalObject["Range"][10]; obj1 === obj2

If one objects moves to the next value, the two objects are no longer the same:

Wolfram Language code: NextValue[obj1]; obj1 === obj2

Advancing the other object means that they are both now the same:

Wolfram Language code: NextValue[obj2]; obj1 === obj2