head	1.2;
access;
symbols;
locks; strict;
comment	@.\" @;


1.2
date	2026.05.22.22.27.22;	author christos;	state Exp;
branches;
next	1.1;
commitid	Ip9NTW8ptkYjsRGG;

1.1
date	2026.04.28.20.40.46;	author christos;	state Exp;
branches;
next	;
commitid	bkVinBKnhvhtDLDG;


desc
@@


1.2
log
@Don't use $Mdocdate$. It breaks reproducible builds
@
text
@.Dd April 29, 2026
.Dt SQLITE3CHANGEGROUP_CHANGE_INT64 3
.Os
.Sh NAME
.Nm sqlite3changegroup_change_int64
.Nd add a 64-bit integer to a changegroup
.Sh SYNOPSIS
.In sqlite3.h
.Ft int
.Fo sqlite3changegroup_change_int64
.Fa "sqlite3_changegroup*"
.Fa "int bNew"
.Fa "int iCol"
.Fa "sqlite3_int64 iVal"
.Fc
.Sh DESCRIPTION
This function may only be called between a successful call to sqlite3changegroup_change_begin()
and its matching sqlite3changegroup_change_finish() call.
If it is called at any other time, it is an SQLITE_MISUSE error.
Calling this function specifies a 64-bit integer value to be used in
the change currently being added to the changegroup object passed as
the first argument.
.Pp
The second parameter, bNew, specifies whether the value is to be part
of the new.* (if bNew is non-zero) or old.* (if bNew is zero) record
of the change under construction.
If this does not match the type of change specified by the preceding
call to sqlite3changegroup_change_begin() (i.e. an old.* value for
an SQLITE_INSERT change, or a new.* value for an SQLITE_DELETE), then
SQLITE_ERROR is returned.
.Pp
The third parameter specifies the column of the old.* or new.* record
that the value will be a part of.
If the specified table has an explicit primary key, then this is the
index of the table column, numbered from 0 in the order specified within
the CREATE TABLE statement.
Or, if the table uses an implicit rowid key, then the column 0 is the
rowid and the explicit columns are numbered starting from 1.
If the iCol parameter is less than 0 or greater than the index of the
last column in the table, SQLITE_RANGE is returned.
.Pp
The fourth parameter is the integer value to use as part of the old.*
or new.* record.
.Pp
If this call is successful, SQLITE_OK is returned.
Otherwise, if an error occurs, an SQLite error code is returned.
.Sh IMPLEMENTATION NOTES
These declarations were extracted from the
interface documentation at line 13433.
.Bd -literal
SQLITE_API int sqlite3changegroup_change_int64(
  sqlite3_changegroup*,
  int bNew,
  int iCol,
  sqlite3_int64 iVal
);
.Ed
@


1.1
log
@Merge conflicts between 3.53.3 and 3.45.1
@
text
@d1 1
a1 1
.Dd $Mdocdate$
@