CURSOR/FIRST

Sets the cursor at the first key value

Input stack: cursor

Output stack: b

If there is a first key/value pair in the database, 1 will be pushed onto the stack and the cursor will be moved. Otherwise, 0 will be pushed and the cursor will not be moved.

PumpkinDB> ["1" "2" ASSOC COMMIT] WRITE [CURSOR CURSOR/FIRST] READ
1

Allocation

Allocates for values to be put onto the stack

Errors

NoTransaction error if there's no current write transaction

InvalidValue error if the cursor identifier is incorrect or expired

Tests

works : ["1" "2" ASSOC COMMIT] WRITE [CURSOR DUP CURSOR/FIRST SWAP CURSOR/KEY "1" EQUAL? AND] READ.
requires_txn : ["1" CURSOR/FIRST] TRY UNWRAP 0x08 EQUAL?.
empty_stack : [[CURSOR/FIRST] TRY] READ UNWRAP 0x04 EQUAL?.
invalid_cursor : [["1" CURSOR/FIRST] READ] TRY UNWRAP 0x03 EQUAL?.

results matching ""

    No results matching ""