fMerge (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

External file management functions

Constants for the external files

Functions for managing directories and external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fInsertTextAtBeginning

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

// Découpe le fichier Video.avi
fSplit("Video.avi", 100*1024*1024, "VideoDécoupée")
IF ErrorOccurred THEN
// Affiche le message d'erreur
Error(ErrorInfo())
RETURN
END

// Des fichiers "VideoDécoupée.001", "VideoDécoupée.002" ont été créés
// Suppression du fichier source "Video.avi"
fDelete("Video.avi")

// Utilise les fichiers "VideoDécoupée.001", "VideoDécoupée.002"
// pour recréer le fichier "Video.avi"
fMerge("VideoDécoupée", "Video.avi")
IF ErrorOccurred THEN
// Affiche le message d'erreur
Error(ErrorInfo())
RETURN
END

Syntax

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

<Result>: Integer

Number of merged files,
0 if an error occurs. 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 control>: Optional control name

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