Test2::Tools::Ref(3p)

Test2::Tools::Ref3p

Tools for validating references.

Usage

    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");

Overview

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.

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/test-more/.

Maintainers

Chad Granum <[email protected]>

Releases

5 releases since OpenBSD 7.7; the text changed 2 times.

  1. 7.7–7.8
  2. 7.9
  3. 8.0

Authors

Chad Granum <[email protected]>

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's man source.