Skip to main content

ValueLoop - chart function

ValueLoop() returns a set of iterated values which, when used in a calculated dimension, will form a synthetic dimension.

The values generated will start with the from value and end with the to value including intermediate values in increments of step.

Information noteIn charts with a synthetic dimension created with the ValueLoop function it is possible to reference the dimension value corresponding to a specific expression cell by restating the ValueLoop function with the same parameters in the chart expression. The function may of course be used anywhere in the layout, but apart from when used for synthetic dimensions it will only be meaningful inside an aggregation function.
Information noteSynthetic dimensions are not affected by selections.

Syntax:  

ValueLoop(from [, to [, step ]])

Return data type: dual

Arguments:  

Arguments
Arguments Description
from Start value in the set of values to be generated.
to End value in the set of values to be generated.
step Size of increment between values.

Examples and results:  

Function examples
Example Result
ValueLoop(1, 10)

This creates a dimension in a table, for example, that can be used for purposes such as numbered labeling. The example here results in values numbered 1 to 10. These values can then be referenced in an expression.

ValueLoop(2, 10,2)

This example results in values numbered 2, 4, 6, 8, and 10 because the argument step has a value of 2.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!