VECCreateLayer()

Description

VECCreateLayer() is used to create a new vector layer (segment) on the indicated database.

Call Signature

int VECCreateLayer ( int/string filespec [, string layer_name [, string layer_desc [, string options] ] ] )

Return Value

int

The layer number of the new layer. -1 is returned if the layer cannot be created.

Arguments

int/string filespec:

This can either be the handle returned by DBOpen(), or the name of an open file.

[ string layer_name ]:

The name to be assigned to the new layer. Defaults to "NONAME".

[ string layer_desc ]:

The Description of the new layer. Defaults to an empty string.

[ string options ]:

Creation options. Defaults to an empty string.

Remarks

Note: that some vector formats come with a predefined set of layers and can't have new layers created.

See also

GDB file functions