Test2::Tools::Ref(3p) | Perl Programmers Reference Guide | Test2::Tools::Ref(3p)

# NAME

Test2::Tools::Ref - Tools for validating references.

# DESCRIPTION

This module contains tools that allow you to verify that something is a ref. It also has tools to check if two refs are the same exact ref, or different. None of the functions in this module do deep comparisons.

# SYNOPSIS

        use Test2::Tools::Ref;
        # Ensure something is a ref.
        ref_ok($ref);
        # Check that $ref is a HASH reference
        ref_ok($ref, 'HASH', 'Must be a hash')
        ref_is($refa, $refb, "Same exact reference");
        ref_is_not($refa, $refb, "Not the same exact reference");

# EXPORTS

All subs are exported by default.

ref_ok($thing)
ref_ok($thing, $type)
ref_ok($thing, $type, $name)
  This checks that $thing is a reference. If $type is specified then it will check that $thing is that type of reference.
ref_is($ref1, $ref2, $name)
  Verify that two references are the exact same reference.
ref_is_not($ref1, $ref2, $name)
  Verify that two references are not the exact same reference.

# SOURCE

The source code repository for Test2-Suite can be found at https://github.com/Test-More/Test2-Suite/.

# MAINTAINERS

Chad Granum <exodist@cpan.org>

# AUTHORS

Chad Granum <exodist@cpan.org>

# COPYRIGHT

Copyright 2018 Chad Granum <exodist@cpan.org>.

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

See http://dev.perl.org/licenses/

2025-01-28 | perl v5.40.1