db.setValue
| Syntax |
db.setValue (f, path, value)
|
| 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 store information. value is the value you want to store in the location indicated by path.
|
| Action |
Stores the value in the location indicated by path.
|
| Returns |
True.
|
| Examples |
db.setValue ("System:Frontier:old.root", "examples.age", 29) // wishful thinking » true
db.setValue ("System:Frontier:old.root", "examples.haircolor", {31, 99, 104})
db.setValue ("System:Frontier:old.root", "examples.1234", 0)
|
| Notes |
The database file specified in the parameter "f" must be opened using db.open before calling this verb. db.setValue can store non-scalar values like tables and outlines. path can be a full or partial database address; the paths table of the target database is used to interpret it. As with normal assignments in Frontier, the location indicated by path must be contained by an existing table. The cell itself may or may not already exist. db.setValue (f, path, x) is equivalent to path^ = x 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
|
