Split files

TextPipe: Online Help Split files	Submit feedback on this topic
Home User Assistance Tutorials How to Use TextPipe Menus: File Edit Filters[ Wizards Convert Unicode Add Remove Replace Extract Special Maps Restrict ] Tools Window Help Advanced

Home
Up

This filter breaks files at specific boundaries. It is very useful for chopping up large files so that they can be transferred on floppy disk, then joined together using the merge function. Files are numbered with an extension of 000, 001, 002, etc, which can also be controlled.

If the output filter is set to Output to Clipboard or Single File Output, the split still occurs but the results are merged back together by the output filter as the very last stage in the filtering process.

Split at Size of (bytes)

When selected, files are split when they reach the given size (in bytes). The maximum file size is 2147483647 (2 GB).

Common Sizes

Common disk sizes are provided - choose one from the list and it will be defaulted to the field on the left

Split at Pattern

When selected, files are split when a given pattern is found.

Pattern

The case sensitive perl pattern to split on.

After this many

If the pattern specifies a single character only, such as a form feed (\f), you can split after this many occurrences of the pattern have been found in one file. The maximum is 2147483647.

Split Position

Where to split:

Before pattern - split pattern is output at start of next file
After pattern - split pattern is output at end of first file
At pattern - split pattern is removed

Split After Lines

The Split occurs after the specified number of lines have occurred. This is handy for dividing print files up into separate files, with 66 lines per page. The maximum value is 2147483647.

Split Filename

If you wish, you can control the names of the output files. All names are based on the input filename, in the input filename's folder. If you wish to control the output path, you MUST use the output filter.

Macro name	Use
%f	The input file's filename e.g. 'readme'
%e	The input file's extension without any period e.g. 'txt'
%d	The split file counter, starting from 0.
%3.3d	The split file counter, starting from 0, formatted in a field 3 wide with leading zeros.
%5.5d	The split file counter, starting from 0, formatted in a field 5 wide with leading zeros.
%x	The split file counter in hexadecimal.

First Filename Number

The number for the first split file.

Prevent Directories from Overloading

Windows get very slow and unstable when there are too many files in one directory. When this option is enabled, TextPipe will start a new folder if the number of split files exceeds 10,000.

New folder names are 10000, 20000, 30000 etc.

See also

Merge