SQLITE3CHANGESET_CONCAT(3)

SQLITE3CHANGESET_CONCAT(3) | Library Functions Manual | SQLITE3CHANGESET_CONCAT(3)

# NAME

`sqlite3changeset_concat` — concatenate two changeset objects

# SYNOPSIS

`#include <sqlite3.h>`

int
`sqlite3changeset_concat`(int nA, void *pA, int nB, void *pB, int *pnOut, void **ppOut);

# DESCRIPTION

This function is used to concatenate two changesets, A and B, into a single changeset. The result is a changeset equivalent to applying changeset A followed by changeset B.

This function combines the two input changesets using an sqlite3_changegroup object. Calling it produces similar results as the following code fragment:

    sqlite3_changegroup *pGrp; rc = sqlite3_changegroup_new(&pGrp); if(
    rc==SQLITE_OK ) rc = sqlite3changegroup_add(pGrp, nA, pA); if( rc==SQLITE_OK
    ) rc = sqlite3changegroup_add(pGrp, nB, pB); if( rc==SQLITE_OK ){ rc
    = sqlite3changegroup_output(pGrp, pnOut, ppOut); }else{ *ppOut = 0;
    *pnOut = 0; }

Refer to the sqlite3_changegroup documentation below for details.

# IMPLEMENTATION NOTES

These declarations were extracted from the interface documentation at line 11774.

    SQLITE_API int sqlite3changeset_concat(
      int nA,                         /* Number of bytes in buffer pA */
      void *pA,                       /* Pointer to buffer containing changeset A */
      int nB,                         /* Number of bytes in buffer pB */
      void *pB,                       /* Pointer to buffer containing changeset B */
      int *pnOut,                     /* OUT: Number of bytes in output changeset */
      void **ppOut                    /* OUT: Buffer containing output changeset */
    );

January 24, 2024 | NetBSD 11.0