idiv: Dividing Iterator

In iterators: Provides Iterator Construct

Description

Returns an iterator that returns pieces of numeric value.

Usage

idiv(n, ..., chunks, chunkSize)

Arguments

n	number of times that the iterator will fire. If not specified, it will count forever.
...	unused.
chunks	the number of pieces that n should be divided into. This is useful when you know the number of pieces that you want. If specified, then chunkSize should not be.
chunkSize	the maximum size of the pieces that n should be divided into. This is useful when you know the size of the pieces that you want. If specified, then chunks should not be.

Value

The dividing iterator.

Examples

  # divide the value 10 into 3 pieces
  it <- idiv(10, chunks=3)
  nextElem(it)
  nextElem(it)
  nextElem(it)
  try(nextElem(it))  # expect a StopIteration exception

  # divide the value 10 into pieces no larger than 3
  it <- idiv(10, chunkSize=3)
  nextElem(it)
  nextElem(it)
  nextElem(it)
  nextElem(it)
  try(nextElem(it))  # expect a StopIteration exception

Example output

[1] 4
[1] 3
[1] 3
Error : StopIteration
[1] 3
[1] 3
[1] 2
[1] 2
Error : StopIteration

iterators documentation built on Feb. 5, 2022, 1:06 a.m.