fSplit (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing external files

Constants for the external files

Functions for managing external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

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

// 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> = fSplit(<File name> , <Maximum size> [, <Output file> [, <Option> [, <Progress bar>]]])

<Result>: Integer

Number of created files,
0 if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<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>: Optional character string (with or without quotes)

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.
Note: 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 : wd240std.dll