From: Matt S Trout <mst@shadowcat.co.uk>
Date: Mon, 30 Sep 2019 17:37:06 +0000 (+0000)
Subject: document row expander
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=cc230faadb608351c7b6149b2b906687f8c23687;p=scpubgit%2FQ-Branch.git

document row expander
---

diff --git a/lib/SQL/Abstract/Reference.pm b/lib/SQL/Abstract/Reference.pm
index ebf3407..67567cc 100644
--- a/lib/SQL/Abstract/Reference.pm
+++ b/lib/SQL/Abstract/Reference.pm
@@ -653,4 +653,21 @@ behaves the same way as the now-directly-supported
   foo
   []
 
+=head2 row
+
+Expands the elements of the value arrayref:
+
+  # expr
+  { -row => [ 1, { -ident => 'foo' }, 2, 3 ] }
+
+  # aqt
+  { -row => [
+      { -bind => [ undef, 1 ] }, { -ident => [ 'foo' ] },
+      { -bind => [ undef, 2 ] }, { -bind => [ undef, 3 ] },
+  ] }
+
+  # query
+  (?, foo, ?, ?)
+  [ 1, 2, 3 ]
+
 =cut