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

# File::Basename

Native implementation of File::Basename

Provides path parsing functions: basename, dirname, fileparse.

# Synopsis

    use File::Basename qw(basename dirname fileparse);

    my $base = basename("/usr/local/bin/perl");   # "perl"
    my $dir  = dirname("/usr/local/bin/perl");    # "/usr/local/bin"

    my ($name, $path, $suffix) = fileparse(
        "/usr/local/lib/libperl.so", qr/\.[^.]*/
    );
    # $name="libperl", $path="/usr/local/lib/", $suffix=".so"

# Functions

## fileparse_set_fstype

Set the filesystem type for path parsing. Always returns "Unix";
the argument is accepted but ignored.

### Synopsis

    use File::Basename 'fileparse_set_fstype';
    fileparse_set_fstype('Unix');