Xbasic

DICTIONARY.CREATE Function

Syntax

as P = Create([C data_dictionary_name[,N file_open_mode]])

Arguments

data_dictionary_name

The name of the dictionary to create.

file_open_mode

Optional. Determines the access privileges that apply to the open table file. You can use one of the following system variables:

Variable: Function
FILE_RO_EXCLUSIVE: Read Only (Exclusive)
FILE_RW_EXCLUSIVE: Read or Write (Exclusive)
FILE_RO_SHARED: Read Only (Shared)
FILE_RW_SHARED: Read or Write (Shared)
FILE_REUSE_EXISTING: Intended for internal use only. Allows you to create another pointer to an open file.

Description

Create a new data dictonary.

Discussion

The DICTIONARY.CREATE() method creates a new data dictionary and returns a table pointer to the new file.

Example

dim tbl as P
tbl = dictionary.create("New_Dict",FILE_RW_EXCLUSIVE)
? tbl.name_get()
= "New_Dict"