xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3changeset_concat.3 (revision deb6f0161a9109e7de9b519dc8dfb9478668dcdd)
1.Dd March 11, 2017
2.Dt SQLITE3CHANGESET_CONCAT 3
3.Os
4.Sh NAME
5.Nm sqlite3changeset_concat
6.Nd Concatenate Two Changeset Objects
7.Sh SYNOPSIS
8.Ft int
9.Fo sqlite3changeset_concat
10.Fa "int nA"
11.Fa "void *pA"
12.Fa "int nB"
13.Fa "void *pB"
14.Fa "int *pnOut"
15.Fa "void **ppOut                    "
16.Fc
17.Sh DESCRIPTION
18This function is used to concatenate two changesets, A and B, into
19a single changeset.
20The result is a changeset equivalent to applying changeset A followed
21by changeset B.
22.Pp
23This function combines the two input changesets using an sqlite3_changegroup
24object.
25Calling it produces similar results as the following code fragment:
26.Pp
27sqlite3_changegroup *pGrp; rc = sqlite3_changegroup_new(&pGrp); if(
28rc==SQLITE_OK ) rc = sqlite3changegroup_add(pGrp, nA, pA); if( rc==SQLITE_OK
29) rc = sqlite3changegroup_add(pGrp, nB, pB); if( rc==SQLITE_OK ){ rc
30= sqlite3changegroup_output(pGrp, pnOut, ppOut); }else{ *ppOut = 0;
31*pnOut = 0; }
32.Pp
33Refer to the sqlite3_changegroup documentation below for details.
34