bytebug@felix.UUCP (Roger L. Long) (12/02/87)
[Macintosh Technical Notes - #166: MPW C functions]
MPW C 2.0 includes new interfaces to ROM routines which no longer
do string and point conversions. These new interfaces are
described here.
---
(This file must be converted with BinHex 4.0)
:#e41-6Bf)%C26bJT!&G28N40380"!*!%%h!!!!0"Nbi!"J"$!!)!"!#3!rm!rrr
m!!%!!"-B!&J!@!!!%eJ!B!"J!!!8J!"B!!)!N!0)!%J!N!3#fJ)Srq(riJ,j!NB
$"`8S!r`!!J#3!dJ!5!#3"!,D!LJ!!3#3!f3!N!-"!!'3!`#3!`%R$`!"!!%!,a2
X!#m8H)!M!*!&'3'3!!#3)3-!N!-$!*!&!3!!$&i!3!!!#G`!&!!-!1lrmJ#8rr)
"8Iq3#J!"!*!$!3#3"3%!!![X!#!!!!(`!!MrmJ!Hrr)!l2rb!EVrN!B-!!!$!!)
!N!-#!*!&!3!!$ZJ%-!!!$B3"C2rb!"lrmJ$Xrr)"Z[q3"3!1!3!9J!!!!SJ!!!%
0"J!'!!!-!!!9!!%0"J!'!!!-!!!9!*!$"J!!$!!!!`!"$@8!"J!!#J!!&3#(p8X
3edJJTc%2GhUJa"BK"Jp$mX!rGDS#&2EA0L'I,!JNFrCr,!phYk%#X3JF8j!!Tc%
2GhUJa"BK"Jp3D-D[,!j"`C'3!2B[H3B+%rCbX2B[H5(b`)*(2fIbi!!!"J!!$!!
!&3!"$3B!"J!!$!!!&3#3!`B!!!S"!"8!!3eP!!B!!!i!!"B!!3hr!!B!!!i!!"8
!N!-"%"!!N!-Rle-NFrCr-Jmp$b,ec[9,H!H!B28'M'S)*(2fIb,`d!!!"J!!#J!
!&J!Jce-NFrCr-3mp$b,e5hJ(J'$d-)*(2fIb,`d!"J!!#J!!&J!2p3D-DJp6*(2
fH2$3!!B!!!i"!"8!029"bcI'S26P)3mMmamfmfm*j[Ca!*!$"G$c,`Rdhe$eF23
`hh8m*e12$3!'!!!+!!!9!'Ve5a"&pe*c%28b4cpRpAH5[b`2+&U3!),hQKmX$fe
rH"N-D"mTmX""papeG"N'$d-)*(2fF'J'-'6fIhAfd6,bi!p8X3-IG`Fb&0E"mkm
0!")!!!`!!"8!$!`!!"B!&``!!"8!$[8epY%24IH'pYkKM`d!!!B!!!i"!"8!!3d
#!!B!!!`!!"8!!3d'!!B!!!`!!"8!!3d'!!B!!!`!!"8!18(h(h9d'!+f)#X3C2C
rGIE4-JpL%1D)'3D!B28'M'S)*(2fIbl`d!!!"J!!$!!!&3!"$3B!"J!!$!!!&3!
3#@9iG'9bEL!`H%%i1%-l$3!'!!!+!!!@!!`*8h4b-M8e)#Tc1`d!"J!!#J!!&J!
FF'&cBf&X)(0SEh*d)&088NP14eG*4&4)+(-T$3!'!!!+!!!@!*!$!4!3!*!$#3(
[!!)!N!-*!02q(`([!HpPFL"TFb"NFQ&RCfPZ)#"d!!N"i3!"!*!$#3&S"S!!N"8
*!HB$"!#3!`N!+!"j!6m"Z3(P!H9Z)'Pc)'&ZB@a[Cfm!!3d"!!B!!!`!!"8!!3d
0!!B!!!`!!"8!!3eP!!B!!!S!!"8!!2r@!(i$[J!068&(580358-4!Im!!"rd%j!
!0IGr,!KIE4##4cpR!IH'pYkKMcV`d!!!"J!!$!!!&3!!$!!!&3!"$3B!"J!!$!!
!&3!"$3!!"J!!$!!!&3!3#@9iG'9bEL!`H%%i383l$3!'!!!+!!!@$3B!"J!!$!!
!&3#ip"05X8!aph$4B[G8%&d26I829`p$$c,blc!(J#X3a"BR8`A3p3D-DJJNFrC
imZ!2@9pe$'-$AhF-3@)3B28'M'S)*(2fF2B[H3peKcpR!V%2d[A1r6"H*e2bi!p
8X3eDTIGh2fF"piEfhU%*(fe6JNBKJ#Yi!aph$4B[G8(cV`d!%J!!$!!!&3"f$!!
!&J"i$!!!&3!"$Dd!"J!!#J%!&3!"$3N!"J!!$J!!&3"Rp8X34IG5Fa$e![56p5(
#mX$bKDN),hQKmX$ferH"N!$'JI+I,!3IFIGA3B"JjA-JjSJC$f,hN!"TP"L2,J$
e5a!aph"c)8eX(cV`d!!5!!!-!!!9!!`-!!!@!"3-!!!9!!S*8Q9MG#!UFMX0!!B
!!!S!!"B!!3d'!!B!!!i"!"8+!!!@!!%0!!!'!!!1!!!9!$9"papeG"J#YL!V%28
&Fb"NpRpepY%b$f)3jSJC$f,hN!$hCUpe(bl`d!!5!!!-!!!9!")-!!!@!"F-!!!
9!"lQM'S23P@KB`p3p8p*p1p5p&p$p8mSi[,%mTm0!!B!!!S!!"B!&J!"$3!!"J!
!$J!!&3!Fp'G),b`)Afd3p39c)"piEfhU'21[$3!'!!!-!!!9!!%0"J!'!!!-!!!
9!%Vc(bi!p6*(2fH!pYpeJJpL%1D)'3D!p3D-DJJNFrCi$bMN("NC$f,hN!"JS6p
R+`pLpj)I+I,[$3!!"J!!$!!!&3!YmamZ!23e2hB8)#X3p$##4cpRJ#828'M'S)*
(2fH2,[$3!!!'!!!-!!!9!+2dhe$eF23`mbmZm`"cb[GC'!B$(hF)%JA3p"p-p-$
d2d(e$e-(-K6@`B!P$deXFb@,$dre-'13!29&@[BPpi"&pe*c'!+f),EhB3JNFrC
i"8$PFbJ'J'6fIhAfd6+2,J$e5aJ3Fb&0E"J%(h(h9d%#YLmkm0!!"J!!$!!!&3#
Sp#('peJ3A3+hJ2H9pe3'lUI'*e1!%j'3!2GH$f)A2fF)TrCl+[H3!+C2Ca32+*p
e%#8#X3pRVh83aC%$%C'I+3Bj#+IfHbVhN!#+AhF8$bLIG4!P!V%#Ifd3FJ*[DaJ
#8"pi(2G5%#X3pRVh83aC(bRbl`d!!!B!!!`!!"8!!3d'!!B!!!`!!"8!&3!"$3B
!"J!!$!!!&3!"$3B!"J!!$!!!&3",mbmZ!24"3G&"2"!V%'Q8')"G!V%28&Fb$f)
G9"$[GBYcpR"b"6*3+a##E2Dr,[$3!!B!!!`!!"8!#r#I8&Fb$Lmlm0!!"J!!#J!
!&J!"$3)!"J!!$!!!&3!"$@m!"J!!$!!!&3"*pAFV!VH!pY%V@I,!DU!V'"$IG6`
R8i$hGIGDN!!6N!$hAJaUTcpR$fH[G4$&N3*I1[$3!!!'!!!-!!!9!!%0"J!'!!!
-!!!9!#Ec,bi!p39c+!pYpeJJpL%1D)'3!2B[H3DC3BMbl`d!!!B!!!`!!"8!1r-
I,J$e-NFrCi$fhh@#$f)3jSJC"S$d-)*(2fH!mS2h@U!K6fecBKRbRbl`d!!!"J!
!$!!!&3!"$3B!"J!!$!!!&3!Hp0E(-PL`p8(,0mDJp18KM`R`N!$r$`d!'!!!$J%
!&3!C$J8!&3!E$J%!&3!F'"%!&`"fp$DUFrC`+aJ3-IG`4IG5FaJ%'2GD+!F`Mfe
US8"MN!$@JK3-@4mZ!256"5X8$hG8Q2,!+aJ3-IG`Fb&0E"J'33pjAh9!e(%jmZm
0!!B!!!`!!"8!N!-"$!`!!3`-!!%-$!#3"J`!!"8!*2-[,J$e"A-S$fhh@#$f)3j
SJC!!pLpj$hCUpe(bl`d!"J!!$!!!&3"Bp6%3DSAcV`Rdhe$eF23`p0BrG@Vb`23
Hi6PrH!p)mk$p,dEh8m*e1!p9KcpR$e-NFrCi"8$`R`Re"A-S"S$e"NEfd5&)r6m
0!!B!!!i!!"8!B&q3A`d!"J!!#3!!&3#0p0p3pA$d-2-[,[-!FmVh@4J$(hF(-K6
@`B!P$e,drdd%Ah8R-B$hHhb`03T6pR&!P3JNFrC`Bj!!jA-Ja6pf&)G6Mbi!p8X
B%$(hF(-K6@`B"N%*'-4rBKN,&"mZm0!!"J!!$J!!&3!"$3!!"J!!$J!!&3"JAj"
I$3!'!!!*!!!9!#aAFQPdG'9Z)'*j1JP'FQ9N)%%Z)%KeH'KKE3P1EhCPE@*PFL!
b,#!a16Jh$3!'!!!1!!!9!*!&!ecJ)!!$lJ!L!*!$%!#3!`01a#!!!8J!#LX"G@V
b`23Hi6PrH!p)m0!!"J!!$J!!&3!lmMmamfmfmk$dhe$eF23`hh8m*e1!peKcpR$
e-NFrCi"8$e"A-S"S"NpRpepY%bM`d!!!"J!!$J!!&3#3"304L#!!!m`!)J#3!``
!N!-$6e`J!!&5!!`b!3!-!!`!!ed!+!!#A!!d-J%!$!!B!!0FQ#!!!Fi!#M)#!"8
!'KJ)!"8!(`i&!"8!)!i"!"8!)4J4!"F!B&q3A`d!"J!!#3!!&3"lp*-26I829`p
$$c(blhMb`#X3p$"c)8eX'!*3p0E(-PL`p2p6"MN29&@[BPpi"&pe*c'!+f),D3J
NFrCi"8$PFbJ'J'6fIhAfd6+!3IFIGA3C!VB[1[$3!!!'!!!-!!!9!*!$!3X,!!%
M)`!"$`m!!3m2!!%2$`!#$i)!!3m2!!%2$`!"#`X!!3m2!!)2JJ!"#`X!!3m2!!)
1JJ!"$Ji!!3i1!!%1$J!"$Ji!!3i1!!%1$J!"$Ji!!3i1!!%1$J!#$S)!!3m2!!)
1JJ!"$Ji!!3i1!!%1$J!"$Ji!!Jk#!!%-$!!"$!`!!3m2!!%2$`!"$Ji!!3i1!!%
1$J!#$S)!!3i1!!%-$!!"$!`!!3`-!!%-$!!"$Ji!!3i1!!%1$J!"$Ji!!3i1!!)
1JJ!"$Ji!!3`-!!%-$!!"$!`!!3i1!!%1$J!"$Ji!!3i1!!%2$`!"$Ji!!Jk$!!%
1$J!"$!`!!3`-!!%1$J!#$S)!N&m$6b!J!!33!#)!N!-,!*!$!e&))!!-Z!"U-3%
!)`!,!!02Y#J!#9B!-M3#!!m!,J!$6a3J!!(B!!`N!3!2!$d!!e%m+!!-)J!m0!%
!$`"-!!02@#!!!H3!$$3"!"i!@`!$6c`S!!SF!&)d!3!2!(N!!e`B)!!&G!!-0!%
!$`#)!!0F)#!!#lB!0M3"!!X!P`!$A$!J!!Y-!'Sa!3!2!+)!!e`d)!!'"!!-0!%
!(J#a!!02G#J!#YJ!D$3"!!X!c`!$A%!J!!TZ!'Sa!3!2!0S!!dqS)!!'GJ!-0!%
!(!$T!!0F5#J!$5)!BM-"!!i""3!$A%`J!!P+!!`c!3!1!4-!!dmN+!!*%J!i-`%
!$J%K!!03V#J!#1S!+$-"!!i",`!$A&JJ!!MH!!`c!3!1!6d!!eaJ+!!)SJ!m-`%
!$J&,!!0Fp#!!#*B!$$-"!!i"@3!$6fJS!!E`!#`c!3!1!@F!!e$%+!!)2!!k-`%
!$J&e!!0FX#!!#"B!$$-"!"`"J`!$84!S!!HD!(`c!3!2!Cm!!fPd)!!&p!!-0!)
!(!'Z!!0TN!!S!!FF!(ic!3!1!FS!!dpX)!!)-!!--`%!$J(B!!0TT#J!"Ui!3M-
"!!i"jJ!$DD!S!!Rd!#Jc!3!1!I3!!dmi)!!)*!!--`%!(!)#!!02C#J!#BJ!9$-
"!!`#(J!$86!J!!4+!!`b!3!-!LS!!ed-)!!&D!!--J,rJ!)f!!02N!!J!!4@!"B
d!J!2!!!"!ecX+!!#p!!B0!)!$J!2!30FE#!!"U)!$$-"!!i!(3%$A'3S!!D#!#!
c!3!1!#X"!ea8)!!%2J!--`%!(!!j!30F4#J!"B!!B!-"!!i!93%$A$`J!!L+!!`
c!3!-!'-"!ec`+!!'6J!Q)J%!$!"[!30F+#J!#(B!&#)"!!`!H`%$6c!J!!AJ!"3
L!3!-!)F"!e&J)!!%VJ!D)J%!$J#6!302K#!!"+)!$$-"!!i!S3%$6e!S!!B3!$i
$!3!1!+m"!e&%)!!$$!!--`%!$J#p!304D#J!"'`!*$-"!!i!b`%$8B!J!!5@!!`
c!3!F!0N"!ecS+!!#N!!!C!-"!!i!p3%$8AJ!!!3b!!`c!3!-!3-"!*!&!ji!*L)
"!!`"$`%!N!8$L!!@)J%!$!%E!3#3"30Z!"SL!3!1!5F"!*!&!f)!$$-"!!i"03%
!N!-)!!-`!$)c!3!1!8-"!*!&!b3!$$-"!!i"83%!N!8$'!!--`%!$`&I!3#3!`J
!!NB!&M3#!!i"EJ%!N!8"`J!--`%!+J&m!3#3!`J!"0)!PJ-"!!i"TJ%!N!8"2!!
--`%!$!'d!3#3!`J!!L)!*#)"!!`"`!%!N!-)!!(i!#SL!3!1!F`"!*!&!6!!$$-
"!"`"fJ%#arJS!!&H!'3c!3!!!m3!N!-)!!!%N!!!N!-'!!!%b!#3!`S!!!B!N!3
%!!!'G!#3!`)!!!JL!*!$!J!!#I!!N!-%!!!,3!#3!``!!!`-!*!$&J!!$*i!N!-
D!!!6F!#D`(S8R`!!!3#3!`,A!!!"e`#3!fTZC'ph,!N*)*!&Hh0dEh*PFb"dD'8
JGfPZC'ph8(3,9%ia0MBJ4Np2+#N#!*!$9dp54%e"3d%"!!!8!5!$'!!!9dp54%e
"3d%"!!!8!5!$'!!!*Z)!N!-)!*!)Q1UNrJ!!%h!!!!0"Eh)JG'KP)%&`F'aTBbi
JC(9bD@jR)(9`C'&dCA0p$5!J4'PbC@0dEh*j)$SJ9fPZC'ph8(4b1`NJN!9l9fP
ZC'ph)'C[FL"NC@CKG@ad)'4TFfXJC'PbC@0dEh*jI3d0)#"cBh*PC@iX#C!$)*!
&Hh*PBh4KEQGXC5"dD'&d!*!$)#iX1b3!!0!!!#rrB#""63!J8%d!1J#3#J%!!!&
-"P0eEQ4KH3#3#3C0EfjNBAN!N!N(9(9PFf4KH3#3#!PAC@4ZCA0NBAN!N!B)9'K
eFR0NBAN!N!F'4R*TC'&j!*!*#&0KG(9bC'&j!*!("dTKER9KFRN!N!J)4Q9LFR9
KFRN!N!F&6@&bBfJ!N!S&3A"bD@`!N!S$6@&j!*!-"%TeEQ8!N!X%5R9XH3#3#`C
"G@GeFh3!N!N*8f9`G'9YBQ9b!*!'"dpMG'pLCA)!N!J)6QpfC@eLCA)!N!F)4'9
MC@eLCA)!N!Irr`!$!*!%,#!!!#!!N!-X)!#3"`&1G3#3!aJ!#`!A!"B!&3!8!*!
$!`!#!!3!"3!'!!F!N!-3$b"PG'jbEf&TFf4XD'0QF!#3!bm!$`!K!!i!N!-@!!-
!&3!%!!m!)J!3!"F!&!!&!")!$6iq"$q3!`8qN!-r2`Jq2J!!!3#3!`,A!!!"e`#
3!fS!!e$!!ki!N!-F!'S!!8P19%`!!3!58e45)!!#!#S!!2rr)!#3#!(rrb!!!#3
!N!3$)2rr!!!"G!#3"!+mrrm!!!'3!!#3"!-Krrm!!!'N!!0FA00#!:
---