Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- db_VISTA III - d_csowrite http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   D_CSOWRITE

SUMMARY
   d_csowrite(SET,FIELD,value[,dbn])
   int SET;
   long FIELD;
   char *value;
   int dbn;

ARGUMENTS
   SET         Set type of current owner to be written.
   FIELD       The field type from current owner.
   value       Pointer to new value.
   dbn         (optional)The number of the database containing the record

DESCRIPTION
   Function  d_csowrite writes the data pointed to by value to data field
   FIELD in the current owner of SET. If FIELD is a key field, the key will
   automatically be updated. If FIELD is used as a sort field for an
   ascending or descending ordered set, the record's position in the set
   will autimatically be adjusted. If FIELD is an array field  the entire
   array is written. Elements of an array cannot be written  individually.
   This function cannot be used modify fields which comprise a compound key.
   Call d_recwrite to modify compound keys.

CURRENCY CHANGES
   None

RETURN CODES
    -2   S_INVSET      Invalid set type. Probably passed a record or field
                       type instead of set type.

    -5   S_INVFLD      Invalid field type. You either did not pass a field
                       type or you passed a field type which is not in the
                       current member.

    3    S_DUPLICATE   Duplicate key

    -8   S_NOCO        The current owner is null.

    -15  S_ISCOMKEY    Illegal operation using compound key field.

    -24  S_NOTLOCKED   Record type containing FIELD is not locked.

    -27  S_TRNOTACT    Transaction not active. In shared mode,changes can
                       only be made from within a transaction.

    -39  S_COMKEY      Records containing compound keys cannot be updated.

EXAMPLE
     /* Change author to "Wirt,N." */
     d_csowrite(HAS_PUBLISHED,NAME,"Wirth,N.");

See Also: d_crwrite d_csmwrite d_recwrite

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson