# queue08

queue08 - fifo queue (number 01 is the template)

Author | Joep Suijs, Copyright © 2009, all rights reserved.
Adapted-by |
Compiler | >=2.4i

Description

    this library provides a (one) byte fifo queue.
    This queue is interrupt-safe in the sense that you can write to the queue from the interrupt and
    read from the main program or vice versa without special precautions.
    Reading (or writing) from both interrupt and main program might not work properly.

    The basic interface is pseudo var:
    queue08 = x -- put x into queue; block if queue is full
    x = queue08 -- read x from queue; block if queue is empty

    non-blocking access to the same queue is provided by
    queue08_nb_put()
    and
    queue08_nb_get()

    other methods:
    queue08_clear()    -- clear queue (makes queue empty)
    queue08_empty()    -- returns true if queue is emtpy (depricated, use queue1_is_empty())
    queue08_is_empty() -- returns true if queue is emtpy
    queue08_is_full()  -- returns true if queue is full
    queue08_nr_free()  -- returns nr of free places in queue
    queue08_nr_used()  -- returns nr of used places in queue

Dependencies

No dependency found

## Summary

### Global variables/contants

- `var volatile byte queue08_out_pointer = 0 ; wijst naar databyte`
- `var volatile byte queue08_in_pointer = 0 ; wijst naar vrije locatie`
- `var volatile byte queue08_data[queue08_size + 1]`

### Procedures

- `queue08_nb'put(byte in v)`
- `queue08'put(byte in v)`
- `queue08_clear()`

### Functions

- `queue08'get() return byte`
- `queue08_is_empty() return bit`
- `queue08_nb'get() return byte`
- `queue08_nr_used() return byte`
- `queue08_is_full() return bit`
- `queue08_empty() return bit`
- `queue08_nb_get(byte out v) return bit`
- `queue08_nr_free() return byte`
- `queue08_nb_put(byte in v) return bit`

## API details

### Global variables/contants

- `var volatile byte queue08_out_pointer = 0 ; wijst naar databyte`

  No documentation found

- `var volatile byte queue08_in_pointer = 0 ; wijst naar vrije locatie`

  No documentation found

- `var volatile byte queue08_data[queue08_size + 1]`

      queue vars

### Procedures

- `queue08_nb'put(byte in v)`

      queue08_nb'put - put one byte into queue (non-blocking)

- `queue08'put(byte in v)`

      queue08'put - put one byte into queue

      When the queue is full, it waits until a byte is removed from the queue.

- `queue08_clear()`

      deprecated

### Functions

- `queue08'get() return byte`

      queue08'get - get one byte from queue

      returns byte from queue.
      When the queue is empty, it waits until a byte is put into the queue.

- `queue08_is_empty() return bit`

      queue08_is_empty() -- returns true if queue is emtpy

- `queue08_nb'get() return byte`

      queue08_nb'get - get one byte from queue (non-blocking)

      returns byte from queue, 0 if queue empty

- `queue08_nr_used() return byte`

      queue08_nr_used - returns nr of used places in queue

- `queue08_is_full() return bit`

      queue08_is_full()  -- returns true if queue is full

- `queue08_empty() return bit`

- `queue08_nb_get(byte out v) return bit`

      queue08_nb_get - get one byte from queue (non-blocking)

      The byte read is put into v (calling param)
      returns: true  when we read a byte from the queue
      false when the queue is empty (byte is not read from queue)

- `queue08_nr_free() return byte`

      queue08_nr_free - returns nr of free places in queue

- `queue08_nb_put(byte in v) return bit`

      queue08_nb_put - put one byte into queue (non-blocking)

      return:  true  when the byte is put into the queue
      false when the queue is full (byte is not put in queue)

## Related samples

No sample found