fSplit (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

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

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

// 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 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>: 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.
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