Function PreparedImpl.queryValue

Execute a prepared SQL SELECT command and returns a single value, the first column of the first row received.

If the query did not produce any rows, OR the rows it produced have zero columns, this will return Nullable!Variant(), ie, null. Test for this with result.isNull.

If the query DID produce a result, but the value actually received is NULL, then result.isNull will be FALSE, and result.get will produce a Variant which CONTAINS null. Check for this with result.get.type == typeid(typeof(null)).

If the SQL command does not produce a result set (such as INSERT/CREATE/etc), then mysql.exceptions.MySQLNoResultRecievedException will be thrown. Use exec instead for such commands.

If there are long data items among the expected result columns you can use the csa param to specify that they are to be subject to chunked transfer via a delegate.

Prototype

std.typecons.Nullable!(std.variant.VariantN!(32L).VariantN) queryValue(
  ColumnSpecialization[] csa = null
);

Parameters

NameDescription
csa An optional array of ColumnSpecialization structs.

Returns

Nullable!Variant: This will be null (check via Nullable.isNull) if the query resulted in an empty result set.

Authors

Copyright

License