This is documentation for Mathematica 5, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)

Documentation / Mathematica / Built-in Functions / Programming / Functional Programming /

NestWhileList

FilledSmallSquare NestWhileList[f, expr, test] generates a list of the results of applying f repeatedly, starting with expr, and continuing until applying test to the result no longer yields True.

FilledSmallSquare NestWhileList[f, expr, test, m] supplies the most recent m results as arguments for test at each step.

FilledSmallSquare NestWhileList[f, expr, test, All] supplies all results so far as arguments for test at each step.

FilledSmallSquare NestWhileList[f, expr, test, m, max] applies f at most max times.

FilledSmallSquare The last element of the list returned by NestWhileList[f, expr, test] is always an expression to which applying test does not yield True.

FilledSmallSquare NestWhileList[f, expr, test, m] at each step evaluates test[, , ... , ]. It does not put the results in a list.

FilledSmallSquare The are given in the order they are generated, with the most recent coming last.

FilledSmallSquare NestWhileList[f, expr, test, m] does not start applying test until at least m results have been generated.

FilledSmallSquare NestWhileList[f, expr, test, mmin, m] does not start applying test until at least mmin results have been generated. At each step it then supplies as arguments to test as many recent results as possible, up to a maximum of m.

FilledSmallSquare NestWhileList[f, expr, test, m] is equivalent to NestWhileList[f, expr, test, m, m].

FilledSmallSquare NestWhileList[f, expr, UnsameQ, 2] is equivalent to FixedPointList[f, expr].

FilledSmallSquare NestWhileList[f, expr, test, All] is equivalent to NestWhileList[f, expr, test, 1, Infinity].

FilledSmallSquare NestWhileList[f, expr, UnsameQ, All] goes on applying f until the same result first appears more than once.

FilledSmallSquare NestWhileList[f, expr, test, m, max, n] applies f an extra n times, appending the results to the list generated.

FilledSmallSquare NestWhileList[f, expr, test, m, max, -n] drops the last n elements from the list generated.

FilledSmallSquare See Section 2.2.2.

FilledSmallSquare See also: NestWhile, FixedPointList, NestList, While.

FilledSmallSquare New in Version 4.

Further Examples