Command: dbinsert

Syntax

dbinsert <ident> {,<ident> }

Description

Insert a new row entry in a database from the local copy of dbstructure values.

Parameters

• <ident>
  Existing identifier(s). They must be dbstructure-type identifiers. Wild names are permitted to facilitate multiple inserts.

Switches

• -ty=<type>
  Insert only the identifier(s) of the indicated identifier <type>.

Notes

dbinsert writes all elements of a dbstructure-type identifier to the database.

The key corresponding to the dbstructure object (i.e. <ident>.key) is ignored by this command, but may be set after the data has been inserted into the external database. If <ident> is not an array and the database has a “unique rowid” row insertion system, then the key is set to point to the newly inserted row. Otherwise the key is set to undefined.

Example

Insert a dbstructure into the database.

person.name = 'Elephants Gerald'
person.phone = '555-5709'
dbinsert person

See Also