New API for getting a specified set of messages

This will be easier to use in some cases where we have to get
only a specified set of messages. This API uses the __iter__
API internally, but maintains the state to give back only the
required set of messages

API is - get_messages(count=1)
Missed a doc string