---
name: "File::Slurp::Tiny"
section: "3pm"
platform: "linux"
package: "perl-file-slurp-tiny"
version: "0.004-13"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/File::Slurp::Tiny"
---

# File::Slurp::Tiny(3pm)

A simple, sane and efficient file slurper \[DISCOURAGED\]

## NAME

File::Slurp::Tiny - A simple, sane and efficient file slurper \[DISCOURAGED\]

## VERSION

version 0.004

## SYNOPSIS

```
 use File::Slurp::Tiny 'read_file';
 my $content = read_file($filename);
```

## DISCOURAGED

**This module is discouraged in favor of File::Slurper**. While a useful experiment, it turned out to be both too similar to File::Slurp (still containing most problematic features of File::Slurp's interface) and yet not similar enough to be a true drop-in replacement.

Bugs will still be fixed, but new features will probably not be added.

## DESCRIPTION

This module provides functions for fast and correct slurping and spewing. All functions are optionally exported.

## FUNCTIONS

### read\_file($filename, %options)

Reads file `$filename` into a scalar. By default it returns this scalar. Can optionally take these named arguments:

- •

  binmode

  Set the layers to read the file with. The default will be something sensible on your platform.

- •

  buf\_ref

  Pass a reference to a scalar to read the file into, instead of returning it by value. This has performance benefits.

- •

  scalar\_ref

  If set to true, `"read_file"` will return a reference to a scalar containing the file content.

### read\_lines($filename, %options)

Reads file `$filename` into a list/array. By default it returns this list. Can optionally take these named arguments:

- •

  binmode

  Set the layers to read the file with. The default will be something sensible on your platform.

- •

  array\_ref

  Pass a reference to an array to read the lines into, instead of returning them by value. This has performance benefits.

- •

  chomp

  `"chomp"` the lines.

### write\_file($filename, $content, %options)

Open `$filename`, and write `$content` to it. Can optionally take this named argument:

- •

  binmode

  Set the layers to write the file with. The default will be something sensible on your platform.

### read\_dir($dirname, %options)

Open `"dirname"` and return all entries except `"."` and `".."`. Can optionally take this named argument:

- •

  prefix

  This will prepend `$dir` to the entries

## SEE ALSO

- •

  Path::Tiny

  A minimalistic abstraction not only around

- •

  File::Slurp

  Another file slurping tool.

## AUTHOR

Leon Timmermans \<leont@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Leon Timmermans.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.