ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / External file functions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Splits a file into several files. The created files can be merged into a single file by fMerge.
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> = fSplit(<File name> , <Maximum size> [, <Output file> [, <Option> [, <Progress Bar control>]]])
<Result>: Integer
  • Number of created files,
  • 0 if an error occurs. To get more details on the error, use ErrorInfo with the errMessage constant.
<File name>: Character string
Full name of file to split.
<Maximum size>: Integer
Maximum size (in bytes) of each created file. This size must be greater than 0.
<Output file>: Optional character string
Full path of the files to create. The created files will correspond to the specified name followed by a ".xxx" extension where xxx corresponds to the index of the created file.
By default, <Output file> corresponds to <File name>.
<Option>: Optional Integer constant
The source file is kept during the split operation. You have the ability to specify the following split option:
fDeleteSourceThe source file will be deleted as the split operation goes along.
Warning: If an error occurs, the source file will be LOST and cannot be retrieved.
<Progress Bar control>: Optional control name
Name of Progress Bar control, used to show the progress of the split operation.
Remarks
  • fOpen cannot be used on a multi-part file. Before using fOpen, the original file must be created again with fMerge.
    Note: The fOpen function used on a part only accesses the sub-file corresponding to that part.
  • The function will return an error if an existing file and one of the sub-files to create have the same name.
  • The number of files that can be created cannot exceed 10 000.
Component: wd300std.dll
Minimum version required
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help