sdir.h

Go to the documentation of this file.

/*-------------------------------------------------------------------------
 *
 * sdir.h
 *    POSTGRES scan direction definitions.
 *
 *
 * Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 * src/include/access/sdir.h
 *
 *-------------------------------------------------------------------------
 */
#ifndef SDIR_H
#define SDIR_H
 
 
/*
 * Defines the direction for scanning a table or an index.  Scans are never
 * invoked using NoMovementScanDirection.  For convenience, we use the values
 * -1 and 1 for backward and forward scans.  This allows us to perform a few
 * mathematical tricks such as what is done in ScanDirectionCombine.
 */
typedef enum ScanDirection
{
    BackwardScanDirection = -1,
    NoMovementScanDirection = 0,
    ForwardScanDirection = 1
} ScanDirection;
 
/*
 * Determine the net effect of two direction specifications.
 * This relies on having ForwardScanDirection = +1, BackwardScanDirection = -1,
 * and will probably not do what you want if applied to any other values.
 */
#define ScanDirectionCombine(a, b)  ((a) * (b))
 
/*
 * ScanDirectionIsValid
 *      True iff scan direction is valid.
 */
#define ScanDirectionIsValid(direction) \
    ((bool) (BackwardScanDirection <= (direction) && \
             (direction) <= ForwardScanDirection))
 
/*
 * ScanDirectionIsBackward
 *      True iff scan direction is backward.
 */
#define ScanDirectionIsBackward(direction) \
    ((bool) ((direction) == BackwardScanDirection))
 
/*
 * ScanDirectionIsNoMovement
 *      True iff scan direction indicates no movement.
 */
#define ScanDirectionIsNoMovement(direction) \
    ((bool) ((direction) == NoMovementScanDirection))
 
/*
 * ScanDirectionIsForward
 *      True iff scan direction is forward.
 */
#define ScanDirectionIsForward(direction) \
    ((bool) ((direction) == ForwardScanDirection))
 
#endif                          /* SDIR_H */