NAME

SQL::Abstract::Util - Small collection of utilities for SQL::Abstract::Classic

EXPORTABLE FUNCTIONS

is_plain_value

Determines if the supplied argument is a plain value as understood by this module:

• The value is undef

• The value is a non-reference

• The value is an object with stringification overloading

• The value is of the form { -value => $anything }

On failure returns undef, on success returns a scalar reference to the original supplied argument.

• Note

  The stringification overloading detection is rather advanced: it takes into consideration not only the presence of a "" overload, but if that fails also checks for enabled autogenerated versions of "", based on either 0+ or bool.

  Unfortunately testing in the field indicates that this detection may tickle a latent bug in perl versions before 5.018, but only when very large numbers of stringifying objects are involved. At the time of writing ( Sep 2014 ) there is no clear explanation of the direct cause, nor is there a manageably small test case that reliably reproduces the problem.

  If you encounter any of the following exceptions in random places within your application stack - this module may be to blame:

  Operation "ne": no method found,
    left argument in overloaded package <something>,
    right argument in overloaded package <something>

  or perhaps even

  Stub found while resolving method "???" overloading """" in package <something>

  If you fall victim to the above - please attempt to reduce the problem to something that could be sent to the SQL::Abstract::Classic developers (either publicly or privately). As a workaround in the meantime you can set $ENV{SQLA_ISVALUE_IGNORE_AUTOGENERATED_STRINGIFICATION} to a true value, which will most likely eliminate your problem (at the expense of not being able to properly detect exotic forms of stringification).

  This notice and environment variable will be removed in a future version, as soon as the underlying problem is found and a reliable workaround is devised.

is_literal_value

Determines if the supplied argument is a literal value as understood by this module:

• \$sql_string

• \[ $sql_string, @bind_values ]

On failure returns undef, on success returns an array reference containing the unpacked version of the supplied literal SQL and bind values.