fMerge (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / External file functions

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.

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 more details on the error, use ErrorInfo with the errMessage constant.
Note: in the event of an error, output files may be present on the disk..

<File name>: Character string

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

<Output file>: Optional character string

Full path of the file to be created.
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 recreated.
fDeleteSource The source files will be deleted as the merge operation goes along.
Warning: If an error occurs, the source files will be LOST and cannot be retrieved.

<Progress Bar control>: Optional control name

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

Component: wd300std.dll