begriffs open source - ai-pg/blob - full-docs/man3/SPI_repalloc.3

   1 '\" t
   2 .\"     Title: SPI_repalloc
   3 .\"    Author: The PostgreSQL Global Development Group
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 2025
   6 .\"    Manual: PostgreSQL 18.0 Documentation
   7 .\"    Source: PostgreSQL 18.0
   8 .\"  Language: English
   9 .\"
  10 .TH "SPI_REPALLOC" "3" "2025" "PostgreSQL 18.0" "PostgreSQL 18.0 Documentation"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 SPI_repalloc \- reallocate memory in the upper executor context
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 void * SPI_repalloc(void * \fIpointer\fR, Size \fIsize\fR)
  36 .fi
  37 .SH "DESCRIPTION"
  38 .PP
  39 \fBSPI_repalloc\fR
  40 changes the size of a memory segment previously allocated using
  41 \fBSPI_palloc\fR\&.
  42 .PP
  43 This function is no longer different from plain
  44 \fBrepalloc\fR\&. It\*(Aqs kept just for backward compatibility of existing code\&.
  45 .SH "ARGUMENTS"
  46 .PP
  47 void * \fIpointer\fR
  48 .RS 4
  49 pointer to existing storage to change
  50 .RE
  51 .PP
  52 Size \fIsize\fR
  53 .RS 4
  54 size in bytes of storage to allocate
  55 .RE
  56 .SH "RETURN VALUE"
  57 .PP
  58 pointer to new storage space of specified size with the contents copied from the existing area