Component: DBBufferC

• RadioQueue
• MemAlloc
• QueryProcessor
• Leds
• CommandUse
• QueryResultIntf
• ParsedQueryIntf
• TupleIntf
• Interrupt
• void allocDebug(void)

• DBBuffer
• StdControl

• typedef enum DBBufferC.__nesc_unnamed4364 { DBBufferC.kIDLE, DBBufferC.kALLOC_SCHEMA, DBBufferC.kALLOC_BUFFER, DBBufferC.kALLOC_ROW, DBBufferC.kREAD_ROW } AllocState
  DBBuffer is a output buffer abstraction for TinyDB.
• typedef struct DBBufferC.__nesc_unnamed4365 { BufferType type; BufferPolicy policy; ParsedQuery **qh; uint16_t numRows; uint16_t nextFree; uint16_t nextFull; uint16_t len; uint16_t rowSize; long data; union DBBufferC.__nesc_unnamed4366 { char **bufdata; uint16_t offset; } u; } Buffer
• DBBufferC.Buffer mBuffers[DBBufferC.kNUM_BUFS]
• long mUsedBufs
• uint8_t mCurBuffer
• uint16_t mCurRow
• Handle mCurRowHandle
• QueryResultPtr mCurResult
• ParsedQuery *mAllocSchema
• DBBufferC.AllocState mState
• TinyDBError calcNextFreeRow(DBBufferC.Buffer *buf)
  (PRIVATE) Adjust the next free row in the buffer

  Returns:

  err_OutOfMemory if the policy indicates that no more inserts should be allowed

• TinyDBError getBuf(uint8_t bufId, DBBufferC.Buffer **buf)
  (PRIVATE) Return a pointer to buffer bufId in buf if bufId is a valid buf.

• command result_t StdControl.init (void)
• command result_t StdControl.start (void)
• command result_t StdControl.stop (void)
• command TinyDBError DBBuffer.enqueue (uint8_t bufferId, QueryResultPtr r, bool *pending, ParsedQuery *pq) Enqueue a result into the specified buffer Note that if pending returns true, this routine may store a reference to r (so it had better not be on the stack!)

• command TinyDBError DBBuffer.pop (uint8_t bufferId) Remove the first element from the db buffer & deallocate it (don't return it.) Use peek() to retrieve the first element without deallocating, then call pop() when finished (because peek returns a pointer into the buffer.)

• command TinyDBError DBBuffer.peek (uint8_t bufferId, QueryResult *qr, bool *pending) Copy the top most result in the buffer into buf

  Returns:

  err_NoMoreResults if no results are available

• command TinyDBError DBBuffer.getResult (uint8_t bufferId, uint16_t idx, QueryResult *qr, bool *pending) Copy the nth result in the buffer into buf

  Returns:

  err_NoMoreResults if idx > getSize() or if buffer[idx] is empty (unset)

• command TinyDBError DBBuffer.size (uint8_t bufferId, uint16_t *size)
• command TinyDBError DBBuffer.alloc (uint8_t bufferId, BufferType type, uint16_t size, BufferPolicy policy, ParsedQuery *schema, bool *pending, long data) Allocate the buffer with the specified size sizes is an array of sizes of each field, with one entry per field

  Note that this may keep a reference to schema until after pending is complete.

• command uint16_t DBBuffer.maxSize (uint8_t bufferId)

  Returns:

  the number of rows in this buffer

• command ParsedQuery DBBuffer.getSchema (uint8_t bufferId)

  Returns:

  the schema of the result

• command TinyDBError DBBuffer.nextUnusedBuffer (uint8_t *bufferId)
• command TinyDBError DBBuffer.qidToBuffer (uint8_t qid, uint8_t *bufferId)

  Returns:

  the buffer id that corresponds to the specified query id in bufferId, or err_InvalidIndex if no such buffer exists

• event result_t DBBuffer.resultReady (uint8_t bufferId)
• event result_t DBBuffer.getNext (uint8_t bufferId)
• event result_t DBBuffer.allocComplete (uint8_t bufferId, TinyDBError result)
• event result_t DBBuffer.putComplete (uint8_t bufferId, QueryResult *buf, TinyDBError result)
• event result_t MemAlloc.allocComplete (HandlePtr handle, result_t success)
• event result_t MemAlloc.compactComplete (void)
• event result_t MemAlloc.reallocComplete (Handle handle, result_t success)
• event result_t QueryProcessor.queryComplete (ParsedQueryPtr q)
• event result_t CommandUse.commandDone (char *commandName, char *resultBuf, SchemaErrorNo err)
• TinyDBError calcNextFreeRow(DBBufferC.Buffer *buf) (PRIVATE) Adjust the next free row in the buffer

  Returns:

  err_OutOfMemory if the policy indicates that no more inserts should be allowed

• TinyDBError getBuf (uint8_t bufId, DBBufferC.Buffer **buf) (PRIVATE) Return a pointer to buffer bufId in buf if bufId is a valid buf.

DBBuffer.alloc

getBuf