PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
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
// 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 find out the error details, use ErrorInfo associated with the errMessage constant.
    Note: 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:
fDeleteDestinationIf the destination file already exists, it will be deleted then re-created.
fDeleteSourceThe 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 : wd250std.dll
Minimum version required
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment