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

# tcllib\_throw(3tcl)

throw - Throw an error exception with a message

```

```

## NAME

throw - throw - Throw an error exception with a message

## SYNOPSIS

package require **Tcl 8.5 9**

package require **throw ?1.1?**

**::throw** *error\_code* *error\_message*

```

```

## DESCRIPTION

This package provides a forward-compatibility implementation of Tcl 8.6's **throw** command (TIP 329), for Tcl 8.5. The code was directly pulled from Tcl 8.6 revision ?, when try/finally was implemented as Tcl procedure instead of in C.

- **::throw** *error\_code* *error\_message*

  throw is merely a reordering of the arguments of the error command. It throws an error with the indicated error code and error message.

## EXAMPLES

```
throw {MYERROR CODE} "My error message"
```

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *try* 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.

## SEE ALSO

[error(3tcl)](/error/3tcl.md)

## KEYWORDS

error, return, throw

## CATEGORY

Utility

## COPYRIGHT

```
Copyright (c) 2015 Miguel Martínez López, BSD licensed
```