---
name: tie
status: documented
runtime: pp
source: src/runtime/pp/tie.rs
---
```{index} single: tie; Perl built-in (pp runtime)
```

# tie

## Synopsis

```perl
tie my %hash, 'DB_File', 'filename';
tie my @array, 'Tie::File', 'data.txt';
tie my $scalar, 'Tie::StdScalar';
my $obj = tie %hash, 'MyTieClass', @args;
```

## Description

Binds a variable to an object class, enabling magical access
through method dispatch.

Associates a variable with a class by calling the class's
`TIEHASH`, `TIEARRAY`, `TIESCALAR`, or `TIEHANDLE` constructor.
After tying, all accesses to the variable are redirected through
`FETCH`/`STORE`/etc. methods on the tie object. Returns the tie
object on success.

**Implementation status:** Stub. Returns `undef` (simulating a
graceful failure) because full tie support requires deep
integration with the value layer to intercept variable access.

## See also

tied, untie