Dbsetseqno()
From Recital Documentation Wiki
Revision as of 09:49, 2 April 2009 by Yvonnemilne (Talk | contribs)
PURPOSE
set the sequence number in a table
SYNOPSIS
#include "dbl.h" int dbsetseqno(dbf, seqno) <input parameter> char *dbf; /* .DBF file descriptor */ long seqno; /* Sequence number to set */ <output parameter> none
</code>
RETURN VALUE
The dbsetseqno() function returns 0 for success, or < 0 if an error occurs. See the section on return code values for a detailed list of return codes.
DESCRIPTION
The dbsetseqno() function sets the sequence number for a specified table (.DBF).
EXAMPLE
The following example sets the sequence number, then gets the sequence number.
#include <stdio.h> #include "dbl.h" /* Recital/Library include file */ #include "dblproto.h" /* Recital/Library prototype file */ static void errorproc( char *func, char *str, int rc); main() { int rc; /* Return Code for error handling */ char *dbf; /* File descriptor for table */ long *seqno; /* Buffer address for sequence number */ rc = dbdcache(100); errorproc("dbdcache()","table cache specified.", rc); rc = dbfilemode(1,0); rc = dbopen("shipwreck.dbf", &dbf); errorproc("dbopen()","table opened shared.", rc); rc=dbsetseqno(dbf, (long) 49); errorproc("dbsetseqno()", "seqno set to 49.", rc); rc=dbgetseqno(dbf, seqno); errorproc("dbgetseqno()", "seqno retrieved.", rc); printf("t Seqno: t%dn", *seqno); rc = dbclose(dbf); errorproc("dbclose()", "table closed.", rc); exit(0); } static void errorproc(func, str, rc) char *func; char *str; int rc; { if ( rc != SUCCESS ) { printf("n Error performing function %s -> %dn", func, rc); exit(1); } printf("Function: t%s, t%s - Okn", func, str); return; }