qdosmsq:traps:trap_3:donl

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

qdosmsq:traps:trap_3:donl [2009/05/19 17:02] (current)
george.gwilt created
Line 1: Line 1:
 +====== SD_DONL/​IOW_DONL ======
 +
 +
 +This trap does a pending newline.
 +
 +^Call Parameters^^Return Parameters^^
 +|D0.B|$2F|D0.L|Error return.|
 +|D1.L| |D1.L|Corrupted.|
 +|D3.W|Timeout |D3.L|Preserved.|
 +|A0.L|Channel ID |A0.L|Preserved.|
 +|A1.L| |A1.L|Corrupted.|
 +
 +===== Errors =====
 +
 +
 +|ERR_NC|Not complete.|
 +|ERR_NO|Channel not open.|
 +
 +
 +===== Notes =====
 +  * All registers not shown above are not used on entry and are preserved on exit.
 +  * If a newline is pending it is activated, otherwise no action is taken and no error is signalled.
 +  * When a newline is activated the cursor is placed at the start of the new line, the window being scrolled up if need be.
 +
 +===== Example =====
 +The example below shows the use of this trap call. It is assumed that A0 contains the window'​s ID.
 +
 +<​code>​
 +newl    moveq   #​sd_donl,​d0 ​    ; $2F
 +        moveq   #​-1,​d3 ​         ; Timeout
 +        trap    #3              ; Do the newline if needed
 +        tst.l   ​d0 ​             ; OK? . .
 +        bne     ​error ​          ; . . no!
 +</​code>​
 +
  
  • qdosmsq/traps/trap_3/donl.txt
  • Last modified: 2009/05/19 17:02
  • by george.gwilt