Skip to content
Topazdocs
6.05.21

Search documentation

Specification 6.0

Use arrow keys to choose a result. Press Enter to open.

Type an API name, diagnostic number, rule, or project topic.

    Download →

    Diagnostics

    Diagnostic TPZ5027

    A mutator changed a value without a root binding, and its result is discarded.

    What TPZ5027 means

    Discarded mutation of a temporary

    Family
    topaz
    Phase
    check
    Code
    TPZ5027

    Cause and conditions

    A mutator call on a value without a root binding produces TPZ5027 when its result is discarded. Taking a mutator method as a value produces TPZ5028. A mutation through an immutable root produces TPZ5003.

    PositionResult consumption
    Expression statement, let _ = E, normal tail of defer, tail of a for or while bodyDiscarded
    Parentheses, block, normal result of if with else, or matchInherits the parent position
    Then tail of if without elseDiscarded regardless of the parent
    Explicit return, function or lambda return tailUsed at that function boundary
    Named binding initializer, argument, condition, operator operand, or receiverUsed

    On the same access or call, TPZ5028 takes priority over TPZ5003, which takes priority over TPZ5027. Errors in other subexpressions, the existing optional-assignment prohibition, and import-reassignment diagnostics remain visible. Whether a named binding is later read, or a caller uses a returned value, is not tracked.

    Response

    Use the result, or bind the value with let mut before changing it.

    Compiler phase: check. The primary location is the mutator call expression.

    The change has no observable owner or retained result.

    A mutator call on a value without a root binding is rejected when the language discards its result.

    How to fix it

    Use the result, or bind the value with let mut before changing it.

    Examples

    Rejected mutator use

    example.tpzRejected mutator useOpen in Playground →
    1. [1, 2].push(3)
    Expected outputNonzero exit
    $ topaz check example.tpz
    Expected result

    Expected result

    Rejection during check. Nonzero exit.

    The required primary-location contract is Pending.

    Accepted repair

    example.tpzAccepted repairOpen in Playground →
    1. let mut xs = [1, 2]
    2. xs.push(3)
    Expected outputExit code 0
    $ topaz check example.tpz
    Expected result

    Expected result

    Checking accepts the program. Exit code 0.