LibraryCreate

Description

Creates an empty PocketBuilder or PowerBuilder library with optional comments.

Syntax

LibraryCreate ( libraryname {, comments } )

Argument

Description

libraryname

A string whose value is the name of the PocketBuilder library you want to create. If you want to create the library somewhere other than the current directory, enter the full path name.

comments (optional)

A string whose value is the comments you want to associate with the library.

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs. If any argument’s value is null, LibraryCreate returns null.

Usage

LibraryCreate creates a PocketBuilder library file (PKL) in the current directory, unless you specify a directory path as part of libraryname. If you do not specify an extension, LibraryCreate adds the extension .PKL. In PowerBuilder, LibraryCreate creates a PowerBuilder library file (PBL).

Examples

Example 1

This statement in a PowerBuilder application creates a library named dwTemp in the PB directory on drive C and associates a comment with the library:

LibraryCreate("c:\pb\dwTemp.pbl", &

    "Temporary library for dynamic DataWindows")

See also