Add method trap()->return()

[roxblnfk]

What was changed

Add method trap()->return()

    /**
     * Send the dump if possible and then return the dumped value immediately.
     *
     * @param int|string $key Position in the value sequence (0-based) or name of the named argument.
     *
     * ```php
     * trap(42)->return(); // 42
     * trap(count: 42, value: 90)->return('value'); // 90
     * trap(foo: 'bar')->return(0); // 'bar'
     * trap()->return(); // exception
     * ```
     */
    public function return(int|string $key = 0): mixed

Why?

Sometimes you have to dump the argument value, which is calculated and not stored in a variable. In such cases, you have to extract the code into a separate variable, which is not very convenient. It's easier to wrap the value with trap( <value> )->return().

Checklist

• Tests
• Documentation