Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 49d296d

Browse files
committed
doc: add examples for array_length() and jsonb_array_length()
The examples show the output of array_length() and jsonb_array_length() for empty arrays. Discussion: https://postgr.es/m/CAKFQuwaoBmRuWdMLzLHDCFDJDX3wvfQ7egAF0bpik_BFgG1KWg@mail.gmail.com Author: David G. Johnston Backpatch-through: 13
1 parent 12f56b6 commit 49d296d

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

doc/src/sgml/func.sgml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15261,6 +15261,10 @@ table2-mapping
1526115261
<para>
1526215262
<literal>json_array_length('[1,2,3,{"f1":1,"f2":[5,6]},4]')</literal>
1526315263
<returnvalue>5</returnvalue>
15264+
</para>
15265+
<para>
15266+
<literal>jsonb_array_length('[]')</literal>
15267+
<returnvalue>0</returnvalue>
1526415268
</para></entry>
1526515269
</row>
1526615270

@@ -17756,10 +17760,19 @@ SELECT NULLIF(value, '(none)') ...
1775617760
</para>
1775717761
<para>
1775817762
Returns the length of the requested array dimension.
17763+
(Produces NULL instead of 0 for empty or missing array dimensions.)
1775917764
</para>
1776017765
<para>
1776117766
<literal>array_length(array[1,2,3], 1)</literal>
1776217767
<returnvalue>3</returnvalue>
17768+
</para>
17769+
<para>
17770+
<literal>array_length(array[]::int[], 1)</literal>
17771+
<returnvalue>NULL</returnvalue>
17772+
</para>
17773+
<para>
17774+
<literal>array_length(array['text'], 2)</literal>
17775+
<returnvalue>NULL</returnvalue>
1776317776
</para></entry>
1776417777
</row>
1776517778

0 commit comments

Comments
 (0)