Documentation

Statements

A statement controls execution.

Statement      = [ Attributes ] StatementInner .
StatementInner = OptionAssignment
                | BuiltinStatement
                | VariableAssignment
                | ReturnStatement
                | ExpressionStatement
                | TestcaseStatement .
  • Copy
  • Fill window

Return statements

A terminating statement prevents execution of all statements that appear after it in the same block. A return statement is a terminating statement.

ReturnStatement = "return" Expression .
  • Copy
  • Fill window

Expression statements

An expression statement is an expression where the computed value is discarded.

ExpressionStatement = Expression .
  • Copy
  • Fill window
Examples of expression statements
1 + 1
f()
a
  • Copy
  • Fill window

Testcase statements

A testcase statement defines a test case.

Testcase statements only work within the context of a Flux development environment.

TestcaseStatement = "testcase" identifier [ TestcaseExtention ] Block .
TestcaseExtention = "extends" string_lit
  • Copy
  • Fill window

Test cases are defined as a set of statements with special scoping rules. Each test case statement in a file is considered to be its own main package. In effect, all statements in package scope and all statements contained within the test case statement are flattened into a single main package and executed. Use the testing package from the standard library to control the pass failure of the test case.

Test extension augments an existing test case with more statements or attributes. A special function call, super(), must be made inside the body of a test case extension. All statements from the parent test case will be executed in its place.

Basic testcase for addition
import "testing"

testcase addition {
    testing.assertEqualValues(got: 1 + 1, want: 2)
}
  • Copy
  • Fill window
Example testcase extension to prevent feature regression
@feature({vectorization: true})
testcase vector_addition extends "basics_test.addition" {
    super()
}
  • Copy
  • Fill window

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

New in InfluxDB 3.2

Key enhancements in InfluxDB 3.2 and the InfluxDB 3 Explorer UI is now generally available.

See the Blog Post

InfluxDB 3.2 is now available for both Core and Enterprise, bringing the general availability of InfluxDB 3 Explorer, a new UI that simplifies how you query, explore, and visualize data. On top of that, InfluxDB 3.2 includes a wide range of performance improvements, feature updates, and bug fixes including automated data retention and more.

For more information, check out: