createArchiveFiltered

ArchiveHandle createArchiveFiltered(string fsRoot,  string outDir,  string base,  string ext,
       CreateOptions co,  FilterOptions fo,  out  OperationStats stats)

@safe

Creates an archive with file filtering support.

This function creates an archive that only includes files matching the specified filter criteria. Use FilterOptions to define include/exclude patterns for filenames and paths.

Parameters

`fsRoot`	filesystem root to back up
`outDir`	directory where slices are written
`base`	archive base name
`ext`	slice extension (e.g., "dar")
`co`	create options created via CreateOptions.create()
`fo`	filter options created via FilterOptions.create()
`stats`	output parameter to receive operation statistics (optional)

Returns

ArchiveHandle for the created archive.

Example:

auto co = CreateOptions.create();
auto fo = FilterOptions.create();
fo.addInclude("*.txt");    // Only include .txt files
fo.addExclude("*.bak");    // Exclude backup files

OperationStats stats;
auto arc = createArchiveFiltered("/home/user/docs", "/backups", "docs", "dar", co, fo, stats);
writefln("Files archived: %d", stats.treated);

ArchiveHandle createArchiveFiltered(string fsRoot,  string outDir,  string base,  string ext,
       CreateOptions co,  FilterOptions fo)

@safe

Creates an archive with file filtering support (no stats).

Convenience overload that doesn't return operation statistics.

Parameters

`fsRoot`	filesystem root to back up
`outDir`	directory where slices are written
`base`	archive base name
`ext`	slice extension (e.g., "dar")
`co`	create options created via CreateOptions.create()
`fo`	filter options created via FilterOptions.create()

Returns

ArchiveHandle for the created archive.