---
name: Cwd
runtime: pp
source: src/native/Cwd/pp.rs
---
```{index} single: Cwd; Perl module (pp runtime)
```

# Cwd

Native implementation of Cwd

Provides current working directory operations.

# Synopsis

    use Cwd;
    my $dir = cwd();

    use Cwd 'abs_path';
    my $abs = abs_path('relative/path');
    my $abs = abs_path('/symlinked/../path');

# Perl Equivalent

Cwd

# Functions

## cwd / getcwd / fastcwd / fastgetcwd

Returns the current working directory as a string.
All four names are synonyms in PetaPerl (no distinction between
XS and pure-Perl implementations).

```perl
use Cwd;
my $dir = cwd();
```

## abs_path / realpath / fast_abs_path

Returns the canonicalized absolute pathname of the argument.
Resolves symlinks. Returns `undef` if the path cannot be resolved.
If no argument is given, resolves the current directory.

```perl
use Cwd 'abs_path';
my $abs = abs_path('relative/path');
my $abs = abs_path();   # current directory
```

## chdir

Changes the working directory and updates `$ENV{PWD}`.
Unlike `CORE::chdir`, does NOT default to `$ENV{HOME}` when
called without arguments. Returns 1 on success, 0 on failure.

```perl
use Cwd 'chdir';
chdir('/tmp') or die "Cannot chdir: $!";
```