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

# tied

## Synopsis

```perl
my $obj = tied %hash;
if (tied $scalar) { ... }   # check if variable is tied
```

## Description

Returns the underlying object of a tied variable.

Returns the object that was associated with the variable by a
previous `tie` call. Returns `undef` if the variable is not tied.
Commonly used to access the tie object's methods directly.

**Implementation status:** Stub. Always returns `undef` because
tie is not yet implemented.

## See also

tie, untie