fSplit (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

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

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fSplit (Function)

In french: fDécoupe

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 find out the name of the error, use the function ErrorInfo with the constant errMessage.

<File name>: Character string (with quotes)

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 (with quotes)

Full path of files to create. The created files will correspond to the specified name followed by a ".xxx" extension where xxx corresponds to the subscript 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:
fDeleteSource The source file will be deleted as the split operation goes along.
Caution: If an error occurs, the source file will be LOST and it cannot be retrieved.

<Progress Bar control>: Optional control name

Name of Progress Bar control, used to show the progress of split operation.

Remarks

fOpen cannot be used on a multi-part file. Before using fOpen, the source file must be re-created by fMerge.
Remark: fOpen used on a part allows you to access the sub-file corresponding to the 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: wd260std.dll