insert-tuple ( tuple -- )
High-level tuple/database integration » High-level tuple/database words

Prev:	drop-table ( class -- )
Next:	update-tuple ( tuple -- )

Vocabulary
db.tuples

Inputs

tuple

a tuple

Outputs
None

Word description
Inserts a tuple into a database if a relation has been defined with define-persistent. If a mapping states that the database assigns a primary key to the tuple, this value will be set after this word runs.

Notes
Objects should only be inserted into a database once per object. To store the object after the initial insert, call update-tuple.

See also
update-tuple, update-tuples, delete-tuples, reject-tuples

Definition

USING: classes db.tuples.private db.types kernel ;

IN: db.tuples

: insert-tuple ( tuple -- )
    dup class-of ensure-defined-persistent db-assigned?
    [ insert-db-assigned-statement ]
    [ insert-user-assigned-statement ] if ;