Skip navigation links

Additional languages
4.19.2.19 NdbTransaction::deleteTuple() »
Section Navigation      [Toggle]

4.19.2.18. NdbTransaction::writeTuple()

Description.  This method is used with NdbRecord to write a tuple of data.

Signature.  

NdbOperation* writeTuple
    (
      const NdbRecord* key_rec, 
      const char* key_row,
      const NdbRecord* attr_rec, 
      const char* attr_row,
      const unsigned char* mask = 0
    )

Parameters.  This method takes the following parameters:

  • key_rec is a pointer to an NdbRecord for either a table or an index. If on a table, then the operation uses a primary key; if on an index, then the operation uses a unique key. In either case, the key_rec must include all columns of the key.

  • The key_row passed to this method defines the primary or unique key of the tuple to be written, and must remain valid until execute() is called.

  • attr_rec is an NdbRecord referencing the attribute to be written.

    Note

    For unique index operations, the attr_rec must refer to the underlying table of the index, not to the index itself.

  • attr_row is a buffer containing the new data.

  • The mask, if not NULL, defines a subset of attributes to be written. The mask is copied, and so does not need to remain valid after the call to this method returns.

Return Value.  The NdbOperation representing this write operation. The operation can be checked for errors if and as necessary.

Example.  

[To be supplied...]