NAME¶

builtin::compat - Provide builtin functions for older perl versions

SYNOPSIS¶

  use builtin::compat qw(
    true
    false
    is_bool
    inf
    nan
    weaken
    unweaken
    is_weak
    blessed
    refaddr
    reftype
    created_as_string
    created_as_number
    stringify
    ceil
    floor
    trim
    indexed
    load_module
  );

DESCRIPTION¶

Provides builtin functions for perl versions that do not include the builtin module.

No functions are exported by default.

This module does its best to behave similar to builtin, which creates its exported functions as lexicals. The functions will be created in the currently compiling scope, not the immediate caller of "builtin::compat->import". The functions will also be removed at the end of the compilation scope using namespace::clean.

The builtin functions will be used directly when they are available.

FUNCTIONS¶

true

See "true" in builtin.

false

See "false" in builtin.

is_bool

See "is_bool" in builtin.

Prior to perl 5.36, it was not possible to track boolean values fully accurately. This function will not be perfectly accurate on earlier perl versions.

inf

See "inf" in builtin.

nan

See "nan" in builtin.

weaken

See "weaken" in builtin.

unweaken

See "unweaken" in builtin.

is_weak

See "is_weak" in builtin.

blessed

See "blessed" in builtin.

refaddr

See "refaddr" in builtin.

reftype

See "reftype" in builtin.

created_as_string

See "created_as_string" in builtin.

Prior to perl 5.36, it was not possible to check if a scalar value was created as a number or as a string fully accurately. This function will not be entirely accurate before then, but should be as accurate as is possible on these perl versions. In particular, a string like "12345" that has been used as a number will cause "create_as_string" to return false and "created_as_number" to return true.

created_as_number

See "created_as_number" in builtin.

Has the same caveats as "created_as_string".

stringify

See "stringify" in builtin.

ceil

See "ceil" in builtin.

floor

See "floor" in builtin.

trim

See "trim" in builtin.

indexed

See "indexed" in builtin.

load_module

See "load_module" in builtin.

AUTHOR¶

haarg - Graham Knop (cpan:HAARG) <haarg@haarg.org>

CONTRIBUTORS¶

None so far.

COPYRIGHT¶

Copyright (c) 2022 the builtin::compat "AUTHOR" and "CONTRIBUTORS" as listed above.

LICENSE¶

This library is free software and may be distributed under the same terms as perl itself. See <https://dev.perl.org/licenses/>.