Show pageOld revisionsBacklinksBack to top This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong. ====== UT_MTEXT/UT_WTEXT - Vector $D0 ====== This vector sends text to a channel. ^Call Parameters^^Return Parameters^^ |D0.L|Unused |D0.L|Error code.| |D1.L|Unused |D1.L|Corrupted.| |D2.L|Unused |D2.L|Corrupted.| |D3.L|Unused |D3.L|0 or -1| |A0.L|Channel ID |A0.L|Preserved.| |A1.L|Pointer to text |A1.L|Corrupted.| |A2.L|Unused |A2.L|Corrupted.| |A3.L|Unused |A3.L|Corrupted.| ===== Errors ===== |ERR_NC|Not complete (only for A0=0)| |ERR_NO|Channel not open| |ERR_DF|Drive full| ===== Notes ===== * All registers not shown above are not used on entry and are preserved on exit. * If A0 = 0, the channel is #0. If this channel is in use #1 is tried. Although not recommended by Sinclair it seems to work. * If A0 = 0, D3 is set to 0 on exit, otherwise D3 is -1. * As is usual D0 is tested before exit except for QDOS versions 1.03 and earlier. * The text to which A1 points is in the usual form, a word containing the length followed by that number of characters. * A programmer who wants LF at the end of the string must include it. ===== Example ===== The example below shows the use of this vector to print a message. <code> Prt movea.w UT_MTEXT,a2 ; UT_MTEXT vector address. lea mess,a1 ; Address of message. jsr (a2) ; Print the message bne.s Error_handler ; Oops! (QDOS versions later than 1.03) rts mess dc.w 6 dc.b 'Hello',10 </code> qdosmsq/vectors/wtext.txt Last modified: 2009/02/11 15:23by george.gwilt