db.newTable

Syntax db.newTable (f, path)

Params f is a filespec or path string of a Frontier object database file that has been opened with db.open.

path is a valid UserTalk address string, indicating the location in the database where you want to create a table.

Action Creates a table in the location indicated by path, replacing the existing value, if any.

Returns True.

Examples db.newTable ("System:Frontier:old.root", "scratchpad.testTable")

   » true

db.newTable ("System:Frontier:old.root", "scratchpad") // replaces existing scratchpad

   » true

Notes The database file specified in the parameter "f" must be opened using db.open before calling this verb.

path can be a full or partial database address; the paths table of the target database is used to interpret it.

The location indicated by path must be contained by an existing table. The cell itself may or may not already exist.

db.newTable (f, path) is equivalent to new (tableType, path) when referring to Frontier's current object database.

To save changes you make to a database, you must call db.save before db.close.

See Also db.open

db.setValue

db.isTable

new

Discuss