PFLANZE / FunctionalPerl-0.72.76 / lib / FP / Div.pm 

            

              
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
95
96
97
98
99
100
101
102
103
104
105
106

              
#
# Copyright (c) 2014-2020 Christian Jaeger, copying@christianjaeger.ch
#
# This is free software, offered under either the same terms as perl 5
# or the terms of the Artistic License version 2 or the terms of the
# MIT License (Expat version). See the file COPYING.md that came
# bundled with this file.
#
=head1 NAME
FP::Div - various pure functions
=head1 SYNOPSIS
=head1 DESCRIPTION
=head1 NOTE
This is alpha software! Read the status section in the package README
or on the L<website|http://functional-perl.org/>.
=cut
package FP::Div;
use strict;
use warnings;
use warnings FATAL => 'uninitialized';
use Exporter "import";
our @EXPORT    = qw();
our @EXPORT_OK = qw(inc dec square average
    identity
    min max minmax
    Chomp
);
our %EXPORT_TAGS = (all => [@EXPORT, @EXPORT_OK]);
use Chj::TEST;
use FP::Carp;
# XX should `indentity` pass multiple values, and this be called
# `identity_scalar`? :
sub identity {
    @_ == 1 or fp_croak_arity 1;
    $_[0]
}
sub inc {
    @_ == 1 or fp_croak_arity 1;
    $_[0] + 1
}
sub dec {
    @_ == 1 or fp_croak_arity 1;
    $_[0] - 1
}
sub square {
    @_ == 1 or fp_croak_arity 1;
    $_[0] * $_[0]
}
sub average {
    @_ == 2 or fp_croak_arity 2;
    ($_[0] + $_[1]) / 2
}
sub min {
    my $x = shift;
    for (@_) {
        $x = $_ if $_ < $x
    }
    $x
}
sub max {
    my $x = shift;
    for (@_) {
        $x = $_ if $_ > $x
    }
    $x
}
sub minmax {
    my $min = shift;
    my $max = $min;
    for (@_) {
        $min = $_ if $_ < $min;
        $max = $_ if $_ > $max;
    }
    ($min, $max)
}
# is there any better idea than ucfirst to distinguish from the
# builtin? `fchomp` ?
sub Chomp {
    @_ == 1 or fp_croak_arity 1;
    my ($str) = @_;
    chomp $str;
    $str
}
1