---
name: "multi"
section: "3tcl"
platform: "linux"
package: "tcllib"
version: "2.0+dfsg-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/multi"
---

# multi(3tcl)

Multi-file operation, scatter/gather, standard object

```

```

## NAME

fileutil::multi - Multi-file operation, scatter/gather, standard object

## SYNOPSIS

package require **Tcl 8.5 9**

package require **fileutil::multi ?0.2?**

package require **fileutil::multi::op ?0.5.4?**

package require **wip ?1.1?**

**::fileutil::multi** ?*word*...?

```

```

## DESCRIPTION

This package provides a single command to perform actions on multiple files selected by glob patterns. It is a thin layer over the package **fileutil::multi::op** which provides objects for the same. This package simply creates a single such object and directs all file commands to it.

At the core is a domain specific language allowing the easy specification of multi-file copy and/or move and/or deletion operations. Alternate names would be scatter/gather processor, or maybe even assembler. For the detailed specification of this language, and examples, please see the documention for the package **fileutil::multi::op**.

## PUBLIC API

The main command of the package is:

- **::fileutil::multi** ?*word*...?

  This command interprets the specified words as file commands to execute. See the section **FILE API** of the documentation for the package **fileutil::multi::op** for the set of acceptable commands, their syntax, and semantics.

  The result of the command is the result generated by the last file command it executed.

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *fileutil* of the *Tcllib Trackers* \[http://core.tcl.tk/tcllib/reportlist\]. Please also report any ideas for enhancements you may have for either package and/or documentation.

When proposing code changes, please provide *unified diffs*, i.e the output of **diff -u**.

Note further that *attachments* are strongly preferred over inlined patches. Attachments can be made by going to the **Edit** form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar.

## KEYWORDS

copy, file utilities, move, multi-file, remove

## CATEGORY

Programming tools