fMerge (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing external files

Constants for the external files

Functions for managing external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fMerge (Function)

In french: fRegroupe

Merges several files into a single one. The files to use have been created during a previous split operation by fSplit.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

This function is now available in Universal Windows 10 App mode.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available in Android Widget mode.

Example

// Splits the Video.avi file
fSplit("Video.avi", 100*1024*1024, "SplitVideo")
IF ErrorOccurred THEN
// Displays the error message
Error(ErrorInfo())
RETURN
END

// The "SplitVideo.001" and "SplitVideo.002" files have been created
// Delete the source file ("Video.avi")
fDelete("Video.avi")

// Uses the "SplitVideo.001" and "SplitVideo.002" files
// to re-create the "Video.avi" file
fMerge("SplitVideo", "Video.avi")
IF ErrorOccurred THEN
// Displays the error message
Error(ErrorInfo())
RETURN
END

Syntax

<Result> = fMerge(<File name> [, <Output file> [, <Option> [, <Progress Bar>]]])

<Result>: Integer

Number of merged files,
0 if an error occurred. To get the details of the error, use ErrorInfo with the errMessage constant.
Remark: in case of error, the output files must be found on disk.

<File name>: Character string (with quotes)

Full name of file to merge (without the ".001" extension).

<Output file>: Optional character string (with quotes)

Full path of file to create.
By default, <Output file> corresponds to <File name>.

<Option>: Optional Integer constant

By default:
the source files are kept during the merge operation.
if the output file already exists, the function returns an error.
You have the ability to specify the following merge options:
fDeleteDestination If the destination file already exists, it will be deleted then re-created.
fDeleteSource The source files will be deleted as the merge operation goes along.
Caution: If an error occurs, the source files will be LOST and they cannot be retrieved.

<Progress Bar>: Optional character string (with or without quotes)

Name of the Progress Bar control used to follow the progress of the merge operation for the different parts of the file.

Component : wd260std.dll