Documentation PostgreSQL 14.22 » Programmation serveur » Interface de programmation serveur » Fonctions de support d'interface » SPI_getbinval

Précédent | Niveau supérieur | Suivant
SPI_getvalue | Sommaire | SPI_gettype

## SPI_getbinval

SPI_getbinval — retourne la valeur binaire de la colonne spécifiée

## Synopsis

    Datum SPI_getbinval(HeapTuple row, TupleDesc rowdesc, int colnumber, bool * isNULL)

## Description

`SPI_getbinval` retourne la valeur de la colonne spécifiée dans le format interne (en tant que type `Datum`).

Cette fonction n'alloue pas de nouvel espace pour le datum. Dans le cas d'un type de données passé par référence, la valeur de retour sera un pointeur dans la ligne passée.

## Arguments

`HeapTuple `row``

  ligne d'entrée à examiner

`TupleDesc `rowdesc``

  description de la ligne d'entrée

`int `colnumber``

  numéro de colonne (le compte commence à 1)

`bool * `isNULL``

  indique une valeur NULL dans la colonne

## Valeur de retour

La valeur binaire de la colonne est retournée. La variable vers laquelle pointe `isNULL` est positionnée à vrai si la colonne est NULL et sinon à faux.

`SPI_result` est positionnée à `SPI_ERROR_NOATTRIBUTE` en cas d'erreur.