Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * multirangetypes.c
4 : * I/O functions, operators, and support functions for multirange types.
5 : *
6 : * The stored (serialized) format of a multirange value is:
7 : *
8 : * 12 bytes: MultirangeType struct including varlena header, multirange
9 : * type's OID and the number of ranges in the multirange.
10 : * 4 * (rangesCount - 1) bytes: 32-bit items pointing to the each range
11 : * in the multirange starting from
12 : * the second one.
13 : * 1 * rangesCount bytes : 8-bit flags for each range in the multirange
14 : * The rest of the multirange are range bound values pointed by multirange
15 : * items.
16 : *
17 : * Majority of items contain lengths of corresponding range bound values.
18 : * Thanks to that items are typically low numbers. This makes multiranges
19 : * compression-friendly. Every MULTIRANGE_ITEM_OFFSET_STRIDE item contains
20 : * an offset of the corresponding range bound values. That allows fast lookups
21 : * for a particular range index. Offsets are counted starting from the end of
22 : * flags aligned to the bound type.
23 : *
24 : * Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
25 : * Portions Copyright (c) 1994, Regents of the University of California
26 : *
27 : *
28 : * IDENTIFICATION
29 : * src/backend/utils/adt/multirangetypes.c
30 : *
31 : *-------------------------------------------------------------------------
32 : */
33 : #include "postgres.h"
34 :
35 : #include "access/tupmacs.h"
36 : #include "common/hashfn.h"
37 : #include "funcapi.h"
38 : #include "lib/stringinfo.h"
39 : #include "libpq/pqformat.h"
40 : #include "nodes/nodes.h"
41 : #include "port/pg_bitutils.h"
42 : #include "utils/array.h"
43 : #include "utils/builtins.h"
44 : #include "utils/lsyscache.h"
45 : #include "utils/multirangetypes.h"
46 : #include "utils/rangetypes.h"
47 :
48 : /* fn_extra cache entry for one of the range I/O functions */
49 : typedef struct MultirangeIOData
50 : {
51 : TypeCacheEntry *typcache; /* multirange type's typcache entry */
52 : FmgrInfo typioproc; /* range type's I/O proc */
53 : Oid typioparam; /* range type's I/O parameter */
54 : } MultirangeIOData;
55 :
56 : typedef enum
57 : {
58 : MULTIRANGE_BEFORE_RANGE,
59 : MULTIRANGE_IN_RANGE,
60 : MULTIRANGE_IN_RANGE_ESCAPED,
61 : MULTIRANGE_IN_RANGE_QUOTED,
62 : MULTIRANGE_IN_RANGE_QUOTED_ESCAPED,
63 : MULTIRANGE_AFTER_RANGE,
64 : MULTIRANGE_FINISHED,
65 : } MultirangeParseState;
66 :
67 : /*
68 : * Macros for accessing past MultirangeType parts of multirange: items, flags
69 : * and boundaries.
70 : */
71 : #define MultirangeGetItemsPtr(mr) ((uint32 *) ((Pointer) (mr) + \
72 : sizeof(MultirangeType)))
73 : #define MultirangeGetFlagsPtr(mr) ((uint8 *) ((Pointer) (mr) + \
74 : sizeof(MultirangeType) + ((mr)->rangeCount - 1) * sizeof(uint32)))
75 : #define MultirangeGetBoundariesPtr(mr, align) ((Pointer) (mr) + \
76 : att_align_nominal(sizeof(MultirangeType) + \
77 : ((mr)->rangeCount - 1) * sizeof(uint32) + \
78 : (mr)->rangeCount * sizeof(uint8), (align)))
79 :
80 : #define MULTIRANGE_ITEM_OFF_BIT 0x80000000
81 : #define MULTIRANGE_ITEM_GET_OFFLEN(item) ((item) & 0x7FFFFFFF)
82 : #define MULTIRANGE_ITEM_HAS_OFF(item) ((item) & MULTIRANGE_ITEM_OFF_BIT)
83 : #define MULTIRANGE_ITEM_OFFSET_STRIDE 4
84 :
85 : typedef int (*multirange_bsearch_comparison) (TypeCacheEntry *typcache,
86 : RangeBound *lower,
87 : RangeBound *upper,
88 : void *key,
89 : bool *match);
90 :
91 : static MultirangeIOData *get_multirange_io_data(FunctionCallInfo fcinfo,
92 : Oid mltrngtypid,
93 : IOFuncSelector func);
94 : static int32 multirange_canonicalize(TypeCacheEntry *rangetyp,
95 : int32 input_range_count,
96 : RangeType **ranges);
97 :
98 : /*
99 : *----------------------------------------------------------
100 : * I/O FUNCTIONS
101 : *----------------------------------------------------------
102 : */
103 :
104 : /*
105 : * Converts string to multirange.
106 : *
107 : * We expect curly brackets to bound the list, with zero or more ranges
108 : * separated by commas. We accept whitespace anywhere: before/after our
109 : * brackets and around the commas. Ranges can be the empty literal or some
110 : * stuff inside parens/brackets. Mostly we delegate parsing the individual
111 : * range contents to range_in, but we have to detect quoting and
112 : * backslash-escaping which can happen for range bounds. Backslashes can
113 : * escape something inside or outside a quoted string, and a quoted string
114 : * can escape quote marks with either backslashes or double double-quotes.
115 : */
116 : Datum
117 1380 : multirange_in(PG_FUNCTION_ARGS)
118 : {
119 1380 : char *input_str = PG_GETARG_CSTRING(0);
120 1380 : Oid mltrngtypoid = PG_GETARG_OID(1);
121 1380 : Oid typmod = PG_GETARG_INT32(2);
122 1380 : Node *escontext = fcinfo->context;
123 : TypeCacheEntry *rangetyp;
124 1380 : int32 ranges_seen = 0;
125 1380 : int32 range_count = 0;
126 1380 : int32 range_capacity = 8;
127 : RangeType *range;
128 1380 : RangeType **ranges = palloc(range_capacity * sizeof(RangeType *));
129 : MultirangeIOData *cache;
130 : MultirangeType *ret;
131 : MultirangeParseState parse_state;
132 1380 : const char *ptr = input_str;
133 1380 : const char *range_str_begin = NULL;
134 : int32 range_str_len;
135 : char *range_str;
136 : Datum range_datum;
137 :
138 1380 : cache = get_multirange_io_data(fcinfo, mltrngtypoid, IOFunc_input);
139 1380 : rangetyp = cache->typcache->rngtype;
140 :
141 : /* consume whitespace */
142 1404 : while (*ptr != '\0' && isspace((unsigned char) *ptr))
143 24 : ptr++;
144 :
145 1380 : if (*ptr == '{')
146 1374 : ptr++;
147 : else
148 6 : ereturn(escontext, (Datum) 0,
149 : (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
150 : errmsg("malformed multirange literal: \"%s\"",
151 : input_str),
152 : errdetail("Missing left brace.")));
153 :
154 : /* consume ranges */
155 1374 : parse_state = MULTIRANGE_BEFORE_RANGE;
156 13764 : for (; parse_state != MULTIRANGE_FINISHED; ptr++)
157 : {
158 12486 : char ch = *ptr;
159 :
160 12486 : if (ch == '\0')
161 18 : ereturn(escontext, (Datum) 0,
162 : (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
163 : errmsg("malformed multirange literal: \"%s\"",
164 : input_str),
165 : errdetail("Unexpected end of input.")));
166 :
167 : /* skip whitespace */
168 12468 : if (isspace((unsigned char) ch))
169 576 : continue;
170 :
171 11892 : switch (parse_state)
172 : {
173 1854 : case MULTIRANGE_BEFORE_RANGE:
174 1854 : if (ch == '[' || ch == '(')
175 : {
176 1524 : range_str_begin = ptr;
177 1524 : parse_state = MULTIRANGE_IN_RANGE;
178 : }
179 330 : else if (ch == '}' && ranges_seen == 0)
180 288 : parse_state = MULTIRANGE_FINISHED;
181 42 : else if (pg_strncasecmp(ptr, RANGE_EMPTY_LITERAL,
182 : strlen(RANGE_EMPTY_LITERAL)) == 0)
183 : {
184 18 : ranges_seen++;
185 : /* nothing to do with an empty range */
186 18 : ptr += strlen(RANGE_EMPTY_LITERAL) - 1;
187 18 : parse_state = MULTIRANGE_AFTER_RANGE;
188 : }
189 : else
190 24 : ereturn(escontext, (Datum) 0,
191 : (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
192 : errmsg("malformed multirange literal: \"%s\"",
193 : input_str),
194 : errdetail("Expected range start.")));
195 1830 : break;
196 8370 : case MULTIRANGE_IN_RANGE:
197 8370 : if (ch == ']' || ch == ')')
198 : {
199 1518 : range_str_len = ptr - range_str_begin + 1;
200 1518 : range_str = pnstrdup(range_str_begin, range_str_len);
201 1518 : if (range_capacity == range_count)
202 : {
203 0 : range_capacity *= 2;
204 : ranges = (RangeType **)
205 0 : repalloc(ranges, range_capacity * sizeof(RangeType *));
206 : }
207 1518 : ranges_seen++;
208 1518 : if (!InputFunctionCallSafe(&cache->typioproc,
209 : range_str,
210 : cache->typioparam,
211 : typmod,
212 : escontext,
213 : &range_datum))
214 12 : PG_RETURN_NULL();
215 1482 : range = DatumGetRangeTypeP(range_datum);
216 1482 : if (!RangeIsEmpty(range))
217 1452 : ranges[range_count++] = range;
218 1482 : parse_state = MULTIRANGE_AFTER_RANGE;
219 : }
220 : else
221 : {
222 6852 : if (ch == '"')
223 78 : parse_state = MULTIRANGE_IN_RANGE_QUOTED;
224 6774 : else if (ch == '\\')
225 6 : parse_state = MULTIRANGE_IN_RANGE_ESCAPED;
226 :
227 : /*
228 : * We will include this character into range_str once we
229 : * find the end of the range value.
230 : */
231 : }
232 8334 : break;
233 6 : case MULTIRANGE_IN_RANGE_ESCAPED:
234 :
235 : /*
236 : * We will include this character into range_str once we find
237 : * the end of the range value.
238 : */
239 6 : parse_state = MULTIRANGE_IN_RANGE;
240 6 : break;
241 156 : case MULTIRANGE_IN_RANGE_QUOTED:
242 156 : if (ch == '"')
243 78 : if (*(ptr + 1) == '"')
244 : {
245 : /* two quote marks means an escaped quote mark */
246 6 : ptr++;
247 : }
248 : else
249 72 : parse_state = MULTIRANGE_IN_RANGE;
250 78 : else if (ch == '\\')
251 18 : parse_state = MULTIRANGE_IN_RANGE_QUOTED_ESCAPED;
252 :
253 : /*
254 : * We will include this character into range_str once we find
255 : * the end of the range value.
256 : */
257 156 : break;
258 1488 : case MULTIRANGE_AFTER_RANGE:
259 1488 : if (ch == ',')
260 480 : parse_state = MULTIRANGE_BEFORE_RANGE;
261 1008 : else if (ch == '}')
262 990 : parse_state = MULTIRANGE_FINISHED;
263 : else
264 18 : ereturn(escontext, (Datum) 0,
265 : (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
266 : errmsg("malformed multirange literal: \"%s\"",
267 : input_str),
268 : errdetail("Expected comma or end of multirange.")));
269 1470 : break;
270 18 : case MULTIRANGE_IN_RANGE_QUOTED_ESCAPED:
271 :
272 : /*
273 : * We will include this character into range_str once we find
274 : * the end of the range value.
275 : */
276 18 : parse_state = MULTIRANGE_IN_RANGE_QUOTED;
277 18 : break;
278 0 : default:
279 0 : elog(ERROR, "unknown parse state: %d", parse_state);
280 : }
281 : }
282 :
283 : /* consume whitespace */
284 1302 : while (*ptr != '\0' && isspace((unsigned char) *ptr))
285 24 : ptr++;
286 :
287 1278 : if (*ptr != '\0')
288 6 : ereturn(escontext, (Datum) 0,
289 : (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
290 : errmsg("malformed multirange literal: \"%s\"",
291 : input_str),
292 : errdetail("Junk after closing right brace.")));
293 :
294 1272 : ret = make_multirange(mltrngtypoid, rangetyp, range_count, ranges);
295 1272 : PG_RETURN_MULTIRANGE_P(ret);
296 : }
297 :
298 : Datum
299 2666 : multirange_out(PG_FUNCTION_ARGS)
300 : {
301 2666 : MultirangeType *multirange = PG_GETARG_MULTIRANGE_P(0);
302 2666 : Oid mltrngtypoid = MultirangeTypeGetOid(multirange);
303 : MultirangeIOData *cache;
304 : StringInfoData buf;
305 : RangeType *range;
306 : char *rangeStr;
307 : int32 range_count;
308 : int32 i;
309 : RangeType **ranges;
310 :
311 2666 : cache = get_multirange_io_data(fcinfo, mltrngtypoid, IOFunc_output);
312 :
313 2666 : initStringInfo(&buf);
314 :
315 2666 : appendStringInfoChar(&buf, '{');
316 :
317 2666 : multirange_deserialize(cache->typcache->rngtype, multirange, &range_count, &ranges);
318 5088 : for (i = 0; i < range_count; i++)
319 : {
320 2422 : if (i > 0)
321 266 : appendStringInfoChar(&buf, ',');
322 2422 : range = ranges[i];
323 2422 : rangeStr = OutputFunctionCall(&cache->typioproc, RangeTypePGetDatum(range));
324 2422 : appendStringInfoString(&buf, rangeStr);
325 : }
326 :
327 2666 : appendStringInfoChar(&buf, '}');
328 :
329 2666 : PG_RETURN_CSTRING(buf.data);
330 : }
331 :
332 : /*
333 : * Binary representation: First an int32-sized count of ranges, followed by
334 : * ranges in their native binary representation.
335 : */
336 : Datum
337 0 : multirange_recv(PG_FUNCTION_ARGS)
338 : {
339 0 : StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
340 0 : Oid mltrngtypoid = PG_GETARG_OID(1);
341 0 : int32 typmod = PG_GETARG_INT32(2);
342 : MultirangeIOData *cache;
343 : uint32 range_count;
344 : RangeType **ranges;
345 : MultirangeType *ret;
346 : StringInfoData tmpbuf;
347 :
348 0 : cache = get_multirange_io_data(fcinfo, mltrngtypoid, IOFunc_receive);
349 :
350 0 : range_count = pq_getmsgint(buf, 4);
351 0 : ranges = palloc(range_count * sizeof(RangeType *));
352 :
353 0 : initStringInfo(&tmpbuf);
354 0 : for (int i = 0; i < range_count; i++)
355 : {
356 0 : uint32 range_len = pq_getmsgint(buf, 4);
357 0 : const char *range_data = pq_getmsgbytes(buf, range_len);
358 :
359 0 : resetStringInfo(&tmpbuf);
360 0 : appendBinaryStringInfo(&tmpbuf, range_data, range_len);
361 :
362 0 : ranges[i] = DatumGetRangeTypeP(ReceiveFunctionCall(&cache->typioproc,
363 : &tmpbuf,
364 : cache->typioparam,
365 : typmod));
366 : }
367 0 : pfree(tmpbuf.data);
368 :
369 0 : pq_getmsgend(buf);
370 :
371 0 : ret = make_multirange(mltrngtypoid, cache->typcache->rngtype,
372 : range_count, ranges);
373 0 : PG_RETURN_MULTIRANGE_P(ret);
374 : }
375 :
376 : Datum
377 0 : multirange_send(PG_FUNCTION_ARGS)
378 : {
379 0 : MultirangeType *multirange = PG_GETARG_MULTIRANGE_P(0);
380 0 : Oid mltrngtypoid = MultirangeTypeGetOid(multirange);
381 0 : StringInfo buf = makeStringInfo();
382 : RangeType **ranges;
383 : int32 range_count;
384 : MultirangeIOData *cache;
385 :
386 0 : cache = get_multirange_io_data(fcinfo, mltrngtypoid, IOFunc_send);
387 :
388 : /* construct output */
389 0 : pq_begintypsend(buf);
390 :
391 0 : pq_sendint32(buf, multirange->rangeCount);
392 :
393 0 : multirange_deserialize(cache->typcache->rngtype, multirange, &range_count, &ranges);
394 0 : for (int i = 0; i < range_count; i++)
395 : {
396 : Datum range;
397 : bytea *outputbytes;
398 :
399 0 : range = RangeTypePGetDatum(ranges[i]);
400 0 : outputbytes = SendFunctionCall(&cache->typioproc, range);
401 :
402 0 : pq_sendint32(buf, VARSIZE(outputbytes) - VARHDRSZ);
403 0 : pq_sendbytes(buf, VARDATA(outputbytes), VARSIZE(outputbytes) - VARHDRSZ);
404 : }
405 :
406 0 : PG_RETURN_BYTEA_P(pq_endtypsend(buf));
407 : }
408 :
409 : /*
410 : * get_multirange_io_data: get cached information needed for multirange type I/O
411 : *
412 : * The multirange I/O functions need a bit more cached info than other multirange
413 : * functions, so they store a MultirangeIOData struct in fn_extra, not just a
414 : * pointer to a type cache entry.
415 : */
416 : static MultirangeIOData *
417 4046 : get_multirange_io_data(FunctionCallInfo fcinfo, Oid mltrngtypid, IOFuncSelector func)
418 : {
419 4046 : MultirangeIOData *cache = (MultirangeIOData *) fcinfo->flinfo->fn_extra;
420 :
421 4046 : if (cache == NULL || cache->typcache->type_id != mltrngtypid)
422 : {
423 : Oid typiofunc;
424 : int16 typlen;
425 : bool typbyval;
426 : char typalign;
427 : char typdelim;
428 :
429 2748 : cache = (MultirangeIOData *) MemoryContextAlloc(fcinfo->flinfo->fn_mcxt,
430 : sizeof(MultirangeIOData));
431 2748 : cache->typcache = lookup_type_cache(mltrngtypid, TYPECACHE_MULTIRANGE_INFO);
432 2748 : if (cache->typcache->rngtype == NULL)
433 0 : elog(ERROR, "type %u is not a multirange type", mltrngtypid);
434 :
435 : /* get_type_io_data does more than we need, but is convenient */
436 2748 : get_type_io_data(cache->typcache->rngtype->type_id,
437 : func,
438 : &typlen,
439 : &typbyval,
440 : &typalign,
441 : &typdelim,
442 : &cache->typioparam,
443 : &typiofunc);
444 :
445 2748 : if (!OidIsValid(typiofunc))
446 : {
447 : /* this could only happen for receive or send */
448 0 : if (func == IOFunc_receive)
449 0 : ereport(ERROR,
450 : (errcode(ERRCODE_UNDEFINED_FUNCTION),
451 : errmsg("no binary input function available for type %s",
452 : format_type_be(cache->typcache->rngtype->type_id))));
453 : else
454 0 : ereport(ERROR,
455 : (errcode(ERRCODE_UNDEFINED_FUNCTION),
456 : errmsg("no binary output function available for type %s",
457 : format_type_be(cache->typcache->rngtype->type_id))));
458 : }
459 2748 : fmgr_info_cxt(typiofunc, &cache->typioproc,
460 2748 : fcinfo->flinfo->fn_mcxt);
461 :
462 2748 : fcinfo->flinfo->fn_extra = cache;
463 : }
464 :
465 4046 : return cache;
466 : }
467 :
468 : /*
469 : * Converts a list of arbitrary ranges into a list that is sorted and merged.
470 : * Changes the contents of `ranges`.
471 : *
472 : * Returns the number of slots actually used, which may be less than
473 : * input_range_count but never more.
474 : *
475 : * We assume that no input ranges are null, but empties are okay.
476 : */
477 : static int32
478 24934 : multirange_canonicalize(TypeCacheEntry *rangetyp, int32 input_range_count,
479 : RangeType **ranges)
480 : {
481 24934 : RangeType *lastRange = NULL;
482 : RangeType *currentRange;
483 : int32 i;
484 24934 : int32 output_range_count = 0;
485 :
486 : /* Sort the ranges so we can find the ones that overlap/meet. */
487 24934 : qsort_arg(ranges, input_range_count, sizeof(RangeType *), range_compare,
488 : rangetyp);
489 :
490 : /* Now merge where possible: */
491 75814 : for (i = 0; i < input_range_count; i++)
492 : {
493 50880 : currentRange = ranges[i];
494 50880 : if (RangeIsEmpty(currentRange))
495 186 : continue;
496 :
497 50694 : if (lastRange == NULL)
498 : {
499 24004 : ranges[output_range_count++] = lastRange = currentRange;
500 24004 : continue;
501 : }
502 :
503 : /*
504 : * range_adjacent_internal gives true if *either* A meets B or B meets
505 : * A, which is not quite want we want, but we rely on the sorting
506 : * above to rule out B meets A ever happening.
507 : */
508 26690 : if (range_adjacent_internal(rangetyp, lastRange, currentRange))
509 : {
510 : /* The two ranges touch (without overlap), so merge them: */
511 1406 : ranges[output_range_count - 1] = lastRange =
512 1406 : range_union_internal(rangetyp, lastRange, currentRange, false);
513 : }
514 25284 : else if (range_before_internal(rangetyp, lastRange, currentRange))
515 : {
516 : /* There's a gap, so make a new entry: */
517 25164 : lastRange = ranges[output_range_count] = currentRange;
518 25164 : output_range_count++;
519 : }
520 : else
521 : {
522 : /* They must overlap, so merge them: */
523 120 : ranges[output_range_count - 1] = lastRange =
524 120 : range_union_internal(rangetyp, lastRange, currentRange, true);
525 : }
526 : }
527 :
528 24934 : return output_range_count;
529 : }
530 :
531 : /*
532 : *----------------------------------------------------------
533 : * SUPPORT FUNCTIONS
534 : *
535 : * These functions aren't in pg_proc, but are useful for
536 : * defining new generic multirange functions in C.
537 : *----------------------------------------------------------
538 : */
539 :
540 : /*
541 : * multirange_get_typcache: get cached information about a multirange type
542 : *
543 : * This is for use by multirange-related functions that follow the convention
544 : * of using the fn_extra field as a pointer to the type cache entry for
545 : * the multirange type. Functions that need to cache more information than
546 : * that must fend for themselves.
547 : */
548 : TypeCacheEntry *
549 1254844 : multirange_get_typcache(FunctionCallInfo fcinfo, Oid mltrngtypid)
550 : {
551 1254844 : TypeCacheEntry *typcache = (TypeCacheEntry *) fcinfo->flinfo->fn_extra;
552 :
553 1254844 : if (typcache == NULL ||
554 1245798 : typcache->type_id != mltrngtypid)
555 : {
556 9046 : typcache = lookup_type_cache(mltrngtypid, TYPECACHE_MULTIRANGE_INFO);
557 9046 : if (typcache->rngtype == NULL)
558 0 : elog(ERROR, "type %u is not a multirange type", mltrngtypid);
559 9046 : fcinfo->flinfo->fn_extra = typcache;
560 : }
561 :
562 1254844 : return typcache;
563 : }
564 :
565 :
566 : /*
567 : * Estimate size occupied by serialized multirange.
568 : */
569 : static Size
570 24934 : multirange_size_estimate(TypeCacheEntry *rangetyp, int32 range_count,
571 : RangeType **ranges)
572 : {
573 24934 : char elemalign = rangetyp->rngelemtype->typalign;
574 : Size size;
575 : int32 i;
576 :
577 : /*
578 : * Count space for MultirangeType struct, items and flags.
579 : */
580 24934 : size = att_align_nominal(sizeof(MultirangeType) +
581 : Max(range_count - 1, 0) * sizeof(uint32) +
582 : range_count * sizeof(uint8), elemalign);
583 :
584 : /* Count space for range bounds */
585 74102 : for (i = 0; i < range_count; i++)
586 49168 : size += att_align_nominal(VARSIZE(ranges[i]) -
587 : sizeof(RangeType) -
588 : sizeof(char), elemalign);
589 :
590 24934 : return size;
591 : }
592 :
593 : /*
594 : * Write multirange data into pre-allocated space.
595 : */
596 : static void
597 24934 : write_multirange_data(MultirangeType *multirange, TypeCacheEntry *rangetyp,
598 : int32 range_count, RangeType **ranges)
599 : {
600 : uint32 *items;
601 24934 : uint32 prev_offset = 0;
602 : uint8 *flags;
603 : int32 i;
604 : Pointer begin,
605 : ptr;
606 24934 : char elemalign = rangetyp->rngelemtype->typalign;
607 :
608 24934 : items = MultirangeGetItemsPtr(multirange);
609 24934 : flags = MultirangeGetFlagsPtr(multirange);
610 24934 : ptr = begin = MultirangeGetBoundariesPtr(multirange, elemalign);
611 74102 : for (i = 0; i < range_count; i++)
612 : {
613 : uint32 len;
614 :
615 49168 : if (i > 0)
616 : {
617 : /*
618 : * Every range, except the first one, has an item. Every
619 : * MULTIRANGE_ITEM_OFFSET_STRIDE item contains an offset, others
620 : * contain lengths.
621 : */
622 25164 : items[i - 1] = ptr - begin;
623 25164 : if ((i % MULTIRANGE_ITEM_OFFSET_STRIDE) != 0)
624 25164 : items[i - 1] -= prev_offset;
625 : else
626 0 : items[i - 1] |= MULTIRANGE_ITEM_OFF_BIT;
627 25164 : prev_offset = ptr - begin;
628 : }
629 49168 : flags[i] = *((Pointer) ranges[i] + VARSIZE(ranges[i]) - sizeof(char));
630 49168 : len = VARSIZE(ranges[i]) - sizeof(RangeType) - sizeof(char);
631 49168 : memcpy(ptr, (Pointer) (ranges[i] + 1), len);
632 49168 : ptr += att_align_nominal(len, elemalign);
633 : }
634 24934 : }
635 :
636 :
637 : /*
638 : * This serializes the multirange from a list of non-null ranges. It also
639 : * sorts the ranges and merges any that touch. The ranges should already be
640 : * detoasted, and there should be no NULLs. This should be used by most
641 : * callers.
642 : *
643 : * Note that we may change the `ranges` parameter (the pointers, but not
644 : * any already-existing RangeType contents).
645 : */
646 : MultirangeType *
647 24934 : make_multirange(Oid mltrngtypoid, TypeCacheEntry *rangetyp, int32 range_count,
648 : RangeType **ranges)
649 : {
650 : MultirangeType *multirange;
651 : Size size;
652 :
653 : /* Sort and merge input ranges. */
654 24934 : range_count = multirange_canonicalize(rangetyp, range_count, ranges);
655 :
656 : /* Note: zero-fill is required here, just as in heap tuples */
657 24934 : size = multirange_size_estimate(rangetyp, range_count, ranges);
658 24934 : multirange = palloc0(size);
659 24934 : SET_VARSIZE(multirange, size);
660 :
661 : /* Now fill in the datum */
662 24934 : multirange->multirangetypid = mltrngtypoid;
663 24934 : multirange->rangeCount = range_count;
664 :
665 24934 : write_multirange_data(multirange, rangetyp, range_count, ranges);
666 :
667 24934 : return multirange;
668 : }
669 :
670 : /*
671 : * Get offset of bounds values of the i'th range in the multirange.
672 : */
673 : static uint32
674 1605328 : multirange_get_bounds_offset(const MultirangeType *multirange, int32 i)
675 : {
676 1605328 : uint32 *items = MultirangeGetItemsPtr(multirange);
677 1605328 : uint32 offset = 0;
678 :
679 : /*
680 : * Summarize lengths till we meet an offset.
681 : */
682 2594282 : while (i > 0)
683 : {
684 988954 : offset += MULTIRANGE_ITEM_GET_OFFLEN(items[i - 1]);
685 988954 : if (MULTIRANGE_ITEM_HAS_OFF(items[i - 1]))
686 0 : break;
687 988954 : i--;
688 : }
689 1605328 : return offset;
690 : }
691 :
692 : /*
693 : * Fetch the i'th range from the multirange.
694 : */
695 : RangeType *
696 3718 : multirange_get_range(TypeCacheEntry *rangetyp,
697 : const MultirangeType *multirange, int i)
698 : {
699 : uint32 offset;
700 : uint8 flags;
701 : Pointer begin,
702 : ptr;
703 3718 : int16 typlen = rangetyp->rngelemtype->typlen;
704 3718 : char typalign = rangetyp->rngelemtype->typalign;
705 : uint32 len;
706 : RangeType *range;
707 :
708 : Assert(i < multirange->rangeCount);
709 :
710 3718 : offset = multirange_get_bounds_offset(multirange, i);
711 3718 : flags = MultirangeGetFlagsPtr(multirange)[i];
712 3718 : ptr = begin = MultirangeGetBoundariesPtr(multirange, typalign) + offset;
713 :
714 : /*
715 : * Calculate the size of bound values. In principle, we could get offset
716 : * of the next range bound values and calculate accordingly. But range
717 : * bound values are aligned, so we have to walk the values to get the
718 : * exact size.
719 : */
720 3718 : if (RANGE_HAS_LBOUND(flags))
721 3070 : ptr = (Pointer) att_addlength_pointer(ptr, typlen, ptr);
722 3718 : if (RANGE_HAS_UBOUND(flags))
723 : {
724 2998 : ptr = (Pointer) att_align_pointer(ptr, typalign, typlen, ptr);
725 2998 : ptr = (Pointer) att_addlength_pointer(ptr, typlen, ptr);
726 : }
727 3718 : len = (ptr - begin) + sizeof(RangeType) + sizeof(uint8);
728 :
729 3718 : range = palloc0(len);
730 3718 : SET_VARSIZE(range, len);
731 3718 : range->rangetypid = rangetyp->type_id;
732 :
733 3718 : memcpy(range + 1, begin, ptr - begin);
734 3718 : *((uint8 *) (range + 1) + (ptr - begin)) = flags;
735 :
736 3718 : return range;
737 : }
738 :
739 : /*
740 : * Fetch bounds from the i'th range of the multirange. This is the shortcut for
741 : * doing the same thing as multirange_get_range() + range_deserialize(), but
742 : * performing fewer operations.
743 : */
744 : void
745 1601610 : multirange_get_bounds(TypeCacheEntry *rangetyp,
746 : const MultirangeType *multirange,
747 : uint32 i, RangeBound *lower, RangeBound *upper)
748 : {
749 : uint32 offset;
750 : uint8 flags;
751 : Pointer ptr;
752 1601610 : int16 typlen = rangetyp->rngelemtype->typlen;
753 1601610 : char typalign = rangetyp->rngelemtype->typalign;
754 1601610 : bool typbyval = rangetyp->rngelemtype->typbyval;
755 : Datum lbound;
756 : Datum ubound;
757 :
758 : Assert(i < multirange->rangeCount);
759 :
760 1601610 : offset = multirange_get_bounds_offset(multirange, i);
761 1601610 : flags = MultirangeGetFlagsPtr(multirange)[i];
762 1601610 : ptr = MultirangeGetBoundariesPtr(multirange, typalign) + offset;
763 :
764 : /* multirange can't contain empty ranges */
765 : Assert((flags & RANGE_EMPTY) == 0);
766 :
767 : /* fetch lower bound, if any */
768 1601610 : if (RANGE_HAS_LBOUND(flags))
769 : {
770 : /* att_align_pointer cannot be necessary here */
771 1584006 : lbound = fetch_att(ptr, typbyval, typlen);
772 1584006 : ptr = (Pointer) att_addlength_pointer(ptr, typlen, ptr);
773 : }
774 : else
775 17604 : lbound = (Datum) 0;
776 :
777 : /* fetch upper bound, if any */
778 1601610 : if (RANGE_HAS_UBOUND(flags))
779 : {
780 1585368 : ptr = (Pointer) att_align_pointer(ptr, typalign, typlen, ptr);
781 1585368 : ubound = fetch_att(ptr, typbyval, typlen);
782 : /* no need for att_addlength_pointer */
783 : }
784 : else
785 16242 : ubound = (Datum) 0;
786 :
787 : /* emit results */
788 1601610 : lower->val = lbound;
789 1601610 : lower->infinite = (flags & RANGE_LB_INF) != 0;
790 1601610 : lower->inclusive = (flags & RANGE_LB_INC) != 0;
791 1601610 : lower->lower = true;
792 :
793 1601610 : upper->val = ubound;
794 1601610 : upper->infinite = (flags & RANGE_UB_INF) != 0;
795 1601610 : upper->inclusive = (flags & RANGE_UB_INC) != 0;
796 1601610 : upper->lower = false;
797 1601610 : }
798 :
799 : /*
800 : * Construct union range from the multirange.
801 : */
802 : RangeType *
803 23106 : multirange_get_union_range(TypeCacheEntry *rangetyp,
804 : const MultirangeType *mr)
805 : {
806 : RangeBound lower,
807 : upper,
808 : tmp;
809 :
810 23106 : if (MultirangeIsEmpty(mr))
811 3042 : return make_empty_range(rangetyp);
812 :
813 20064 : multirange_get_bounds(rangetyp, mr, 0, &lower, &tmp);
814 20064 : multirange_get_bounds(rangetyp, mr, mr->rangeCount - 1, &tmp, &upper);
815 :
816 20064 : return make_range(rangetyp, &lower, &upper, false, NULL);
817 : }
818 :
819 :
820 : /*
821 : * multirange_deserialize: deconstruct a multirange value
822 : *
823 : * NB: the given multirange object must be fully detoasted; it cannot have a
824 : * short varlena header.
825 : */
826 : void
827 3842 : multirange_deserialize(TypeCacheEntry *rangetyp,
828 : const MultirangeType *multirange, int32 *range_count,
829 : RangeType ***ranges)
830 : {
831 3842 : *range_count = multirange->rangeCount;
832 :
833 : /* Convert each ShortRangeType into a RangeType */
834 3842 : if (*range_count > 0)
835 : {
836 : int i;
837 :
838 3212 : *ranges = palloc(*range_count * sizeof(RangeType *));
839 6870 : for (i = 0; i < *range_count; i++)
840 3658 : (*ranges)[i] = multirange_get_range(rangetyp, multirange, i);
841 : }
842 : else
843 : {
844 630 : *ranges = NULL;
845 : }
846 3842 : }
847 :
848 : MultirangeType *
849 18 : make_empty_multirange(Oid mltrngtypoid, TypeCacheEntry *rangetyp)
850 : {
851 18 : return make_multirange(mltrngtypoid, rangetyp, 0, NULL);
852 : }
853 :
854 : /*
855 : * Similar to range_overlaps_internal(), but takes range bounds instead of
856 : * ranges as arguments.
857 : */
858 : static bool
859 58434 : range_bounds_overlaps(TypeCacheEntry *typcache,
860 : RangeBound *lower1, RangeBound *upper1,
861 : RangeBound *lower2, RangeBound *upper2)
862 : {
863 114558 : if (range_cmp_bounds(typcache, lower1, lower2) >= 0 &&
864 56124 : range_cmp_bounds(typcache, lower1, upper2) <= 0)
865 912 : return true;
866 :
867 59832 : if (range_cmp_bounds(typcache, lower2, lower1) >= 0 &&
868 2310 : range_cmp_bounds(typcache, lower2, upper1) <= 0)
869 2310 : return true;
870 :
871 55212 : return false;
872 : }
873 :
874 : /*
875 : * Similar to range_contains_internal(), but takes range bounds instead of
876 : * ranges as arguments.
877 : */
878 : static bool
879 94514 : range_bounds_contains(TypeCacheEntry *typcache,
880 : RangeBound *lower1, RangeBound *upper1,
881 : RangeBound *lower2, RangeBound *upper2)
882 : {
883 125430 : if (range_cmp_bounds(typcache, lower1, lower2) <= 0 &&
884 30916 : range_cmp_bounds(typcache, upper1, upper2) >= 0)
885 8912 : return true;
886 :
887 85602 : return false;
888 : }
889 :
890 : /*
891 : * Check if the given key matches any range in multirange using binary search.
892 : * If the required range isn't found, that counts as a mismatch. When the
893 : * required range is found, the comparison function can still report this as
894 : * either match or mismatch. For instance, if we search for containment, we can
895 : * found a range, which is overlapping but not containing the key range, and
896 : * that would count as a mismatch.
897 : */
898 : static bool
899 154692 : multirange_bsearch_match(TypeCacheEntry *typcache, const MultirangeType *mr,
900 : void *key, multirange_bsearch_comparison cmp_func)
901 : {
902 : uint32 l,
903 : u,
904 : idx;
905 : int comparison;
906 154692 : bool match = false;
907 :
908 154692 : l = 0;
909 154692 : u = mr->rangeCount;
910 404408 : while (l < u)
911 : {
912 : RangeBound lower,
913 : upper;
914 :
915 271890 : idx = (l + u) / 2;
916 271890 : multirange_get_bounds(typcache, mr, idx, &lower, &upper);
917 271890 : comparison = (*cmp_func) (typcache, &lower, &upper, key, &match);
918 :
919 271890 : if (comparison < 0)
920 94232 : u = idx;
921 177658 : else if (comparison > 0)
922 155484 : l = idx + 1;
923 : else
924 22174 : return match;
925 : }
926 :
927 132518 : return false;
928 : }
929 :
930 : /*
931 : *----------------------------------------------------------
932 : * GENERIC FUNCTIONS
933 : *----------------------------------------------------------
934 : */
935 :
936 : /*
937 : * Construct multirange value from zero or more ranges. Since this is a
938 : * variadic function we get passed an array. The array must contain ranges
939 : * that match our return value, and there must be no NULLs.
940 : */
941 : Datum
942 13806 : multirange_constructor2(PG_FUNCTION_ARGS)
943 : {
944 13806 : Oid mltrngtypid = get_fn_expr_rettype(fcinfo->flinfo);
945 : Oid rngtypid;
946 : TypeCacheEntry *typcache;
947 : TypeCacheEntry *rangetyp;
948 : ArrayType *rangeArray;
949 : int range_count;
950 : Datum *elements;
951 : bool *nulls;
952 : RangeType **ranges;
953 : int dims;
954 : int i;
955 :
956 13806 : typcache = multirange_get_typcache(fcinfo, mltrngtypid);
957 13806 : rangetyp = typcache->rngtype;
958 :
959 : /*
960 : * A no-arg invocation should call multirange_constructor0 instead, but
961 : * returning an empty range is what that does.
962 : */
963 :
964 13806 : if (PG_NARGS() == 0)
965 0 : PG_RETURN_MULTIRANGE_P(make_multirange(mltrngtypid, rangetyp, 0, NULL));
966 :
967 : /*
968 : * This check should be guaranteed by our signature, but let's do it just
969 : * in case.
970 : */
971 :
972 13806 : if (PG_ARGISNULL(0))
973 0 : elog(ERROR,
974 : "multirange values cannot contain null members");
975 :
976 13806 : rangeArray = PG_GETARG_ARRAYTYPE_P(0);
977 :
978 13806 : dims = ARR_NDIM(rangeArray);
979 13806 : if (dims > 1)
980 0 : ereport(ERROR,
981 : (errcode(ERRCODE_CARDINALITY_VIOLATION),
982 : errmsg("multiranges cannot be constructed from multidimensional arrays")));
983 :
984 13806 : rngtypid = ARR_ELEMTYPE(rangeArray);
985 13806 : if (rngtypid != rangetyp->type_id)
986 0 : elog(ERROR, "type %u does not match constructor type", rngtypid);
987 :
988 : /*
989 : * Be careful: we can still be called with zero ranges, like this:
990 : * `int4multirange(variadic '{}'::int4range[])
991 : */
992 13806 : if (dims == 0)
993 : {
994 6 : range_count = 0;
995 6 : ranges = NULL;
996 : }
997 : else
998 : {
999 13800 : deconstruct_array(rangeArray, rngtypid, rangetyp->typlen, rangetyp->typbyval,
1000 13800 : rangetyp->typalign, &elements, &nulls, &range_count);
1001 :
1002 13800 : ranges = palloc0(range_count * sizeof(RangeType *));
1003 53412 : for (i = 0; i < range_count; i++)
1004 : {
1005 39612 : if (nulls[i])
1006 0 : ereport(ERROR,
1007 : (errcode(ERRCODE_NULL_VALUE_NOT_ALLOWED),
1008 : errmsg("multirange values cannot contain null members")));
1009 :
1010 : /* make_multirange will do its own copy */
1011 39612 : ranges[i] = DatumGetRangeTypeP(elements[i]);
1012 : }
1013 : }
1014 :
1015 13806 : PG_RETURN_MULTIRANGE_P(make_multirange(mltrngtypid, rangetyp, range_count, ranges));
1016 : }
1017 :
1018 : /*
1019 : * Construct multirange value from a single range. It'd be nice if we could
1020 : * just use multirange_constructor2 for this case, but we need a non-variadic
1021 : * single-arg function to let us define a CAST from a range to its multirange.
1022 : */
1023 : Datum
1024 8208 : multirange_constructor1(PG_FUNCTION_ARGS)
1025 : {
1026 8208 : Oid mltrngtypid = get_fn_expr_rettype(fcinfo->flinfo);
1027 : Oid rngtypid;
1028 : TypeCacheEntry *typcache;
1029 : TypeCacheEntry *rangetyp;
1030 : RangeType *range;
1031 :
1032 8208 : typcache = multirange_get_typcache(fcinfo, mltrngtypid);
1033 8208 : rangetyp = typcache->rngtype;
1034 :
1035 : /*
1036 : * This check should be guaranteed by our signature, but let's do it just
1037 : * in case.
1038 : */
1039 :
1040 8208 : if (PG_ARGISNULL(0))
1041 0 : elog(ERROR,
1042 : "multirange values cannot contain null members");
1043 :
1044 8208 : range = PG_GETARG_RANGE_P(0);
1045 :
1046 : /* Make sure the range type matches. */
1047 8208 : rngtypid = RangeTypeGetOid(range);
1048 8208 : if (rngtypid != rangetyp->type_id)
1049 0 : elog(ERROR, "type %u does not match constructor type", rngtypid);
1050 :
1051 8208 : PG_RETURN_MULTIRANGE_P(make_multirange(mltrngtypid, rangetyp, 1, &range));
1052 : }
1053 :
1054 : /*
1055 : * Constructor just like multirange_constructor1, but opr_sanity gets angry
1056 : * if the same internal function handles multiple functions with different arg
1057 : * counts.
1058 : */
1059 : Datum
1060 372 : multirange_constructor0(PG_FUNCTION_ARGS)
1061 : {
1062 : Oid mltrngtypid;
1063 : TypeCacheEntry *typcache;
1064 : TypeCacheEntry *rangetyp;
1065 :
1066 : /* This should always be called without arguments */
1067 372 : if (PG_NARGS() != 0)
1068 0 : elog(ERROR,
1069 : "niladic multirange constructor must not receive arguments");
1070 :
1071 372 : mltrngtypid = get_fn_expr_rettype(fcinfo->flinfo);
1072 372 : typcache = multirange_get_typcache(fcinfo, mltrngtypid);
1073 372 : rangetyp = typcache->rngtype;
1074 :
1075 372 : PG_RETURN_MULTIRANGE_P(make_multirange(mltrngtypid, rangetyp, 0, NULL));
1076 : }
1077 :
1078 :
1079 : /* multirange, multirange -> multirange type functions */
1080 :
1081 : /* multirange union */
1082 : Datum
1083 54 : multirange_union(PG_FUNCTION_ARGS)
1084 : {
1085 54 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1086 54 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1087 : TypeCacheEntry *typcache;
1088 : int32 range_count1;
1089 : int32 range_count2;
1090 : int32 range_count3;
1091 : RangeType **ranges1;
1092 : RangeType **ranges2;
1093 : RangeType **ranges3;
1094 :
1095 54 : if (MultirangeIsEmpty(mr1))
1096 12 : PG_RETURN_MULTIRANGE_P(mr2);
1097 42 : if (MultirangeIsEmpty(mr2))
1098 6 : PG_RETURN_MULTIRANGE_P(mr1);
1099 :
1100 36 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
1101 :
1102 36 : multirange_deserialize(typcache->rngtype, mr1, &range_count1, &ranges1);
1103 36 : multirange_deserialize(typcache->rngtype, mr2, &range_count2, &ranges2);
1104 :
1105 36 : range_count3 = range_count1 + range_count2;
1106 36 : ranges3 = palloc0(range_count3 * sizeof(RangeType *));
1107 36 : memcpy(ranges3, ranges1, range_count1 * sizeof(RangeType *));
1108 36 : memcpy(ranges3 + range_count1, ranges2, range_count2 * sizeof(RangeType *));
1109 36 : PG_RETURN_MULTIRANGE_P(make_multirange(typcache->type_id, typcache->rngtype,
1110 : range_count3, ranges3));
1111 : }
1112 :
1113 : /* multirange minus */
1114 : Datum
1115 120 : multirange_minus(PG_FUNCTION_ARGS)
1116 : {
1117 120 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1118 120 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1119 120 : Oid mltrngtypoid = MultirangeTypeGetOid(mr1);
1120 : TypeCacheEntry *typcache;
1121 : TypeCacheEntry *rangetyp;
1122 : int32 range_count1;
1123 : int32 range_count2;
1124 : RangeType **ranges1;
1125 : RangeType **ranges2;
1126 :
1127 120 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
1128 120 : rangetyp = typcache->rngtype;
1129 :
1130 120 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
1131 24 : PG_RETURN_MULTIRANGE_P(mr1);
1132 :
1133 96 : multirange_deserialize(typcache->rngtype, mr1, &range_count1, &ranges1);
1134 96 : multirange_deserialize(typcache->rngtype, mr2, &range_count2, &ranges2);
1135 :
1136 96 : PG_RETURN_MULTIRANGE_P(multirange_minus_internal(mltrngtypoid,
1137 : rangetyp,
1138 : range_count1,
1139 : ranges1,
1140 : range_count2,
1141 : ranges2));
1142 : }
1143 :
1144 : MultirangeType *
1145 96 : multirange_minus_internal(Oid mltrngtypoid, TypeCacheEntry *rangetyp,
1146 : int32 range_count1, RangeType **ranges1,
1147 : int32 range_count2, RangeType **ranges2)
1148 : {
1149 : RangeType *r1;
1150 : RangeType *r2;
1151 : RangeType **ranges3;
1152 : int32 range_count3;
1153 : int32 i1;
1154 : int32 i2;
1155 :
1156 : /*
1157 : * Worst case: every range in ranges1 makes a different cut to some range
1158 : * in ranges2.
1159 : */
1160 96 : ranges3 = palloc0((range_count1 + range_count2) * sizeof(RangeType *));
1161 96 : range_count3 = 0;
1162 :
1163 : /*
1164 : * For each range in mr1, keep subtracting until it's gone or the ranges
1165 : * in mr2 have passed it. After a subtraction we assign what's left back
1166 : * to r1. The parallel progress through mr1 and mr2 is similar to
1167 : * multirange_overlaps_multirange_internal.
1168 : */
1169 96 : r2 = ranges2[0];
1170 234 : for (i1 = 0, i2 = 0; i1 < range_count1; i1++)
1171 : {
1172 138 : r1 = ranges1[i1];
1173 :
1174 : /* Discard r2s while r2 << r1 */
1175 156 : while (r2 != NULL && range_before_internal(rangetyp, r2, r1))
1176 : {
1177 18 : r2 = ++i2 >= range_count2 ? NULL : ranges2[i2];
1178 : }
1179 :
1180 174 : while (r2 != NULL)
1181 : {
1182 132 : if (range_split_internal(rangetyp, r1, r2, &ranges3[range_count3], &r1))
1183 : {
1184 : /*
1185 : * If r2 takes a bite out of the middle of r1, we need two
1186 : * outputs
1187 : */
1188 18 : range_count3++;
1189 18 : r2 = ++i2 >= range_count2 ? NULL : ranges2[i2];
1190 : }
1191 114 : else if (range_overlaps_internal(rangetyp, r1, r2))
1192 : {
1193 : /*
1194 : * If r2 overlaps r1, replace r1 with r1 - r2.
1195 : */
1196 66 : r1 = range_minus_internal(rangetyp, r1, r2);
1197 :
1198 : /*
1199 : * If r2 goes past r1, then we need to stay with it, in case
1200 : * it hits future r1s. Otherwise we need to keep r1, in case
1201 : * future r2s hit it. Since we already subtracted, there's no
1202 : * point in using the overright/overleft calls.
1203 : */
1204 66 : if (RangeIsEmpty(r1) || range_before_internal(rangetyp, r1, r2))
1205 : break;
1206 : else
1207 18 : r2 = ++i2 >= range_count2 ? NULL : ranges2[i2];
1208 : }
1209 : else
1210 : {
1211 : /*
1212 : * This and all future r2s are past r1, so keep them. Also
1213 : * assign whatever is left of r1 to the result.
1214 : */
1215 48 : break;
1216 : }
1217 : }
1218 :
1219 : /*
1220 : * Nothing else can remove anything from r1, so keep it. Even if r1 is
1221 : * empty here, make_multirange will remove it.
1222 : */
1223 138 : ranges3[range_count3++] = r1;
1224 : }
1225 :
1226 96 : return make_multirange(mltrngtypoid, rangetyp, range_count3, ranges3);
1227 : }
1228 :
1229 : /* multirange intersection */
1230 : Datum
1231 186 : multirange_intersect(PG_FUNCTION_ARGS)
1232 : {
1233 186 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1234 186 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1235 186 : Oid mltrngtypoid = MultirangeTypeGetOid(mr1);
1236 : TypeCacheEntry *typcache;
1237 : TypeCacheEntry *rangetyp;
1238 : int32 range_count1;
1239 : int32 range_count2;
1240 : RangeType **ranges1;
1241 : RangeType **ranges2;
1242 :
1243 186 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
1244 186 : rangetyp = typcache->rngtype;
1245 :
1246 186 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
1247 18 : PG_RETURN_MULTIRANGE_P(make_empty_multirange(mltrngtypoid, rangetyp));
1248 :
1249 168 : multirange_deserialize(rangetyp, mr1, &range_count1, &ranges1);
1250 168 : multirange_deserialize(rangetyp, mr2, &range_count2, &ranges2);
1251 :
1252 168 : PG_RETURN_MULTIRANGE_P(multirange_intersect_internal(mltrngtypoid,
1253 : rangetyp,
1254 : range_count1,
1255 : ranges1,
1256 : range_count2,
1257 : ranges2));
1258 : }
1259 :
1260 : MultirangeType *
1261 264 : multirange_intersect_internal(Oid mltrngtypoid, TypeCacheEntry *rangetyp,
1262 : int32 range_count1, RangeType **ranges1,
1263 : int32 range_count2, RangeType **ranges2)
1264 : {
1265 : RangeType *r1;
1266 : RangeType *r2;
1267 : RangeType **ranges3;
1268 : int32 range_count3;
1269 : int32 i1;
1270 : int32 i2;
1271 :
1272 264 : if (range_count1 == 0 || range_count2 == 0)
1273 60 : return make_multirange(mltrngtypoid, rangetyp, 0, NULL);
1274 :
1275 : /*-----------------------------------------------
1276 : * Worst case is a stitching pattern like this:
1277 : *
1278 : * mr1: --- --- --- ---
1279 : * mr2: --- --- ---
1280 : * mr3: - - - - - -
1281 : *
1282 : * That seems to be range_count1 + range_count2 - 1,
1283 : * but one extra won't hurt.
1284 : *-----------------------------------------------
1285 : */
1286 204 : ranges3 = palloc0((range_count1 + range_count2) * sizeof(RangeType *));
1287 204 : range_count3 = 0;
1288 :
1289 : /*
1290 : * For each range in mr1, keep intersecting until the ranges in mr2 have
1291 : * passed it. The parallel progress through mr1 and mr2 is similar to
1292 : * multirange_minus_multirange_internal, but we don't have to assign back
1293 : * to r1.
1294 : */
1295 204 : r2 = ranges2[0];
1296 414 : for (i1 = 0, i2 = 0; i1 < range_count1; i1++)
1297 : {
1298 240 : r1 = ranges1[i1];
1299 :
1300 : /* Discard r2s while r2 << r1 */
1301 252 : while (r2 != NULL && range_before_internal(rangetyp, r2, r1))
1302 : {
1303 12 : r2 = ++i2 >= range_count2 ? NULL : ranges2[i2];
1304 : }
1305 :
1306 306 : while (r2 != NULL)
1307 : {
1308 276 : if (range_overlaps_internal(rangetyp, r1, r2))
1309 : {
1310 : /* Keep the overlapping part */
1311 258 : ranges3[range_count3++] = range_intersect_internal(rangetyp, r1, r2);
1312 :
1313 : /* If we "used up" all of r2, go to the next one... */
1314 258 : if (range_overleft_internal(rangetyp, r2, r1))
1315 66 : r2 = ++i2 >= range_count2 ? NULL : ranges2[i2];
1316 :
1317 : /* ...otherwise go to the next r1 */
1318 : else
1319 192 : break;
1320 : }
1321 : else
1322 : /* We're past r1, so move to the next one */
1323 18 : break;
1324 : }
1325 :
1326 : /* If we're out of r2s, there can be no more intersections */
1327 240 : if (r2 == NULL)
1328 30 : break;
1329 : }
1330 :
1331 204 : return make_multirange(mltrngtypoid, rangetyp, range_count3, ranges3);
1332 : }
1333 :
1334 : /*
1335 : * range_agg_transfn: combine adjacent/overlapping ranges.
1336 : *
1337 : * All we do here is gather the input ranges into an array
1338 : * so that the finalfn can sort and combine them.
1339 : */
1340 : Datum
1341 380 : range_agg_transfn(PG_FUNCTION_ARGS)
1342 : {
1343 : MemoryContext aggContext;
1344 : Oid rngtypoid;
1345 : ArrayBuildState *state;
1346 :
1347 380 : if (!AggCheckCallContext(fcinfo, &aggContext))
1348 0 : elog(ERROR, "range_agg_transfn called in non-aggregate context");
1349 :
1350 380 : rngtypoid = get_fn_expr_argtype(fcinfo->flinfo, 1);
1351 380 : if (!type_is_range(rngtypoid))
1352 0 : elog(ERROR, "range_agg must be called with a range");
1353 :
1354 380 : if (PG_ARGISNULL(0))
1355 234 : state = initArrayResult(rngtypoid, aggContext, false);
1356 : else
1357 146 : state = (ArrayBuildState *) PG_GETARG_POINTER(0);
1358 :
1359 : /* skip NULLs */
1360 380 : if (!PG_ARGISNULL(1))
1361 356 : accumArrayResult(state, PG_GETARG_DATUM(1), false, rngtypoid, aggContext);
1362 :
1363 380 : PG_RETURN_POINTER(state);
1364 : }
1365 :
1366 : /*
1367 : * range_agg_finalfn: use our internal array to merge touching ranges.
1368 : *
1369 : * Shared by range_agg_finalfn(anyrange) and
1370 : * multirange_agg_finalfn(anymultirange).
1371 : */
1372 : Datum
1373 628 : range_agg_finalfn(PG_FUNCTION_ARGS)
1374 : {
1375 : MemoryContext aggContext;
1376 : Oid mltrngtypoid;
1377 : TypeCacheEntry *typcache;
1378 : ArrayBuildState *state;
1379 : int32 range_count;
1380 : RangeType **ranges;
1381 : int i;
1382 :
1383 628 : if (!AggCheckCallContext(fcinfo, &aggContext))
1384 0 : elog(ERROR, "range_agg_finalfn called in non-aggregate context");
1385 :
1386 628 : state = PG_ARGISNULL(0) ? NULL : (ArrayBuildState *) PG_GETARG_POINTER(0);
1387 628 : if (state == NULL)
1388 : /* This shouldn't be possible, but just in case.... */
1389 166 : PG_RETURN_NULL();
1390 :
1391 : /* Also return NULL if we had zero inputs, like other aggregates */
1392 462 : range_count = state->nelems;
1393 462 : if (range_count == 0)
1394 18 : PG_RETURN_NULL();
1395 :
1396 444 : mltrngtypoid = get_fn_expr_rettype(fcinfo->flinfo);
1397 444 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
1398 :
1399 444 : ranges = palloc0(range_count * sizeof(RangeType *));
1400 1196 : for (i = 0; i < range_count; i++)
1401 752 : ranges[i] = DatumGetRangeTypeP(state->dvalues[i]);
1402 :
1403 444 : PG_RETURN_MULTIRANGE_P(make_multirange(mltrngtypoid, typcache->rngtype, range_count, ranges));
1404 : }
1405 :
1406 : /*
1407 : * multirange_agg_transfn: combine adjacent/overlapping multiranges.
1408 : *
1409 : * All we do here is gather the input multiranges' ranges into an array so
1410 : * that the finalfn can sort and combine them.
1411 : */
1412 : Datum
1413 450 : multirange_agg_transfn(PG_FUNCTION_ARGS)
1414 : {
1415 : MemoryContext aggContext;
1416 : Oid mltrngtypoid;
1417 : TypeCacheEntry *typcache;
1418 : TypeCacheEntry *rngtypcache;
1419 : ArrayBuildState *state;
1420 :
1421 450 : if (!AggCheckCallContext(fcinfo, &aggContext))
1422 0 : elog(ERROR, "multirange_agg_transfn called in non-aggregate context");
1423 :
1424 450 : mltrngtypoid = get_fn_expr_argtype(fcinfo->flinfo, 1);
1425 450 : if (!type_is_multirange(mltrngtypoid))
1426 0 : elog(ERROR, "range_agg must be called with a multirange");
1427 :
1428 450 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
1429 450 : rngtypcache = typcache->rngtype;
1430 :
1431 450 : if (PG_ARGISNULL(0))
1432 228 : state = initArrayResult(rngtypcache->type_id, aggContext, false);
1433 : else
1434 222 : state = (ArrayBuildState *) PG_GETARG_POINTER(0);
1435 :
1436 : /* skip NULLs */
1437 450 : if (!PG_ARGISNULL(1))
1438 : {
1439 : MultirangeType *current;
1440 : int32 range_count;
1441 : RangeType **ranges;
1442 :
1443 384 : current = PG_GETARG_MULTIRANGE_P(1);
1444 384 : multirange_deserialize(rngtypcache, current, &range_count, &ranges);
1445 384 : if (range_count == 0)
1446 : {
1447 : /*
1448 : * Add an empty range so we get an empty result (not a null
1449 : * result).
1450 : */
1451 42 : accumArrayResult(state,
1452 42 : RangeTypePGetDatum(make_empty_range(rngtypcache)),
1453 : false, rngtypcache->type_id, aggContext);
1454 : }
1455 : else
1456 : {
1457 696 : for (int32 i = 0; i < range_count; i++)
1458 354 : accumArrayResult(state, RangeTypePGetDatum(ranges[i]), false, rngtypcache->type_id, aggContext);
1459 : }
1460 : }
1461 :
1462 450 : PG_RETURN_POINTER(state);
1463 : }
1464 :
1465 : Datum
1466 96 : multirange_intersect_agg_transfn(PG_FUNCTION_ARGS)
1467 : {
1468 : MemoryContext aggContext;
1469 : Oid mltrngtypoid;
1470 : TypeCacheEntry *typcache;
1471 : MultirangeType *result;
1472 : MultirangeType *current;
1473 : int32 range_count1;
1474 : int32 range_count2;
1475 : RangeType **ranges1;
1476 : RangeType **ranges2;
1477 :
1478 96 : if (!AggCheckCallContext(fcinfo, &aggContext))
1479 0 : elog(ERROR, "multirange_intersect_agg_transfn called in non-aggregate context");
1480 :
1481 96 : mltrngtypoid = get_fn_expr_argtype(fcinfo->flinfo, 1);
1482 96 : if (!type_is_multirange(mltrngtypoid))
1483 0 : elog(ERROR, "range_intersect_agg must be called with a multirange");
1484 :
1485 96 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
1486 :
1487 : /* strictness ensures these are non-null */
1488 96 : result = PG_GETARG_MULTIRANGE_P(0);
1489 96 : current = PG_GETARG_MULTIRANGE_P(1);
1490 :
1491 96 : multirange_deserialize(typcache->rngtype, result, &range_count1, &ranges1);
1492 96 : multirange_deserialize(typcache->rngtype, current, &range_count2, &ranges2);
1493 :
1494 96 : result = multirange_intersect_internal(mltrngtypoid,
1495 96 : typcache->rngtype,
1496 : range_count1,
1497 : ranges1,
1498 : range_count2,
1499 : ranges2);
1500 96 : PG_RETURN_MULTIRANGE_P(result);
1501 : }
1502 :
1503 :
1504 : /* multirange -> element type functions */
1505 :
1506 : /* extract lower bound value */
1507 : Datum
1508 150 : multirange_lower(PG_FUNCTION_ARGS)
1509 : {
1510 150 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1511 : TypeCacheEntry *typcache;
1512 : RangeBound lower;
1513 : RangeBound upper;
1514 :
1515 150 : if (MultirangeIsEmpty(mr))
1516 24 : PG_RETURN_NULL();
1517 :
1518 126 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1519 :
1520 126 : multirange_get_bounds(typcache->rngtype, mr, 0,
1521 : &lower, &upper);
1522 :
1523 126 : if (!lower.infinite)
1524 108 : PG_RETURN_DATUM(lower.val);
1525 : else
1526 18 : PG_RETURN_NULL();
1527 : }
1528 :
1529 : /* extract upper bound value */
1530 : Datum
1531 138 : multirange_upper(PG_FUNCTION_ARGS)
1532 : {
1533 138 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1534 : TypeCacheEntry *typcache;
1535 : RangeBound lower;
1536 : RangeBound upper;
1537 :
1538 138 : if (MultirangeIsEmpty(mr))
1539 24 : PG_RETURN_NULL();
1540 :
1541 114 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1542 :
1543 114 : multirange_get_bounds(typcache->rngtype, mr, mr->rangeCount - 1,
1544 : &lower, &upper);
1545 :
1546 114 : if (!upper.infinite)
1547 96 : PG_RETURN_DATUM(upper.val);
1548 : else
1549 18 : PG_RETURN_NULL();
1550 : }
1551 :
1552 :
1553 : /* multirange -> bool functions */
1554 :
1555 : /* is multirange empty? */
1556 : Datum
1557 66 : multirange_empty(PG_FUNCTION_ARGS)
1558 : {
1559 66 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1560 :
1561 66 : PG_RETURN_BOOL(MultirangeIsEmpty(mr));
1562 : }
1563 :
1564 : /* is lower bound inclusive? */
1565 : Datum
1566 66 : multirange_lower_inc(PG_FUNCTION_ARGS)
1567 : {
1568 66 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1569 : TypeCacheEntry *typcache;
1570 : RangeBound lower;
1571 : RangeBound upper;
1572 :
1573 66 : if (MultirangeIsEmpty(mr))
1574 24 : PG_RETURN_BOOL(false);
1575 :
1576 42 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1577 42 : multirange_get_bounds(typcache->rngtype, mr, 0,
1578 : &lower, &upper);
1579 :
1580 42 : PG_RETURN_BOOL(lower.inclusive);
1581 : }
1582 :
1583 : /* is upper bound inclusive? */
1584 : Datum
1585 66 : multirange_upper_inc(PG_FUNCTION_ARGS)
1586 : {
1587 66 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1588 : TypeCacheEntry *typcache;
1589 : RangeBound lower;
1590 : RangeBound upper;
1591 :
1592 66 : if (MultirangeIsEmpty(mr))
1593 24 : PG_RETURN_BOOL(false);
1594 :
1595 42 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1596 42 : multirange_get_bounds(typcache->rngtype, mr, mr->rangeCount - 1,
1597 : &lower, &upper);
1598 :
1599 42 : PG_RETURN_BOOL(upper.inclusive);
1600 : }
1601 :
1602 : /* is lower bound infinite? */
1603 : Datum
1604 66 : multirange_lower_inf(PG_FUNCTION_ARGS)
1605 : {
1606 66 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1607 : TypeCacheEntry *typcache;
1608 : RangeBound lower;
1609 : RangeBound upper;
1610 :
1611 66 : if (MultirangeIsEmpty(mr))
1612 24 : PG_RETURN_BOOL(false);
1613 :
1614 42 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1615 42 : multirange_get_bounds(typcache->rngtype, mr, 0,
1616 : &lower, &upper);
1617 :
1618 42 : PG_RETURN_BOOL(lower.infinite);
1619 : }
1620 :
1621 : /* is upper bound infinite? */
1622 : Datum
1623 66 : multirange_upper_inf(PG_FUNCTION_ARGS)
1624 : {
1625 66 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1626 : TypeCacheEntry *typcache;
1627 : RangeBound lower;
1628 : RangeBound upper;
1629 :
1630 66 : if (MultirangeIsEmpty(mr))
1631 24 : PG_RETURN_BOOL(false);
1632 :
1633 42 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1634 42 : multirange_get_bounds(typcache->rngtype, mr, mr->rangeCount - 1,
1635 : &lower, &upper);
1636 :
1637 42 : PG_RETURN_BOOL(upper.infinite);
1638 : }
1639 :
1640 :
1641 :
1642 : /* multirange, element -> bool functions */
1643 :
1644 : /* contains? */
1645 : Datum
1646 23340 : multirange_contains_elem(PG_FUNCTION_ARGS)
1647 : {
1648 23340 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1649 23340 : Datum val = PG_GETARG_DATUM(1);
1650 : TypeCacheEntry *typcache;
1651 :
1652 23340 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1653 :
1654 23340 : PG_RETURN_BOOL(multirange_contains_elem_internal(typcache->rngtype, mr, val));
1655 : }
1656 :
1657 : /* contained by? */
1658 : Datum
1659 144 : elem_contained_by_multirange(PG_FUNCTION_ARGS)
1660 : {
1661 144 : Datum val = PG_GETARG_DATUM(0);
1662 144 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
1663 : TypeCacheEntry *typcache;
1664 :
1665 144 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1666 :
1667 144 : PG_RETURN_BOOL(multirange_contains_elem_internal(typcache->rngtype, mr, val));
1668 : }
1669 :
1670 : /*
1671 : * Comparison function for checking if any range of multirange contains given
1672 : * key element using binary search.
1673 : */
1674 : static int
1675 32424 : multirange_elem_bsearch_comparison(TypeCacheEntry *typcache,
1676 : RangeBound *lower, RangeBound *upper,
1677 : void *key, bool *match)
1678 : {
1679 32424 : Datum val = *((Datum *) key);
1680 : int cmp;
1681 :
1682 32424 : if (!lower->infinite)
1683 : {
1684 31134 : cmp = DatumGetInt32(FunctionCall2Coll(&typcache->rng_cmp_proc_finfo,
1685 : typcache->rng_collation,
1686 : lower->val, val));
1687 31134 : if (cmp > 0 || (cmp == 0 && !lower->inclusive))
1688 30570 : return -1;
1689 : }
1690 :
1691 1854 : if (!upper->infinite)
1692 : {
1693 1728 : cmp = DatumGetInt32(FunctionCall2Coll(&typcache->rng_cmp_proc_finfo,
1694 : typcache->rng_collation,
1695 : upper->val, val));
1696 1728 : if (cmp < 0 || (cmp == 0 && !upper->inclusive))
1697 168 : return 1;
1698 : }
1699 :
1700 1686 : *match = true;
1701 1686 : return 0;
1702 : }
1703 :
1704 : /*
1705 : * Test whether multirange mr contains a specific element value.
1706 : */
1707 : bool
1708 23484 : multirange_contains_elem_internal(TypeCacheEntry *rangetyp,
1709 : const MultirangeType *mr, Datum val)
1710 : {
1711 23484 : if (MultirangeIsEmpty(mr))
1712 3120 : return false;
1713 :
1714 20364 : return multirange_bsearch_match(rangetyp, mr, &val,
1715 : multirange_elem_bsearch_comparison);
1716 : }
1717 :
1718 : /* multirange, range -> bool functions */
1719 :
1720 : /* contains? */
1721 : Datum
1722 89754 : multirange_contains_range(PG_FUNCTION_ARGS)
1723 : {
1724 89754 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1725 89754 : RangeType *r = PG_GETARG_RANGE_P(1);
1726 : TypeCacheEntry *typcache;
1727 :
1728 89754 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1729 :
1730 89754 : PG_RETURN_BOOL(multirange_contains_range_internal(typcache->rngtype, mr, r));
1731 : }
1732 :
1733 : Datum
1734 74490 : range_contains_multirange(PG_FUNCTION_ARGS)
1735 : {
1736 74490 : RangeType *r = PG_GETARG_RANGE_P(0);
1737 74490 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
1738 : TypeCacheEntry *typcache;
1739 :
1740 74490 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1741 :
1742 74490 : PG_RETURN_BOOL(range_contains_multirange_internal(typcache->rngtype, r, mr));
1743 : }
1744 :
1745 : /* contained by? */
1746 : Datum
1747 37620 : range_contained_by_multirange(PG_FUNCTION_ARGS)
1748 : {
1749 37620 : RangeType *r = PG_GETARG_RANGE_P(0);
1750 37620 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
1751 : TypeCacheEntry *typcache;
1752 :
1753 37620 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1754 :
1755 37620 : PG_RETURN_BOOL(multirange_contains_range_internal(typcache->rngtype, mr, r));
1756 : }
1757 :
1758 : Datum
1759 50490 : multirange_contained_by_range(PG_FUNCTION_ARGS)
1760 : {
1761 50490 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1762 50490 : RangeType *r = PG_GETARG_RANGE_P(1);
1763 : TypeCacheEntry *typcache;
1764 :
1765 50490 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1766 :
1767 50490 : PG_RETURN_BOOL(range_contains_multirange_internal(typcache->rngtype, r, mr));
1768 : }
1769 :
1770 : /*
1771 : * Comparison function for checking if any range of multirange contains given
1772 : * key range using binary search.
1773 : */
1774 : static int
1775 116910 : multirange_range_contains_bsearch_comparison(TypeCacheEntry *typcache,
1776 : RangeBound *lower, RangeBound *upper,
1777 : void *key, bool *match)
1778 : {
1779 116910 : RangeBound *keyLower = (RangeBound *) key;
1780 116910 : RangeBound *keyUpper = (RangeBound *) key + 1;
1781 :
1782 : /* Check if key range is strictly in the left or in the right */
1783 116910 : if (range_cmp_bounds(typcache, keyUpper, lower) < 0)
1784 31776 : return -1;
1785 85134 : if (range_cmp_bounds(typcache, keyLower, upper) > 0)
1786 74862 : return 1;
1787 :
1788 : /*
1789 : * At this point we found overlapping range. But we have to check if it
1790 : * really contains the key range. Anyway, we have to stop our search
1791 : * here, because multirange contains only non-overlapping ranges.
1792 : */
1793 10272 : *match = range_bounds_contains(typcache, lower, upper, keyLower, keyUpper);
1794 :
1795 10272 : return 0;
1796 : }
1797 :
1798 : /*
1799 : * Test whether multirange mr contains a specific range r.
1800 : */
1801 : bool
1802 158958 : multirange_contains_range_internal(TypeCacheEntry *rangetyp,
1803 : const MultirangeType *mr,
1804 : const RangeType *r)
1805 : {
1806 : RangeBound bounds[2];
1807 : bool empty;
1808 :
1809 : /*
1810 : * Every multirange contains an infinite number of empty ranges, even an
1811 : * empty one.
1812 : */
1813 158958 : if (RangeIsEmpty(r))
1814 90612 : return true;
1815 :
1816 68346 : if (MultirangeIsEmpty(mr))
1817 3096 : return false;
1818 :
1819 65250 : range_deserialize(rangetyp, r, &bounds[0], &bounds[1], &empty);
1820 : Assert(!empty);
1821 :
1822 65250 : return multirange_bsearch_match(rangetyp, mr, bounds,
1823 : multirange_range_contains_bsearch_comparison);
1824 : }
1825 :
1826 : /*
1827 : * Test whether range r contains a multirange mr.
1828 : */
1829 : bool
1830 276958 : range_contains_multirange_internal(TypeCacheEntry *rangetyp,
1831 : const RangeType *r,
1832 : const MultirangeType *mr)
1833 : {
1834 : RangeBound lower1,
1835 : upper1,
1836 : lower2,
1837 : upper2,
1838 : tmp;
1839 : bool empty;
1840 :
1841 : /*
1842 : * Every range contains an infinite number of empty multiranges, even an
1843 : * empty one.
1844 : */
1845 276958 : if (MultirangeIsEmpty(mr))
1846 191048 : return true;
1847 :
1848 85910 : if (RangeIsEmpty(r))
1849 25272 : return false;
1850 :
1851 : /* Range contains multirange iff it contains its union range. */
1852 60638 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
1853 : Assert(!empty);
1854 60638 : multirange_get_bounds(rangetyp, mr, 0, &lower2, &tmp);
1855 60638 : multirange_get_bounds(rangetyp, mr, mr->rangeCount - 1, &tmp, &upper2);
1856 :
1857 60638 : return range_bounds_contains(rangetyp, &lower1, &upper1, &lower2, &upper2);
1858 : }
1859 :
1860 :
1861 : /* multirange, multirange -> bool functions */
1862 :
1863 : /* equality (internal version) */
1864 : bool
1865 47814 : multirange_eq_internal(TypeCacheEntry *rangetyp,
1866 : const MultirangeType *mr1,
1867 : const MultirangeType *mr2)
1868 : {
1869 : int32 range_count_1;
1870 : int32 range_count_2;
1871 : int32 i;
1872 : RangeBound lower1,
1873 : upper1,
1874 : lower2,
1875 : upper2;
1876 :
1877 : /* Different types should be prevented by ANYMULTIRANGE matching rules */
1878 47814 : if (MultirangeTypeGetOid(mr1) != MultirangeTypeGetOid(mr2))
1879 0 : elog(ERROR, "multirange types do not match");
1880 :
1881 47814 : range_count_1 = mr1->rangeCount;
1882 47814 : range_count_2 = mr2->rangeCount;
1883 :
1884 47814 : if (range_count_1 != range_count_2)
1885 29490 : return false;
1886 :
1887 18522 : for (i = 0; i < range_count_1; i++)
1888 : {
1889 12228 : multirange_get_bounds(rangetyp, mr1, i, &lower1, &upper1);
1890 12228 : multirange_get_bounds(rangetyp, mr2, i, &lower2, &upper2);
1891 :
1892 12444 : if (range_cmp_bounds(rangetyp, &lower1, &lower2) != 0 ||
1893 216 : range_cmp_bounds(rangetyp, &upper1, &upper2) != 0)
1894 12030 : return false;
1895 : }
1896 :
1897 6294 : return true;
1898 : }
1899 :
1900 : /* equality */
1901 : Datum
1902 47682 : multirange_eq(PG_FUNCTION_ARGS)
1903 : {
1904 47682 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1905 47682 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1906 : TypeCacheEntry *typcache;
1907 :
1908 47682 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
1909 :
1910 47682 : PG_RETURN_BOOL(multirange_eq_internal(typcache->rngtype, mr1, mr2));
1911 : }
1912 :
1913 : /* inequality (internal version) */
1914 : bool
1915 132 : multirange_ne_internal(TypeCacheEntry *rangetyp,
1916 : const MultirangeType *mr1,
1917 : const MultirangeType *mr2)
1918 : {
1919 132 : return (!multirange_eq_internal(rangetyp, mr1, mr2));
1920 : }
1921 :
1922 : /* inequality */
1923 : Datum
1924 132 : multirange_ne(PG_FUNCTION_ARGS)
1925 : {
1926 132 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1927 132 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1928 : TypeCacheEntry *typcache;
1929 :
1930 132 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
1931 :
1932 132 : PG_RETURN_BOOL(multirange_ne_internal(typcache->rngtype, mr1, mr2));
1933 : }
1934 :
1935 : /* overlaps? */
1936 : Datum
1937 37344 : range_overlaps_multirange(PG_FUNCTION_ARGS)
1938 : {
1939 37344 : RangeType *r = PG_GETARG_RANGE_P(0);
1940 37344 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
1941 : TypeCacheEntry *typcache;
1942 :
1943 37344 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1944 :
1945 37344 : PG_RETURN_BOOL(range_overlaps_multirange_internal(typcache->rngtype, r, mr));
1946 : }
1947 :
1948 : Datum
1949 45390 : multirange_overlaps_range(PG_FUNCTION_ARGS)
1950 : {
1951 45390 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
1952 45390 : RangeType *r = PG_GETARG_RANGE_P(1);
1953 : TypeCacheEntry *typcache;
1954 :
1955 45390 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
1956 :
1957 45390 : PG_RETURN_BOOL(range_overlaps_multirange_internal(typcache->rngtype, r, mr));
1958 : }
1959 :
1960 : Datum
1961 46554 : multirange_overlaps_multirange(PG_FUNCTION_ARGS)
1962 : {
1963 46554 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
1964 46554 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
1965 : TypeCacheEntry *typcache;
1966 :
1967 46554 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
1968 :
1969 46554 : PG_RETURN_BOOL(multirange_overlaps_multirange_internal(typcache->rngtype, mr1, mr2));
1970 : }
1971 :
1972 : /*
1973 : * Comparison function for checking if any range of multirange overlaps given
1974 : * key range using binary search.
1975 : */
1976 : static int
1977 122556 : multirange_range_overlaps_bsearch_comparison(TypeCacheEntry *typcache,
1978 : RangeBound *lower, RangeBound *upper,
1979 : void *key, bool *match)
1980 : {
1981 122556 : RangeBound *keyLower = (RangeBound *) key;
1982 122556 : RangeBound *keyUpper = (RangeBound *) key + 1;
1983 :
1984 122556 : if (range_cmp_bounds(typcache, keyUpper, lower) < 0)
1985 31886 : return -1;
1986 90670 : if (range_cmp_bounds(typcache, keyLower, upper) > 0)
1987 80454 : return 1;
1988 :
1989 10216 : *match = true;
1990 10216 : return 0;
1991 : }
1992 :
1993 : bool
1994 100786 : range_overlaps_multirange_internal(TypeCacheEntry *rangetyp,
1995 : const RangeType *r,
1996 : const MultirangeType *mr)
1997 : {
1998 : RangeBound bounds[2];
1999 : bool empty;
2000 :
2001 : /*
2002 : * Empties never overlap, even with empties. (This seems strange since
2003 : * they *do* contain each other, but we want to follow how ranges work.)
2004 : */
2005 100786 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2006 31708 : return false;
2007 :
2008 69078 : range_deserialize(rangetyp, r, &bounds[0], &bounds[1], &empty);
2009 : Assert(!empty);
2010 :
2011 69078 : return multirange_bsearch_match(rangetyp, mr, bounds,
2012 : multirange_range_overlaps_bsearch_comparison);
2013 : }
2014 :
2015 : bool
2016 46554 : multirange_overlaps_multirange_internal(TypeCacheEntry *rangetyp,
2017 : const MultirangeType *mr1,
2018 : const MultirangeType *mr2)
2019 : {
2020 : int32 range_count1;
2021 : int32 range_count2;
2022 : int32 i1;
2023 : int32 i2;
2024 : RangeBound lower1,
2025 : upper1,
2026 : lower2,
2027 : upper2;
2028 :
2029 : /*
2030 : * Empties never overlap, even with empties. (This seems strange since
2031 : * they *do* contain each other, but we want to follow how ranges work.)
2032 : */
2033 46554 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
2034 25314 : return false;
2035 :
2036 21240 : range_count1 = mr1->rangeCount;
2037 21240 : range_count2 = mr2->rangeCount;
2038 :
2039 : /*
2040 : * Every range in mr1 gets a chance to overlap with the ranges in mr2, but
2041 : * we can use their ordering to avoid O(n^2). This is similar to
2042 : * range_overlaps_multirange where r1 : r2 :: mrr : r, but there if we
2043 : * don't find an overlap with r we're done, and here if we don't find an
2044 : * overlap with r2 we try the next r2.
2045 : */
2046 21240 : i1 = 0;
2047 21240 : multirange_get_bounds(rangetyp, mr1, i1, &lower1, &upper1);
2048 76452 : for (i1 = 0, i2 = 0; i2 < range_count2; i2++)
2049 : {
2050 58536 : multirange_get_bounds(rangetyp, mr2, i2, &lower2, &upper2);
2051 :
2052 : /* Discard r1s while r1 << r2 */
2053 58668 : while (range_cmp_bounds(rangetyp, &upper1, &lower2) < 0)
2054 : {
2055 234 : if (++i1 >= range_count1)
2056 102 : return false;
2057 132 : multirange_get_bounds(rangetyp, mr1, i1, &lower1, &upper1);
2058 : }
2059 :
2060 : /*
2061 : * If r1 && r2, we're done, otherwise we failed to find an overlap for
2062 : * r2, so go to the next one.
2063 : */
2064 58434 : if (range_bounds_overlaps(rangetyp, &lower1, &upper1, &lower2, &upper2))
2065 3222 : return true;
2066 : }
2067 :
2068 : /* We looked through all of mr2 without finding an overlap */
2069 17916 : return false;
2070 : }
2071 :
2072 : /* does not extend to right of? */
2073 : bool
2074 73210 : range_overleft_multirange_internal(TypeCacheEntry *rangetyp,
2075 : const RangeType *r,
2076 : const MultirangeType *mr)
2077 : {
2078 : RangeBound lower1,
2079 : upper1,
2080 : lower2,
2081 : upper2;
2082 : bool empty;
2083 :
2084 73210 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2085 6012 : return false;
2086 :
2087 67198 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
2088 : Assert(!empty);
2089 67198 : multirange_get_bounds(rangetyp, mr, mr->rangeCount - 1,
2090 : &lower2, &upper2);
2091 :
2092 67198 : return (range_cmp_bounds(rangetyp, &upper1, &upper2) <= 0);
2093 : }
2094 :
2095 : Datum
2096 37242 : range_overleft_multirange(PG_FUNCTION_ARGS)
2097 : {
2098 37242 : RangeType *r = PG_GETARG_RANGE_P(0);
2099 37242 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
2100 : TypeCacheEntry *typcache;
2101 :
2102 37242 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2103 :
2104 37242 : PG_RETURN_BOOL(range_overleft_multirange_internal(typcache->rngtype, r, mr));
2105 : }
2106 :
2107 : Datum
2108 47286 : multirange_overleft_range(PG_FUNCTION_ARGS)
2109 : {
2110 47286 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2111 47286 : RangeType *r = PG_GETARG_RANGE_P(1);
2112 : TypeCacheEntry *typcache;
2113 : RangeBound lower1,
2114 : upper1,
2115 : lower2,
2116 : upper2;
2117 : bool empty;
2118 :
2119 47286 : if (MultirangeIsEmpty(mr) || RangeIsEmpty(r))
2120 25212 : PG_RETURN_BOOL(false);
2121 :
2122 22074 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2123 :
2124 22074 : multirange_get_bounds(typcache->rngtype, mr, mr->rangeCount - 1,
2125 : &lower1, &upper1);
2126 22074 : range_deserialize(typcache->rngtype, r, &lower2, &upper2, &empty);
2127 : Assert(!empty);
2128 :
2129 22074 : PG_RETURN_BOOL(range_cmp_bounds(typcache->rngtype, &upper1, &upper2) <= 0);
2130 : }
2131 :
2132 : Datum
2133 47292 : multirange_overleft_multirange(PG_FUNCTION_ARGS)
2134 : {
2135 47292 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2136 47292 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2137 : TypeCacheEntry *typcache;
2138 : RangeBound lower1,
2139 : upper1,
2140 : lower2,
2141 : upper2;
2142 :
2143 47292 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
2144 25218 : PG_RETURN_BOOL(false);
2145 :
2146 22074 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2147 :
2148 22074 : multirange_get_bounds(typcache->rngtype, mr1, mr1->rangeCount - 1,
2149 : &lower1, &upper1);
2150 22074 : multirange_get_bounds(typcache->rngtype, mr2, mr2->rangeCount - 1,
2151 : &lower2, &upper2);
2152 :
2153 22074 : PG_RETURN_BOOL(range_cmp_bounds(typcache->rngtype, &upper1, &upper2) <= 0);
2154 : }
2155 :
2156 : /* does not extend to left of? */
2157 : bool
2158 119302 : range_overright_multirange_internal(TypeCacheEntry *rangetyp,
2159 : const RangeType *r,
2160 : const MultirangeType *mr)
2161 : {
2162 : RangeBound lower1,
2163 : upper1,
2164 : lower2,
2165 : upper2;
2166 : bool empty;
2167 :
2168 119302 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2169 6012 : return false;
2170 :
2171 113290 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
2172 : Assert(!empty);
2173 113290 : multirange_get_bounds(rangetyp, mr, 0, &lower2, &upper2);
2174 :
2175 113290 : return (range_cmp_bounds(rangetyp, &lower1, &lower2) >= 0);
2176 : }
2177 :
2178 : Datum
2179 37242 : range_overright_multirange(PG_FUNCTION_ARGS)
2180 : {
2181 37242 : RangeType *r = PG_GETARG_RANGE_P(0);
2182 37242 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
2183 : TypeCacheEntry *typcache;
2184 :
2185 37242 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2186 :
2187 37242 : PG_RETURN_BOOL(range_overright_multirange_internal(typcache->rngtype, r, mr));
2188 : }
2189 :
2190 : Datum
2191 61800 : multirange_overright_range(PG_FUNCTION_ARGS)
2192 : {
2193 61800 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2194 61800 : RangeType *r = PG_GETARG_RANGE_P(1);
2195 : TypeCacheEntry *typcache;
2196 : RangeBound lower1,
2197 : upper1,
2198 : lower2,
2199 : upper2;
2200 : bool empty;
2201 :
2202 61800 : if (MultirangeIsEmpty(mr) || RangeIsEmpty(r))
2203 25212 : PG_RETURN_BOOL(false);
2204 :
2205 36588 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2206 :
2207 36588 : multirange_get_bounds(typcache->rngtype, mr, 0, &lower1, &upper1);
2208 36588 : range_deserialize(typcache->rngtype, r, &lower2, &upper2, &empty);
2209 : Assert(!empty);
2210 :
2211 36588 : PG_RETURN_BOOL(range_cmp_bounds(typcache->rngtype, &lower1, &lower2) >= 0);
2212 : }
2213 :
2214 : Datum
2215 61806 : multirange_overright_multirange(PG_FUNCTION_ARGS)
2216 : {
2217 61806 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2218 61806 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2219 : TypeCacheEntry *typcache;
2220 : RangeBound lower1,
2221 : upper1,
2222 : lower2,
2223 : upper2;
2224 :
2225 61806 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
2226 25218 : PG_RETURN_BOOL(false);
2227 :
2228 36588 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2229 :
2230 36588 : multirange_get_bounds(typcache->rngtype, mr1, 0, &lower1, &upper1);
2231 36588 : multirange_get_bounds(typcache->rngtype, mr2, 0, &lower2, &upper2);
2232 :
2233 36588 : PG_RETURN_BOOL(range_cmp_bounds(typcache->rngtype, &lower1, &lower2) >= 0);
2234 : }
2235 :
2236 : /* contains? */
2237 : Datum
2238 156312 : multirange_contains_multirange(PG_FUNCTION_ARGS)
2239 : {
2240 156312 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2241 156312 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2242 : TypeCacheEntry *typcache;
2243 :
2244 156312 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2245 :
2246 156312 : PG_RETURN_BOOL(multirange_contains_multirange_internal(typcache->rngtype, mr1, mr2));
2247 : }
2248 :
2249 : /* contained by? */
2250 : Datum
2251 50808 : multirange_contained_by_multirange(PG_FUNCTION_ARGS)
2252 : {
2253 50808 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2254 50808 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2255 : TypeCacheEntry *typcache;
2256 :
2257 50808 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2258 :
2259 50808 : PG_RETURN_BOOL(multirange_contains_multirange_internal(typcache->rngtype, mr2, mr1));
2260 : }
2261 :
2262 : /*
2263 : * Test whether multirange mr1 contains every range from another multirange mr2.
2264 : */
2265 : bool
2266 207120 : multirange_contains_multirange_internal(TypeCacheEntry *rangetyp,
2267 : const MultirangeType *mr1,
2268 : const MultirangeType *mr2)
2269 : {
2270 207120 : int32 range_count1 = mr1->rangeCount;
2271 207120 : int32 range_count2 = mr2->rangeCount;
2272 : int i1,
2273 : i2;
2274 : RangeBound lower1,
2275 : upper1,
2276 : lower2,
2277 : upper2;
2278 :
2279 : /*
2280 : * We follow the same logic for empties as ranges: - an empty multirange
2281 : * contains an empty range/multirange. - an empty multirange can't contain
2282 : * any other range/multirange. - an empty multirange is contained by any
2283 : * other range/multirange.
2284 : */
2285 :
2286 207120 : if (range_count2 == 0)
2287 145212 : return true;
2288 61908 : if (range_count1 == 0)
2289 22296 : return false;
2290 :
2291 : /*
2292 : * Every range in mr2 must be contained by some range in mr1. To avoid
2293 : * O(n^2) we walk through both ranges in tandem.
2294 : */
2295 39612 : i1 = 0;
2296 39612 : multirange_get_bounds(rangetyp, mr1, i1, &lower1, &upper1);
2297 42900 : for (i2 = 0; i2 < range_count2; i2++)
2298 : {
2299 41250 : multirange_get_bounds(rangetyp, mr2, i2, &lower2, &upper2);
2300 :
2301 : /* Discard r1s while r1 << r2 */
2302 77544 : while (range_cmp_bounds(rangetyp, &upper1, &lower2) < 0)
2303 : {
2304 53940 : if (++i1 >= range_count1)
2305 17646 : return false;
2306 36294 : multirange_get_bounds(rangetyp, mr1, i1, &lower1, &upper1);
2307 : }
2308 :
2309 : /*
2310 : * If r1 @> r2, go to the next r2, otherwise return false (since every
2311 : * r1[n] and r1[n+1] must have a gap). Note this will give weird
2312 : * answers if you don't canonicalize, e.g. with a custom
2313 : * int2multirange {[1,1], [2,2]} there is a "gap". But that is
2314 : * consistent with other range operators, e.g. '[1,1]'::int2range -|-
2315 : * '[2,2]'::int2range is false.
2316 : */
2317 23604 : if (!range_bounds_contains(rangetyp, &lower1, &upper1,
2318 : &lower2, &upper2))
2319 20316 : return false;
2320 : }
2321 :
2322 : /* All ranges in mr2 are satisfied */
2323 1650 : return true;
2324 : }
2325 :
2326 : /* strictly left of? */
2327 : Datum
2328 37230 : range_before_multirange(PG_FUNCTION_ARGS)
2329 : {
2330 37230 : RangeType *r = PG_GETARG_RANGE_P(0);
2331 37230 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
2332 : TypeCacheEntry *typcache;
2333 :
2334 37230 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2335 :
2336 37230 : PG_RETURN_BOOL(range_before_multirange_internal(typcache->rngtype, r, mr));
2337 : }
2338 :
2339 : Datum
2340 44760 : multirange_before_range(PG_FUNCTION_ARGS)
2341 : {
2342 44760 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2343 44760 : RangeType *r = PG_GETARG_RANGE_P(1);
2344 : TypeCacheEntry *typcache;
2345 :
2346 44760 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2347 :
2348 44760 : PG_RETURN_BOOL(range_after_multirange_internal(typcache->rngtype, r, mr));
2349 : }
2350 :
2351 : Datum
2352 44766 : multirange_before_multirange(PG_FUNCTION_ARGS)
2353 : {
2354 44766 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2355 44766 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2356 : TypeCacheEntry *typcache;
2357 :
2358 44766 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2359 :
2360 44766 : PG_RETURN_BOOL(multirange_before_multirange_internal(typcache->rngtype, mr1, mr2));
2361 : }
2362 :
2363 : /* strictly right of? */
2364 : Datum
2365 37236 : range_after_multirange(PG_FUNCTION_ARGS)
2366 : {
2367 37236 : RangeType *r = PG_GETARG_RANGE_P(0);
2368 37236 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
2369 : TypeCacheEntry *typcache;
2370 :
2371 37236 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2372 :
2373 37236 : PG_RETURN_BOOL(range_after_multirange_internal(typcache->rngtype, r, mr));
2374 : }
2375 :
2376 : Datum
2377 56748 : multirange_after_range(PG_FUNCTION_ARGS)
2378 : {
2379 56748 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2380 56748 : RangeType *r = PG_GETARG_RANGE_P(1);
2381 : TypeCacheEntry *typcache;
2382 :
2383 56748 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2384 :
2385 56748 : PG_RETURN_BOOL(range_before_multirange_internal(typcache->rngtype, r, mr));
2386 : }
2387 :
2388 : Datum
2389 56760 : multirange_after_multirange(PG_FUNCTION_ARGS)
2390 : {
2391 56760 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2392 56760 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2393 : TypeCacheEntry *typcache;
2394 :
2395 56760 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2396 :
2397 56760 : PG_RETURN_BOOL(multirange_before_multirange_internal(typcache->rngtype, mr2, mr1));
2398 : }
2399 :
2400 : /* strictly left of? (internal version) */
2401 : bool
2402 108598 : range_before_multirange_internal(TypeCacheEntry *rangetyp,
2403 : const RangeType *r,
2404 : const MultirangeType *mr)
2405 : {
2406 : RangeBound lower1,
2407 : upper1,
2408 : lower2,
2409 : upper2;
2410 : bool empty;
2411 :
2412 108598 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2413 31224 : return false;
2414 :
2415 77374 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
2416 : Assert(!empty);
2417 :
2418 77374 : multirange_get_bounds(rangetyp, mr, 0, &lower2, &upper2);
2419 :
2420 77374 : return (range_cmp_bounds(rangetyp, &upper1, &lower2) < 0);
2421 : }
2422 :
2423 : bool
2424 101526 : multirange_before_multirange_internal(TypeCacheEntry *rangetyp,
2425 : const MultirangeType *mr1,
2426 : const MultirangeType *mr2)
2427 : {
2428 : RangeBound lower1,
2429 : upper1,
2430 : lower2,
2431 : upper2;
2432 :
2433 101526 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
2434 50436 : return false;
2435 :
2436 51090 : multirange_get_bounds(rangetyp, mr1, mr1->rangeCount - 1,
2437 : &lower1, &upper1);
2438 51090 : multirange_get_bounds(rangetyp, mr2, 0,
2439 : &lower2, &upper2);
2440 :
2441 51090 : return (range_cmp_bounds(rangetyp, &upper1, &lower2) < 0);
2442 : }
2443 :
2444 : /* strictly right of? (internal version) */
2445 : bool
2446 159278 : range_after_multirange_internal(TypeCacheEntry *rangetyp,
2447 : const RangeType *r,
2448 : const MultirangeType *mr)
2449 : {
2450 : RangeBound lower1,
2451 : upper1,
2452 : lower2,
2453 : upper2;
2454 : bool empty;
2455 : int32 range_count;
2456 :
2457 159278 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2458 31224 : return false;
2459 :
2460 128054 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
2461 : Assert(!empty);
2462 :
2463 128054 : range_count = mr->rangeCount;
2464 128054 : multirange_get_bounds(rangetyp, mr, range_count - 1,
2465 : &lower2, &upper2);
2466 :
2467 128054 : return (range_cmp_bounds(rangetyp, &lower1, &upper2) > 0);
2468 : }
2469 :
2470 : bool
2471 92422 : range_adjacent_multirange_internal(TypeCacheEntry *rangetyp,
2472 : const RangeType *r,
2473 : const MultirangeType *mr)
2474 : {
2475 : RangeBound lower1,
2476 : upper1,
2477 : lower2,
2478 : upper2;
2479 : bool empty;
2480 : int32 range_count;
2481 :
2482 92422 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2483 6012 : return false;
2484 :
2485 86410 : range_deserialize(rangetyp, r, &lower1, &upper1, &empty);
2486 : Assert(!empty);
2487 :
2488 86410 : range_count = mr->rangeCount;
2489 86410 : multirange_get_bounds(rangetyp, mr, 0,
2490 : &lower2, &upper2);
2491 :
2492 86410 : if (bounds_adjacent(rangetyp, upper1, lower2))
2493 72 : return true;
2494 :
2495 86338 : if (range_count > 1)
2496 79126 : multirange_get_bounds(rangetyp, mr, range_count - 1,
2497 : &lower2, &upper2);
2498 :
2499 86338 : if (bounds_adjacent(rangetyp, upper2, lower1))
2500 84 : return true;
2501 :
2502 86254 : return false;
2503 : }
2504 :
2505 : /* adjacent to? */
2506 : Datum
2507 37224 : range_adjacent_multirange(PG_FUNCTION_ARGS)
2508 : {
2509 37224 : RangeType *r = PG_GETARG_RANGE_P(0);
2510 37224 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(1);
2511 : TypeCacheEntry *typcache;
2512 :
2513 37224 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2514 :
2515 37224 : PG_RETURN_BOOL(range_adjacent_multirange_internal(typcache->rngtype, r, mr));
2516 : }
2517 :
2518 : Datum
2519 44442 : multirange_adjacent_range(PG_FUNCTION_ARGS)
2520 : {
2521 44442 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2522 44442 : RangeType *r = PG_GETARG_RANGE_P(1);
2523 : TypeCacheEntry *typcache;
2524 :
2525 44442 : if (RangeIsEmpty(r) || MultirangeIsEmpty(mr))
2526 25212 : PG_RETURN_BOOL(false);
2527 :
2528 19230 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2529 :
2530 19230 : PG_RETURN_BOOL(range_adjacent_multirange_internal(typcache->rngtype, r, mr));
2531 : }
2532 :
2533 : Datum
2534 44472 : multirange_adjacent_multirange(PG_FUNCTION_ARGS)
2535 : {
2536 44472 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2537 44472 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2538 : TypeCacheEntry *typcache;
2539 : int32 range_count1;
2540 : int32 range_count2;
2541 : RangeBound lower1,
2542 : upper1,
2543 : lower2,
2544 : upper2;
2545 :
2546 44472 : if (MultirangeIsEmpty(mr1) || MultirangeIsEmpty(mr2))
2547 25218 : PG_RETURN_BOOL(false);
2548 :
2549 19254 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2550 :
2551 19254 : range_count1 = mr1->rangeCount;
2552 19254 : range_count2 = mr2->rangeCount;
2553 19254 : multirange_get_bounds(typcache->rngtype, mr1, range_count1 - 1,
2554 : &lower1, &upper1);
2555 19254 : multirange_get_bounds(typcache->rngtype, mr2, 0,
2556 : &lower2, &upper2);
2557 19254 : if (bounds_adjacent(typcache->rngtype, upper1, lower2))
2558 30 : PG_RETURN_BOOL(true);
2559 :
2560 19224 : if (range_count1 > 1)
2561 12012 : multirange_get_bounds(typcache->rngtype, mr1, 0,
2562 : &lower1, &upper1);
2563 19224 : if (range_count2 > 1)
2564 19206 : multirange_get_bounds(typcache->rngtype, mr2, range_count2 - 1,
2565 : &lower2, &upper2);
2566 19224 : if (bounds_adjacent(typcache->rngtype, upper2, lower1))
2567 24 : PG_RETURN_BOOL(true);
2568 19200 : PG_RETURN_BOOL(false);
2569 : }
2570 :
2571 : /* Btree support */
2572 :
2573 : /* btree comparator */
2574 : Datum
2575 918 : multirange_cmp(PG_FUNCTION_ARGS)
2576 : {
2577 918 : MultirangeType *mr1 = PG_GETARG_MULTIRANGE_P(0);
2578 918 : MultirangeType *mr2 = PG_GETARG_MULTIRANGE_P(1);
2579 : int32 range_count_1;
2580 : int32 range_count_2;
2581 : int32 range_count_max;
2582 : int32 i;
2583 : TypeCacheEntry *typcache;
2584 918 : int cmp = 0; /* If both are empty we'll use this. */
2585 :
2586 : /* Different types should be prevented by ANYMULTIRANGE matching rules */
2587 918 : if (MultirangeTypeGetOid(mr1) != MultirangeTypeGetOid(mr2))
2588 0 : elog(ERROR, "multirange types do not match");
2589 :
2590 918 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr1));
2591 :
2592 918 : range_count_1 = mr1->rangeCount;
2593 918 : range_count_2 = mr2->rangeCount;
2594 :
2595 : /* Loop over source data */
2596 918 : range_count_max = Max(range_count_1, range_count_2);
2597 984 : for (i = 0; i < range_count_max; i++)
2598 : {
2599 : RangeBound lower1,
2600 : upper1,
2601 : lower2,
2602 : upper2;
2603 :
2604 : /*
2605 : * If one multirange is shorter, it's as if it had empty ranges at the
2606 : * end to extend its length. An empty range compares earlier than any
2607 : * other range, so the shorter multirange comes before the longer.
2608 : * This is the same behavior as in other types, e.g. in strings 'aaa'
2609 : * < 'aaaaaa'.
2610 : */
2611 798 : if (i >= range_count_1)
2612 : {
2613 120 : cmp = -1;
2614 732 : break;
2615 : }
2616 678 : if (i >= range_count_2)
2617 : {
2618 168 : cmp = 1;
2619 168 : break;
2620 : }
2621 :
2622 510 : multirange_get_bounds(typcache->rngtype, mr1, i, &lower1, &upper1);
2623 510 : multirange_get_bounds(typcache->rngtype, mr2, i, &lower2, &upper2);
2624 :
2625 510 : cmp = range_cmp_bounds(typcache->rngtype, &lower1, &lower2);
2626 510 : if (cmp == 0)
2627 90 : cmp = range_cmp_bounds(typcache->rngtype, &upper1, &upper2);
2628 510 : if (cmp != 0)
2629 444 : break;
2630 : }
2631 :
2632 918 : PG_FREE_IF_COPY(mr1, 0);
2633 918 : PG_FREE_IF_COPY(mr2, 1);
2634 :
2635 918 : PG_RETURN_INT32(cmp);
2636 : }
2637 :
2638 : /* inequality operators using the multirange_cmp function */
2639 : Datum
2640 168 : multirange_lt(PG_FUNCTION_ARGS)
2641 : {
2642 168 : int cmp = DatumGetInt32(multirange_cmp(fcinfo));
2643 :
2644 168 : PG_RETURN_BOOL(cmp < 0);
2645 : }
2646 :
2647 : Datum
2648 96 : multirange_le(PG_FUNCTION_ARGS)
2649 : {
2650 96 : int cmp = DatumGetInt32(multirange_cmp(fcinfo));
2651 :
2652 96 : PG_RETURN_BOOL(cmp <= 0);
2653 : }
2654 :
2655 : Datum
2656 72 : multirange_ge(PG_FUNCTION_ARGS)
2657 : {
2658 72 : int cmp = DatumGetInt32(multirange_cmp(fcinfo));
2659 :
2660 72 : PG_RETURN_BOOL(cmp >= 0);
2661 : }
2662 :
2663 : Datum
2664 114 : multirange_gt(PG_FUNCTION_ARGS)
2665 : {
2666 114 : int cmp = DatumGetInt32(multirange_cmp(fcinfo));
2667 :
2668 114 : PG_RETURN_BOOL(cmp > 0);
2669 : }
2670 :
2671 : /* multirange -> range functions */
2672 :
2673 : /* Find the smallest range that includes everything in the multirange */
2674 : Datum
2675 36 : range_merge_from_multirange(PG_FUNCTION_ARGS)
2676 : {
2677 36 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2678 36 : Oid mltrngtypoid = MultirangeTypeGetOid(mr);
2679 : TypeCacheEntry *typcache;
2680 : RangeType *result;
2681 :
2682 36 : typcache = multirange_get_typcache(fcinfo, mltrngtypoid);
2683 :
2684 36 : if (MultirangeIsEmpty(mr))
2685 : {
2686 6 : result = make_empty_range(typcache->rngtype);
2687 : }
2688 30 : else if (mr->rangeCount == 1)
2689 : {
2690 12 : result = multirange_get_range(typcache->rngtype, mr, 0);
2691 : }
2692 : else
2693 : {
2694 : RangeBound firstLower,
2695 : firstUpper,
2696 : lastLower,
2697 : lastUpper;
2698 :
2699 18 : multirange_get_bounds(typcache->rngtype, mr, 0,
2700 : &firstLower, &firstUpper);
2701 18 : multirange_get_bounds(typcache->rngtype, mr, mr->rangeCount - 1,
2702 : &lastLower, &lastUpper);
2703 :
2704 18 : result = make_range(typcache->rngtype, &firstLower, &lastUpper,
2705 : false, NULL);
2706 : }
2707 :
2708 36 : PG_RETURN_RANGE_P(result);
2709 : }
2710 :
2711 : /* Turn multirange into a set of ranges */
2712 : Datum
2713 72 : multirange_unnest(PG_FUNCTION_ARGS)
2714 : {
2715 : typedef struct
2716 : {
2717 : MultirangeType *mr;
2718 : TypeCacheEntry *typcache;
2719 : int index;
2720 : } multirange_unnest_fctx;
2721 :
2722 : FuncCallContext *funcctx;
2723 : multirange_unnest_fctx *fctx;
2724 : MemoryContext oldcontext;
2725 :
2726 : /* stuff done only on the first call of the function */
2727 72 : if (SRF_IS_FIRSTCALL())
2728 : {
2729 : MultirangeType *mr;
2730 :
2731 : /* create a function context for cross-call persistence */
2732 24 : funcctx = SRF_FIRSTCALL_INIT();
2733 :
2734 : /*
2735 : * switch to memory context appropriate for multiple function calls
2736 : */
2737 24 : oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
2738 :
2739 : /*
2740 : * Get the multirange value and detoast if needed. We can't do this
2741 : * earlier because if we have to detoast, we want the detoasted copy
2742 : * to be in multi_call_memory_ctx, so it will go away when we're done
2743 : * and not before. (If no detoast happens, we assume the originally
2744 : * passed multirange will stick around till then.)
2745 : */
2746 24 : mr = PG_GETARG_MULTIRANGE_P(0);
2747 :
2748 : /* allocate memory for user context */
2749 24 : fctx = (multirange_unnest_fctx *) palloc(sizeof(multirange_unnest_fctx));
2750 :
2751 : /* initialize state */
2752 24 : fctx->mr = mr;
2753 24 : fctx->index = 0;
2754 24 : fctx->typcache = lookup_type_cache(MultirangeTypeGetOid(mr),
2755 : TYPECACHE_MULTIRANGE_INFO);
2756 :
2757 24 : funcctx->user_fctx = fctx;
2758 24 : MemoryContextSwitchTo(oldcontext);
2759 : }
2760 :
2761 : /* stuff done on every call of the function */
2762 72 : funcctx = SRF_PERCALL_SETUP();
2763 72 : fctx = funcctx->user_fctx;
2764 :
2765 72 : if (fctx->index < fctx->mr->rangeCount)
2766 : {
2767 : RangeType *range;
2768 :
2769 48 : range = multirange_get_range(fctx->typcache->rngtype,
2770 48 : fctx->mr,
2771 : fctx->index);
2772 48 : fctx->index++;
2773 :
2774 48 : SRF_RETURN_NEXT(funcctx, RangeTypePGetDatum(range));
2775 : }
2776 : else
2777 : {
2778 : /* do when there is no more left */
2779 24 : SRF_RETURN_DONE(funcctx);
2780 : }
2781 : }
2782 :
2783 : /* Hash support */
2784 :
2785 : /* hash a multirange value */
2786 : Datum
2787 336 : hash_multirange(PG_FUNCTION_ARGS)
2788 : {
2789 336 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2790 336 : uint32 result = 1;
2791 : TypeCacheEntry *typcache,
2792 : *scache;
2793 : int32 range_count,
2794 : i;
2795 :
2796 336 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2797 336 : scache = typcache->rngtype->rngelemtype;
2798 336 : if (!OidIsValid(scache->hash_proc_finfo.fn_oid))
2799 : {
2800 6 : scache = lookup_type_cache(scache->type_id,
2801 : TYPECACHE_HASH_PROC_FINFO);
2802 6 : if (!OidIsValid(scache->hash_proc_finfo.fn_oid))
2803 0 : ereport(ERROR,
2804 : (errcode(ERRCODE_UNDEFINED_FUNCTION),
2805 : errmsg("could not identify a hash function for type %s",
2806 : format_type_be(scache->type_id))));
2807 : }
2808 :
2809 336 : range_count = mr->rangeCount;
2810 600 : for (i = 0; i < range_count; i++)
2811 : {
2812 : RangeBound lower,
2813 : upper;
2814 264 : uint8 flags = MultirangeGetFlagsPtr(mr)[i];
2815 : uint32 lower_hash;
2816 : uint32 upper_hash;
2817 : uint32 range_hash;
2818 :
2819 264 : multirange_get_bounds(typcache->rngtype, mr, i, &lower, &upper);
2820 :
2821 264 : if (RANGE_HAS_LBOUND(flags))
2822 198 : lower_hash = DatumGetUInt32(FunctionCall1Coll(&scache->hash_proc_finfo,
2823 198 : typcache->rngtype->rng_collation,
2824 : lower.val));
2825 : else
2826 66 : lower_hash = 0;
2827 :
2828 264 : if (RANGE_HAS_UBOUND(flags))
2829 210 : upper_hash = DatumGetUInt32(FunctionCall1Coll(&scache->hash_proc_finfo,
2830 210 : typcache->rngtype->rng_collation,
2831 : upper.val));
2832 : else
2833 54 : upper_hash = 0;
2834 :
2835 : /* Merge hashes of flags and bounds */
2836 264 : range_hash = hash_bytes_uint32((uint32) flags);
2837 264 : range_hash ^= lower_hash;
2838 264 : range_hash = pg_rotate_left32(range_hash, 1);
2839 264 : range_hash ^= upper_hash;
2840 :
2841 : /*
2842 : * Use the same approach as hash_array to combine the individual
2843 : * elements' hash values:
2844 : */
2845 264 : result = (result << 5) - result + range_hash;
2846 : }
2847 :
2848 336 : PG_FREE_IF_COPY(mr, 0);
2849 :
2850 336 : PG_RETURN_UINT32(result);
2851 : }
2852 :
2853 : /*
2854 : * Returns 64-bit value by hashing a value to a 64-bit value, with a seed.
2855 : * Otherwise, similar to hash_multirange.
2856 : */
2857 : Datum
2858 60 : hash_multirange_extended(PG_FUNCTION_ARGS)
2859 : {
2860 60 : MultirangeType *mr = PG_GETARG_MULTIRANGE_P(0);
2861 60 : Datum seed = PG_GETARG_DATUM(1);
2862 60 : uint64 result = 1;
2863 : TypeCacheEntry *typcache,
2864 : *scache;
2865 : int32 range_count,
2866 : i;
2867 :
2868 60 : typcache = multirange_get_typcache(fcinfo, MultirangeTypeGetOid(mr));
2869 60 : scache = typcache->rngtype->rngelemtype;
2870 60 : if (!OidIsValid(scache->hash_extended_proc_finfo.fn_oid))
2871 : {
2872 0 : scache = lookup_type_cache(scache->type_id,
2873 : TYPECACHE_HASH_EXTENDED_PROC_FINFO);
2874 0 : if (!OidIsValid(scache->hash_extended_proc_finfo.fn_oid))
2875 0 : ereport(ERROR,
2876 : (errcode(ERRCODE_UNDEFINED_FUNCTION),
2877 : errmsg("could not identify a hash function for type %s",
2878 : format_type_be(scache->type_id))));
2879 : }
2880 :
2881 60 : range_count = mr->rangeCount;
2882 120 : for (i = 0; i < range_count; i++)
2883 : {
2884 : RangeBound lower,
2885 : upper;
2886 60 : uint8 flags = MultirangeGetFlagsPtr(mr)[i];
2887 : uint64 lower_hash;
2888 : uint64 upper_hash;
2889 : uint64 range_hash;
2890 :
2891 60 : multirange_get_bounds(typcache->rngtype, mr, i, &lower, &upper);
2892 :
2893 60 : if (RANGE_HAS_LBOUND(flags))
2894 60 : lower_hash = DatumGetUInt64(FunctionCall2Coll(&scache->hash_extended_proc_finfo,
2895 60 : typcache->rngtype->rng_collation,
2896 : lower.val,
2897 : seed));
2898 : else
2899 0 : lower_hash = 0;
2900 :
2901 60 : if (RANGE_HAS_UBOUND(flags))
2902 60 : upper_hash = DatumGetUInt64(FunctionCall2Coll(&scache->hash_extended_proc_finfo,
2903 60 : typcache->rngtype->rng_collation,
2904 : upper.val,
2905 : seed));
2906 : else
2907 0 : upper_hash = 0;
2908 :
2909 : /* Merge hashes of flags and bounds */
2910 60 : range_hash = DatumGetUInt64(hash_uint32_extended((uint32) flags,
2911 60 : DatumGetInt64(seed)));
2912 60 : range_hash ^= lower_hash;
2913 60 : range_hash = ROTATE_HIGH_AND_LOW_32BITS(range_hash);
2914 60 : range_hash ^= upper_hash;
2915 :
2916 : /*
2917 : * Use the same approach as hash_array to combine the individual
2918 : * elements' hash values:
2919 : */
2920 60 : result = (result << 5) - result + range_hash;
2921 : }
2922 :
2923 60 : PG_FREE_IF_COPY(mr, 0);
2924 :
2925 60 : PG_RETURN_UINT64(result);
2926 : }
|
