Improve documentation example for jsonpath like_regex operator
authorAlexander Korotkov
Thu, 13 May 2021 13:10:21 +0000 (16:10 +0300)
committerAlexander Korotkov
Thu, 13 May 2021 13:10:21 +0000 (16:10 +0300)
Make sample like_regex match string values of the root object instead of the
whole document.  The corrected example seems to represent a more relevant
use case.

Backpatch to 12, when jsonpath was introduced.

Discussion: https://postgr.es/m/13440f8b-4c1f-5875-c8e3-f3f65606af2f%40xs4all.nl
Author: Erik Rijkers
Reviewed-by: Michael Paquier, Alexander Korotkov
Backpatch-through: 12

doc/src/sgml/func.sgml

index 4d1f1794ca336eb1d2fe0f489ab111f41ecc0858..3a21129021adae0b3396c3be72d374b9966fd985 100644 (file)
@@ -17130,9 +17130,10 @@ $[*] ? (@ like_regex "^[aeiou]" flag "i")
      is a JSON path string literal, written according to the rules given in
      .  This means in particular that any
      backslashes you want to use in the regular expression must be doubled.
-     For example, to match strings that contain only digits:
+     For example, to match string values of the root document that contain
+     only digits:
 
-$ ? (@ like_regex "^\\d+$")
+$.* ? (@ like_regex "^\\d+$")