char * axl_stream_get_near_to ( axlStream stream,
int  count 
)

Allows to get current status of the given stream, taking the current index, getting an amount of count bytes before and after the given index.

This function is mainly used to get a piece of the stream at the given position while reporting errors. This allows to show the piece of xml that is failing.

The string return must not be deallocated. Value returned is actually managed by the stream object associated.

Parameters:
stream The stream where the near to operation will be performed.
count The amount of bytes to take.
Returns:
A string that is taken counting bytes with provided count value starting from the index. Stream provided must be not NULL and count value must be greater than 0.