Fix initialization of fake LSN for unlogged relations

[postgresql] / src / include / utils / tuplestore.h

diff --git a/src/include/utils/tuplestore.h b/src/include/utils/tuplestore.h
index 702d3b73c917e2e795bbb21b52d8a81533d9b977..f9b6fcec29e36dd8b0fef5bcc14567f09c193d0b 100644 (file)
--- a/src/include/utils/tuplestore.h
+++ b/src/include/utils/tuplestore.h
@@ -6,21 +6,33 @@
  * This module handles temporary storage of tuples for purposes such
  * as Materialize nodes, hashjoin batch files, etc.  It is essentially
  * a dumbed-down version of tuplesort.c; it does no sorting of tuples
- * but can only store a sequence of tuples and regurgitate it later.
+ * but can only store and regurgitate a sequence of tuples.  However,
+ * because no sort is required, it is allowed to start reading the sequence
+ * before it has all been written.  This is particularly useful for cursors,
+ * because it allows random access within the already-scanned portion of
+ * a query without having to process the underlying scan to completion.
+ * Also, it is possible to support multiple independent read pointers.
+ *
  * A temporary file is used to handle the data if it exceeds the
  * space limit specified by the caller.
  *
- * Portions Copyright (c) 1996-2000, PostgreSQL, Inc
+ * Beginning in Postgres 8.2, what is stored is just MinimalTuples;
+ * callers cannot expect valid system columns in regurgitated tuples.
+ * Also, we have changed the API to return tuples in TupleTableSlots,
+ * so that there is a check to prevent attempted access to system columns.
+ *
+ * Portions Copyright (c) 1996-2019, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $Id: tuplestore.h,v 1.1 2000/06/18 22:44:35 tgl Exp $
+ * src/include/utils/tuplestore.h
  *
  *-------------------------------------------------------------------------
  */
 #ifndef TUPLESTORE_H
 #define TUPLESTORE_H
 
-#include "access/htup.h"
+#include "executor/tuptable.h"
+
 
 /* Tuplestorestate is an opaque type whose details are not known outside
  * tuplestore.c.
@@ -28,33 +40,52 @@
 typedef struct Tuplestorestate Tuplestorestate;
 
 /*
- * Currently we only need to store HeapTuples, but it would be easy
+ * Currently we only need to store MinimalTuples, but it would be easy
  * to support the same behavior for IndexTuples and/or bare Datums.
  */
 
 extern Tuplestorestate *tuplestore_begin_heap(bool randomAccess,
+                                                                                         bool interXact,
                                                                                          int maxKBytes);
 
-extern void tuplestore_puttuple(Tuplestorestate *state, void *tuple);
+extern void tuplestore_set_eflags(Tuplestorestate *state, int eflags);
 
-extern void tuplestore_donestoring(Tuplestorestate *state);
+extern void tuplestore_puttupleslot(Tuplestorestate *state,
+                                                                       TupleTableSlot *slot);
+extern void tuplestore_puttuple(Tuplestorestate *state, HeapTuple tuple);
+extern void tuplestore_putvalues(Tuplestorestate *state, TupleDesc tdesc,
+                                                                Datum *values, bool *isnull);
 
-extern void *tuplestore_gettuple(Tuplestorestate *state, bool forward,
-                                                                bool *should_free);
+/* tuplestore_donestoring() used to be required, but is no longer used */
+#define tuplestore_donestoring(state)  ((void) 0)
 
-#define tuplestore_getheaptuple(state, forward, should_free) \
-       ((HeapTuple) tuplestore_gettuple(state, forward, should_free))
+extern int     tuplestore_alloc_read_pointer(Tuplestorestate *state, int eflags);
 
-extern void tuplestore_end(Tuplestorestate *state);
+extern void tuplestore_select_read_pointer(Tuplestorestate *state, int ptr);
 
-/*
- * These routines may only be called if randomAccess was specified 'true'.
- * Likewise, backwards scan in gettuple/getdatum is only allowed if
- * randomAccess was specified.
- */
+extern void tuplestore_copy_read_pointer(Tuplestorestate *state,
+                                                                                int srcptr, int destptr);
+
+extern void tuplestore_trim(Tuplestorestate *state);
+
+extern bool tuplestore_in_memory(Tuplestorestate *state);
+
+extern bool tuplestore_gettupleslot(Tuplestorestate *state, bool forward,
+                                                                       bool copy, TupleTableSlot *slot);
+
+extern bool tuplestore_advance(Tuplestorestate *state, bool forward);
+
+extern bool tuplestore_skiptuples(Tuplestorestate *state,
+                                                                 int64 ntuples, bool forward);
+
+extern int64 tuplestore_tuple_count(Tuplestorestate *state);
+
+extern bool tuplestore_ateof(Tuplestorestate *state);
 
 extern void tuplestore_rescan(Tuplestorestate *state);
-extern void tuplestore_markpos(Tuplestorestate *state);
-extern void tuplestore_restorepos(Tuplestorestate *state);
 
-#endif  /* TUPLESTORE_H */
+extern void tuplestore_clear(Tuplestorestate *state);
+
+extern void tuplestore_end(Tuplestorestate *state);
+
+#endif                                                 /* TUPLESTORE_H */