-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathlisting149.html
executable file
·930 lines (827 loc) · 53.8 KB
/
listing149.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>MoreIsBetter - /MIB-Libraries/MoreOSL/MoreOSL.h</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/LegacyTechnologies/index.html">Legacy Documents</a> > <a href="../../samplecode/LegacyTechnologies/idxMacOS9Earlier-date.html">Mac OS 9 & Earlier</a> > <A HREF="javascript:location.replace('index.html');">MoreIsBetter</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">MoreIsBetter</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/MIB-Libraries/MoreOSL/MoreOSL.h</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/MIB-Clients/Demos/MoreOpenAndSaveDemo/AnswerShell.c</option>
<option value="listing2.html">/MIB-Clients/MacCVSProTool/MacCVSProTool.c</option>
<option value="listing3.html">/MIB-Clients/SampleSubmit/SampleSubmit.c</option>
<option value="listing4.html">/MIB-Documentation/index.html</option>
<option value="listing5.html">/MIB-Documentation/MoreDocumentation/0ReleaseNotes.html</option>
<option value="listing6.html">/MIB-Documentation/MoreDocumentation/0toc.html</option>
<option value="listing7.html">/MIB-Documentation/MoreDocumentation/banner.html</option>
<option value="listing8.html">/MIB-Documentation/MoreDocumentation/BuildingAndUsing.html</option>
<option value="listing9.html">/MIB-Documentation/MoreDocumentation/ContributingToMoreIsBetter.html</option>
<option value="listing10.html">/MIB-Documentation/MoreDocumentation/copyright.html</option>
<option value="listing11.html">/MIB-Documentation/MoreDocumentation/index.html</option>
<option value="listing12.html">/MIB-Documentation/MoreDocumentation/intro.html</option>
<option value="listing13.html">/MIB-Documentation/MoreDocumentation/MoreAppearance.html</option>
<option value="listing14.html">/MIB-Documentation/MoreDocumentation/MoreAppleEvents.html</option>
<option value="listing15.html">/MIB-Documentation/MoreDocumentation/MoreCDs.html</option>
<option value="listing16.html">/MIB-Documentation/MoreDocumentation/MoreCodeFragments.html</option>
<option value="listing17.html">/MIB-Documentation/MoreDocumentation/MoreControls.html</option>
<option value="listing18.html">/MIB-Documentation/MoreDocumentation/MoreDevices.html</option>
<option value="listing19.html">/MIB-Documentation/MoreDocumentation/MoreDialogs.html</option>
<option value="listing20.html">/MIB-Documentation/MoreDocumentation/MoreDisks.html</option>
<option value="listing21.html">/MIB-Documentation/MoreDocumentation/MoreErrors.html</option>
<option value="listing22.html">/MIB-Documentation/MoreDocumentation/MoreEvents.html</option>
<option value="listing23.html">/MIB-Documentation/MoreDocumentation/MoreInterfaceLib.html</option>
<option value="listing24.html">/MIB-Documentation/MoreDocumentation/MoreLists.html</option>
<option value="listing25.html">/MIB-Documentation/MoreDocumentation/MoreMemory.html</option>
<option value="listing26.html">/MIB-Documentation/MoreDocumentation/MoreMenus.html</option>
<option value="listing27.html">/MIB-Documentation/MoreDocumentation/MoreMultiprocessing.html</option>
<option value="listing28.html">/MIB-Documentation/MoreDocumentation/MoreNavigation.html</option>
<option value="listing29.html">/MIB-Documentation/MoreDocumentation/MoreNetworkSetup.html</option>
<option value="listing30.html">/MIB-Documentation/MoreDocumentation/MoreOpenAndSave.html</option>
<option value="listing31.html">/MIB-Documentation/MoreDocumentation/MoreOpenTransport.html</option>
<option value="listing32.html">/MIB-Documentation/MoreDocumentation/MoreOSL.html</option>
<option value="listing33.html">/MIB-Documentation/MoreDocumentation/MoreOSUtils.html</option>
<option value="listing34.html">/MIB-Documentation/MoreDocumentation/MorePatches.html</option>
<option value="listing35.html">/MIB-Documentation/MoreDocumentation/MorePreferences.html</option>
<option value="listing36.html">/MIB-Documentation/MoreDocumentation/MoreProcesses.html</option>
<option value="listing37.html">/MIB-Documentation/MoreDocumentation/MoreQuickDraw.html</option>
<option value="listing38.html">/MIB-Documentation/MoreDocumentation/MoreResources.html</option>
<option value="listing39.html">/MIB-Documentation/MoreDocumentation/MoreTextUtils.html</option>
<option value="listing40.html">/MIB-Documentation/MoreDocumentation/MoreToolbox.html</option>
<option value="listing41.html">/MIB-Documentation/MoreDocumentation/MoreWindows.html</option>
<option value="listing42.html">/MIB-Libraries/MIB_Carbon.h</option>
<option value="listing43.html">/MIB-Libraries/MIB_SourceHeader.txt</option>
<option value="listing44.html">/MIB-Libraries/MoreAppearance/MoreAppearance.cp</option>
<option value="listing45.html">/MIB-Libraries/MoreAppearance/MoreAppearance.h</option>
<option value="listing46.html">/MIB-Libraries/MoreAppleEvents/MoreAEDataModel.c</option>
<option value="listing47.html">/MIB-Libraries/MoreAppleEvents/MoreAEDataModel.h</option>
<option value="listing48.html">/MIB-Libraries/MoreAppleEvents/MoreAEObjects.c</option>
<option value="listing49.html">/MIB-Libraries/MoreAppleEvents/MoreAEObjects.h</option>
<option value="listing50.html">/MIB-Libraries/MoreAppleEvents/MoreAppleEvents.cp</option>
<option value="listing51.html">/MIB-Libraries/MoreAppleEvents/MoreAppleEvents.h</option>
<option value="listing52.html">/MIB-Libraries/MoreAppleEvents/MoreAppleEventsPlus.c</option>
<option value="listing53.html">/MIB-Libraries/MoreAppleEvents/MoreAppleEventsPlus.h</option>
<option value="listing54.html">/MIB-Libraries/MoreAppleEvents/MoreFinderEvents.c</option>
<option value="listing55.html">/MIB-Libraries/MoreAppleEvents/MoreFinderEvents.h</option>
<option value="listing56.html">/MIB-Libraries/MoreAppleEvents/MoreOSA.c</option>
<option value="listing57.html">/MIB-Libraries/MoreAppleEvents/MoreOSA.h</option>
<option value="listing58.html">/MIB-Libraries/MoreAppleEvents/ProductInfo.txt</option>
<option value="listing59.html">/MIB-Libraries/MoreAppleEvents/TestMoreAppleEvents/Carbon.r</option>
<option value="listing60.html">/MIB-Libraries/MoreAppleEvents/TestMoreAppleEvents/HelloWorld.c</option>
<option value="listing61.html">/MIB-Libraries/MoreAppleEvents/TestMoreAppleEvents/Info.plist.r</option>
<option value="listing62.html">/MIB-Libraries/MoreAppleEvents/TestMoreAppleEvents/TestMoreAppleEvents.c</option>
<option value="listing63.html">/MIB-Libraries/MoreAppleEvents/VersionInfo.r</option>
<option value="listing64.html">/MIB-Libraries/MoreCarbonEvents/MoreCarbonEvents.c</option>
<option value="listing65.html">/MIB-Libraries/MoreCarbonEvents/MoreCarbonEvents.h</option>
<option value="listing66.html">/MIB-Libraries/MoreCFQ/MoreCFQ.c</option>
<option value="listing67.html">/MIB-Libraries/MoreCFQ/MoreCFQ.h</option>
<option value="listing68.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CallMachOFramework/CallMachOFramework.c</option>
<option value="listing69.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CallMachOFramework/CallMachOFramework.r</option>
<option value="listing70.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CallMachOFramework/Read Me CallMachOFramework.txt</option>
<option value="listing71.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CallMachOFramework/System Framework Stub/Stub Library Read Me.txt</option>
<option value="listing72.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CFMLateImport.c</option>
<option value="listing73.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/CFMLateImport.h</option>
<option value="listing74.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/LateImportTest/LateImportTest.c</option>
<option value="listing75.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/LateImportTest/TestLibrary/TestLibrary.h</option>
<option value="listing76.html">/MIB-Libraries/MoreCodeFragments/CFMLateImport/LateImportTest/TestLibrary/TestLibraryImpl.c</option>
<option value="listing77.html">/MIB-Libraries/MoreControls/MoreControls.cp</option>
<option value="listing78.html">/MIB-Libraries/MoreControls/MoreControls.h</option>
<option value="listing79.html">/MIB-Libraries/MoreCRC/MoreCRC.c</option>
<option value="listing80.html">/MIB-Libraries/MoreCRC/MoreCRC.h</option>
<option value="listing81.html">/MIB-Libraries/MoreDebugging/MoreAddrToSym.c</option>
<option value="listing82.html">/MIB-Libraries/MoreDebugging/MoreAddrToSym.h</option>
<option value="listing83.html">/MIB-Libraries/MoreDebugging/MoreBacktrace.c</option>
<option value="listing84.html">/MIB-Libraries/MoreDebugging/MoreBacktrace.h</option>
<option value="listing85.html">/MIB-Libraries/MoreDebugging/MoreBacktraceTest/MoreBacktraceTest.c</option>
<option value="listing86.html">/MIB-Libraries/MoreDebugging/MoreBBLog.c</option>
<option value="listing87.html">/MIB-Libraries/MoreDebugging/MoreBBLog.h</option>
<option value="listing88.html">/MIB-Libraries/MoreDevices/InterruptSafeDebug/GenerateFont/GenerateFont.c</option>
<option value="listing89.html">/MIB-Libraries/MoreDevices/InterruptSafeDebug/InterruptSafeDebug.c</option>
<option value="listing90.html">/MIB-Libraries/MoreDevices/InterruptSafeDebug/InterruptSafeDebug.h</option>
<option value="listing91.html">/MIB-Libraries/MoreDevices/InterruptSafeDebug/InterruptSafeDebug.s</option>
<option value="listing92.html">/MIB-Libraries/MoreDevices/InterruptSafeDebug/TestInterruptSafeDebug/TestInterruptSafeDebug.c</option>
<option value="listing93.html">/MIB-Libraries/MoreDevices/TradDriverLoaderLib/ReadMe.html</option>
<option value="listing94.html">/MIB-Libraries/MoreDevices/TradDriverLoaderLib/TestTradDriverLoaderLib/TestDriver/TestDriverMain.c</option>
<option value="listing95.html">/MIB-Libraries/MoreDevices/TradDriverLoaderLib/TestTradDriverLoaderLib/TestTradDriverLoader.c</option>
<option value="listing96.html">/MIB-Libraries/MoreDevices/TradDriverLoaderLib/TradDriverLoaderLib.c</option>
<option value="listing97.html">/MIB-Libraries/MoreDevices/TradDriverLoaderLib/TradDriverLoaderLib.h</option>
<option value="listing98.html">/MIB-Libraries/MoreDialogs/MoreDialogs.cp</option>
<option value="listing99.html">/MIB-Libraries/MoreDialogs/MoreDialogs.h</option>
<option value="listing100.html">/MIB-Libraries/MoreDisks/MoreCDs.c</option>
<option value="listing101.html">/MIB-Libraries/MoreDisks/MoreCDs.h</option>
<option value="listing102.html">/MIB-Libraries/MoreDisks/MoreDisks.c</option>
<option value="listing103.html">/MIB-Libraries/MoreDisks/MoreDisks.h</option>
<option value="listing104.html">/MIB-Libraries/MoreDisks/TestMoreDisks/TestMoreDisks.c</option>
<option value="listing105.html">/MIB-Libraries/MoreErrors/MoreErrors.c</option>
<option value="listing106.html">/MIB-Libraries/MoreErrors/MoreErrors.h</option>
<option value="listing107.html">/MIB-Libraries/MoreErrors/MoreErrors.r</option>
<option value="listing108.html">/MIB-Libraries/MoreEvents/MoreEvents.h</option>
<option value="listing109.html">/MIB-Libraries/MoreInterfaceLib/MoreInterfaceLib.c</option>
<option value="listing110.html">/MIB-Libraries/MoreInterfaceLib/MoreInterfaceLib.h</option>
<option value="listing111.html">/MIB-Libraries/MoreInterfaceLib/RemoteAccessInterface.h</option>
<option value="listing112.html">/MIB-Libraries/MoreInterfaceLib/TestMoreInterfaceLib/TestMoreInterfaceLib.c</option>
<option value="listing113.html">/MIB-Libraries/MoreIsBetter.h</option>
<option value="listing114.html">/MIB-Libraries/MoreLists/MoreLists.c</option>
<option value="listing115.html">/MIB-Libraries/MoreLists/MoreLists.h</option>
<option value="listing116.html">/MIB-Libraries/MoreMemory/MoreMemory.c</option>
<option value="listing117.html">/MIB-Libraries/MoreMemory/MoreMemory.h</option>
<option value="listing118.html">/MIB-Libraries/MoreMemory/TestMoreMemory/TestMoreMemory.c</option>
<option value="listing119.html">/MIB-Libraries/MoreMenus/MenuKeyGlyphs.h</option>
<option value="listing120.html">/MIB-Libraries/MoreMenus/MoreMenus.c</option>
<option value="listing121.html">/MIB-Libraries/MoreMenus/MoreMenus.h</option>
<option value="listing122.html">/MIB-Libraries/MoreMenus/MoreSystemMenus.c</option>
<option value="listing123.html">/MIB-Libraries/MoreMenus/MoreSystemMenus.h</option>
<option value="listing124.html">/MIB-Libraries/MoreMenus/TestMoreSystemMenus/TestMoreSystemMenus.c</option>
<option value="listing125.html">/MIB-Libraries/MoreMultiprocessing/MoreBlueActions.c</option>
<option value="listing126.html">/MIB-Libraries/MoreMultiprocessing/MoreBlueActions.h</option>
<option value="listing127.html">/MIB-Libraries/MoreMultiprocessing/MoreMPLog.c</option>
<option value="listing128.html">/MIB-Libraries/MoreMultiprocessing/MoreMPLog.h</option>
<option value="listing129.html">/MIB-Libraries/MoreNavigation/MoreNavigation.c</option>
<option value="listing130.html">/MIB-Libraries/MoreNavigation/MoreNavigation.h</option>
<option value="listing131.html">/MIB-Libraries/MoreOpenAndSave/MoreOpenAndSave.cp</option>
<option value="listing132.html">/MIB-Libraries/MoreOpenAndSave/MoreOpenAndSave.h</option>
<option value="listing133.html">/MIB-Libraries/MoreOpenTransport/MoreAutoPush.c</option>
<option value="listing134.html">/MIB-Libraries/MoreOpenTransport/MoreAutoPush.h</option>
<option value="listing135.html">/MIB-Libraries/MoreOpenTransport/MoreAutoPushTest/MoreAutoPushTest.c</option>
<option value="listing136.html">/MIB-Libraries/MoreOpenTransport/OTClassicContext.h</option>
<option value="listing137.html">/MIB-Libraries/MoreOpenTransport/OTClassicContextTest/OTClassicContextTest.c</option>
<option value="listing138.html">/MIB-Libraries/MoreOpenTransport/OTMP.c</option>
<option value="listing139.html">/MIB-Libraries/MoreOpenTransport/OTMP.h</option>
<option value="listing140.html">/MIB-Libraries/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTP.c</option>
<option value="listing141.html">/MIB-Libraries/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTP.h</option>
<option value="listing142.html">/MIB-Libraries/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTPTest.c</option>
<option value="listing143.html">/MIB-Libraries/MoreOpenTransport/OTMPSimpleServerHTTP/OTMPSimpleServerHTTPTest.r</option>
<option value="listing144.html">/MIB-Libraries/MoreOpenTransport/OTMPSimpleServerHTTP/Sample HTTP Source/index.html</option>
<option value="listing145.html">/MIB-Libraries/MoreOpenTransport/OTMPTest/OTMPTest.c</option>
<option value="listing146.html">/MIB-Libraries/MoreOpenTransport/Read_Me_About_OTMP.html</option>
<option value="listing147.html">/MIB-Libraries/MoreOpenTransport/ReadMeOTClassicContext.html</option>
<option value="listing148.html">/MIB-Libraries/MoreOSL/MoreOSL.c</option>
<option value="listing149.html">/MIB-Libraries/MoreOSL/MoreOSL.h</option>
<option value="listing150.html">/MIB-Libraries/MoreOSL/MoreOSLHelpers.c</option>
<option value="listing151.html">/MIB-Libraries/MoreOSL/MoreOSLHelpers.h</option>
<option value="listing152.html">/MIB-Libraries/MoreOSL/MoreOSLStringComp.applescript</option>
<option value="listing153.html">/MIB-Libraries/MoreOSL/MoreOSLStringCompare.c</option>
<option value="listing154.html">/MIB-Libraries/MoreOSL/MoreOSLStringCompare.h</option>
<option value="listing155.html">/MIB-Libraries/MoreOSL/MoreOSLTokens.c</option>
<option value="listing156.html">/MIB-Libraries/MoreOSL/MoreOSLTokens.h</option>
<option value="listing157.html">/MIB-Libraries/MoreOSL/ReadMe.html</option>
<option value="listing158.html">/MIB-Libraries/MoreOSL/TestMoreOSL/Test Script.applescript</option>
<option value="listing159.html">/MIB-Libraries/MoreOSL/TestMoreOSL/TestMoreOSL.c</option>
<option value="listing160.html">/MIB-Libraries/MoreOSL/TestMoreOSL/TestMoreOSLTerminology.h</option>
<option value="listing161.html">/MIB-Libraries/MoreOSL/TestMoreOSL/TestMoreOSLTerminology.r</option>
<option value="listing162.html">/MIB-Libraries/MoreOSUtils/MoreOSUtils.c</option>
<option value="listing163.html">/MIB-Libraries/MoreOSUtils/MoreOSUtils.h</option>
<option value="listing164.html">/MIB-Libraries/MoreOSUtils/TestMoreOSUtils/TestMoreOSUtils.c</option>
<option value="listing165.html">/MIB-Libraries/MorePatches/MoreCFMPatches/MoreCFMPatches.c</option>
<option value="listing166.html">/MIB-Libraries/MorePatches/MoreCFMPatches/MoreCFMPatches.h</option>
<option value="listing167.html">/MIB-Libraries/MorePatches/MoreCFMPatches/MoreCFMPatches.s</option>
<option value="listing168.html">/MIB-Libraries/MorePatches/MoreCFMPatches/MoreCFMPatchesTest/MoreCFMPatchesTest.c</option>
<option value="listing169.html">/MIB-Libraries/MorePreferences/MorePreferences.cp</option>
<option value="listing170.html">/MIB-Libraries/MorePreferences/MorePreferences.h</option>
<option value="listing171.html">/MIB-Libraries/MoreProcesses/MoreProcesses.cp</option>
<option value="listing172.html">/MIB-Libraries/MoreProcesses/MoreProcesses.h</option>
<option value="listing173.html">/MIB-Libraries/MoreProcesses/MoreScheduledExec.c</option>
<option value="listing174.html">/MIB-Libraries/MoreProcesses/MoreScheduledExec.h</option>
<option value="listing175.html">/MIB-Libraries/MoreProcesses/TestMoreScheduledExec/TestMoreScheduledExec.c</option>
<option value="listing176.html">/MIB-Libraries/MoreQuickDraw/MoreQuickDraw.cp</option>
<option value="listing177.html">/MIB-Libraries/MoreQuickDraw/MoreQuickDraw.h</option>
<option value="listing178.html">/MIB-Libraries/MoreResources/MoreResources.c</option>
<option value="listing179.html">/MIB-Libraries/MoreResources/MoreResources.h</option>
<option value="listing180.html">/MIB-Libraries/MoreSCF/MoreSCF.c</option>
<option value="listing181.html">/MIB-Libraries/MoreSCF/MoreSCF.h</option>
<option value="listing182.html">/MIB-Libraries/MoreSCF/MoreSCFCCLScanner.c</option>
<option value="listing183.html">/MIB-Libraries/MoreSCF/MoreSCFCCLScanner.h</option>
<option value="listing184.html">/MIB-Libraries/MoreSCF/MoreSCFDigest.c</option>
<option value="listing185.html">/MIB-Libraries/MoreSCF/MoreSCFDigest.h</option>
<option value="listing186.html">/MIB-Libraries/MoreSCF/MoreSCFHelpers.c</option>
<option value="listing187.html">/MIB-Libraries/MoreSCF/MoreSCFHelpers.h</option>
<option value="listing188.html">/MIB-Libraries/MoreSCF/MoreSCFPortScanner.c</option>
<option value="listing189.html">/MIB-Libraries/MoreSCF/MoreSCFPortScanner.h</option>
<option value="listing190.html">/MIB-Libraries/MoreSCF/MoreSCFTest/MoreSCFTest.c</option>
<option value="listing191.html">/MIB-Libraries/MoreSCF/ReadMeAboutMoreSCF.html</option>
<option value="listing192.html">/MIB-Libraries/MoreSecurity/MoreSecurity.c</option>
<option value="listing193.html">/MIB-Libraries/MoreSecurity/MoreSecurity.h</option>
<option value="listing194.html">/MIB-Libraries/MoreSecurity/MoreSecurityTest/MoreSecurityTest.c</option>
<option value="listing195.html">/MIB-Libraries/MoreSecurity/MoreSecurityTest/MoreSecurityTestCommon.h</option>
<option value="listing196.html">/MIB-Libraries/MoreSecurity/MoreSecurityTest/MoreSecurityTestTool.c</option>
<option value="listing197.html">/MIB-Libraries/MoreSecurity/ReadMeAboutMoreAuthSample.html</option>
<option value="listing198.html">/MIB-Libraries/MoreSetup.h</option>
<option value="listing199.html">/MIB-Libraries/MoreSetup.r</option>
<option value="listing200.html">/MIB-Libraries/MoreSound/MoreSound.cp</option>
<option value="listing201.html">/MIB-Libraries/MoreSound/MoreSound.h</option>
<option value="listing202.html">/MIB-Libraries/MoreTextUtils/MoreTextUtils.cp</option>
<option value="listing203.html">/MIB-Libraries/MoreTextUtils/MoreTextUtils.h</option>
<option value="listing204.html">/MIB-Libraries/MoreTextUtils/TestMoreTextUtils/TestMoreTextUtils.c</option>
<option value="listing205.html">/MIB-Libraries/MoreTextUtils/TestMoreTextUtils/TestMoreTextUtils.r</option>
<option value="listing206.html">/MIB-Libraries/MoreToolbox/MoreToolbox.cp</option>
<option value="listing207.html">/MIB-Libraries/MoreToolbox/MoreToolbox.h</option>
<option value="listing208.html">/MIB-Libraries/MoreUNIX/MoreUNIX.c</option>
<option value="listing209.html">/MIB-Libraries/MoreUNIX/MoreUNIX.h</option>
<option value="listing210.html">/MIB-Libraries/MoreWindows/MoreWindows.cp</option>
<option value="listing211.html">/MIB-Libraries/MoreWindows/MoreWindows.h</option>
<option value="listing212.html">/MIB-Libraries/NetworkSetup/MoreNetworkSetup.c</option>
<option value="listing213.html">/MIB-Libraries/NetworkSetup/MoreNetworkSetup.h</option>
<option value="listing214.html">/MIB-Libraries/NetworkSetup/Network Setup SDK Bits/ Read Me.txt</option>
<option value="listing215.html">/MIB-Libraries/NetworkSetup/Network Setup SDK Bits/NetworkSetupBigPicture.html</option>
<option value="listing216.html">/MIB-Libraries/NetworkSetup/NetworkSetupHelpers.c</option>
<option value="listing217.html">/MIB-Libraries/NetworkSetup/NetworkSetupHelpers.h</option>
<option value="listing218.html">/MIB-Libraries/NetworkSetup/NetworkSetupTest/NetworkSetupTest.c</option>
<option value="listing219.html">/MIB-Libraries/NetworkSetup/OldStyleAPI/OldOTConfigLib.h</option>
<option value="listing220.html">/MIB-Libraries/NetworkSetup/ReadMe.html</option>
<option value="listing221.html">/MIB-Libraries/PascalInterfaces/MoreSetup.p</option>
<option value="listing222.html">/MIB-Libraries/PascalInterfaces/TradDriverLoaderLib.p</option></select>
</p>
</form>
<p><strong><a href="MoreIsBetter.zip">Download Sample</a></strong> (“MoreIsBetter.zip”, 1.61M)<BR>
<strong><a href="MoreIsBetter.dmg">Download Sample</a></strong> (“MoreIsBetter.dmg”, 2.04M)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/*
File: MoreOSL.h
Contains: What OSL should have been.
Written by: Quinn
Copyright: Copyright (c) 2000-2001 by Apple Computer, Inc., All Rights Reserved.
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc.
("Apple") in consideration of your agreement to the following terms, and your
use, installation, modification or redistribution of this Apple software
constitutes acceptance of these terms. If you do not agree with these terms,
please do not use, install, modify or redistribute this Apple software.
In consideration of your agreement to abide by the following terms, and subject
to these terms, Apple grants you a personal, non-exclusive license, under Apple's
copyrights in this original Apple software (the "Apple Software"), to use,
reproduce, modify and redistribute the Apple Software, with or without
modifications, in source and/or binary forms; provided that if you redistribute
the Apple Software in its entirety and without modifications, you must retain
this notice and the following text and disclaimers in all such redistributions of
the Apple Software. Neither the name, trademarks, service marks or logos of
Apple Computer, Inc. may be used to endorse or promote products derived from the
Apple Software without specific prior written permission from Apple. Except as
expressly stated in this notice, no other rights or licenses, express or implied,
are granted by Apple herein, including but not limited to any patent rights that
may be infringed by your derivative works or by other works in which the Apple
Software may be incorporated.
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
COMBINATION WITH YOUR PRODUCTS.
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Change History (most recent first):
$Log: MoreOSL.h,v $
Revision 1.8 2002/11/08 23:48:43
When using framework includes, explicitly include the frameworks we need. Convert nil to NULL.
Revision 1.7 2001/11/07 15:54:10
Tidy up headers, add CVS logs, update copyright.
<6> 24/9/01 Quinn Fixes to compile with C++ activated.
<5> 21/9/01 Quinn Changes for CWPro7 Mach-O build.
<4> 27/3/00 Quinn Expanded comments. Dinked with some error numbers.
<3> 20/3/00 Quinn Replaced debug Boolean with individual flags. Implemented
formRange. Exposed routines for "make" event handlers to
support "with properties". General access by name and ID.
"coerceToken" object primitive.
<2> 9/3/00 Quinn Changed how we do access by name to support strings beyond
Str255.
<1> 6/3/00 Quinn First checked in.
*/
#pragma once
/////////////////////////////////////////////////////////////////
// MoreIsBetter Setup
#include "MoreSetup.h"
// Mac OS Interfaces
#if MORE_FRAMEWORK_INCLUDES
#include <Carbon/Carbon.h>
#else
#include <AppleEvents.h>
#endif
// MIB Prototypes
#include "MoreOSLTokens.h"
/////////////////////////////////////////////////////////////////
#ifdef __cplusplus
extern "C" {
#endif
/////////////////////////////////////////////////////////////////
// Debugging
// Bits in the gDebugFlags variable.
enum {
kMOSLNoLogging = 0, // no debug logging
kMOSLLogOSLMask = 0x0001, // log MOSL's interaction with OSL
kMOSLLogCallbacksMask = 0x0002, // log MOSL's class callbacks
kMOSLLogGeneralMask = 0x0004, // log MOSL's general class event handlers
kMOSLLogDispatchMask = 0x0008 // log MOSL's Apple event dispatcher
};
#if MORE_DEBUG
extern UInt32 gDebugFlags;
#endif
/////////////////////////////////////////////////////////////////
// Error Numbers
// DTS Q&A OV 02 says that errors in the range 1000..9999 are legal
// for developers to use. MOSL is stealing some of those from you.
enum {
kMOSLDirectObjectRequiredErr = 5300,
kMOSLDirectObjectNotAllowedErr = 5301,
kMOSLUnrecognisedOperatorErr = 5302,
kMOSLCantRelateObjectsErr = 5303,
kMOSLStringOperatorNotSupported = 5304,
kMOSLClassHasNoElementsOfThisTypeErr = 5305,
kMOSLBoundaryNotInSameContainerErr = 5306,
kMOSLBoundaryMustBeObjectErr = 5307,
kMOSLBoundaryMustBeCompatibleErr = 5308
};
/////////////////////////////////////////////////////////////////
// Data Access
// The following routines are designed to let your Apple event handlers
// access parameters whose contents might be an object specifier. In
// your handler, you should call AEGetParamDesc with typeWildCard to
// get the parameter data, and pass the resulting descriptor to
// one of the following routines. If the descriptor is an object specifier,
// the routine will resolve the object specifier and call your class getter
// to get the actual data.
extern pascal OSStatus MOSLCoerceObjDesc(const AEDesc *desc, DescType desiredType, AEDesc *coercedDesc);
// Coerce the specified descriptor to the specified type, resolving and getting
// the data for an object specifier if necessary.
extern pascal OSStatus MOSLCoerceObjDescToPtr(const AEDesc *desc, DescType desiredType, void *buf, Size bufSize);
// Coerces the specified descriptor to the specified type, resolving and getting
// the data for an object specifier if necessary. The data is stored in the
// variable pointed to by buf, whose size is bufSize. The buffer size must
// exactly match the size of the data (except for typeStr255, as described next).
//
// typePString is used as a pseudo-type that can be passed to MOSLCoerceObjDescToPtr to
// extract a Pascal string from a descriptor. You must pass the size of the string
// (including the length byte) to the bufSize parameter. MOSLCoerceObjDescToPtr
// coerces the descriptor type typeText and then copies the text data into the string
// pointed to by buffer, setting up the length byte appropriately.
/////////////////////////////////////////////////////////////////
// Event Table
// When you initialise MOSL, you pass in two global static structures.
// The first of these is the event table, which gives the set of Apple events
// which you're prepared to handle and some basic information about those events.
// The second structure, the class table, is defined later in this header file.
// MOSLEventIndex is used whenever we declare a integer that represents a
// an index into the event table.
typedef UInt32 MOSLEventIndex;
// MOSLDirectObjectRequirement is used as a field of the event table entries
// to determine how MOSL handles the direct object for that event.
typedef UInt32 MOSLDirectObjectRequirement;
enum {
kMOSLDOOptional = 0, // the direct object parameter is optional for this event
kMOSLDORequired, // the direct object parameter is required for this event
// if not present you get a kMOSLDirectObjectRequiredErr error
kMOSLDOIllegal, // no direct object parameter is allowed for this event
// if a direct object is present, you get a kMOSLDirectObjectNotAllowedErr error
kMOSLDOBadOK // a bad direct object parameter is allowed for this event
// typically used by the "exists" event
};
// MOSLResultAction is used as a field of the event table entries
// to determine how MOSL handles the reply for that event.
typedef UInt32 MOSLResultAction;
enum {
kMOSLReturnNone = 0, // this event has no reply
kMOSLReturnDefault, // this event's reply is handled in the default way,
// contrast with below
kMOSLReturnCountList, // when the direct object is a list,
// this event's reply is the count of the list
// typically used for the "count" event
kMOSLReturnCollapseBooleanList // when the direct object is a list of Booleans,
// this event's reply collapses the list to a single Boolean by ANDing each entry
// typically used for the "exists" event
};
// The event table is made up of MOSLEventEntry structures. Each
// structure contains the class and event ID, and a specification
// of how to handle the direct object parameter and reply for this event.
// MOSL registers an Apple event handler for each event in this table.
struct MOSLEventEntry {
AEEventClass classID;
AEEventID eventID;
MOSLDirectObjectRequirement dirObjReq;
MOSLResultAction resultAction;
};
typedef struct MOSLEventEntry MOSLEventEntry, *MOSLEventEntryPtr;
typedef const MOSLEventEntry *MOSLEventTablePtr;
/////////////////////////////////////////////////////////////////
// Class Table
// The class table is the second core data structure you must supply when
// initialising MOSL. The class table lists all of the classes native to
// your application, the properties for those classes, and how to handle
// events for those classes.
// The first component of a class table entry is the property table for the
// class. The property table is an array of entries of type MOSLPropEntry.
// Each entry contains the property name (the four character code that uniquely
// identifies the property) and a data long. The contents of the data
// long are dependent on the property type. For standard properties, the
// long can contain either kMOSLPropReadOnly or kMOSLPropReadWrite to indicate
// whether the property is read only or read/write. The meaning of the property
// data for special properties is discussed below.
//
// There are three special property name values:
//
// o pProperties -- If you include this property in your property table,
// MOSL will automatically handle getting (or setting) all the properties of
// an object by iterating through the class's property list. The property
// had the standard meaning in this case.
//
// o pInherits -- This value indicates that this class inherits the properties
// of another class. The property data long must contain the class ID of
// the class whose properties are to be inherited. If present, this property
// must be the last property in the property table.
//
// The class you inherit properties from can also inherit properties from
// another class.
//
// The pInherits property need not be related to the similar property in your
// application's 'aete', nor to the inheritance scheme used by your native
// objects. It is only used by MOSL to determine whether a particular class
// has a particular property.
//
// o kMOSLPropNameLast -- This value indicates the end of the property table.
// The property data long must be kMOSLPropDataLast. This property is only
// needed if the property table doesn't end with a pInherits.
typedef UInt32 MOSLPropIndex;
struct MOSLPropEntry {
DescType propName; // property name or pInherits
UInt32 propData; // kMOSLPropReadOnly, kMOSLPropReadWrite (or class to inherit from for pInherits)
};
typedef struct MOSLPropEntry MOSLPropEntry, *MOSLPropEntryPtr;
typedef const MOSLPropEntry *MOSLPropTablePtr;
enum {
kMOSLPropReadOnly = 0, // this property is read-only
kMOSLPropReadWrite = 1, // this property is read/write
kMOSLPropNameLast = 0xFFFFFFFF, // this is the last property in the property table
kMOSLPropDataLast = 0xFFFFFFFF // when propName is kMOSLPropNameLast, propData must be kMOSLPropDataLast
};
// The second component of a class table entry is a table of event handlers.
// A class's event handler table is very much like the system Apple event dispatch
// table, except that there is a class event handler table for each class known
// to MOSL. When MOSL receives an Apple event, it resolves the direct object
// of the event and then determines the class of that object. It then calls
// the corresponding handler in the class's event handler table.
//
// In the OSL biz this is known as "class first" dispatching (-:
//
// The event handler table is indexed by the same indexes used for the event
// table (ie MOSLEventIndex). For example, if you put the 'core'/'getd' event
// first in your event table, you must put each class's "get data" handler
// first in its event handler table. Also, the event handler array must
// have an entry for each event in the event table.
//
// If your class doesn't handle a specific event, you should set the corresponding
// entry in the event handlers table to NULL. MOSL will return the appropriate
// error (errAECantHandleClass) if someone tries to dispatch an event to a class
// that doesn't understand that event.
//
// For the common 'core' events, you can point your event handler to a generic
// implementation that call's your classes object primitives. See the comment
// above MOSLGeneralCount for details.
typedef pascal OSStatus (*MOSLClassEventHandler)(const MOSLToken *dirObjTok, const AppleEvent *theEvent, AEDesc *result);
// Each element of the class's event handler table is a pointer
// to a routine of type MOSLClassEventHandler. This routine is much like
// an Apple event handler except:
//
// a) it receives a token for its direct object, and
// b) the result is an AEDesc, not an AppleEvent
//
// This is because MOSL handles lists of direct objects automatically for you.
// Your handler just does the event on a single token and returns the corresponding
// result and, if the direct object is a list, MOSL takes care of calling you
// multiple times and assembling the results.
//
// Just like an Apple event handler, your handler can get its parameters from
// the Apple event by calling AEGetParamDesc.
// The MOSLClassEventTablePtr type is used specifically to reference the first
// element of the class's event handler table.
typedef const MOSLClassEventHandler *MOSLClassEventTablePtr;
// MOSL provides a generic implementation of a number of core Apple events. These
// implementations are layered on top of your classes object primitives (see below).
// You can take advantage of these generic implementations by simply setting the
// appropriate entry in your class's event handler table to point to the generic
// routine.
extern pascal OSStatus MOSLGeneralCount(const MOSLToken *dirObjTok, const AppleEvent *theEvent, AEDesc *result);
// This routine implements the "count" Apple event based on your class's
// counter object primitive (MOSLClassCounter). It handles the "each"
// parameter.
extern pascal OSStatus MOSLGeneralExists(const MOSLToken *dirObjTok, const AppleEvent *theEvent, AEDesc *result);
// This routine implements the "exists" Apple event by simply looking to
// see whether the direct object is valid. To use this routine, the
// "exists" Apple event must have its direct object requirement set to
// kMOSLDOBadOK in the event table.
extern pascal OSStatus MOSLGeneralGetData(const MOSLToken *dirObjTok, const AppleEvent *theEvent, AEDesc *result);
// This routine implements the "get data" Apple event based on your class's
// getter object primitive (MOSLClassGetter). It handles the "as" parameter.
extern pascal OSStatus MOSLGeneralSetData(const MOSLToken *dirObjTok, const AppleEvent *theEvent, AEDesc *result);
// This routine implements the "set data" Apple event based on your class's
// setter object primitive (MOSLClassSetter).
extern pascal OSStatus MOSLSetObjectProperties(const MOSLToken *objTok, const AERecord *data);
// This routine is intended to be called as part of your "make" event handler
// when the event contains a "with properties" parameter. It allows you to
// specify a record containing property values. For each settable property,
// the routine will call your class's "setter" object primitive to set the
// actual property value.
//
// objTok must be a token for your object, not for any specific property.
// data must be a valid AERecord (typeAERecord).
extern pascal OSStatus MOSLGeneralAccessByName(const MOSLToken *containerTok, DescType elementType, const AEDesc *name, MOSLToken *valueTok);
// This routine implements a generic "accessByName" object primitive
// in terms of the "counter", "accessByIndex", and "getter" primitives.
// The routine calls "counter" to count the number of elements of type
// elementType within containerTok, then repeatedly calls "accessByIndex"
// to get tokens for each element, then calls "getter" to get the value
// for the name property of that token, then internally compares the name
// to the name parameter. If they match, it returns the token for the
// matching element in valueTok.
//
// You can put this routine as your "accessByName" primitive in your
// class table entry as long as your class implements "counter",
// "accessByIndex", and "getter" for pName.
extern pascal OSStatus MOSLGeneralAccessByUniqueID(const MOSLToken *containerTok, DescType elementType, SInt32 uniqueID, MOSLToken *valueTok);
// This routine is like MOSLGeneralAccessByName except that it implements
// support for the "accessByUniqueID" object primitive.
//
// You can put this routine as your "accessByUniqueID" primitive in your
// class table entry as long as your class implements "counter",
// "accessByIndex", and "getter" for pID.
// The third component of a class table entry is the object primitives for the
// class. These primitives are like various callbacks you would otherwise supply
// to OSL except that:
//
// a) there are a set of callbacks for each class.
// b) the callbacks are much more specific
// c) the callbacks use MOSLTokens instead of generic descriptors
typedef pascal OSStatus (*MOSLClassCounter)(const MOSLToken *containerTok, DescType elementType, SInt32 *result);
// Given a reference to an object (containerTok), count the number of elements
// of type elementType.
//
// o primitive may be NULL if class doesn't have elements
// o containerTok is always an object, never a property
// o elementType may be cObject, which you should treat as your default element type
// o you should return kClassHasNoElementsOfThisTypeErr if element type isn't one of your elements
// o you should return errAENoSuchObject if the container doesn't contain the specified object
typedef pascal OSStatus (*MOSLClassAccessByUniqueID)(const MOSLToken *containerTok, DescType elementType, SInt32 uniqueID, MOSLToken *valueTok);
// Given a reference to an object (containerTok), return the element (of type
// elementType) whose unique ID is uniqueID.
//
// o primitive may be NULL if class doesn't support accessing objects by unique ID
// o containerTok is always an object, never a property
// o elementType may be cObject, which you should treat as your default element type
// o you should return kClassHasNoElementsOfThisTypeErr if element type isn't one of your elements
// o you should return errAENoSuchObject if the container doesn't contain the specified object\
// o for polymorphic objects, return a token of the "best type"
// o you may want to take advantage of MOSLGeneralAccessByUniqueID
typedef pascal OSStatus (*MOSLClassAccessByIndex)(const MOSLToken *containerTok, DescType elementType, SInt32 index, MOSLToken *valueTok);
// Given a reference to an object (containerTok), return the element (of type
// elementType) with the specified index.
//
// o primitive may be NULL if class doesn't have elements
// o containerTok is always an object, never a property
// o elementType may be cObject, which you should treat as your default element type
// o index is always a positive number, 1-based index starting from the beginning of
// the container (if the object specifier included a negative index, MOSL has already
// called your "counter" primitive to turn it into a positive number)
// o you should return kClassHasNoElementsOfThisTypeErr if element type isn't one of your elements
// o you should return errAENoSuchObject if the container doesn't contain the specified object
// o for polymorphic objects, return a token of the "best type"
typedef pascal OSStatus (*MOSLClassAccessByName)(const MOSLToken *containerTok, DescType elementType, const AEDesc *name, MOSLToken *valueTok);
// Given a reference to an object (containerTok), return the element (of type
// elementType) with the specified name. The name is given as an AEDesc because
// there are many ways string formats it can come in to MOSL as. You should use
// the MOSLStringEqualsXxx routines (above) to compare the name against the
// names of your objects.
//
// o primitive may be NULL if class doesn't support accessing objects by name
// o containerTok is always an object, never a property
// o elementType may be cObject, which you should treat as your default element type
// o you should return kClassHasNoElementsOfThisTypeErr if element type isn't one of your elements
// o you should return errAENoSuchObject if the container doesn't contain the specified object
// o for polymorphic objects, return a token of the "best type"
// o you may want to take advantage of MOSLGeneralAccessByName
typedef pascal OSStatus (*MOSLClassGetter)(const MOSLToken *tok, AEDesc *desc);
// Given a reference to an object or property, return the data for that reference.
//
// o routine is required for all classes
// o called for both objects and properties
// o objects should return an object specifier for the object
// o properties should return the actual property data (for data properties)
// or a token (for properties whose value is a reference to another object)
// o only called for properties in your class's property table (getter
// infrastructure checks property table and returns errAENoSuchObject)
typedef pascal OSStatus (*MOSLClassSetter)(const MOSLToken *tok, const AEDesc *desc);
// Given a reference to a property, set the property to the data in desc.
//
// o only called for properties, never for objects
// o only called for properties in your class's property table (setter
// infrastructure checks property table and returns errAENoSuchObject)
// o only called for read/write properties (setter infrastructure uses
// property table to return errAENotModifiable for read-only properties)
// o routine is optional, may be NULL if no properties are read/write
// o use MOSLCoerceObjDesc to extract data from desc
typedef pascal OSStatus (*MOSLClassCoerceToken)(const MOSLToken *tok, DescType toClass, MOSLToken *coercedTok);
// Coerce from a subclass to one of its superclass. You must supply
// this routine if your access by index/id/name object primitives return
// a subclass.
//
// This routine is not necessary if your access object primitives always
// return a token of the same type of the requested type (the elementType
// parameter to the access object primitive) or you are the base class.
//
// o tok is never a property
// o toClass can be any of the superclasses for that subclass
// o toClass can also be cObject, in which case you should coerce
// to the base class
// o coercedTok can be NULL
// o return errAECoercionFail if toClass isn't a superclass of tok
// MOSLClassIndex is used whenever we declare a integer that represents a
// an index into the class table.
typedef UInt32 MOSLClassIndex;
// Finally, we define the structure use for each entry in the class table.
// For information about each component, see the corresponding comments
// above.
struct MOSLClassEntry {
OSType classID;
// first component -- property table
MOSLPropTablePtr properties;
// second component -- event handler table
MOSLClassEventTablePtr eventHandlers;
// third component -- object primitives
MOSLClassCounter counter;
MOSLClassAccessByUniqueID accessByUniqueID;
MOSLClassAccessByIndex accessByIndex;
MOSLClassAccessByName accessByName;
MOSLClassGetter getter;
MOSLClassSetter setter;
MOSLClassCoerceToken coerceToken;
};
typedef struct MOSLClassEntry MOSLClassEntry, *MOSLClassEntryPtr;
typedef const MOSLClassEntry *MOSLClassTablePtr;
// IMPORTANT:
// The first entry of the class table *must* be the application's class
// (cApplication).
enum {
kMOSLCApplicationIndex = 0
};
/////////////////////////////////////////////////////////////////
// Globals and Initialisation
typedef pascal OSStatus (*MOSLDefaultEventHandler)(const AEDesc *dirObj, const AppleEvent *theEvent, MOSLEventIndex eventIndex, AEDesc *result);
// Your application may optionally choose to provide a default handler.
// This handler is called if, after direct object resolution, we find
// that the class of the direct object is not one of the classes in the
// class table. This is useful for handling events on classes that
// you don't otherwise recognise, such as the "open" event on class
// typeFSS.
//
// Note that your default handler is invoked after object resolution
// and list breakdown, so it will be passed the actual elements of a
// list, not the list itself.
typedef pascal void (*MOSLErrorToStringProc)(OSStatus errNum, Str255 errStr);
// You may choose to supply this routine to map error numbers to strings.
// When MOSL encounters an error processing an Apple event, it calls this
// routine to determine the error message and then, if the string is not
// empty, sets the keyErrorString parameter of the reply to this string.
//
// This routine is optional for prototype implementations but is required
// for real applications. The reason is that MOSL has some internal errors
// (see the top of the file) that must be mapped to sensible error strings.
// MOSL does not provide these strings because their specification is tied
// to how your application performs localisation.
//
// At a minimum, your error to string routine must be able to map these
// MOSL errors to sensible values. You must also be prepared to map any
// errors that your various MOSL callbacks might return. OTOH, you don't
// have to supply strings for common Mac OS error numbers because AppleScript
// contains built-in error strings.
extern pascal OSStatus InitMoreOSL(MOSLEventTablePtr eventTableBase, MOSLEventIndex eventTableSize,
MOSLClassTablePtr classTableBase, MOSLClassIndex classTableSize,
MOSLDefaultEventHandler defaultHandler,
MOSLErrorToStringProc errorToStringProc);
// This routine initialises the More Object Support Library (MOSL) module.
// You must supply a pointer to the base of your event and class table,
// and the number of elements in each table. Neither table is optional (ie
// the pointer must not be NULL) although they may be empty (ie the size can
// be zero). You may also provide a pointer to a default event handler
// and an error to string mapping routine.
//
// For a description of the event table format and semantics, see "Event Table" above.
// For a description of the class table format and semantics, see "Class Table" above.
//
// Note that there is no TermMoreOSL routine. This module assumes that you
// will initialise it at the beginning of your application and that the termination
// will be done by the Process Manager when the application quits. Further note
// that this routine expects that, if InitMoreOSL fails, your application will
// refuses to launch.
//
// The only likely failures are:
//
// o insufficient system sofware -- The routine checks for the presence of
// a good ObjectSupportLib and returns an error gracefully without modifying
// any state if this check fails. Your application may then choose to revert
// to its non-scripting Apple event support.
//
// o insufficient memory -- If the routine runs out of memory during the initialisation
// process, it makes no attempt to clean up gracefully.
#ifdef __cplusplus
}
#endif
</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/MoreIsBetter/listing149.html%3Fid%3DDTS10000732-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/MoreIsBetter/listing149.html%3Fid%3DDTS10000732-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/MoreIsBetter/listing149.html%3Fid%3DDTS10000732-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>