oracular (3) SQL::Abstract::Util.3pm.gz

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.