File: README

package info (click to toggle)
libcurry-perl 1.001000-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 96 kB
  • sloc: perl: 41; makefile: 2
file content (94 lines) | stat: -rw-r--r-- 2,384 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
NAME
    curry - Create automatic curried method call closures for any class or
    object

SYNOPSIS
      use curry;

      my $code = $obj->curry::frobnicate('foo');

    is equivalent to:

      my $code = sub { $obj->frobnicate(foo => @_) };

    Additionally,

      use curry::weak;

      my $code = $obj->curry::weak::frobnicate('foo');

    is equivalent to:

      my $code = do {
        Scalar::Util::weaken(my $weak_obj = $obj);
        sub {
          return unless $weak_obj; # in case it already went away
          $weak_obj->frobnicate(foo => @_)
        };
      };

    If you want to pass a weakened copy of an object to a coderef, use the
    $weak package variable:

     use curry::weak;

     my $code = $self->$curry::weak(sub {
      my ($self, @args) = @_;
      print "$self must still be alive, because we were called (with @args)\n";
     }, 'xyz');

    which is much the same as:

     my $code = do {
      my $sub = sub {
       my ($self, @args) = @_;
       print "$self must still be alive, because we were called (with @args)\n";
      };
      Scalar::Util::weaken(my $weak_obj = $self);
      sub {
       return unless $weak_obj; # in case it already went away
       $sub->($weak_obj, 'xyz', @_);
      }
     };

    There's an equivalent - but somewhat less useful - $curry package
    variable:

     use curry;

     my $code = $self->$curry::curry(sub {
      my ($self, $var) = @_;
      print "The stashed value from our ->something method call was $var\n";
     }, $self->something('complicated'));

    Both of these methods can also be used if your scalar is a method name,
    rather than a coderef.

     use curry;

     my $code = $self->$curry::curry($methodname, $self->something('complicated'));

RATIONALE
    How many times have you written

      sub { $obj->something($some, $args, @_) }

    or worse still needed to weaken it and had to check and re-check your
    code to be sure you weren't closing over things the wrong way?

    Right. That's why I wrote this.

AUTHOR
    mst - Matt S. Trout (cpan:MSTROUT) <mst@shadowcat.co.uk>

CONTRIBUTORS
    None yet - maybe this software is perfect! (ahahahahahahahahaha)

COPYRIGHT
    Copyright (c) 2012 the curry "AUTHOR" and "CONTRIBUTORS" as listed
    above.

LICENSE
    This library is free software and may be distributed under the same
    terms as perl itself.