File Coverage

blib/lib/Acme/CPANModules/InterestingTies.pm

Criterion	Covered	Total	%
statement	3	3	100.0
branch			n/a
condition			n/a
subroutine	1	1	100.0
pod			n/a
total	4	4	100.0

package Acme::CPANModules::InterestingTies;

use strict;

our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY
our $DATE = '2023-10-31'; # DATE
our $DIST = 'Acme-CPANModules-InterestingTies'; # DIST
our $VERSION = '0.001'; # VERSION

our $LIST = {
    summary => "List of interesting uses of the tie() interface",
    description => <<'MARKDOWN',

The perl's tie interface allows you to create "magical" scalar, array, hash, or
filehandle. When you read or set the value of these variables, various things
can be triggered.

This  list catalogs some of the interesting uses of the
tie() interface.

MARKDOWN
    entries => [

        {
            module => 'Acme::Tie::Formatted',
            description => <<'MARKDOWN',

This module allows you to do `sprintf()` by accessing a hash key, e.g.:

    print $format{17, "%03x"};

will output:

    011

The nice thing about this is that the `$format{...}` term can be put inside
double quote, although you have to use a different quote inside the quote, e.g.:

    print "The value is: $format{17, '%03x'}";
    print qq(The value is: $format{17, "%03x"});

The module advertises the functionality as "printf inside print", although the
author chose to accept a different argument order than printf. Instead of:

    FORMAT, LIST

the FORMAT is put at the end:

    LIST, FORMAT

MARKDOWN
        },

        {
            module => 'Regexp::Common',
            description => <<'MARKDOWN',

This module contains a collection of regular expression patterns. To access the
patterns, you can use the tied hash %RE, e.g.:

    $RE{quoted}
    $RE{num}{real}

You can also give arguments to customize the generated pattern:

    $RE{delimited}{-delim=>'/'}]

The advantage, again, is being able to be used inside a regular expression
pattern.

Note that the module also offers subroutine-based interface. I also created an
alternative module called  which opts for the non-magical
subroutine-based interface and offers smaller startup overhead.

MARKDOWN
        },

    ],
};

1;
# ABSTRACT: List of interesting uses of the tie() interface

__END__