]> granicus.if.org Git - postgresql/blobdiff - src/backend/utils/adt/oid.c
Update copyright for 2014
[postgresql] / src / backend / utils / adt / oid.c
index 2154da090ecfa5165080fc50bdeb3a44e551e77a..8945ef43f0148bf80ade05a1c56996bdf003e13c 100644 (file)
 /*-------------------------------------------------------------------------
  *
- * oid.c--
- *    Functions for the built-in type Oid.
+ * oid.c
+ *       Functions for the built-in type Oid ... also oidvector.
  *
- * Copyright (c) 1994, Regents of the University of California
+ * Portions Copyright (c) 1996-2014, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1994, Regents of the University of California
  *
  *
  * IDENTIFICATION
- *    $Header: /cvsroot/pgsql/src/backend/utils/adt/oid.c,v 1.6 1997/03/14 23:20:52 scrappy Exp $
+ *       src/backend/utils/adt/oid.c
  *
  *-------------------------------------------------------------------------
  */
+#include "postgres.h"
 
-#include <stdio.h>
-#include <string.h>
+#include <ctype.h>
+#include <limits.h>
 
-#include "postgres.h"
-#include "utils/builtins.h"    /* where function declarations go */
+#include "catalog/pg_type.h"
+#include "libpq/pqformat.h"
+#include "utils/array.h"
+#include "utils/builtins.h"
+
+
+#define OidVectorSize(n)       (offsetof(oidvector, values) + (n) * sizeof(Oid))
 
-/***************************************************************************** 
- *   USER I/O ROUTINES                                                       *
+
+/*****************************************************************************
+ *      USER I/O ROUTINES                                                                                                               *
  *****************************************************************************/
 
+static Oid
+oidin_subr(const char *s, char **endloc)
+{
+       unsigned long cvt;
+       char       *endptr;
+       Oid                     result;
+
+       if (*s == '\0')
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type oid: \"%s\"",
+                                               s)));
+
+       errno = 0;
+       cvt = strtoul(s, &endptr, 10);
+
+       /*
+        * strtoul() normally only sets ERANGE.  On some systems it also may set
+        * EINVAL, which simply means it couldn't parse the input string. This is
+        * handled by the second "if" consistent across platforms.
+        */
+       if (errno && errno != ERANGE && errno != EINVAL)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type oid: \"%s\"",
+                                               s)));
+
+       if (endptr == s && *s != '\0')
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type oid: \"%s\"",
+                                               s)));
+
+       if (errno == ERANGE)
+               ereport(ERROR,
+                               (errcode(ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE),
+                                errmsg("value \"%s\" is out of range for type oid", s)));
+
+       if (endloc)
+       {
+               /* caller wants to deal with rest of string */
+               *endloc = endptr;
+       }
+       else
+       {
+               /* allow only whitespace after number */
+               while (*endptr && isspace((unsigned char) *endptr))
+                       endptr++;
+               if (*endptr)
+                       ereport(ERROR,
+                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                        errmsg("invalid input syntax for type oid: \"%s\"",
+                                                       s)));
+       }
+
+       result = (Oid) cvt;
+
+       /*
+        * Cope with possibility that unsigned long is wider than Oid, in which
+        * case strtoul will not raise an error for some values that are out of
+        * the range of Oid.
+        *
+        * For backwards compatibility, we want to accept inputs that are given
+        * with a minus sign, so allow the input value if it matches after either
+        * signed or unsigned extension to long.
+        *
+        * To ensure consistent results on 32-bit and 64-bit platforms, make sure
+        * the error message is the same as if strtoul() had returned ERANGE.
+        */
+#if OID_MAX != ULONG_MAX
+       if (cvt != (unsigned long) result &&
+               cvt != (unsigned long) ((int) result))
+               ereport(ERROR,
+                               (errcode(ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE),
+                                errmsg("value \"%s\" is out of range for type oid", s)));
+#endif
+
+       return result;
+}
+
+Datum
+oidin(PG_FUNCTION_ARGS)
+{
+       char       *s = PG_GETARG_CSTRING(0);
+       Oid                     result;
+
+       result = oidin_subr(s, NULL);
+       PG_RETURN_OID(result);
+}
+
+Datum
+oidout(PG_FUNCTION_ARGS)
+{
+       Oid                     o = PG_GETARG_OID(0);
+       char       *result = (char *) palloc(12);
+
+       snprintf(result, 12, "%u", o);
+       PG_RETURN_CSTRING(result);
+}
+
+/*
+ *             oidrecv                 - converts external binary format to oid
+ */
+Datum
+oidrecv(PG_FUNCTION_ARGS)
+{
+       StringInfo      buf = (StringInfo) PG_GETARG_POINTER(0);
+
+       PG_RETURN_OID((Oid) pq_getmsgint(buf, sizeof(Oid)));
+}
+
+/*
+ *             oidsend                 - converts oid to binary format
+ */
+Datum
+oidsend(PG_FUNCTION_ARGS)
+{
+       Oid                     arg1 = PG_GETARG_OID(0);
+       StringInfoData buf;
+
+       pq_begintypsend(&buf);
+       pq_sendint(&buf, arg1, sizeof(Oid));
+       PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
+}
+
 /*
- *     oid8in          - converts "num num ..." to internal form
+ * construct oidvector given a raw array of Oids
  *
- *     Note:
- *             Fills any nonexistent digits with NULL oids.
+ * If oids is NULL then caller must fill values[] afterward
+ */
+oidvector *
+buildoidvector(const Oid *oids, int n)
+{
+       oidvector  *result;
+
+       result = (oidvector *) palloc0(OidVectorSize(n));
+
+       if (n > 0 && oids)
+               memcpy(result->values, oids, n * sizeof(Oid));
+
+       /*
+        * Attach standard array header.  For historical reasons, we set the index
+        * lower bound to 0 not 1.
+        */
+       SET_VARSIZE(result, OidVectorSize(n));
+       result->ndim = 1;
+       result->dataoffset = 0;         /* never any nulls */
+       result->elemtype = OIDOID;
+       result->dim1 = n;
+       result->lbound1 = 0;
+
+       return result;
+}
+
+/*
+ *             oidvectorin                     - converts "num num ..." to internal form
  */
-Oid *oid8in(char *oidString)
-{
-    register Oid       (*result)[];
-    int                        nums;
-    
-    if (oidString == NULL)
-       return(NULL);
-    result = (Oid (*)[]) palloc(sizeof(Oid [8]));
-    if ((nums = sscanf(oidString, "%d%d%d%d%d%d%d%d",
-                      &(*result)[0],
-                      &(*result)[1],
-                      &(*result)[2],
-                      &(*result)[3],
-                      &(*result)[4],
-                      &(*result)[5],
-                      &(*result)[6],
-                      &(*result)[7])) != 8) {
-       do
-           (*result)[nums++] = 0;
-       while (nums < 8);
-    }
-    return((Oid *) result);
+Datum
+oidvectorin(PG_FUNCTION_ARGS)
+{
+       char       *oidString = PG_GETARG_CSTRING(0);
+       oidvector  *result;
+       int                     n;
+
+       result = (oidvector *) palloc0(OidVectorSize(FUNC_MAX_ARGS));
+
+       for (n = 0; n < FUNC_MAX_ARGS; n++)
+       {
+               while (*oidString && isspace((unsigned char) *oidString))
+                       oidString++;
+               if (*oidString == '\0')
+                       break;
+               result->values[n] = oidin_subr(oidString, &oidString);
+       }
+       while (*oidString && isspace((unsigned char) *oidString))
+               oidString++;
+       if (*oidString)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
+                                errmsg("oidvector has too many elements")));
+
+       SET_VARSIZE(result, OidVectorSize(n));
+       result->ndim = 1;
+       result->dataoffset = 0;         /* never any nulls */
+       result->elemtype = OIDOID;
+       result->dim1 = n;
+       result->lbound1 = 0;
+
+       PG_RETURN_POINTER(result);
 }
 
 /*
- *     oid8out - converts internal form to "num num ..."
+ *             oidvectorout - converts internal form to "num num ..."
  */
-char *oid8out(Oid      (*oidArray)[])
-{
-    register int               num;
-    register Oid       *sp;
-    register char              *rp;
-    char                       *result;
-    
-    if (oidArray == NULL) {
-       result = (char *) palloc(2);
-       result[0] = '-';
-       result[1] = '\0';
-       return(result);
-    }
-    
-    /* assumes sign, 10 digits, ' ' */
-    rp = result = (char *) palloc(8 * 12);
-    sp = *oidArray;
-    for (num = 8; num != 0; num--) {
-       ltoa(*sp++, rp);
-       while (*++rp != '\0')
-           ;
-       *rp++ = ' ';
-    }
-    *--rp = '\0';
-    return(result);
-}
-
-Oid oidin(char *s)
-{
-    extern int32 int4in();
-    
-    return(int4in(s));
-}
-
-char *oidout(Oid o)
-{
-    extern char *int4out();
-    
-    return(int4out(o));
-}
-
-/***************************************************************************** 
- *   PUBLIC ROUTINES                                                         *
+Datum
+oidvectorout(PG_FUNCTION_ARGS)
+{
+       oidvector  *oidArray = (oidvector *) PG_GETARG_POINTER(0);
+       int                     num,
+                               nnums = oidArray->dim1;
+       char       *rp;
+       char       *result;
+
+       /* assumes sign, 10 digits, ' ' */
+       rp = result = (char *) palloc(nnums * 12 + 1);
+       for (num = 0; num < nnums; num++)
+       {
+               if (num != 0)
+                       *rp++ = ' ';
+               sprintf(rp, "%u", oidArray->values[num]);
+               while (*++rp != '\0')
+                       ;
+       }
+       *rp = '\0';
+       PG_RETURN_CSTRING(result);
+}
+
+/*
+ *             oidvectorrecv                   - converts external binary format to oidvector
+ */
+Datum
+oidvectorrecv(PG_FUNCTION_ARGS)
+{
+       StringInfo      buf = (StringInfo) PG_GETARG_POINTER(0);
+       FunctionCallInfoData locfcinfo;
+       oidvector  *result;
+
+       /*
+        * Normally one would call array_recv() using DirectFunctionCall3, but
+        * that does not work since array_recv wants to cache some data using
+        * fcinfo->flinfo->fn_extra.  So we need to pass it our own flinfo
+        * parameter.
+        */
+       InitFunctionCallInfoData(locfcinfo, fcinfo->flinfo, 3,
+                                                        InvalidOid, NULL, NULL);
+
+       locfcinfo.arg[0] = PointerGetDatum(buf);
+       locfcinfo.arg[1] = ObjectIdGetDatum(OIDOID);
+       locfcinfo.arg[2] = Int32GetDatum(-1);
+       locfcinfo.argnull[0] = false;
+       locfcinfo.argnull[1] = false;
+       locfcinfo.argnull[2] = false;
+
+       result = (oidvector *) DatumGetPointer(array_recv(&locfcinfo));
+
+       Assert(!locfcinfo.isnull);
+
+       /* sanity checks: oidvector must be 1-D, 0-based, no nulls */
+       if (ARR_NDIM(result) != 1 ||
+               ARR_HASNULL(result) ||
+               ARR_ELEMTYPE(result) != OIDOID ||
+               ARR_LBOUND(result)[0] != 0)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_BINARY_REPRESENTATION),
+                                errmsg("invalid oidvector data")));
+
+       /* check length for consistency with oidvectorin() */
+       if (ARR_DIMS(result)[0] > FUNC_MAX_ARGS)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
+                                errmsg("oidvector has too many elements")));
+
+       PG_RETURN_POINTER(result);
+}
+
+/*
+ *             oidvectorsend                   - converts oidvector to binary format
+ */
+Datum
+oidvectorsend(PG_FUNCTION_ARGS)
+{
+       return array_send(fcinfo);
+}
+
+/*
+ *             oidparse                                - get OID from IConst/FConst node
+ */
+Oid
+oidparse(Node *node)
+{
+       switch (nodeTag(node))
+       {
+               case T_Integer:
+                       return intVal(node);
+               case T_Float:
+
+                       /*
+                        * Values too large for int4 will be represented as Float
+                        * constants by the lexer.      Accept these if they are valid OID
+                        * strings.
+                        */
+                       return oidin_subr(strVal(node), NULL);
+               default:
+                       elog(ERROR, "unrecognized node type: %d", (int) nodeTag(node));
+       }
+       return InvalidOid;                      /* keep compiler quiet */
+}
+
+
+/*****************************************************************************
+ *      PUBLIC ROUTINES                                                                                                                 *
  *****************************************************************************/
 
-bool oideq(Oid arg1, Oid arg2)
+Datum
+oideq(PG_FUNCTION_ARGS)
 {
-    return(arg1 == arg2);
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 == arg2);
 }
 
-bool oidne(Oid arg1, Oid arg2)
+Datum
+oidne(PG_FUNCTION_ARGS)
 {
-    return(arg1 != arg2);
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 != arg2);
 }
 
-bool oid8eq(Oid arg1[], Oid arg2[])
+Datum
+oidlt(PG_FUNCTION_ARGS)
 {
-    return (bool)(memcmp(arg1, arg2, 8 * sizeof(Oid)) == 0);
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 < arg2);
 }
 
-bool oideqint4(Oid arg1, int32 arg2)
+Datum
+oidle(PG_FUNCTION_ARGS)
 {
-/* oid is unsigned, but int4 is signed */
-    return (arg2 >= 0 && arg1 == arg2);
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 <= arg2);
 }
 
-bool int4eqoid(int32 arg1, Oid arg2)
+Datum
+oidge(PG_FUNCTION_ARGS)
 {
-/* oid is unsigned, but int4 is signed */
-    return (arg1 >= 0 && arg1 == arg2);
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 >= arg2);
 }
 
+Datum
+oidgt(PG_FUNCTION_ARGS)
+{
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_BOOL(arg1 > arg2);
+}
+
+Datum
+oidlarger(PG_FUNCTION_ARGS)
+{
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_OID((arg1 > arg2) ? arg1 : arg2);
+}
+
+Datum
+oidsmaller(PG_FUNCTION_ARGS)
+{
+       Oid                     arg1 = PG_GETARG_OID(0);
+       Oid                     arg2 = PG_GETARG_OID(1);
+
+       PG_RETURN_OID((arg1 < arg2) ? arg1 : arg2);
+}
+
+Datum
+oidvectoreq(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp == 0);
+}
+
+Datum
+oidvectorne(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp != 0);
+}
+
+Datum
+oidvectorlt(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp < 0);
+}
+
+Datum
+oidvectorle(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp <= 0);
+}
+
+Datum
+oidvectorge(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp >= 0);
+}
+
+Datum
+oidvectorgt(PG_FUNCTION_ARGS)
+{
+       int32           cmp = DatumGetInt32(btoidvectorcmp(fcinfo));
+
+       PG_RETURN_BOOL(cmp > 0);
+}