PostgreSQL Source Code  git master
parse_oper.c File Reference
#include "postgres.h"
#include "access/htup_details.h"
#include "catalog/pg_operator.h"
#include "catalog/pg_type.h"
#include "lib/stringinfo.h"
#include "nodes/nodeFuncs.h"
#include "parser/parse_coerce.h"
#include "parser/parse_func.h"
#include "parser/parse_oper.h"
#include "parser/parse_type.h"
#include "utils/builtins.h"
#include "utils/inval.h"
#include "utils/lsyscache.h"
#include "utils/syscache.h"
#include "utils/typcache.h"
Include dependency graph for parse_oper.c:

Go to the source code of this file.

Data Structures

struct  OprCacheKey
 
struct  OprCacheEntry
 

Macros

#define MAX_CACHED_PATH_LEN   16
 

Typedefs

typedef struct OprCacheKey OprCacheKey
 
typedef struct OprCacheEntry OprCacheEntry
 

Functions

static Oid binary_oper_exact (List *opname, Oid arg1, Oid arg2)
 
static FuncDetailCode oper_select_candidate (int nargs, Oid *input_typeids, FuncCandidateList candidates, Oid *operOid)
 
static const char * op_signature_string (List *op, char oprkind, Oid arg1, Oid arg2)
 
static void op_error (ParseState *pstate, List *op, char oprkind, Oid arg1, Oid arg2, FuncDetailCode fdresult, int location)
 
static bool make_oper_cache_key (ParseState *pstate, OprCacheKey *key, List *opname, Oid ltypeId, Oid rtypeId, int location)
 
static Oid find_oper_cache_entry (OprCacheKey *key)
 
static void make_oper_cache_entry (OprCacheKey *key, Oid opr_oid)
 
static void InvalidateOprCacheCallBack (Datum arg, int cacheid, uint32 hashvalue)
 
Oid LookupOperName (ParseState *pstate, List *opername, Oid oprleft, Oid oprright, bool noError, int location)
 
Oid LookupOperWithArgs (ObjectWithArgs *oper, bool noError)
 
void get_sort_group_operators (Oid argtype, bool needLT, bool needEQ, bool needGT, Oid *ltOpr, Oid *eqOpr, Oid *gtOpr, bool *isHashable)
 
Oid oprid (Operator op)
 
Oid oprfuncid (Operator op)
 
Operator oper (ParseState *pstate, List *opname, Oid ltypeId, Oid rtypeId, bool noError, int location)
 
Operator compatible_oper (ParseState *pstate, List *op, Oid arg1, Oid arg2, bool noError, int location)
 
Oid compatible_oper_opid (List *op, Oid arg1, Oid arg2, bool noError)
 
Operator left_oper (ParseState *pstate, List *op, Oid arg, bool noError, int location)
 
Exprmake_op (ParseState *pstate, List *opname, Node *ltree, Node *rtree, Node *last_srf, int location)
 
Exprmake_scalar_array_op (ParseState *pstate, List *opname, bool useOr, Node *ltree, Node *rtree, int location)
 

Variables

static HTABOprCacheHash = NULL
 

Macro Definition Documentation

◆ MAX_CACHED_PATH_LEN

#define MAX_CACHED_PATH_LEN   16

Definition at line 49 of file parse_oper.c.

Typedef Documentation

◆ OprCacheEntry

typedef struct OprCacheEntry OprCacheEntry

◆ OprCacheKey

typedef struct OprCacheKey OprCacheKey

Function Documentation

◆ binary_oper_exact()

static Oid binary_oper_exact ( List opname,
Oid  arg1,
Oid  arg2 
)
static

Definition at line 274 of file parse_oper.c.

275 {
276  Oid result;
277  bool was_unknown = false;
278 
279  /* Unspecified type for one of the arguments? then use the other */
280  if ((arg1 == UNKNOWNOID) && (arg2 != InvalidOid))
281  {
282  arg1 = arg2;
283  was_unknown = true;
284  }
285  else if ((arg2 == UNKNOWNOID) && (arg1 != InvalidOid))
286  {
287  arg2 = arg1;
288  was_unknown = true;
289  }
290 
291  result = OpernameGetOprid(opname, arg1, arg2);
292  if (OidIsValid(result))
293  return result;
294 
295  if (was_unknown)
296  {
297  /* arg1 and arg2 are the same here, need only look at arg1 */
298  Oid basetype = getBaseType(arg1);
299 
300  if (basetype != arg1)
301  {
302  result = OpernameGetOprid(opname, basetype, basetype);
303  if (OidIsValid(result))
304  return result;
305  }
306  }
307 
308  return InvalidOid;
309 }
#define OidIsValid(objectId)
Definition: c.h:764
Oid getBaseType(Oid typid)
Definition: lsyscache.c:2503
Oid OpernameGetOprid(List *names, Oid oprleft, Oid oprright)
Definition: namespace.c:1508
#define InvalidOid
Definition: postgres_ext.h:36
unsigned int Oid
Definition: postgres_ext.h:31

References getBaseType(), InvalidOid, OidIsValid, and OpernameGetOprid().

Referenced by oper().

◆ compatible_oper()

Operator compatible_oper ( ParseState pstate,
List op,
Oid  arg1,
Oid  arg2,
bool  noError,
int  location 
)

Definition at line 462 of file parse_oper.c.

464 {
465  Operator optup;
466  Form_pg_operator opform;
467 
468  /* oper() will find the best available match */
469  optup = oper(pstate, op, arg1, arg2, noError, location);
470  if (optup == (Operator) NULL)
471  return (Operator) NULL; /* must be noError case */
472 
473  /* but is it good enough? */
474  opform = (Form_pg_operator) GETSTRUCT(optup);
475  if (IsBinaryCoercible(arg1, opform->oprleft) &&
476  IsBinaryCoercible(arg2, opform->oprright))
477  return optup;
478 
479  /* nope... */
480  ReleaseSysCache(optup);
481 
482  if (!noError)
483  ereport(ERROR,
484  (errcode(ERRCODE_UNDEFINED_FUNCTION),
485  errmsg("operator requires run-time type coercion: %s",
486  op_signature_string(op, 'b', arg1, arg2)),
487  parser_errposition(pstate, location)));
488 
489  return (Operator) NULL;
490 }
int errcode(int sqlerrcode)
Definition: elog.c:858
int errmsg(const char *fmt,...)
Definition: elog.c:1069
#define ERROR
Definition: elog.h:39
#define ereport(elevel,...)
Definition: elog.h:149
#define GETSTRUCT(TUP)
Definition: htup_details.h:653
bool IsBinaryCoercible(Oid srctype, Oid targettype)
int parser_errposition(ParseState *pstate, int location)
Definition: parse_node.c:111
static const char * op_signature_string(List *op, char oprkind, Oid arg1, Oid arg2)
Definition: parse_oper.c:614
Operator oper(ParseState *pstate, List *opname, Oid ltypeId, Oid rtypeId, bool noError, int location)
Definition: parse_oper.c:382
FormData_pg_operator * Form_pg_operator
Definition: pg_operator.h:83
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:868

References ereport, errcode(), errmsg(), ERROR, GETSTRUCT, IsBinaryCoercible(), op_signature_string(), oper(), parser_errposition(), and ReleaseSysCache().

Referenced by compatible_oper_opid().

◆ compatible_oper_opid()

Oid compatible_oper_opid ( List op,
Oid  arg1,
Oid  arg2,
bool  noError 
)

Definition at line 499 of file parse_oper.c.

500 {
501  Operator optup;
502  Oid result;
503 
504  optup = compatible_oper(NULL, op, arg1, arg2, noError, -1);
505  if (optup != NULL)
506  {
507  result = oprid(optup);
508  ReleaseSysCache(optup);
509  return result;
510  }
511  return InvalidOid;
512 }
Oid oprid(Operator op)
Definition: parse_oper.c:250
Operator compatible_oper(ParseState *pstate, List *op, Oid arg1, Oid arg2, bool noError, int location)
Definition: parse_oper.c:462

References compatible_oper(), InvalidOid, oprid(), and ReleaseSysCache().

Referenced by addTargetToSortList(), and ComputeIndexAttrs().

◆ find_oper_cache_entry()

static Oid find_oper_cache_entry ( OprCacheKey key)
static

Definition at line 995 of file parse_oper.c.

996 {
997  OprCacheEntry *oprentry;
998 
999  if (OprCacheHash == NULL)
1000  {
1001  /* First time through: initialize the hash table */
1002  HASHCTL ctl;
1003 
1004  ctl.keysize = sizeof(OprCacheKey);
1005  ctl.entrysize = sizeof(OprCacheEntry);
1006  OprCacheHash = hash_create("Operator lookup cache", 256,
1007  &ctl, HASH_ELEM | HASH_BLOBS);
1008 
1009  /* Arrange to flush cache on pg_operator and pg_cast changes */
1012  (Datum) 0);
1015  (Datum) 0);
1016  }
1017 
1018  /* Look for an existing entry */
1019  oprentry = (OprCacheEntry *) hash_search(OprCacheHash,
1020  key,
1021  HASH_FIND, NULL);
1022  if (oprentry == NULL)
1023  return InvalidOid;
1024 
1025  return oprentry->opr_oid;
1026 }
void * hash_search(HTAB *hashp, const void *keyPtr, HASHACTION action, bool *foundPtr)
Definition: dynahash.c:953
HTAB * hash_create(const char *tabname, long nelem, const HASHCTL *info, int flags)
Definition: dynahash.c:350
@ HASH_FIND
Definition: hsearch.h:113
#define HASH_ELEM
Definition: hsearch.h:95
#define HASH_BLOBS
Definition: hsearch.h:97
void CacheRegisterSyscacheCallback(int cacheid, SyscacheCallbackFunction func, Datum arg)
Definition: inval.c:1519
static void InvalidateOprCacheCallBack(Datum arg, int cacheid, uint32 hashvalue)
Definition: parse_oper.c:1050
static HTAB * OprCacheHash
Definition: parse_oper.c:937
struct OprCacheEntry OprCacheEntry
struct OprCacheKey OprCacheKey
uintptr_t Datum
Definition: postgres.h:64
Size keysize
Definition: hsearch.h:75
Size entrysize
Definition: hsearch.h:76
@ OPERNAMENSP
Definition: syscache.h:71
@ CASTSOURCETARGET
Definition: syscache.h:46

References CacheRegisterSyscacheCallback(), CASTSOURCETARGET, HASHCTL::entrysize, HASH_BLOBS, hash_create(), HASH_ELEM, HASH_FIND, hash_search(), InvalidateOprCacheCallBack(), InvalidOid, sort-test::key, HASHCTL::keysize, OPERNAMENSP, OprCacheEntry::opr_oid, and OprCacheHash.

Referenced by left_oper(), and oper().

◆ get_sort_group_operators()

void get_sort_group_operators ( Oid  argtype,
bool  needLT,
bool  needEQ,
bool  needGT,
Oid ltOpr,
Oid eqOpr,
Oid gtOpr,
bool isHashable 
)

Definition at line 192 of file parse_oper.c.

196 {
197  TypeCacheEntry *typentry;
198  int cache_flags;
199  Oid lt_opr;
200  Oid eq_opr;
201  Oid gt_opr;
202  bool hashable;
203 
204  /*
205  * Look up the operators using the type cache.
206  *
207  * Note: the search algorithm used by typcache.c ensures that the results
208  * are consistent, ie all from matching opclasses.
209  */
210  if (isHashable != NULL)
213  else
215 
216  typentry = lookup_type_cache(argtype, cache_flags);
217  lt_opr = typentry->lt_opr;
218  eq_opr = typentry->eq_opr;
219  gt_opr = typentry->gt_opr;
220  hashable = OidIsValid(typentry->hash_proc);
221 
222  /* Report errors if needed */
223  if ((needLT && !OidIsValid(lt_opr)) ||
224  (needGT && !OidIsValid(gt_opr)))
225  ereport(ERROR,
226  (errcode(ERRCODE_UNDEFINED_FUNCTION),
227  errmsg("could not identify an ordering operator for type %s",
228  format_type_be(argtype)),
229  errhint("Use an explicit ordering operator or modify the query.")));
230  if (needEQ && !OidIsValid(eq_opr))
231  ereport(ERROR,
232  (errcode(ERRCODE_UNDEFINED_FUNCTION),
233  errmsg("could not identify an equality operator for type %s",
234  format_type_be(argtype))));
235 
236  /* Return results as needed */
237  if (ltOpr)
238  *ltOpr = lt_opr;
239  if (eqOpr)
240  *eqOpr = eq_opr;
241  if (gtOpr)
242  *gtOpr = gt_opr;
243  if (isHashable)
244  *isHashable = hashable;
245 }
int errhint(const char *fmt,...)
Definition: elog.c:1316
char * format_type_be(Oid type_oid)
Definition: format_type.c:343
TypeCacheEntry * lookup_type_cache(Oid type_id, int flags)
Definition: typcache.c:344
#define TYPECACHE_EQ_OPR
Definition: typcache.h:136
#define TYPECACHE_GT_OPR
Definition: typcache.h:138
#define TYPECACHE_LT_OPR
Definition: typcache.h:137
#define TYPECACHE_HASH_PROC
Definition: typcache.h:140

References TypeCacheEntry::eq_opr, ereport, errcode(), errhint(), errmsg(), ERROR, format_type_be(), TypeCacheEntry::gt_opr, TypeCacheEntry::hash_proc, lookup_type_cache(), TypeCacheEntry::lt_opr, OidIsValid, TYPECACHE_EQ_OPR, TYPECACHE_GT_OPR, TYPECACHE_HASH_PROC, and TYPECACHE_LT_OPR.

Referenced by addTargetToGroupList(), addTargetToSortList(), makeSortGroupClauseForSetOp(), and std_typanalyze().

◆ InvalidateOprCacheCallBack()

static void InvalidateOprCacheCallBack ( Datum  arg,
int  cacheid,
uint32  hashvalue 
)
static

Definition at line 1050 of file parse_oper.c.

1051 {
1052  HASH_SEQ_STATUS status;
1053  OprCacheEntry *hentry;
1054 
1055  Assert(OprCacheHash != NULL);
1056 
1057  /* Currently we just flush all entries; hard to be smarter ... */
1058  hash_seq_init(&status, OprCacheHash);
1059 
1060  while ((hentry = (OprCacheEntry *) hash_seq_search(&status)) != NULL)
1061  {
1063  &hentry->key,
1064  HASH_REMOVE, NULL) == NULL)
1065  elog(ERROR, "hash table corrupted");
1066  }
1067 }
void * hash_seq_search(HASH_SEQ_STATUS *status)
Definition: dynahash.c:1431
void hash_seq_init(HASH_SEQ_STATUS *status, HTAB *hashp)
Definition: dynahash.c:1421
@ HASH_REMOVE
Definition: hsearch.h:115
Assert(fmt[strlen(fmt) - 1] !='\n')
OprCacheKey key
Definition: parse_oper.c:62

References Assert(), elog(), ERROR, HASH_REMOVE, hash_search(), hash_seq_init(), hash_seq_search(), OprCacheEntry::key, and OprCacheHash.

Referenced by find_oper_cache_entry().

◆ left_oper()

Operator left_oper ( ParseState pstate,
List op,
Oid  arg,
bool  noError,
int  location 
)

Definition at line 530 of file parse_oper.c.

531 {
532  Oid operOid;
534  bool key_ok;
536  HeapTuple tup = NULL;
537 
538  /*
539  * Try to find the mapping in the lookaside cache.
540  */
541  key_ok = make_oper_cache_key(pstate, &key, op, InvalidOid, arg, location);
542 
543  if (key_ok)
544  {
545  operOid = find_oper_cache_entry(&key);
546  if (OidIsValid(operOid))
547  {
548  tup = SearchSysCache1(OPEROID, ObjectIdGetDatum(operOid));
549  if (HeapTupleIsValid(tup))
550  return (Operator) tup;
551  }
552  }
553 
554  /*
555  * First try for an "exact" match.
556  */
557  operOid = OpernameGetOprid(op, InvalidOid, arg);
558  if (!OidIsValid(operOid))
559  {
560  /*
561  * Otherwise, search for the most suitable candidate.
562  */
563  FuncCandidateList clist;
564 
565  /* Get prefix operators of given name */
566  clist = OpernameGetCandidates(op, 'l', false);
567 
568  /* No operators found? Then fail... */
569  if (clist != NULL)
570  {
571  /*
572  * The returned list has args in the form (0, oprright). Move the
573  * useful data into args[0] to keep oper_select_candidate simple.
574  * XXX we are assuming here that we may scribble on the list!
575  */
576  FuncCandidateList clisti;
577 
578  for (clisti = clist; clisti != NULL; clisti = clisti->next)
579  {
580  clisti->args[0] = clisti->args[1];
581  }
582 
583  /*
584  * We must run oper_select_candidate even if only one candidate,
585  * otherwise we may falsely return a non-type-compatible operator.
586  */
587  fdresult = oper_select_candidate(1, &arg, clist, &operOid);
588  }
589  }
590 
591  if (OidIsValid(operOid))
592  tup = SearchSysCache1(OPEROID, ObjectIdGetDatum(operOid));
593 
594  if (HeapTupleIsValid(tup))
595  {
596  if (key_ok)
597  make_oper_cache_entry(&key, operOid);
598  }
599  else if (!noError)
600  op_error(pstate, op, 'l', InvalidOid, arg, fdresult, location);
601 
602  return (Operator) tup;
603 }
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
FuncCandidateList OpernameGetCandidates(List *names, char oprkind, bool missing_schema_ok)
Definition: namespace.c:1611
FuncDetailCode
Definition: parse_func.h:23
@ FUNCDETAIL_NOTFOUND
Definition: parse_func.h:24
static void make_oper_cache_entry(OprCacheKey *key, Oid opr_oid)
Definition: parse_oper.c:1034
static FuncDetailCode oper_select_candidate(int nargs, Oid *input_typeids, FuncCandidateList candidates, Oid *operOid)
Definition: parse_oper.c:324
static void op_error(ParseState *pstate, List *op, char oprkind, Oid arg1, Oid arg2, FuncDetailCode fdresult, int location)
Definition: parse_oper.c:634
static bool make_oper_cache_key(ParseState *pstate, OprCacheKey *key, List *opname, Oid ltypeId, Oid rtypeId, int location)
Definition: parse_oper.c:951
static Oid find_oper_cache_entry(OprCacheKey *key)
Definition: parse_oper.c:995
void * arg
static Datum ObjectIdGetDatum(Oid X)
Definition: postgres.h:252
struct _FuncCandidateList * next
Definition: namespace.h:30
Oid args[FLEXIBLE_ARRAY_MEMBER]
Definition: namespace.h:38
HeapTuple SearchSysCache1(int cacheId, Datum key1)
Definition: syscache.c:820
@ OPEROID
Definition: syscache.h:72

References arg, _FuncCandidateList::args, find_oper_cache_entry(), FUNCDETAIL_NOTFOUND, HeapTupleIsValid, InvalidOid, sort-test::key, make_oper_cache_entry(), make_oper_cache_key(), _FuncCandidateList::next, ObjectIdGetDatum(), OidIsValid, op_error(), oper_select_candidate(), OpernameGetCandidates(), OpernameGetOprid(), OPEROID, and SearchSysCache1().

Referenced by generate_operator_name(), and make_op().

◆ LookupOperName()

Oid LookupOperName ( ParseState pstate,
List opername,
Oid  oprleft,
Oid  oprright,
bool  noError,
int  location 
)

Definition at line 101 of file parse_oper.c.

103 {
104  Oid result;
105 
106  result = OpernameGetOprid(opername, oprleft, oprright);
107  if (OidIsValid(result))
108  return result;
109 
110  /* we don't use op_error here because only an exact match is wanted */
111  if (!noError)
112  {
113  char oprkind;
114 
115  if (!OidIsValid(oprleft))
116  oprkind = 'l';
117  else if (OidIsValid(oprright))
118  oprkind = 'b';
119  else
120  {
121  ereport(ERROR,
122  (errcode(ERRCODE_SYNTAX_ERROR),
123  errmsg("postfix operators are not supported"),
124  parser_errposition(pstate, location)));
125  oprkind = 0; /* keep compiler quiet */
126  }
127 
128  ereport(ERROR,
129  (errcode(ERRCODE_UNDEFINED_FUNCTION),
130  errmsg("operator does not exist: %s",
131  op_signature_string(opername, oprkind,
132  oprleft, oprright)),
133  parser_errposition(pstate, location)));
134  }
135 
136  return InvalidOid;
137 }

References ereport, errcode(), errmsg(), ERROR, InvalidOid, OidIsValid, op_signature_string(), OpernameGetOprid(), and parser_errposition().

Referenced by AggregateCreate(), DefineOpClass(), LookupOperWithArgs(), and OperatorLookup().

◆ LookupOperWithArgs()

Oid LookupOperWithArgs ( ObjectWithArgs oper,
bool  noError 
)

Definition at line 145 of file parse_oper.c.

146 {
147  TypeName *oprleft,
148  *oprright;
149  Oid leftoid,
150  rightoid;
151 
152  Assert(list_length(oper->objargs) == 2);
153  oprleft = linitial_node(TypeName, oper->objargs);
154  oprright = lsecond_node(TypeName, oper->objargs);
155 
156  if (oprleft == NULL)
157  leftoid = InvalidOid;
158  else
159  leftoid = LookupTypeNameOid(NULL, oprleft, noError);
160 
161  if (oprright == NULL)
162  rightoid = InvalidOid;
163  else
164  rightoid = LookupTypeNameOid(NULL, oprright, noError);
165 
166  return LookupOperName(NULL, oper->objname, leftoid, rightoid,
167  noError, -1);
168 }
Oid LookupOperName(ParseState *pstate, List *opername, Oid oprleft, Oid oprright, bool noError, int location)
Definition: parse_oper.c:101
Oid LookupTypeNameOid(ParseState *pstate, const TypeName *typeName, bool missing_ok)
Definition: parse_type.c:232
static int list_length(const List *l)
Definition: pg_list.h:152
#define linitial_node(type, l)
Definition: pg_list.h:181
#define lsecond_node(type, l)
Definition: pg_list.h:186

References Assert(), InvalidOid, linitial_node, list_length(), LookupOperName(), LookupTypeNameOid(), lsecond_node, and oper().

Referenced by AlterOperator(), AlterOpFamilyAdd(), DefineOpClass(), and get_object_address().

◆ make_op()

Expr* make_op ( ParseState pstate,
List opname,
Node ltree,
Node rtree,
Node last_srf,
int  location 
)

Definition at line 672 of file parse_oper.c.

674 {
675  Oid ltypeId,
676  rtypeId;
677  Operator tup;
678  Form_pg_operator opform;
679  Oid actual_arg_types[2];
680  Oid declared_arg_types[2];
681  int nargs;
682  List *args;
683  Oid rettype;
684  OpExpr *result;
685 
686  /* Check it's not a postfix operator */
687  if (rtree == NULL)
688  ereport(ERROR,
689  (errcode(ERRCODE_SYNTAX_ERROR),
690  errmsg("postfix operators are not supported")));
691 
692  /* Select the operator */
693  if (ltree == NULL)
694  {
695  /* prefix operator */
696  rtypeId = exprType(rtree);
697  ltypeId = InvalidOid;
698  tup = left_oper(pstate, opname, rtypeId, false, location);
699  }
700  else
701  {
702  /* otherwise, binary operator */
703  ltypeId = exprType(ltree);
704  rtypeId = exprType(rtree);
705  tup = oper(pstate, opname, ltypeId, rtypeId, false, location);
706  }
707 
708  opform = (Form_pg_operator) GETSTRUCT(tup);
709 
710  /* Check it's not a shell */
711  if (!RegProcedureIsValid(opform->oprcode))
712  ereport(ERROR,
713  (errcode(ERRCODE_UNDEFINED_FUNCTION),
714  errmsg("operator is only a shell: %s",
715  op_signature_string(opname,
716  opform->oprkind,
717  opform->oprleft,
718  opform->oprright)),
719  parser_errposition(pstate, location)));
720 
721  /* Do typecasting and build the expression tree */
722  if (ltree == NULL)
723  {
724  /* prefix operator */
725  args = list_make1(rtree);
726  actual_arg_types[0] = rtypeId;
727  declared_arg_types[0] = opform->oprright;
728  nargs = 1;
729  }
730  else
731  {
732  /* otherwise, binary operator */
733  args = list_make2(ltree, rtree);
734  actual_arg_types[0] = ltypeId;
735  actual_arg_types[1] = rtypeId;
736  declared_arg_types[0] = opform->oprleft;
737  declared_arg_types[1] = opform->oprright;
738  nargs = 2;
739  }
740 
741  /*
742  * enforce consistency with polymorphic argument and return types,
743  * possibly adjusting return type or declared_arg_types (which will be
744  * used as the cast destination by make_fn_arguments)
745  */
746  rettype = enforce_generic_type_consistency(actual_arg_types,
747  declared_arg_types,
748  nargs,
749  opform->oprresult,
750  false);
751 
752  /* perform the necessary typecasting of arguments */
753  make_fn_arguments(pstate, args, actual_arg_types, declared_arg_types);
754 
755  /* and build the expression node */
756  result = makeNode(OpExpr);
757  result->opno = oprid(tup);
758  result->opfuncid = opform->oprcode;
759  result->opresulttype = rettype;
760  result->opretset = get_func_retset(opform->oprcode);
761  /* opcollid and inputcollid will be set by parse_collate.c */
762  result->args = args;
763  result->location = location;
764 
765  /* if it returns a set, check that's OK */
766  if (result->opretset)
767  {
768  check_srf_call_placement(pstate, last_srf, location);
769  /* ... and remember it for error checks at higher levels */
770  pstate->p_last_srf = (Node *) result;
771  }
772 
773  ReleaseSysCache(tup);
774 
775  return (Expr *) result;
776 }
#define RegProcedureIsValid(p)
Definition: c.h:766
bool get_func_retset(Oid funcid)
Definition: lsyscache.c:1746
Oid exprType(const Node *expr)
Definition: nodeFuncs.c:43
#define makeNode(_type_)
Definition: nodes.h:176
Oid enforce_generic_type_consistency(const Oid *actual_arg_types, Oid *declared_arg_types, int nargs, Oid rettype, bool allow_poly)
void make_fn_arguments(ParseState *pstate, List *fargs, Oid *actual_arg_types, Oid *declared_arg_types)
Definition: parse_func.c:1824
void check_srf_call_placement(ParseState *pstate, Node *last_srf, int location)
Definition: parse_func.c:2510
Operator left_oper(ParseState *pstate, List *op, Oid arg, bool noError, int location)
Definition: parse_oper.c:530
#define list_make1(x1)
Definition: pg_list.h:212
#define list_make2(x1, x2)
Definition: pg_list.h:214
Definition: pg_list.h:54
Definition: nodes.h:129
int location
Definition: primnodes.h:766
Oid opno
Definition: primnodes.h:745
List * args
Definition: primnodes.h:763
Node * p_last_srf
Definition: parse_node.h:228
Definition: ltree.h:43

References generate_unaccent_rules::args, OpExpr::args, check_srf_call_placement(), enforce_generic_type_consistency(), ereport, errcode(), errmsg(), ERROR, exprType(), get_func_retset(), GETSTRUCT, InvalidOid, left_oper(), list_make1, list_make2, OpExpr::location, make_fn_arguments(), makeNode, op_signature_string(), oper(), OpExpr::opno, oprid(), ParseState::p_last_srf, parser_errposition(), RegProcedureIsValid, and ReleaseSysCache().

Referenced by make_distinct_op(), make_row_comparison_op(), transformAExprIn(), transformAExprNullIf(), and transformAExprOp().

◆ make_oper_cache_entry()

static void make_oper_cache_entry ( OprCacheKey key,
Oid  opr_oid 
)
static

Definition at line 1034 of file parse_oper.c.

1035 {
1036  OprCacheEntry *oprentry;
1037 
1038  Assert(OprCacheHash != NULL);
1039 
1040  oprentry = (OprCacheEntry *) hash_search(OprCacheHash,
1041  key,
1042  HASH_ENTER, NULL);
1043  oprentry->opr_oid = opr_oid;
1044 }
@ HASH_ENTER
Definition: hsearch.h:114

References Assert(), HASH_ENTER, hash_search(), sort-test::key, OprCacheEntry::opr_oid, and OprCacheHash.

Referenced by left_oper(), and oper().

◆ make_oper_cache_key()

static bool make_oper_cache_key ( ParseState pstate,
OprCacheKey key,
List opname,
Oid  ltypeId,
Oid  rtypeId,
int  location 
)
static

Definition at line 951 of file parse_oper.c.

953 {
954  char *schemaname;
955  char *opername;
956 
957  /* deconstruct the name list */
958  DeconstructQualifiedName(opname, &schemaname, &opername);
959 
960  /* ensure zero-fill for stable hashing */
961  MemSet(key, 0, sizeof(OprCacheKey));
962 
963  /* save operator name and input types into key */
964  strlcpy(key->oprname, opername, NAMEDATALEN);
965  key->left_arg = ltypeId;
966  key->right_arg = rtypeId;
967 
968  if (schemaname)
969  {
970  ParseCallbackState pcbstate;
971 
972  /* search only in exact schema given */
973  setup_parser_errposition_callback(&pcbstate, pstate, location);
974  key->search_path[0] = LookupExplicitNamespace(schemaname, false);
976  }
977  else
978  {
979  /* get the active search path */
980  if (fetch_search_path_array(key->search_path,
982  return false; /* oops, didn't fit */
983  }
984 
985  return true;
986 }
#define MemSet(start, val, len)
Definition: c.h:1009
Oid LookupExplicitNamespace(const char *nspname, bool missing_ok)
Definition: namespace.c:2918
void DeconstructQualifiedName(const List *names, char **nspname_p, char **objname_p)
Definition: namespace.c:2834
int fetch_search_path_array(Oid *sarray, int sarray_len)
Definition: namespace.c:4255
void cancel_parser_errposition_callback(ParseCallbackState *pcbstate)
Definition: parse_node.c:161
void setup_parser_errposition_callback(ParseCallbackState *pcbstate, ParseState *pstate, int location)
Definition: parse_node.c:145
#define MAX_CACHED_PATH_LEN
Definition: parse_oper.c:49
#define NAMEDATALEN
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition: strlcpy.c:45

References cancel_parser_errposition_callback(), DeconstructQualifiedName(), fetch_search_path_array(), sort-test::key, LookupExplicitNamespace(), MAX_CACHED_PATH_LEN, MemSet, NAMEDATALEN, setup_parser_errposition_callback(), and strlcpy().

Referenced by left_oper(), and oper().

◆ make_scalar_array_op()

Expr* make_scalar_array_op ( ParseState pstate,
List opname,
bool  useOr,
Node ltree,
Node rtree,
int  location 
)

Definition at line 783 of file parse_oper.c.

787 {
788  Oid ltypeId,
789  rtypeId,
790  atypeId,
791  res_atypeId;
792  Operator tup;
793  Form_pg_operator opform;
794  Oid actual_arg_types[2];
795  Oid declared_arg_types[2];
796  List *args;
797  Oid rettype;
798  ScalarArrayOpExpr *result;
799 
800  ltypeId = exprType(ltree);
801  atypeId = exprType(rtree);
802 
803  /*
804  * The right-hand input of the operator will be the element type of the
805  * array. However, if we currently have just an untyped literal on the
806  * right, stay with that and hope we can resolve the operator.
807  */
808  if (atypeId == UNKNOWNOID)
809  rtypeId = UNKNOWNOID;
810  else
811  {
812  rtypeId = get_base_element_type(atypeId);
813  if (!OidIsValid(rtypeId))
814  ereport(ERROR,
815  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
816  errmsg("op ANY/ALL (array) requires array on right side"),
817  parser_errposition(pstate, location)));
818  }
819 
820  /* Now resolve the operator */
821  tup = oper(pstate, opname, ltypeId, rtypeId, false, location);
822  opform = (Form_pg_operator) GETSTRUCT(tup);
823 
824  /* Check it's not a shell */
825  if (!RegProcedureIsValid(opform->oprcode))
826  ereport(ERROR,
827  (errcode(ERRCODE_UNDEFINED_FUNCTION),
828  errmsg("operator is only a shell: %s",
829  op_signature_string(opname,
830  opform->oprkind,
831  opform->oprleft,
832  opform->oprright)),
833  parser_errposition(pstate, location)));
834 
835  args = list_make2(ltree, rtree);
836  actual_arg_types[0] = ltypeId;
837  actual_arg_types[1] = rtypeId;
838  declared_arg_types[0] = opform->oprleft;
839  declared_arg_types[1] = opform->oprright;
840 
841  /*
842  * enforce consistency with polymorphic argument and return types,
843  * possibly adjusting return type or declared_arg_types (which will be
844  * used as the cast destination by make_fn_arguments)
845  */
846  rettype = enforce_generic_type_consistency(actual_arg_types,
847  declared_arg_types,
848  2,
849  opform->oprresult,
850  false);
851 
852  /*
853  * Check that operator result is boolean
854  */
855  if (rettype != BOOLOID)
856  ereport(ERROR,
857  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
858  errmsg("op ANY/ALL (array) requires operator to yield boolean"),
859  parser_errposition(pstate, location)));
860  if (get_func_retset(opform->oprcode))
861  ereport(ERROR,
862  (errcode(ERRCODE_WRONG_OBJECT_TYPE),
863  errmsg("op ANY/ALL (array) requires operator not to return a set"),
864  parser_errposition(pstate, location)));
865 
866  /*
867  * Now switch back to the array type on the right, arranging for any
868  * needed cast to be applied. Beware of polymorphic operators here;
869  * enforce_generic_type_consistency may or may not have replaced a
870  * polymorphic type with a real one.
871  */
872  if (IsPolymorphicType(declared_arg_types[1]))
873  {
874  /* assume the actual array type is OK */
875  res_atypeId = atypeId;
876  }
877  else
878  {
879  res_atypeId = get_array_type(declared_arg_types[1]);
880  if (!OidIsValid(res_atypeId))
881  ereport(ERROR,
882  (errcode(ERRCODE_UNDEFINED_OBJECT),
883  errmsg("could not find array type for data type %s",
884  format_type_be(declared_arg_types[1])),
885  parser_errposition(pstate, location)));
886  }
887  actual_arg_types[1] = atypeId;
888  declared_arg_types[1] = res_atypeId;
889 
890  /* perform the necessary typecasting of arguments */
891  make_fn_arguments(pstate, args, actual_arg_types, declared_arg_types);
892 
893  /* and build the expression node */
894  result = makeNode(ScalarArrayOpExpr);
895  result->opno = oprid(tup);
896  result->opfuncid = opform->oprcode;
897  result->hashfuncid = InvalidOid;
898  result->negfuncid = InvalidOid;
899  result->useOr = useOr;
900  /* inputcollid will be set by parse_collate.c */
901  result->args = args;
902  result->location = location;
903 
904  ReleaseSysCache(tup);
905 
906  return (Expr *) result;
907 }
Oid get_base_element_type(Oid typid)
Definition: lsyscache.c:2814
Oid get_array_type(Oid typid)
Definition: lsyscache.c:2769

References generate_unaccent_rules::args, ScalarArrayOpExpr::args, enforce_generic_type_consistency(), ereport, errcode(), errmsg(), ERROR, exprType(), format_type_be(), get_array_type(), get_base_element_type(), get_func_retset(), GETSTRUCT, InvalidOid, list_make2, ScalarArrayOpExpr::location, make_fn_arguments(), makeNode, OidIsValid, op_signature_string(), oper(), ScalarArrayOpExpr::opno, oprid(), parser_errposition(), RegProcedureIsValid, ReleaseSysCache(), and ScalarArrayOpExpr::useOr.

Referenced by transformAExprIn(), transformAExprOpAll(), and transformAExprOpAny().

◆ op_error()

static void op_error ( ParseState pstate,
List op,
char  oprkind,
Oid  arg1,
Oid  arg2,
FuncDetailCode  fdresult,
int  location 
)
static

Definition at line 634 of file parse_oper.c.

637 {
638  if (fdresult == FUNCDETAIL_MULTIPLE)
639  ereport(ERROR,
640  (errcode(ERRCODE_AMBIGUOUS_FUNCTION),
641  errmsg("operator is not unique: %s",
642  op_signature_string(op, oprkind, arg1, arg2)),
643  errhint("Could not choose a best candidate operator. "
644  "You might need to add explicit type casts."),
645  parser_errposition(pstate, location)));
646  else
647  ereport(ERROR,
648  (errcode(ERRCODE_UNDEFINED_FUNCTION),
649  errmsg("operator does not exist: %s",
650  op_signature_string(op, oprkind, arg1, arg2)),
651  (!arg1 || !arg2) ?
652  errhint("No operator matches the given name and argument type. "
653  "You might need to add an explicit type cast.") :
654  errhint("No operator matches the given name and argument types. "
655  "You might need to add explicit type casts."),
656  parser_errposition(pstate, location)));
657 }
@ FUNCDETAIL_MULTIPLE
Definition: parse_func.h:25

References ereport, errcode(), errhint(), errmsg(), ERROR, FUNCDETAIL_MULTIPLE, op_signature_string(), and parser_errposition().

Referenced by left_oper(), and oper().

◆ op_signature_string()

static const char * op_signature_string ( List op,
char  oprkind,
Oid  arg1,
Oid  arg2 
)
static

Definition at line 614 of file parse_oper.c.

615 {
616  StringInfoData argbuf;
617 
618  initStringInfo(&argbuf);
619 
620  if (oprkind != 'l')
621  appendStringInfo(&argbuf, "%s ", format_type_be(arg1));
622 
624 
625  appendStringInfo(&argbuf, " %s", format_type_be(arg2));
626 
627  return argbuf.data; /* return palloc'd string buffer */
628 }
char * NameListToString(const List *names)
Definition: namespace.c:3127
void appendStringInfo(StringInfo str, const char *fmt,...)
Definition: stringinfo.c:91
void appendStringInfoString(StringInfo str, const char *s)
Definition: stringinfo.c:176
void initStringInfo(StringInfo str)
Definition: stringinfo.c:59

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, format_type_be(), initStringInfo(), and NameListToString().

Referenced by compatible_oper(), LookupOperName(), make_op(), make_scalar_array_op(), and op_error().

◆ oper()

Operator oper ( ParseState pstate,
List opname,
Oid  ltypeId,
Oid  rtypeId,
bool  noError,
int  location 
)

Definition at line 382 of file parse_oper.c.

384 {
385  Oid operOid;
387  bool key_ok;
389  HeapTuple tup = NULL;
390 
391  /*
392  * Try to find the mapping in the lookaside cache.
393  */
394  key_ok = make_oper_cache_key(pstate, &key, opname, ltypeId, rtypeId, location);
395 
396  if (key_ok)
397  {
398  operOid = find_oper_cache_entry(&key);
399  if (OidIsValid(operOid))
400  {
401  tup = SearchSysCache1(OPEROID, ObjectIdGetDatum(operOid));
402  if (HeapTupleIsValid(tup))
403  return (Operator) tup;
404  }
405  }
406 
407  /*
408  * First try for an "exact" match.
409  */
410  operOid = binary_oper_exact(opname, ltypeId, rtypeId);
411  if (!OidIsValid(operOid))
412  {
413  /*
414  * Otherwise, search for the most suitable candidate.
415  */
416  FuncCandidateList clist;
417 
418  /* Get binary operators of given name */
419  clist = OpernameGetCandidates(opname, 'b', false);
420 
421  /* No operators found? Then fail... */
422  if (clist != NULL)
423  {
424  /*
425  * Unspecified type for one of the arguments? then use the other
426  * (XXX this is probably dead code?)
427  */
428  Oid inputOids[2];
429 
430  if (rtypeId == InvalidOid)
431  rtypeId = ltypeId;
432  else if (ltypeId == InvalidOid)
433  ltypeId = rtypeId;
434  inputOids[0] = ltypeId;
435  inputOids[1] = rtypeId;
436  fdresult = oper_select_candidate(2, inputOids, clist, &operOid);
437  }
438  }
439 
440  if (OidIsValid(operOid))
441  tup = SearchSysCache1(OPEROID, ObjectIdGetDatum(operOid));
442 
443  if (HeapTupleIsValid(tup))
444  {
445  if (key_ok)
446  make_oper_cache_entry(&key, operOid);
447  }
448  else if (!noError)
449  op_error(pstate, opname, 'b', ltypeId, rtypeId, fdresult, location);
450 
451  return (Operator) tup;
452 }
static Oid binary_oper_exact(List *opname, Oid arg1, Oid arg2)
Definition: parse_oper.c:274

References binary_oper_exact(), find_oper_cache_entry(), FUNCDETAIL_NOTFOUND, HeapTupleIsValid, InvalidOid, sort-test::key, make_oper_cache_entry(), make_oper_cache_key(), ObjectIdGetDatum(), OidIsValid, op_error(), oper_select_candidate(), OpernameGetCandidates(), OPEROID, and SearchSysCache1().

Referenced by compatible_oper(), Do_MultiXactIdWait(), generate_operator_name(), LookupOperWithArgs(), make_op(), make_scalar_array_op(), makeOperatorDependencies(), multi_sort_add_dimension(), MultiXactIdWait(), pushOperator(), tsquery_opr_selec(), tsqueryrecv(), and XactLockTableWait().

◆ oper_select_candidate()

static FuncDetailCode oper_select_candidate ( int  nargs,
Oid input_typeids,
FuncCandidateList  candidates,
Oid operOid 
)
static

Definition at line 324 of file parse_oper.c.

328 {
329  int ncandidates;
330 
331  /*
332  * Delete any candidates that cannot actually accept the given input
333  * types, whether directly or by coercion.
334  */
335  ncandidates = func_match_argtypes(nargs, input_typeids,
336  candidates, &candidates);
337 
338  /* Done if no candidate or only one candidate survives */
339  if (ncandidates == 0)
340  {
341  *operOid = InvalidOid;
342  return FUNCDETAIL_NOTFOUND;
343  }
344  if (ncandidates == 1)
345  {
346  *operOid = candidates->oid;
347  return FUNCDETAIL_NORMAL;
348  }
349 
350  /*
351  * Use the same heuristics as for ambiguous functions to resolve the
352  * conflict.
353  */
354  candidates = func_select_candidate(nargs, input_typeids, candidates);
355 
356  if (candidates)
357  {
358  *operOid = candidates->oid;
359  return FUNCDETAIL_NORMAL;
360  }
361 
362  *operOid = InvalidOid;
363  return FUNCDETAIL_MULTIPLE; /* failed to select a best candidate */
364 }
FuncCandidateList func_select_candidate(int nargs, Oid *input_typeids, FuncCandidateList candidates)
Definition: parse_func.c:1007
int func_match_argtypes(int nargs, Oid *input_typeids, FuncCandidateList raw_candidates, FuncCandidateList *candidates)
Definition: parse_func.c:922
@ FUNCDETAIL_NORMAL
Definition: parse_func.h:26

References func_match_argtypes(), func_select_candidate(), FUNCDETAIL_MULTIPLE, FUNCDETAIL_NORMAL, FUNCDETAIL_NOTFOUND, InvalidOid, and _FuncCandidateList::oid.

Referenced by left_oper(), and oper().

◆ oprfuncid()

Oid oprfuncid ( Operator  op)

Definition at line 257 of file parse_oper.c.

258 {
260 
261  return pgopform->oprcode;
262 }

References GETSTRUCT.

◆ oprid()

Variable Documentation

◆ OprCacheHash

HTAB* OprCacheHash = NULL
static