Age Owner Branch data TLA Line data Source code
1 : : /*-------------------------------------------------------------------------
2 : : *
3 : : * oid.c
4 : : * Functions for the built-in type Oid ... also oidvector.
5 : : *
6 : : * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
7 : : * Portions Copyright (c) 1994, Regents of the University of California
8 : : *
9 : : *
10 : : * IDENTIFICATION
11 : : * src/backend/utils/adt/oid.c
12 : : *
13 : : *-------------------------------------------------------------------------
14 : : */
15 : : #include "postgres.h"
16 : :
17 : : #include <ctype.h>
18 : : #include <limits.h>
19 : :
20 : : #include "catalog/pg_type.h"
21 : : #include "common/int.h"
22 : : #include "libpq/pqformat.h"
23 : : #include "nodes/miscnodes.h"
24 : : #include "nodes/value.h"
25 : : #include "utils/array.h"
26 : : #include "utils/builtins.h"
27 : :
28 : :
29 : : #define OidVectorSize(n) (offsetof(oidvector, values) + (n) * sizeof(Oid))
30 : :
31 : :
32 : : /*****************************************************************************
33 : : * USER I/O ROUTINES *
34 : : *****************************************************************************/
35 : :
36 : : Datum
9265 tgl@sss.pgh.pa.us 37 :CBC 3441866 : oidin(PG_FUNCTION_ARGS)
38 : : {
39 : 3441866 : char *s = PG_GETARG_CSTRING(0);
40 : : Oid result;
41 : :
1225 42 : 3441866 : result = uint32in_subr(s, NULL, "oid", fcinfo->context);
9265 43 : 3441826 : PG_RETURN_OID(result);
44 : : }
45 : :
46 : : Datum
47 : 12206825 : oidout(PG_FUNCTION_ARGS)
48 : : {
49 : 12206825 : Oid o = PG_GETARG_OID(0);
50 : 12206825 : char *result = (char *) palloc(12);
51 : :
52 : 12206825 : snprintf(result, 12, "%u", o);
53 : 12206825 : PG_RETURN_CSTRING(result);
54 : : }
55 : :
56 : : /*
57 : : * oidrecv - converts external binary format to oid
58 : : */
59 : : Datum
8397 60 : 113 : oidrecv(PG_FUNCTION_ARGS)
61 : : {
62 : 113 : StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
63 : :
64 : 113 : PG_RETURN_OID((Oid) pq_getmsgint(buf, sizeof(Oid)));
65 : : }
66 : :
67 : : /*
68 : : * oidsend - converts oid to binary format
69 : : */
70 : : Datum
71 : 9 : oidsend(PG_FUNCTION_ARGS)
72 : : {
73 : 9 : Oid arg1 = PG_GETARG_OID(0);
74 : : StringInfoData buf;
75 : :
76 : 9 : pq_begintypsend(&buf);
3128 andres@anarazel.de 77 : 9 : pq_sendint32(&buf, arg1);
8397 tgl@sss.pgh.pa.us 78 : 9 : PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
79 : : }
80 : :
81 : : /*
82 : : * construct oidvector given a raw array of Oids
83 : : *
84 : : * If oids is NULL then caller must fill values[] afterward
85 : : */
86 : : oidvector *
7707 87 : 83294 : buildoidvector(const Oid *oids, int n)
88 : : {
89 : : oidvector *result;
90 : :
91 : 83294 : result = (oidvector *) palloc0(OidVectorSize(n));
92 : :
93 [ + + + - ]: 83294 : if (n > 0 && oids)
94 : 80232 : memcpy(result->values, oids, n * sizeof(Oid));
95 : :
96 : : /*
97 : : * Attach standard array header. For historical reasons, we set the index
98 : : * lower bound to 0 not 1.
99 : : */
7007 100 : 83294 : SET_VARSIZE(result, OidVectorSize(n));
7707 101 : 83294 : result->ndim = 1;
7474 102 : 83294 : result->dataoffset = 0; /* never any nulls */
7707 103 : 83294 : result->elemtype = OIDOID;
104 : 83294 : result->dim1 = n;
105 : 83294 : result->lbound1 = 0;
106 : :
107 : 83294 : return result;
108 : : }
109 : :
110 : : /*
111 : : * validate that an array object meets the restrictions of oidvector
112 : : *
113 : : * We need this because there are pathways by which a general oid[] array can
114 : : * be cast to oidvector, allowing the type's restrictions to be violated.
115 : : * All code that receives an oidvector as a SQL parameter should check this.
116 : : */
117 : : void
85 118 : 9507501 : check_valid_oidvector(const oidvector *oidArray)
119 : : {
120 : : /*
121 : : * We insist on ndim == 1 and dataoffset == 0 (that is, no nulls) because
122 : : * otherwise the array's layout will not be what calling code expects. We
123 : : * needn't be picky about the index lower bound though. Checking elemtype
124 : : * is just paranoia.
125 : : */
126 [ + + ]: 9507501 : if (oidArray->ndim != 1 ||
127 [ + - ]: 9507497 : oidArray->dataoffset != 0 ||
128 [ - + ]: 9507497 : oidArray->elemtype != OIDOID)
129 [ + - ]: 4 : ereport(ERROR,
130 : : (errcode(ERRCODE_DATATYPE_MISMATCH),
131 : : errmsg("array is not a valid oidvector")));
132 : 9507497 : }
133 : :
134 : : /*
135 : : * oidvectorin - converts "num num ..." to internal form
136 : : */
137 : : Datum
9465 138 : 195109 : oidvectorin(PG_FUNCTION_ARGS)
139 : : {
140 : 195109 : char *oidString = PG_GETARG_CSTRING(0);
1238 141 : 195109 : Node *escontext = fcinfo->context;
142 : : oidvector *result;
143 : : int nalloc;
144 : : int n;
145 : :
1206 146 : 195109 : nalloc = 32; /* arbitrary initial size guess */
147 : 195109 : result = (oidvector *) palloc0(OidVectorSize(nalloc));
148 : :
149 : 195109 : for (n = 0;; n++)
150 : : {
9284 151 [ + + + + ]: 704007 : while (*oidString && isspace((unsigned char) *oidString))
9612 bruce@momjian.us 152 : 161896 : oidString++;
9265 tgl@sss.pgh.pa.us 153 [ + + ]: 542111 : if (*oidString == '\0')
154 : 195093 : break;
155 : :
1206 156 [ - + ]: 347018 : if (n >= nalloc)
157 : : {
1206 tgl@sss.pgh.pa.us 158 :UBC 0 : nalloc *= 2;
159 : 0 : result = (oidvector *) repalloc(result, OidVectorSize(nalloc));
160 : : }
161 : :
1225 tgl@sss.pgh.pa.us 162 :CBC 347018 : result->values[n] = uint32in_subr(oidString, &oidString,
163 : : "oid", escontext);
1238 164 [ + + + - : 347018 : if (SOFT_ERROR_OCCURRED(escontext))
+ + ]
165 : 16 : PG_RETURN_NULL();
166 : : }
167 : :
7007 168 : 195093 : SET_VARSIZE(result, OidVectorSize(n));
7707 169 : 195093 : result->ndim = 1;
7474 170 : 195093 : result->dataoffset = 0; /* never any nulls */
7707 171 : 195093 : result->elemtype = OIDOID;
172 : 195093 : result->dim1 = n;
173 : 195093 : result->lbound1 = 0;
174 : :
9465 175 : 195093 : PG_RETURN_POINTER(result);
176 : : }
177 : :
178 : : /*
179 : : * oidvectorout - converts internal form to "num num ..."
180 : : */
181 : : Datum
182 : 22004 : oidvectorout(PG_FUNCTION_ARGS)
183 : : {
7707 184 : 22004 : oidvector *oidArray = (oidvector *) PG_GETARG_POINTER(0);
185 : : int num,
186 : : nnums;
187 : : char *rp;
188 : : char *result;
189 : :
190 : : /* validate input before fetching dim1 */
85 191 : 22004 : check_valid_oidvector(oidArray);
192 : 22000 : nnums = oidArray->dim1;
193 : :
194 : : /* assumes sign, 10 digits, ' ' */
7707 195 : 22000 : rp = result = (char *) palloc(nnums * 12 + 1);
196 [ + + ]: 57880 : for (num = 0; num < nnums; num++)
197 : : {
9612 bruce@momjian.us 198 [ + + ]: 35880 : if (num != 0)
199 : 15826 : *rp++ = ' ';
7707 tgl@sss.pgh.pa.us 200 : 35880 : sprintf(rp, "%u", oidArray->values[num]);
10467 bruce@momjian.us 201 [ + + ]: 101256 : while (*++rp != '\0')
202 : : ;
203 : : }
9612 204 : 22000 : *rp = '\0';
9465 tgl@sss.pgh.pa.us 205 : 22000 : PG_RETURN_CSTRING(result);
206 : : }
207 : :
208 : : /*
209 : : * oidvectorrecv - converts external binary format to oidvector
210 : : */
211 : : Datum
8397 tgl@sss.pgh.pa.us 212 :UBC 0 : oidvectorrecv(PG_FUNCTION_ARGS)
213 : : {
2656 andres@anarazel.de 214 : 0 : LOCAL_FCINFO(locfcinfo, 3);
8397 tgl@sss.pgh.pa.us 215 : 0 : StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
216 : : oidvector *result;
217 : :
218 : : /*
219 : : * Normally one would call array_recv() using DirectFunctionCall3, but
220 : : * that does not work since array_recv wants to cache some data using
221 : : * fcinfo->flinfo->fn_extra. So we need to pass it our own flinfo
222 : : * parameter.
223 : : */
2656 andres@anarazel.de 224 : 0 : InitFunctionCallInfoData(*locfcinfo, fcinfo->flinfo, 3,
225 : : InvalidOid, NULL, NULL);
226 : :
227 : 0 : locfcinfo->args[0].value = PointerGetDatum(buf);
228 : 0 : locfcinfo->args[0].isnull = false;
229 : 0 : locfcinfo->args[1].value = ObjectIdGetDatum(OIDOID);
230 : 0 : locfcinfo->args[1].isnull = false;
231 : 0 : locfcinfo->args[2].value = Int32GetDatum(-1);
232 : 0 : locfcinfo->args[2].isnull = false;
233 : :
234 : 0 : result = (oidvector *) DatumGetPointer(array_recv(locfcinfo));
235 : :
236 [ # # ]: 0 : Assert(!locfcinfo->isnull);
237 : :
238 : : /* sanity checks: oidvector must be 1-D, 0-based, no nulls */
7474 tgl@sss.pgh.pa.us 239 [ # # ]: 0 : if (ARR_NDIM(result) != 1 ||
240 [ # # ]: 0 : ARR_HASNULL(result) ||
6087 heikki.linnakangas@i 241 [ # # ]: 0 : ARR_ELEMTYPE(result) != OIDOID ||
242 [ # # ]: 0 : ARR_LBOUND(result)[0] != 0)
7707 tgl@sss.pgh.pa.us 243 [ # # ]: 0 : ereport(ERROR,
244 : : (errcode(ERRCODE_INVALID_BINARY_REPRESENTATION),
245 : : errmsg("invalid oidvector data")));
246 : :
8397 247 : 0 : PG_RETURN_POINTER(result);
248 : : }
249 : :
250 : : /*
251 : : * oidvectorsend - converts oidvector to binary format
252 : : */
253 : : Datum
254 : 0 : oidvectorsend(PG_FUNCTION_ARGS)
255 : : {
256 : : /* We don't do check_valid_oidvector, since array_send won't care */
7707 257 : 0 : return array_send(fcinfo);
258 : : }
259 : :
260 : : /*
261 : : * oidparse - get OID from ICONST/FCONST node
262 : : */
263 : : Oid
5805 rhaas@postgresql.org 264 :CBC 117 : oidparse(Node *node)
265 : : {
266 [ + + - ]: 117 : switch (nodeTag(node))
267 : : {
268 : 109 : case T_Integer:
269 : 109 : return intVal(node);
270 : 8 : case T_Float:
271 : :
272 : : /*
273 : : * Values too large for int4 will be represented as Float
274 : : * constants by the lexer. Accept these if they are valid OID
275 : : * strings.
276 : : */
1225 tgl@sss.pgh.pa.us 277 : 8 : return uint32in_subr(castNode(Float, node)->fval, NULL,
278 : : "oid", NULL);
5805 rhaas@postgresql.org 279 :UBC 0 : default:
280 [ # # ]: 0 : elog(ERROR, "unrecognized node type: %d", (int) nodeTag(node));
281 : : }
282 : : return InvalidOid; /* keep compiler quiet */
283 : : }
284 : :
285 : : /* qsort comparison function for Oids */
286 : : int
3352 peter_e@gmx.net 287 :CBC 265534 : oid_cmp(const void *p1, const void *p2)
288 : : {
289 : 265534 : Oid v1 = *((const Oid *) p1);
290 : 265534 : Oid v2 = *((const Oid *) p2);
291 : :
809 nathan@postgresql.or 292 : 265534 : return pg_cmp_u32(v1, v2);
293 : : }
294 : :
295 : :
296 : : /*****************************************************************************
297 : : * PUBLIC ROUTINES *
298 : : *****************************************************************************/
299 : :
300 : : Datum
9465 tgl@sss.pgh.pa.us 301 : 88590288 : oideq(PG_FUNCTION_ARGS)
302 : : {
303 : 88590288 : Oid arg1 = PG_GETARG_OID(0);
304 : 88590288 : Oid arg2 = PG_GETARG_OID(1);
305 : :
306 : 88590288 : PG_RETURN_BOOL(arg1 == arg2);
307 : : }
308 : :
309 : : Datum
310 : 1926946 : oidne(PG_FUNCTION_ARGS)
311 : : {
312 : 1926946 : Oid arg1 = PG_GETARG_OID(0);
313 : 1926946 : Oid arg2 = PG_GETARG_OID(1);
314 : :
315 : 1926946 : PG_RETURN_BOOL(arg1 != arg2);
316 : : }
317 : :
318 : : Datum
9296 319 : 4051765 : oidlt(PG_FUNCTION_ARGS)
320 : : {
321 : 4051765 : Oid arg1 = PG_GETARG_OID(0);
322 : 4051765 : Oid arg2 = PG_GETARG_OID(1);
323 : :
324 : 4051765 : PG_RETURN_BOOL(arg1 < arg2);
325 : : }
326 : :
327 : : Datum
328 : 1383721 : oidle(PG_FUNCTION_ARGS)
329 : : {
330 : 1383721 : Oid arg1 = PG_GETARG_OID(0);
331 : 1383721 : Oid arg2 = PG_GETARG_OID(1);
332 : :
333 : 1383721 : PG_RETURN_BOOL(arg1 <= arg2);
334 : : }
335 : :
336 : : Datum
337 : 58783 : oidge(PG_FUNCTION_ARGS)
338 : : {
339 : 58783 : Oid arg1 = PG_GETARG_OID(0);
340 : 58783 : Oid arg2 = PG_GETARG_OID(1);
341 : :
342 : 58783 : PG_RETURN_BOOL(arg1 >= arg2);
343 : : }
344 : :
345 : : Datum
346 : 190129 : oidgt(PG_FUNCTION_ARGS)
347 : : {
348 : 190129 : Oid arg1 = PG_GETARG_OID(0);
349 : 190129 : Oid arg2 = PG_GETARG_OID(1);
350 : :
351 : 190129 : PG_RETURN_BOOL(arg1 > arg2);
352 : : }
353 : :
354 : : Datum
9030 tgl@sss.pgh.pa.us 355 :UBC 0 : oidlarger(PG_FUNCTION_ARGS)
356 : : {
357 : 0 : Oid arg1 = PG_GETARG_OID(0);
358 : 0 : Oid arg2 = PG_GETARG_OID(1);
359 : :
360 : 0 : PG_RETURN_OID((arg1 > arg2) ? arg1 : arg2);
361 : : }
362 : :
363 : : Datum
364 : 0 : oidsmaller(PG_FUNCTION_ARGS)
365 : : {
366 : 0 : Oid arg1 = PG_GETARG_OID(0);
367 : 0 : Oid arg2 = PG_GETARG_OID(1);
368 : :
369 : 0 : PG_RETURN_OID((arg1 < arg2) ? arg1 : arg2);
370 : : }
371 : :
372 : : Datum
9465 tgl@sss.pgh.pa.us 373 :CBC 22044 : oidvectoreq(PG_FUNCTION_ARGS)
374 : : {
7707 375 : 22044 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
376 : :
377 : 22044 : PG_RETURN_BOOL(cmp == 0);
378 : : }
379 : :
380 : : Datum
9465 381 : 14981 : oidvectorne(PG_FUNCTION_ARGS)
382 : : {
7707 383 : 14981 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
384 : :
385 : 14981 : PG_RETURN_BOOL(cmp != 0);
386 : : }
387 : :
388 : : Datum
9465 389 : 2456 : oidvectorlt(PG_FUNCTION_ARGS)
390 : : {
7707 391 : 2456 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
392 : :
393 : 2456 : PG_RETURN_BOOL(cmp < 0);
394 : : }
395 : :
396 : : Datum
9465 397 : 848 : oidvectorle(PG_FUNCTION_ARGS)
398 : : {
7707 399 : 848 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
400 : :
401 : 848 : PG_RETURN_BOOL(cmp <= 0);
402 : : }
403 : :
404 : : Datum
9465 tgl@sss.pgh.pa.us 405 :UBC 0 : oidvectorge(PG_FUNCTION_ARGS)
406 : : {
7707 407 : 0 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
408 : :
409 : 0 : PG_RETURN_BOOL(cmp >= 0);
410 : : }
411 : :
412 : : Datum
9465 413 : 0 : oidvectorgt(PG_FUNCTION_ARGS)
414 : : {
7707 415 : 0 : int32 cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
416 : :
417 : 0 : PG_RETURN_BOOL(cmp > 0);
418 : : }
|
