@param b BAM alignment record
@param state The base modification state pointer.
@param mods A supplied array for returning base modifications
@param n_mods The size of the mods array
@return The number of modifications found on success,
-1 on failure.
Note if called multipled times, qpos must be higher than the previous call.
Hence this is suitable for use from a pileup iterator. If more random
access is required, bam_parse_basemod must be called each time to reset
the state although this has an efficiency cost.
If no modifications are found, the returned value is zero.
If more than n_mods modifications are found, the total found is returned.
Note this means the caller needs to check whether this is higher than
n_mods.
@param b BAM alignment record @param state The base modification state pointer. @param mods A supplied array for returning base modifications @param n_mods The size of the mods array @return The number of modifications found on success, -1 on failure.
Note if called multipled times, qpos must be higher than the previous call. Hence this is suitable for use from a pileup iterator. If more random access is required, bam_parse_basemod must be called each time to reset the state although this has an efficiency cost.
If no modifications are found, the returned value is zero. If more than n_mods modifications are found, the total found is returned. Note this means the caller needs to check whether this is higher than n_mods.