addNote() and addRest()
In addition to what is described in the Doxygen documentation, please note the following:
Each call to
cursor.addRest() advances the cursor. The cursor is advanced by the amount of the duration as set by the last call to
cursor.setDuration() call. EXCEPTION: When adding a note, or rest, in the final beat of the last measure in the score the cursor will not automatically advance after adding that final note or rest. If your code depends on the cursor having advanced you will need to test for this condition and compensate accordingly.
(Assumption: my guess is that this behaviour occurs because the plugin API is using the underlying C++ code that implements the user-interface for adding notes; and in the context of a human at the keyboard this makes perfect sense. In that case there is no longer any room left for the cursor to advance to. This would generally be true inside a plugin as well; however, if you are walking a staff in a plugin, adding notes, you'd be doing that inside a while-loop and testing for the end of the staff. In this situation failure to trap the final note's non-cursor-advancement may cause an infinite-loop condition.)