@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,
0 if no more modifications are present,
-1 on failure.
Unlike bam_mods_at_next_pos this skips ahead to the next site
with modifications.
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, 0 if no more modifications are present, -1 on failure.
Unlike bam_mods_at_next_pos this skips ahead to the next site with modifications.
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.