DbCopy Function

 FUNCTION DbCopy(
	cTargetFile,
	acFields,
	cbForCondition,
	cbWhileCondition,
	nNext,
	nRecord,
	lRest,
	cDriver,
	acRDDs,
	lNoOpt
) AS LOGIC CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool DbCopy(
	Usual cTargetFile = default,
	Usual acFields = default,
	Usual cbForCondition = default,
	Usual cbWhileCondition = default,
	Usual nNext = default,
	Usual nRecord = default,
	Usual lRest = default,
	Usual cDriver = default,
	Usual acRDDs = default,
	Usual lNoOpt = default
)

Parameters

cTargetFile (Optional)

Type: Usual
The name of the target file, including an optional drive, directory, and extension. See SetDefault() and SetPath() for file searching and creation rules.
The default extension for database files is determined by the RDD.
For text files, it is .TXT.
If cTargetFile does not exist, it is created.
If it exists, this function attempts to open the file in exclusive mode and, if successful, the file is overwritten without warning or error.
If access is denied because, for example, another process is using the file, NetErr() is set to TRUE.
DBCreate() creates the specified file in ANSI or OEM character set format, based on the SetAnsi() setting. (For more information, refer to the SetAnsi() function.)

acFields (Optional)

Type: Usual
A list of fields to copy to cTargetFile.
The default is all fields.

cbForCondition (Optional)

Type: Usual
A code block that defines a condition that each record within the scope must meet in order to be processed.

cbWhileCondition (Optional)

Type: Usual
A code block that defines another condition that each record must meet in order to be processed. As soon as a record is encountered that causes the condition to fail, the operation terminates.
If no scope is specified, cbWhileCondition changes the default scope to lRest.
You define the scope using one of these three, mutually exclusive arguments.
The default is all records.

nNext (Optional)

Type: Usual
The number of records to process, starting at nRecord. Specify 0 to ignore this argument.

nRecord (Optional)

Type: Usual
A single record number to process. Specify 0 to ignore this argument.

lRest (Optional)

Type: Usual
TRUE processes only records from nStart to the end of the file. FALSE processes all records.

cDriver (Optional)

Type: Usual
The name of the RDD that will service the data server. If not specified, the default RDD as determined by RDDSetDefault() is used. The name of the RDD that will service the work area.
If not specified, the default RDD as determined by RDDSetDefault() is used.

acRDDs (Optional)

Type: Usual
A one-dimensional array with the names of RDDs from which the main RDD inherits special functionality.
This allows you to use RDDs with special capabilities, like encryption or decryption, in different work areas with different database drivers.
These RDDs overlay special functions of the main RDD (specified with the cDriver argument).
If multiple RDDs (specified with this argument) implement the same function, the function associated with the last RDD in the list takes precedence.
If acRDDs is omitted, no additional RDDs are assumed.

lNoOpt (Optional)

Type: Usual
Disable (Rushmore) optimizations (not supported yet).

Return Value

Reference