Pegasus InfoCorp: Web site design and web software development company

D_FILLNEW (1)

insert a new record

SYNOPSIS

    #include <typhoon.h>

    d_fillnew(ulong recid, void *buf)

DESCRIPTION

    d_fillnew inserts a new record in a table. recid specifies the type of the record stored in buf. The inserted record retains the same database address throughout its life in the database.

DIAGNOSTICS

    The status code returned by the function is also stored in the global variable db_status.

    S_OKAY

      The record was successfully inserted.

    S_NOCD

      There is no current database.

    S_INVREC

      The record id is not valid.

    S_DUPLICATE

      One of the keys in the record would cause duplicates in a unique index. db_subcode contains the id of the conflicting field or key.

    S_RECSIZE

      A length determinator of a variable length field contained a illegal value. db_subcode contains the id of the conflicting field.

    S_FOREIGN

      The target of a foreign key could not be found. db_subcode contains the id of the target table.

CURRENCY CHANGES

    If d_fillnew returned S_OKAY the record becomes the current record.

EXAMPLE

    #include <typhoon.h>

    struct customer cust; strcpy(cust.name, "Pedersen"); cust.account = 10002; if( d_fillnew(CUSTOMER, &cust) != S_OKAY ) /* handle error */

IDENTIFICATION

    Author: Thomas B. Pedersen. Copyright (c) 1994 Thomas B. Pedersen.

SEE ALSO

    - d_recwrite (1) -

    Id Rv $3 Dt $4 iD $3 $4 $5 $6 $7 $Id: d_getsequence 3 v 1 1 1995/06/12 18:58:12 tbp Exp $ r s-1TYPHOON s0 n ds - %-- t ds - (em