minix/external/public-domain/sqlite/man/sqlite3changeset_concat.3
2018-11-18 02:11:42 +00:00

34 lines
1011 B
Groff

.Dd March 11, 2017
.Dt SQLITE3CHANGESET_CONCAT 3
.Os
.Sh NAME
.Nm sqlite3changeset_concat
.Nd Concatenate Two Changeset Objects
.Sh SYNOPSIS
.Ft int
.Fo sqlite3changeset_concat
.Fa "int nA"
.Fa "void *pA"
.Fa "int nB"
.Fa "void *pB"
.Fa "int *pnOut"
.Fa "void **ppOut "
.Fc
.Sh 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.
.Pp
This function combines the two input changesets using an sqlite3_changegroup
object.
Calling it produces similar results as the following code fragment:
.Pp
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; }
.Pp
Refer to the sqlite3_changegroup documentation below for details.