-
Notifications
You must be signed in to change notification settings - Fork 1
/
stlsoft.h
2794 lines (2446 loc) · 109 KB
/
stlsoft.h
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
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/* /////////////////////////////////////////////////////////////////////////
* File: stlsoft/stlsoft.h
*
* Purpose: Root header for the STLSoft libraries. Performs various
* compiler and platform discriminations, and definitions of
* types.
*
* Created: 15th January 2002
* Updated: 7th May 2009
*
* Home: http://stlsoft.org/
*
* Copyright (c) 2002-2009, Matthew Wilson and Synesis Software
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* - Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* - Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* - Neither the name(s) of Matthew Wilson and Synesis Software nor the
* names of any contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
* IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* ////////////////////////////////////////////////////////////////////// */
#ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT
#define STLSOFT_INCL_STLSOFT_H_STLSOFT
#define STLSOFT_INCL_H_STLSOFT /*!< \brief Definition of previous include-guard symbol for stlsoft/stlsoft.h, for backwards compatibility. */
#if defined(__STLSOFT_DOCUMENTATION_SKIP_SECTION) && \
!defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
# define STLSOFT_DOCUMENTATION_SKIP_SECTION
#endif /* STLSOFT_DOCUMENTATION_SKIP_SECTION? */
/* File version */
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
# define STLSOFT_VER_STLSOFT_H_STLSOFT_MAJOR 3
# define STLSOFT_VER_STLSOFT_H_STLSOFT_MINOR 21
# define STLSOFT_VER_STLSOFT_H_STLSOFT_REVISION 1
# define STLSOFT_VER_STLSOFT_H_STLSOFT_EDIT 386
#else /* ? STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* # include "./internal/doxygen_defs.h" */
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
/** \file stlsoft/stlsoft.h
*
* \brief [C, C++] The root header for the
* \ref group__project__stlsoft "STLSoft" project, and for all other
* \ref group__projects "projects".
*/
/* /////////////////////////////////////////////////////////////////////////
* STLSoft version
*
* The libraries version information is comprised of major, minor and
* revision components.
*
* Each release of the libraries will bear a different version, and that
* version will also have its own symbol: Version 1.0.1 specifies
* _STLSOFT_VER_1_0_1.
*
* Thus the symbol _STLSOFT_VER may be compared meaningfully with a specific
* version symbol, e.g.# if _STLSOFT_VER >= _STLSOFT_VER_1_0_1
*/
/** \def _STLSOFT_VER_MAJOR
* \brief The major version number of STLSoft
*
* A change to the major version component implies that a dramatic change
* has occurred in the libraries, such that considerable changes to source
* dependent on previous versions would need to be effected.
*/
/** \def _STLSOFT_VER_MINOR
* \brief The minor version number of STLSoft
*
* A change to the minor version component imply that a significant change
* has occurred to the libraries, either in the addition of new functionality
* or in the destructive change to one or more components such that
* recompilation and code change may be necessitated.
*/
/** \def _STLSOFT_VER_REVISION
* \brief The revision version number of STLSoft
*
* A change to the revision version component imply that a bug has been
* fixed. Dependent code should be recompiled in order to pick up the
* changes.
*/
/** \def _STLSOFT_VER
* \brief The current composite version number of STLSoft
*
* In addition to the individual version symbols - _STLSOFT_VER_MAJOR,
* _STLSOFT_VER_MINOR and _STLSOFT_VER_REVISION - a composite symbol
* _STLSOFT_VER is defined, where:
* - bits 24-31: the major version
* - bits 16-23: the minor version
* - bits 8-15: the revision version
* - bits 0-7: the beta number; if not a beta, it is 0xFF
*/
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
# define _STLSOFT_VER_1_0_1 0x00010001 /*!< Version 1.0.1 */
# define _STLSOFT_VER_1_0_2 0x00010002 /*!< Version 1.0.2 */
# define _STLSOFT_VER_1_1_1 0x00010101 /*!< Version 1.1.1 */
# define _STLSOFT_VER_1_1_2 0x00010102 /*!< Version 1.1.2 */
# define _STLSOFT_VER_1_1_3 0x00010103 /*!< Version 1.1.3 */
# define _STLSOFT_VER_1_2_1 0x00010201 /*!< Version 1.2.1 */
# define _STLSOFT_VER_1_3_1 0x00010301 /*!< Version 1.3.1 */
# define _STLSOFT_VER_1_3_2 0x00010302 /*!< Version 1.3.2 */
# define _STLSOFT_VER_1_4_1 0x00010401 /*!< Version 1.4.1 */
# define _STLSOFT_VER_1_4_2 0x00010402 /*!< Version 1.4.2 */
# define _STLSOFT_VER_1_4_3 0x00010403 /*!< Version 1.4.3 */
# define _STLSOFT_VER_1_4_4 0x00010404 /*!< Version 1.4.4 */
# define _STLSOFT_VER_1_4_5 0x00010405 /*!< Version 1.4.5 */
# define _STLSOFT_VER_1_4_6 0x00010406 /*!< Version 1.4.6 */
# define _STLSOFT_VER_1_5_1 0x00010501 /*!< Version 1.5.1 */
# define _STLSOFT_VER_1_5_2 0x00010502 /*!< Version 1.5.2 */
# define _STLSOFT_VER_1_6_1 0x00010601 /*!< Version 1.6.1 */
# define _STLSOFT_VER_1_6_2 0x00010602 /*!< Version 1.6.2 */
# define _STLSOFT_VER_1_6_3 0x00010603 /*!< Version 1.6.3 */
# define _STLSOFT_VER_1_6_4 0x00010604 /*!< Version 1.6.4 */
# define _STLSOFT_VER_1_6_5 0x00010605 /*!< Version 1.6.5 */
# define _STLSOFT_VER_1_6_6 0x00010606 /*!< Version 1.6.6 */
# define _STLSOFT_VER_1_7_1 0x00010701 /*!< Version 1.7.1 */
# define _STLSOFT_VER_1_7_2 0x00010702 /*!< Version 1.7.2 */
# define _STLSOFT_VER_1_8_1 0x00010801 /*!< Version 1.8.1 */
# define _STLSOFT_VER_1_8_2 0x00010802 /*!< Version 1.8.2 */
# define _STLSOFT_VER_1_8_3 0x00010803 /*!< Version 1.8.3 */
# define _STLSOFT_VER_1_8_4 0x00010804 /*!< Version 1.8.4 */
# define _STLSOFT_VER_1_8_5 0x00010805 /*!< Version 1.8.5 */
# define _STLSOFT_VER_1_8_6 0x00010806 /*!< Version 1.8.6 */
# define _STLSOFT_VER_1_8_7 0x00010807 /*!< Version 1.8.7 */
# define _STLSOFT_VER_1_8_8 0x00010808 /*!< Version 1.8.8 */
# define _STLSOFT_VER_1_8_9 0x00010809 /*!< Version 1.8.9 */
# define _STLSOFT_VER_1_9_1_B13 0x0109010d /*!< Version 1.9.1 beta 13 (10th Jul 2006) */
# define _STLSOFT_VER_1_9_1_B20 0x01090114 /*!< Version 1.9.1 beta 20 (28th Aug 2006) */
# define _STLSOFT_VER_1_9_1_B22 0x01090116 /*!< Version 1.9.1 beta 22 (13th Sep 2006) */
# define _STLSOFT_VER_1_9_1_B28 0x0109011c /*!< Version 1.9.1 beta 28 (29th Oct 2006) */
# define _STLSOFT_VER_1_9_1_B29 0x0109011d /*!< Version 1.9.1 beta 29 (27th Nov 2006) */
# define _STLSOFT_VER_1_9_1_B33 0x01090121 /*!< Version 1.9.1 beta 33 (13th Dec 2006) */
# define _STLSOFT_VER_1_9_1_B34 0x01090122 /*!< Version 1.9.1 beta 34 (24th Dec 2006) */
# define _STLSOFT_VER_1_9_1_B37 0x01090125 /*!< Version 1.9.1 beta 37 (30th Dec 2006) */
# define _STLSOFT_VER_1_9_1_B40 0x01090128 /*!< Version 1.9.1 beta 40 (6th Jan 2007) */
# define _STLSOFT_VER_1_9_1_B41 0x01090129 /*!< Version 1.9.1 beta 41 (14th Jan 2007) */
# define _STLSOFT_VER_1_9_1_B42 0x0109012a /*!< Version 1.9.1 beta 42 (15th Jan 2007) */
# define _STLSOFT_VER_1_9_1_B45 0x0109012d /*!< Version 1.9.1 beta 45 (1st Mar 2007) */
# define _STLSOFT_VER_1_9_1_B47 0x0109012f /*!< Version 1.9.1 beta 47 (6th Apr 2007) */
# define _STLSOFT_VER_1_9_1_B48 0x01090130 /*!< Version 1.9.1 beta 48 (12th Apr 2007) */
# define _STLSOFT_VER_1_9_1 0x010901ff /*!< Version 1.9.1 (30th Apr 2007) */
# define _STLSOFT_VER_1_9_2 0x010902ff /*!< Version 1.9.2 (2nd Jun 2007) */
# define _STLSOFT_VER_1_9_3 0x010903ff /*!< Version 1.9.3 (29th Jul 2007) */
# define _STLSOFT_VER_1_9_4 0x010904ff /*!< Version 1.9.4 (2nd Aug 2007) */
# define _STLSOFT_VER_1_9_5 0x010905ff /*!< Version 1.9.5 (4th Aug 2007) */
# define _STLSOFT_VER_1_9_6 0x010906ff /*!< Version 1.9.6 (6th Aug 2007) */
# define _STLSOFT_VER_1_9_7 0x010907ff /*!< Version 1.9.7 (16th Nov 2007) */
# define _STLSOFT_VER_1_9_8 0x010908ff /*!< Version 1.9.8 (18th Nov 2007) */
# define _STLSOFT_VER_1_9_9 0x010909ff /*!< Version 1.9.9 (19th Nov 2007) */
# define _STLSOFT_VER_1_9_10 0x01090aff /*!< Version 1.9.10 (10th Dec 2007) */
# define _STLSOFT_VER_1_9_11 0x01090bff /*!< Version 1.9.11 (17th Dec 2007) */
# define _STLSOFT_VER_1_9_12 0x01090cff /*!< Version 1.9.12 (19th Dec 2007) */
# define _STLSOFT_VER_1_9_13 0x01090dff /*!< Version 1.9.13 (20th Dec 2007) */
# define _STLSOFT_VER_1_9_14 0x01090eff /*!< Version 1.9.14 (23rd Dec 2007) */
# define _STLSOFT_VER_1_9_15 0x01090fff /*!< Version 1.9.15 (24th Dec 2007) */
# define _STLSOFT_VER_1_9_16 0x010910ff /*!< Version 1.9.16 (29th Dec 2007) */
# define _STLSOFT_VER_1_9_17 0x010911ff /*!< Version 1.9.17 (5th Jan 2008) */
# define _STLSOFT_VER_1_9_18 0x010912ff /*!< Version 1.9.18 (27th Jan 2008) */
# define _STLSOFT_VER_1_9_19 0x010913ff /*!< Version 1.9.19 (2nd Feb 2008) */
# define _STLSOFT_VER_1_9_20 0x010914ff /*!< Version 1.9.20 (3rd Feb 2008) */
# define _STLSOFT_VER_1_9_21 0x010915ff /*!< Version 1.9.21 (5th Feb 2008) */
# define _STLSOFT_VER_1_9_22 0x010916ff /*!< Version 1.9.22 (8th Feb 2008) */
# define _STLSOFT_VER_1_9_23 0x010917ff /*!< Version 1.9.23 (21st Feb 2008) */
# define _STLSOFT_VER_1_9_24 0x010918ff /*!< Version 1.9.24 (8th Mar 2008) */
# define _STLSOFT_VER_1_9_25 0x010919ff /*!< Version 1.9.25 (9th Mar 2008) */
# define _STLSOFT_VER_1_9_26 0x01091aff /*!< Version 1.9.26 (15th Mar 2008) */
# define _STLSOFT_VER_1_9_27 0x01091bff /*!< Version 1.9.27 (17th Mar 2008) */
# define _STLSOFT_VER_1_9_28 0x01091cff /*!< Version 1.9.28 (24th Mar 2008) */
# define _STLSOFT_VER_1_9_29 0x01091dff /*!< Version 1.9.29 (3rd Apr 2008) */
# define _STLSOFT_VER_1_9_30 0x01091eff /*!< Version 1.9.30 (3rd Apr 2008) */
# define _STLSOFT_VER_1_9_31 0x01091fff /*!< Version 1.9.31 (13th Apr 2008) */
# define _STLSOFT_VER_1_9_32 0x010920ff /*!< Version 1.9.32 (22nd Apr 2008) */
# define _STLSOFT_VER_1_9_33 0x010921ff /*!< Version 1.9.33 (24th Apr 2008) */
# define _STLSOFT_VER_1_9_34 0x010922ff /*!< Version 1.9.34 (25th Apr 2008) */
# define _STLSOFT_VER_1_9_35 0x010923ff /*!< Version 1.9.35 (29th Apr 2008) */
# define _STLSOFT_VER_1_9_36 0x010924ff /*!< Version 1.9.36 (30th Apr 2008) */
# define _STLSOFT_VER_1_9_37 0x010925ff /*!< Version 1.9.37 (3rd May 2008) */
# define _STLSOFT_VER_1_9_38 0x010926ff /*!< Version 1.9.38 (4th May 2008) */
# define _STLSOFT_VER_1_9_39 0x010927ff /*!< Version 1.9.39 (10th May 2008) */
# define _STLSOFT_VER_1_9_40 0x010928ff /*!< Version 1.9.40 (13th May 2008) */
# define _STLSOFT_VER_1_9_41 0x010929ff /*!< Version 1.9.41 (14th May 2008) */
# define _STLSOFT_VER_1_9_42 0x01092aff /*!< Version 1.9.42 (17th May 2008) */
# define _STLSOFT_VER_1_9_43 0x01092bff /*!< Version 1.9.43 (31st May 2008) */
# define _STLSOFT_VER_1_9_44 0x01092cff /*!< Version 1.9.44 (1st Jun 2008) */
# define _STLSOFT_VER_1_9_45 0x01092dff /*!< Version 1.9.45 (8th Jun 2008) */
# define _STLSOFT_VER_1_9_46 0x01092eff /*!< Version 1.9.46 (11th Aug 2008) */
# define _STLSOFT_VER_1_9_48 0x010930ff /*!< Version 1.9.48 (23rd Aug 2008) */
# define _STLSOFT_VER_1_9_49 0x010931ff /*!< Version 1.9.49 (2nd Sep 2008) */
# define _STLSOFT_VER_1_9_50 0x010932ff /*!< Version 1.9.50 (3rd Sep 2008) */
# define _STLSOFT_VER_1_9_51 0x010933ff /*!< Version 1.9.51 (6th Sep 2008) */
# define _STLSOFT_VER_1_9_52 0x010934ff /*!< Version 1.9.52 (11th Sep 2008) */
# define _STLSOFT_VER_1_9_53 0x010935ff /*!< Version 1.9.53 (15th Sep 2008) */
# define _STLSOFT_VER_1_9_54 0x010936ff /*!< Version 1.9.54 (15th Sep 2008) */
# define _STLSOFT_VER_1_9_55 0x010937ff /*!< Version 1.9.55 (23rd Sep 2008) */
# define _STLSOFT_VER_1_9_56 0x010938ff /*!< Version 1.9.56 (1st Oct 2008) */
# define _STLSOFT_VER_1_9_57 0x010939ff /*!< Version 1.9.57 (10th Oct 2008) */
# define _STLSOFT_VER_1_9_58 0x01093aff /*!< Version 1.9.58 (15th Oct 2008) */
# define _STLSOFT_VER_1_9_59 0x01093bff /*!< Version 1.9.59 (24th Oct 2008) */
# define _STLSOFT_VER_1_9_60 0x01093cff /*!< Version 1.9.60 (27th Oct 2008) */
# define _STLSOFT_VER_1_9_62 0x01093eff /*!< Version 1.9.62 (1st Dec 2008) */
# define _STLSOFT_VER_1_9_63 0x01093fff /*!< Version 1.9.63 (9th Dec 2008) */
# define _STLSOFT_VER_1_9_64 0x010940ff /*!< Version 1.9.64 (28th Dec 2008) */
# define _STLSOFT_VER_1_9_65 0x010941ff /*!< Version 1.9.65 (1st Jan 2009) */
# define _STLSOFT_VER_1_9_66 0x010942ff /*!< Version 1.9.66 (4th Jan 2009) */
# define _STLSOFT_VER_1_9_67 0x010943ff /*!< Version 1.9.67 (17th Jan 2009) */
# define _STLSOFT_VER_1_9_68 0x010944ff /*!< Version 1.9.68 (18th Jan 2009) */
# define _STLSOFT_VER_1_9_69 0x010945ff /*!< Version 1.9.69 (23rd Jan 2009) */
# define _STLSOFT_VER_1_9_70 0x010946ff /*!< Version 1.9.70 (24th Jan 2009) */
# define _STLSOFT_VER_1_9_71 0x010947ff /*!< Version 1.9.71 (28th Jan 2009) */
# define _STLSOFT_VER_1_9_72 0x010948ff /*!< Version 1.9.72 (1st Feb 2009) */
# define _STLSOFT_VER_1_9_73 0x010949ff /*!< Version 1.9.73 (5th Feb 2009) */
# define _STLSOFT_VER_1_9_74 0x01094aff /*!< Version 1.9.74 (6th Feb 2009) */
# define _STLSOFT_VER_1_9_75 0x01094bff /*!< Version 1.9.75 (24th Feb 2009) */
# define _STLSOFT_VER_1_9_76 0x01094cff /*!< Version 1.9.76 (6th Mar 2009) */
# define _STLSOFT_VER_1_9_77 0x01094dff /*!< Version 1.9.77 (9th Mar 2009) */
# define _STLSOFT_VER_1_9_78 0x01094eff /*!< Version 1.9.78 (27th Apr 2009) */
# define _STLSOFT_VER_1_9_79 0x01094fff /*!< Version 1.9.79 (2nd May 2009) */
# define _STLSOFT_VER_1_9_80 0x010950ff /*!< Version 1.9.80 (5th May 2009) */
# define _STLSOFT_VER_1_9_81 0x010951ff /*!< Version 1.9.81 (??? May 2009) */
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
#define _STLSOFT_VER_MAJOR 1
#define _STLSOFT_VER_MINOR 9
#define _STLSOFT_VER_REVISION 81
#define _STLSOFT_VER _STLSOFT_VER_1_9_81
/* /////////////////////////////////////////////////////////////////////////
* Basic macros
*/
/* Compilation messages
*
* To see certain informational messages during compilation define the
* preprocessor symbol _STLSOFT_COMPILE_VERBOSE
*/
#ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
# define STLSOFT_STRINGIZE_a_(x) #x
# define STLSOFT_STRINGIZE_a(x) STLSOFT_STRINGIZE_a_(x)
# if defined(__BORLANDC__) || \
defined(__SUNPRO_C)
# define STLSOFT_STRINGIZE_w_(x) L"" ## STLSOFT_STRINGIZE_a(x)
# else /* ? compiler */
# define STLSOFT_STRINGIZE_w_(x) L ## #x
# endif /* compiler */
# define STLSOFT_STRINGIZE_w(x) STLSOFT_STRINGIZE_w_(x)
# define STLSOFT_STRINGIZE(x) STLSOFT_STRINGIZE_a(x)
/* Simple macro indirection */
# define STLSOFT_MACRO_INDIRECT(x) x
/* Token pasting */
# define STLSOFT_PP_PASTE_2_TOKENS(t1, t2) t1 ## t2
# define STLSOFT_PP_PASTE_3_TOKENS(t1, t2, t3) t1 ## t2 ## t3
#endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* /////////////////////////////////////////////////////////////////////////
* Sanity checks - 1
*/
/* /////////////////////////////////////////////////////////////////////////
* Compiler compatibility
*
* Currently the only compilers supported by the STLSoft libraries are
*
* Borland C++ 5.5, 5.51, 5.6 & 5.6.4
* Comeau 4.3.0.1 & 4.3.3
* Digital Mars C/C++ 8.26 and above
* GCC 2.95, 2.96, 3.2, 3.3, 3.4 & 4.0
* Intel C/C++ 6.0, 7.0, 7.1, 8.0, 9.0
* Metrowerks 2.4 & 3.0 (CodeWarrior 7.0 & 8.0)
* SunPro 5.9
* Visual C++ 4.2, 5.0, 6.0, 7.0 (.NET), 7.1 (.NET 2003), 8.0
* Watcom C/C++ 11.0, Open Watcom 1.0, 1.1, 1.2, 1.3, 1.4, 1.5
*/
#ifdef STLSOFT_COMPILER_IS_UNKNOWN
# undef STLSOFT_COMPILER_IS_UNKNOWN
#endif /* STLSOFT_COMPILER_IS_UNKNOWN */
#ifdef STLSOFT_COMPILER_IS_BORLAND
# undef STLSOFT_COMPILER_IS_BORLAND
#endif /* STLSOFT_COMPILER_IS_BORLAND */
#ifdef STLSOFT_COMPILER_IS_COMO
# undef STLSOFT_COMPILER_IS_COMO
#endif /* STLSOFT_COMPILER_IS_COMO */
#ifdef STLSOFT_COMPILER_IS_DMC
# undef STLSOFT_COMPILER_IS_DMC
#endif /* STLSOFT_COMPILER_IS_DMC */
#ifdef STLSOFT_COMPILER_IS_GCC
# undef STLSOFT_COMPILER_IS_GCC
#endif /* STLSOFT_COMPILER_IS_GCC */
#ifdef STLSOFT_COMPILER_IS_INTEL
# undef STLSOFT_COMPILER_IS_INTEL
#endif /* STLSOFT_COMPILER_IS_INTEL */
#ifdef STLSOFT_COMPILER_IS_MSVC
# undef STLSOFT_COMPILER_IS_MSVC
#endif /* STLSOFT_COMPILER_IS_MSVC */
#ifdef STLSOFT_COMPILER_IS_MWERKS
# undef STLSOFT_COMPILER_IS_MWERKS
#endif /* STLSOFT_COMPILER_IS_MWERKS */
#ifdef STLSOFT_COMPILER_IS_SUNPRO
# undef STLSOFT_COMPILER_IS_SUNPRO
#endif /* STLSOFT_COMPILER_IS_SUNPRO */
#ifdef STLSOFT_COMPILER_IS_VECTORC
# undef STLSOFT_COMPILER_IS_VECTORC
#endif /* STLSOFT_COMPILER_IS_VECTORC */
#ifdef STLSOFT_COMPILER_IS_WATCOM
# undef STLSOFT_COMPILER_IS_WATCOM
#endif /* STLSOFT_COMPILER_IS_WATCOM */
/* Strict compability fix
*/
#if defined(_STLSOFT_STRICT) && \
!defined(STLSOFT_STRICT)
# define STLSOFT_STRICT
#endif /* _STLSOFT_STRICT && !STLSOFT_STRICT */
/* First we do a check to see whether other compilers are providing
* compatibility with Visual C++, and handle that.
*/
#ifdef _MSC_VER
# if defined(__BORLANDC__) || /* Borland */ \
defined(__COMO__) || /* Comeau */ \
defined(__DMC__) || /* Digital Mars */ \
defined(__GNUC__) || /* GNU */ \
defined(__INTEL_COMPILER) || /* Intel */ \
defined(__MWERKS__) || /* Metrowerks */ \
defined(__SUNPRO_C) || /* Sun Pro C */ \
defined(__SUNPRO_CC) || /* Sun Pro C++ */ \
defined(__VECTORC) || /* VectorC */ \
defined(__WATCOMC__) /* Watcom */
/* Handle Microsoft Visual C++ support. */
# if defined(_STLSOFT_NO_MSC_VER_SUPPORT) || \
( defined(STLSOFT_STRICT) && \
!defined(_STLSOFT_MSC_VER_SUPPORT))
# undef _MSC_VER
# endif /* _STLSOFT_NO_MSC_VER_SUPPORT || (STLSOFT_STRICT && _STLSOFT_MSC_VER_SUPPORT) */
# endif /* compiler */
#endif /* _MSC_VER */
#if defined(_STLSOFT_FORCE_CUSTOM_COMPILER)
# define STLSOFT_COMPILER_LABEL_STRING "Custom (forced) compiler"
# define STLSOFT_COMPILER_VERSION_STRING "Custom (forced) compiler"
# define STLSOFT_COMPILER_IS_CUSTOM
# ifndef __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME
# error When using the custom compiler option you must define the symbol __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME, e.g. #define __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME <stlsoft/internal/cccap/my_compiler.h>
# endif /* !__STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME */
#elif defined(__COMO__) /* Do Comeau next, so that no Comeau back-end server compilers are preferentially discriminated */
/* ******************************* Comeau ****************************** */
# define STLSOFT_COMPILER_IS_COMO
# define STLSOFT_COMPILER_LABEL_STRING "Comeau C++"
# if __COMO_VERSION__ < 4300
# error Only versions 4.3.0.1 and later of Comeau C++ compiler is supported by the STLSoft libraries
# elif (__COMO_VERSION__ == 4300)
# define STLSOFT_COMPILER_VERSION_STRING "Comeau C++ 4.3.0.1"
# elif (__COMO_VERSION__ == 4303)
# define STLSOFT_COMPILER_VERSION_STRING "Comeau C++ 4.3.3"
# else /* ? __COMO_VERSION__ */
# define STLSOFT_COMPILER_VERSION_STRING "Unknown version of Comeau C++"
# endif /* __COMO_VERSION__ */
#elif defined(__BORLANDC__)
/* ******************************* Borland ***************************** */
# define STLSOFT_COMPILER_IS_BORLAND
# define STLSOFT_COMPILER_LABEL_STRING "Borland C/C++"
# if 0 /* (__BORLANDC__ == 0x0460) */
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 4.52"
# elif 0 /* (__BORLANDC__ == 0x0550) */
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.5"
# elif (__BORLANDC__ == 0x0551)
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.51"
# elif (__BORLANDC__ == 0x0560)
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.6"
# elif (__BORLANDC__ == 0x0564)
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.6.4 (C++ BuilderX)"
# elif (__BORLANDC__ == 0x0582)
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.82 (Turbo C++)"
# elif (0x0590 == (__BORLANDC__ & 0xfff0))
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 5.9.x"
# elif (0x0610 == (__BORLANDC__ & 0xfff0))
# define STLSOFT_COMPILER_VERSION_STRING "Borland C++ 6.1.x (C++ Builder)"
# else /* ? __BORLANDC__ */
# error Currently only versions 5.51, 5.6, 5.6.4, 5.8.2, 5.9.x, and 6.1.x of the Borland C++ compiler are supported by the STLSoft libraries
# endif /* __BORLANDC__ */
#elif defined(__DMC__)
/* **************************** Digital Mars *************************** */
# define STLSOFT_COMPILER_IS_DMC
# define STLSOFT_COMPILER_LABEL_STRING "Digital Mars C/C++"
# if (__DMC__ < 0x0826)
# error Only versions 8.26 and later of the Digital Mars C/C++ compilers are supported by the STLSoft libraries
# else /* ? __DMC__ */
# if __DMC__ >= 0x0832
# define STLSOFT_COMPILER_VERSION_STRING __DMC_VERSION_STRING__
# elif (__DMC__ == 0x0826)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.26"
# elif (__DMC__ == 0x0827)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.27"
# elif (__DMC__ == 0x0828)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.28"
# elif (__DMC__ == 0x0829)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.29"
# elif (__DMC__ == 0x0830)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.30"
# elif (__DMC__ == 0x0831)
# define STLSOFT_COMPILER_VERSION_STRING "Digital Mars C/C++ 8.31"
# endif /* __DMC__ */
# endif /* version */
#elif defined(__GNUC__)
/* ******************************** GCC ******************************** */
# define STLSOFT_COMPILER_IS_GCC
# define STLSOFT_COMPILER_LABEL_STRING "GNU C/C++"
# if __GNUC__ != 2 && \
__GNUC__ != 3 && \
__GNUC__ != 4
# error GNU C/C++ compilers whose major version is not 2, 3 or 4 are not currently supported by the STLSoft libraries
# elif __GNUC__ == 2
# if __GNUC_MINOR__ < 95
# error Currently only version 2.95 and above of the GNU C/C++ compiler is supported by the STLSoft libraries
# elif __GNUC_MINOR__ == 95
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 2.95"
# elif __GNUC_MINOR__ == 96
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 2.96"
# else /* ? __GNUC_MINOR__ */
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ >2.96 - you should be aware that this version may not be supported correctly"
# endif /* __GNUC_MINOR__ */
# elif __GNUC__ == 3
# if __GNUC_MINOR__ == 2
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 3.2"
# elif __GNUC_MINOR__ == 3
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 3.3"
# elif __GNUC_MINOR__ == 4
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 3.4"
# else /* ? __GNUC_MINOR__ */
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ >3.4 - you should be aware that this version may not be supported correctly"
# endif /* __GNUC_MINOR__ */
# elif __GNUC__ == 0
# if __GNUC_MINOR__ == 0
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ 4.0"
# else /* ? __GNUC_MINOR__ */
# define STLSOFT_COMPILER_VERSION_STRING "GNU C/C++ >4.0 - you should be aware that this version may not be supported correctly"
# endif /* __GNUC__ */
# endif /* __GNUC_MINOR__ */
#elif defined(__INTEL_COMPILER)
/* ******************************* Intel ******************************* */
# define STLSOFT_COMPILER_IS_INTEL
# define STLSOFT_COMPILER_LABEL_STRING "Intel C/C++"
# if (__INTEL_COMPILER == 600)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 6.0"
# elif (__INTEL_COMPILER == 700)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 7.0"
# elif (__INTEL_COMPILER == 800)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 8.0"
# elif (__INTEL_COMPILER == 900)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 9.0"
# elif (__INTEL_COMPILER == 1000)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 10.0"
# elif (__INTEL_COMPILER == 1100)
# define STLSOFT_COMPILER_VERSION_STRING "Intel C/C++ 11.0"
# else /* ? __INTEL_COMPILER */
# error Only Intel C++ Compiler versions 6.0, 7.0(/7.1), 8.0, 9.0, 10.0 and 11.0 currently supported by the STLSoft libraries
# endif /* __INTEL_COMPILER */
#elif defined(__MWERKS__)
/* ***************************** Metrowerks **************************** */
# define STLSOFT_COMPILER_IS_MWERKS
# define STLSOFT_COMPILER_LABEL_STRING "Metrowerks CodeWarrior C/C++"
# if ((__MWERKS__ & 0xFF00) == 0x2400)
# define STLSOFT_COMPILER_VERSION_STRING "Metrowerks CodeWarrior C/C++ 2.4"
# elif ((__MWERKS__ & 0xFF00) == 0x3000)
# define STLSOFT_COMPILER_VERSION_STRING "Metrowerks CodeWarrior C/C++ 3.0"
# elif ((__MWERKS__ & 0xFF00) == 0x3200)
# define STLSOFT_COMPILER_VERSION_STRING "Metrowerks CodeWarrior C/C++ 3.2"
# else /* ? __MWERKS__ */
# error Only Metrowerks C++ Compiler 2.4 (CodeWarrior 7), 3.0 (CodeWarrior 8) and 3.2 (CodeWarrior 9) currently supported by the STLSoft libraries
# endif /* __MWERKS__ */
#elif defined(__SUNPRO_C) || \
defined(__SUNPRO_CC)
/* ******************************* Sun Pro ***************************** */
/* Sanity check on language/compiler */
# ifdef __cplusplus
# ifdef __SUNPRO_C
# error __SUNPRO_C should not be defined by the Sun C compiler in C++ compilation
# endif /* __SUNPRO_C */
# ifndef __SUNPRO_CC
# error __SUNPRO_CC should be defined by the Sun C++ compiler in C++ compilation
# endif /* !__SUNPRO_CC */
# else /* ? __cplusplus */
# ifndef __SUNPRO_C
# error __SUNPRO_C should be defined by the Sun C compiler in C compilation
# endif /* !__SUNPRO_C */
# ifdef __SUNPRO_CC
# error __SUNPRO_CC should not be defined by the Sun C++ compiler in C compilation
# endif /* __SUNPRO_CC */
# endif /* __cplusplus */
# define STLSOFT_COMPILER_IS_SUNPRO
# ifdef __cplusplus
# define STLSOFT_COMPILER_LABEL_STRING "Sun Pro C++"
# if (0x0590 == (__SUNPRO_CC & 0xFFF0))
# define STLSOFT_COMPILER_VERSION_STRING "Sun Pro C++ v5.9"
# else /* ? __SUNPRO_CC */
# error Currently only version v5.9 of the Sun Pro C++ compiler is supported by the STLSoft libraries
# endif /* __SUNPRO_CC */
# else /* ? __cplusplus */
# define STLSOFT_COMPILER_LABEL_STRING "Sun Pro C"
# if (0x0590 == (__SUNPRO_C & 0xFFF0))
# define STLSOFT_COMPILER_VERSION_STRING "Sun Pro C v5.9"
# else /* ? __SUNPRO_CC */
# error Currently only version v5.9 of the Sun Pro C compiler is supported by the STLSoft libraries
# endif /* __SUNPRO_CC */
# endif /* __cplusplus */
#elif defined(__VECTORC)
/* ************************** CodePlay VectorC ************************* */
# define STLSOFT_COMPILER_IS_VECTORC
# define STLSOFT_COMPILER_LABEL_STRING "CodePlay VectorC C/C++"
# if (__VECTORC == 1)
# define STLSOFT_COMPILER_VERSION_STRING "CodePlay VectorC C/C++"
# else /* ? __VECTORC */
# error Currently only versions of the CodePlay Vector C/C++ compiler defining __VECTORC == 1 are supported by the STLSoft libraries
# endif /* __VECTORC */
#elif defined(__WATCOMC__)
/* ******************************* Watcom ****************************** */
# define STLSOFT_COMPILER_IS_WATCOM
# define STLSOFT_COMPILER_LABEL_STRING "Watcom C/C++"
# if (__WATCOMC__ == 1200)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.0"
# elif (__WATCOMC__ == 1210)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.1"
# elif (__WATCOMC__ == 1220)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.2"
# elif (__WATCOMC__ == 1230)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.3"
# elif (__WATCOMC__ == 1240)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.4"
# elif (__WATCOMC__ == 1250)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.5"
# elif (__WATCOMC__ == 1260)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.6"
# elif (__WATCOMC__ == 1270)
# define STLSOFT_COMPILER_VERSION_STRING "Open Watcom C/C++ 1.7"
# else /* ? __WATCOMC__ */
# error Currently only versions 1.0-1.7 of Open Watcom C/C++ are recognised by the STLSoft libraries
# endif /* __WATCOMC__ */
#elif defined(_MSC_VER)
/* ***************************** Visual C++ **************************** */
# define STLSOFT_COMPILER_IS_MSVC
# define STLSOFT_COMPILER_LABEL_STRING "Visual C++"
# if defined(STLSOFT_FORCE_MSVC_4_2) && (_MSC_VER == 1020)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 4.2"
# elif (_MSC_VER == 1100)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 5.0"
# elif (_MSC_VER == 1200)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 6.0"
# elif (_MSC_VER == 1300)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 7.0"
# elif (_MSC_VER == 1310)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 7.1"
# elif (_MSC_VER == 1400)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 8.0"
# elif (_MSC_VER == 1500)
# define STLSOFT_COMPILER_VERSION_STRING "Visual C++ 9.0"
# else /* ? _MSC_VER */
# error Currently only versions 5.0, 6.0, 7.0, 7.1, 8.0 and 9.0 of the Visual C++ compiler are supported by the STLSoft libraries
# endif /* _MSC_VER */
#else /* ? compiler */
/* ********************** No recognised compiler *********************** */
# if defined(_STLSOFT_FORCE_UNKNOWN_COMPILER) || \
defined(_STLSOFT_FORCE_ANY_COMPILER)
# define STLSOFT_COMPILER_LABEL_STRING "Unknown (forced) compiler"
# define STLSOFT_COMPILER_VERSION_STRING "Unknown (forced) compiler"
# define STLSOFT_COMPILER_IS_UNKNOWN
# else /* ? _STLSOFT_FORCE_UNKNOWN_COMPILER || _STLSOFT_FORCE_ANY_COMPILER */
# error Compiler is not recognised.
# error Currently only Borland C++, Comeau C++, Digital Mars C/C++, GNU C/C++,
# error Intel C/C++, Metrowerks CodeWarrior, Visual C++ and Watcom C/C++
# error compilers are supported by the STLSoft libraries
# error If you want to use the libraries with your compiler, you may specify the
# error _STLSOFT_FORCE_CUSTOM_COMPILER or _STLSOFT_FORCE_ANY_COMPILER pre-processor
# error symbols.
# error _STLSOFT_FORCE_ANY_COMPILER assumes that your compiler can support all
# error modern C++ compiler features, and causes the inclusion of the compiler
# error features file stlsoft/internal/cccap/unknown.h, which is provided by STLSoft.
# error _STLSOFT_FORCE_CUSTOM_COMPILER requires that you specify the name of the
# error compiler features file in __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME.
# error The idea is to use _STLSOFT_FORCE_ANY_COMPILER, to determine what language
# error features your compiler can support, and then copy, edit and use that file
# error via _STLSOFT_FORCE_CUSTOM_COMPILER and __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME.
# endif /* _STLSOFT_FORCE_ANY_COMPILER */
#endif /* compiler tag */
#ifdef STLSOFT_DOCUMENTATION_SKIP_SECTION
/** \def STLSOFT_COMPILER_LABEL_STRING
* \brief A nul-terminated C-style string denoting the name of the compiler.
*/
# define STLSOFT_COMPILER_LABEL_STRING "Acme Compiler"
/** \def STLSOFT_COMPILER_VERSION_STRING
* \brief A nul-terminated C-style string denoting the name and version of the compiler.
*/
# define STLSOFT_COMPILER_VERSION_STRING "Acme Compiler v1.0"
#else /* ? STLSOFT_DOCUMENTATION_SKIP_SECTION */
# define __STLSOFT_COMPILER_LABEL_STRING STLSOFT_COMPILER_LABEL_STRING
# define __STLSOFT_COMPILER_VERSION_STRING STLSOFT_COMPILER_VERSION_STRING
#endif /* STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* /////////////////////////////////////////////////////////////////////////
* Compiler language feature support
*
* Various compilers support the language differently (or not at all), so these
* features are discriminated here and utilised by various means within the code
* in order to minimise the use of the preprocessor conditionals in the other
* libraries' source code.
*/
#if defined(_STLSOFT_INCLUDE_UNDEFS) || \
( defined(STLSOFT_STRICT) && \
!defined(STLSOFT_NO_UNDEFS))
# include <stlsoft/internal/_undefs.h>
#endif /* _STLSOFT_INCLUDE_UNDEFS) || (STLSOFT_STRICT) && !STLSOFT_NO_UNDEFS) */
/* Now we include the appropriate compiler-specific header */
#if defined(STLSOFT_COMPILER_IS_CUSTOM)
# include __STLSOFT_CF_CUSTOM_COMPILER_INCLUDE_NAME
#elif defined(STLSOFT_COMPILER_IS_UNKNOWN)
# include <stlsoft/internal/cccap/unknown.h>
#elif defined(STLSOFT_COMPILER_IS_BORLAND)
# include <stlsoft/internal/cccap/borland.h>
#elif defined(STLSOFT_COMPILER_IS_COMO)
# include <stlsoft/internal/cccap/como.h>
#elif defined(STLSOFT_COMPILER_IS_DMC)
# include <stlsoft/internal/cccap/dmc.h>
#elif defined(STLSOFT_COMPILER_IS_GCC)
# include <stlsoft/internal/cccap/gcc.h>
#elif defined(STLSOFT_COMPILER_IS_INTEL)
# include <stlsoft/internal/cccap/intel.h>
#elif defined(STLSOFT_COMPILER_IS_MSVC)
# include <stlsoft/internal/cccap/msvc.h>
#elif defined(STLSOFT_COMPILER_IS_MWERKS)
# include <stlsoft/internal/cccap/mwerks.h>
#elif defined(STLSOFT_COMPILER_IS_SUNPRO)
# include <stlsoft/internal/cccap/sunpro.h>
#elif defined(STLSOFT_COMPILER_IS_VECTORC)
# include <stlsoft/internal/cccap/vectorc.h>
#elif defined(STLSOFT_COMPILER_IS_WATCOM)
# include <stlsoft/internal/cccap/watcom.h>
#else /* ? compiler */
# error Compiler not correctly discriminated
#endif /* compiler */
#if defined(_STLSOFT_COMPILE_VERBOSE) && \
!defined(STLSOFT_CF_PRAGMA_MESSAGE_SUPPORT)
# undef _STLSOFT_COMPILE_VERBOSE
#endif /* !STLSOFT_CF_PRAGMA_MESSAGE_SUPPORT && _STLSOFT_COMPILE_VERBOSE */
#if defined(STLSOFT_NO_COMPILE_VERBOSE) && \
defined(_STLSOFT_COMPILE_VERBOSE)
# undef _STLSOFT_COMPILE_VERBOSE
#endif /* STLSOFT_NO_COMPILE_VERBOSE && _STLSOFT_COMPILE_VERBOSE */
#ifdef _STLSOFT_COMPILE_VERBOSE
# pragma message(STLSOFT_COMPILER_VERSION_STRING)
#endif /* STLSOFT_CF_PRAGMA_MESSAGE_SUPPORT */
/* __FUNCTION__ support */
/** \def STLSOFT_FUNCTION_SYMBOL
*
* The symbol to be used where __FUNCTION__ may be used, taking into account
* any compiler-specific alternative forms
*
* \note Not defined if no appropriate symbol is available
*/
#if defined(STLSOFT_CF_FUNCTION_SYMBOL_SUPPORT)
# define STLSOFT_FUNCTION_SYMBOL __FUNCTION__
#elif defined(STLSOFT_CF_func_SYMBOL_SUPPORT)
# define STLSOFT_FUNCTION_SYMBOL __func__
#endif /* __FUNCTION__ or __func__ */
/* /////////////////////////////////////////////////////////////////////////
* Sanity checks - 2
*
* Must have the sizes of basic integral types defined
*/
#ifndef _STLSOFT_SIZEOF_CHAR
# error _STLSOFT_SIZEOF_CHAR not defined
#endif /* !_STLSOFT_SIZEOF_CHAR */
#ifndef _STLSOFT_SIZEOF_SHORT
# error _STLSOFT_SIZEOF_SHORT not defined
#endif /* !_STLSOFT_SIZEOF_SHORT */
#ifndef _STLSOFT_SIZEOF_INT
# error _STLSOFT_SIZEOF_INT not defined
#endif /* !_STLSOFT_SIZEOF_INT */
#ifndef _STLSOFT_SIZEOF_LONG
# error _STLSOFT_SIZEOF_LONG not defined
#endif /* !_STLSOFT_SIZEOF_LONG */
#ifdef STLSOFT_CF_BUILTIN_long_long_SUPPORT
# ifndef _STLSOFT_SIZEOF_LONG_LONG
# error _STLSOFT_SIZEOF_LONG_LONG not defined
# endif /* !_STLSOFT_SIZEOF_LONG_LONG */
#endif /* STLSOFT_CF_BUILTIN_long_long_SUPPORT */
/* /////////////////////////////////////////////////////////////////////////
* Sanity checks - 3
*
*/
/* Template support */
#if defined(__cplusplus) && \
!defined(STLSOFT_CF_TEMPLATE_SUPPORT)
# error Template support not detected. STLSoft libraries are template-based and require this support.
#endif /* STLSOFT_CF_TEMPLATE_SUPPORT */
/* Native 64-bit integer support */
#if !defined(STLSOFT_CF_64BIT_INT_SUPPORT) && \
( defined(STLSOFT_CF_64BIT_INT_IS___int64) || \
defined(STLSOFT_CF_64BIT_INT_IS_long_long))
# error Definition for 64-bit support is not correct. STLSOFT_CF_64BIT_INT_SUPPORT must be defined for 64-bit support
#endif /* !STLSOFT_CF_64BIT_INT_SUPPORT && (STLSOFT_CF_64BIT_INT_IS___int64 || STLSOFT_CF_64BIT_INT_IS_long_long) */
/* Out-of-memory throws bad_alloc.
*
* Discriminated symbol is STLSOFT_CF_NOTHROW_BAD_ALLOC
*
* By default, compilations with the Borland, and Watcom compilers throw
* bad_alloc in conditions of memory exhaustion, and those with Digital Mars
* and Microsoft do not.
*
* The Microsoft compilers do not throw bad_alloc for long established reasons,
* though they can be made to do so (see Matthew Wilson, "Generating
* Out-Of-Memory Exceptions", Windows Developer's Journal, Vol 12 Number 5, May
* 2001). This feature may be added in a forthcoming release of the libraries.
*
* The Digital Mars compiler appears to ship without any header files that
* define bad_alloc (whether in std or not), so it is therefore assumed that
* operator new will not throw exceptions in out of memory conditions.
*
* Define STLSOFT_CF_THROW_BAD_ALLOC to force Digital Mars/Microsoft to do so.
* Define STLSOFT_CF_NOTHROW_BAD_ALLOC to prevent Borland/Comeau/
* GCC/Metrowerks/Watcom from doing so.
*/
/* STLSOFT_CF_EXCEPTION_SUPPORT */
# if defined(__STLSOFT_CF_EXCEPTION_SUPPORT) && \
!defined(STLSOFT_CF_EXCEPTION_SUPPORT)
# error Configuration error: deprecated symbol __STLSOFT_CF_EXCEPTION_SUPPORT is defined when STLSOFT_CF_EXCEPTION_SUPPORT is not!
# else /* ? STLSOFT_CF_INT_DISTINCT_INT_TYPE */
# ifdef STLSOFT_CF_EXCEPTION_SUPPORT
# define __STLSOFT_CF_EXCEPTION_SUPPORT
# endif /* STLSOFT_CF_EXCEPTION_SUPPORT */
# endif /* STLSOFT_CF_EXCEPTION_SUPPORT */
/* STLSOFT_CF_EXCEPTION_SUPPORT */
# if defined(__STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT) && \
!defined(STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT)
# error Configuration error: deprecated symbol __STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT is defined when STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT is not!
# else /* ? STLSOFT_CF_INT_DISTINCT_INT_TYPE */
# ifdef STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT
# define __STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT
# endif /* STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT */
# endif /* STLSOFT_CF_EXCEPTION_SIGNATURE_SUPPORT */
#ifndef STLSOFT_CF_EXCEPTION_SUPPORT
/** \def STLSOFT_CF_NOTHROW_BAD_ALLOC
* \brief Define if you've overridden <code>operator new</code> to return
* <code>NULL</code> on allocation failure (which is non-standard
* behaviour).
*/
# define STLSOFT_CF_NOTHROW_BAD_ALLOC
#endif /* !STLSOFT_CF_EXCEPTION_SUPPORT */
#ifdef STLSOFT_CF_NOTHROW_BAD_ALLOC
# ifdef STLSOFT_CF_THROW_BAD_ALLOC
# undef STLSOFT_CF_THROW_BAD_ALLOC
# endif /* STLSOFT_CF_THROW_BAD_ALLOC */
#else /* ? STLSOFT_CF_NOTHROW_BAD_ALLOC */
/* Leave it to whatever the compiler's capability discrimination has determined */
#endif /* STLSOFT_CF_NOTHROW_BAD_ALLOC */
/* Template specialisation syntax support
*/
/** \def STLSOFT_TEMPLATE_SPECIALISATION
* \brief Resolves to <code>template <></code> for compilers that support correct
* template specialisation syntax, and to nothing for those that do not.
*/
#ifdef STLSOFT_TEMPLATE_SPECIALISATION
# undef STLSOFT_TEMPLATE_SPECIALISATION
#endif /* STLSOFT_TEMPLATE_SPECIALISATION */
#ifdef STLSOFT_CF_TEMPLATE_SPECIALISATION_SYNTAX
# define STLSOFT_TEMPLATE_SPECIALISATION template <>
#else /* ? STLSOFT_CF_TEMPLATE_SPECIALISATION_SYNTAX */
# define STLSOFT_TEMPLATE_SPECIALISATION
#endif /* STLSOFT_CF_TEMPLATE_SPECIALISATION_SYNTAX */
/* Keyword support.
*
* Define _STLSOFT_FORCE_ALL_KEYWORDS to force the assumption of compiler
* support for all keywords.
*
* Define _STLSOFT_FORCE_KEYWORD_EXPLICIT to force the assumption of compiler
* support for the explicit keyword
*
* Define _STLSOFT_FORCE_KEYWORD_MUTABLE to force the assumption of compiler
* support for the mutable keyword
*
* Define _STLSOFT_FORCE_KEYWORD_TYPENAME to force the assumption of compiler
* support for the typename keyword
*/
#ifdef _STLSOFT_FORCE_ALL_KEYWORDS
# define _STLSOFT_FORCE_KEYWORD_EXPLICIT
# define _STLSOFT_FORCE_KEYWORD_MUTABLE
# define _STLSOFT_FORCE_KEYWORD_TYPENAME
#endif /* _STLSOFT_FORCE_ALL_KEYWORDS */
#if !defined(STLSOFT_CF_EXPLICIT_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_EXPLICIT)
# define STLSOFT_CF_EXPLICIT_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_EXPLICIT_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_EXPLICIT */
#if !defined(STLSOFT_CF_MUTABLE_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_MUTABLE)
# define STLSOFT_CF_MUTABLE_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_MUTABLE_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_MUTABLE */
#if !defined(STLSOFT_CF_TYPENAME_PARAM_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_TYPENAME)
# define STLSOFT_CF_TYPENAME_PARAM_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_TYPENAME_PARAM_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_TYPENAME */
#if !defined(STLSOFT_CF_TYPENAME_TYPE_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_TYPENAME)
# define STLSOFT_CF_TYPENAME_TYPE_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_TYPENAME_TYPE_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_TYPENAME */
#if !defined(STLSOFT_CF_TYPENAME_TYPE_DEF_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_TYPENAME)
# define STLSOFT_CF_TYPENAME_TYPE_DEF_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_TYPENAME_TYPE_DEF_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_TYPENAME */
#if !defined(STLSOFT_CF_TYPENAME_TYPE_MIL_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_TYPENAME)
# define STLSOFT_CF_TYPENAME_TYPE_MIL_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_TYPENAME_TYPE_MIL_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_TYPENAME */
#if !defined(STLSOFT_CF_TYPENAME_TYPE_RET_KEYWORD_SUPPORT) && \
defined(_STLSOFT_FORCE_KEYWORD_TYPENAME)
# define STLSOFT_CF_TYPENAME_TYPE_RET_KEYWORD_SUPPORT
#endif /* !STLSOFT_CF_TYPENAME_TYPE_RET_KEYWORD_SUPPORT && _STLSOFT_FORCE_KEYWORD_TYPENAME */
/* /////////////////////////////////////////////////////////////////////////
* Calling convention
*/
/* Calling convention support symbols */
#ifdef STLSOFT_DOCUMENTATION_SKIP_SECTION
/** \def STLSOFT_CF_CDECL_SUPPORTED
* \brief When defined, indicates that the compiler supports the <b>cdecl</b> calling convention.
*/
# define STLSOFT_CF_CDECL_SUPPORTED
/** \def STLSOFT_CF_FASTCALL_SUPPORTED
* \brief When defined, indicates that the compiler supports the <b>fastcall</b> calling convention.
*/
# define STLSOFT_CF_FASTCALL_SUPPORTED
/** \def STLSOFT_CF_STDCALL_SUPPORTED
* \brief When defined, indicates that the compiler supports the <b>stdcall</b> calling convention.
*/
# define STLSOFT_CF_STDCALL_SUPPORTED
#endif /* STLSOFT_DOCUMENTATION_SKIP_SECTION */
/* Calling convention keyword abstraction */
/** \def STLSOFT_CDECL
* \brief Resolves to the <b>cdecl</b> keyword for the current compiler, or to nothing for compilers
* that do not support any calling conventions.
*/
#if !defined(STLSOFT_CDECL)
# define STLSOFT_CDECL
#endif /* !STLSOFT_CDECL */
/** \def STLSOFT_FASTCALL
* \brief Resolves to the <b>fastcall</b> keyword for the current compiler
*/
#if !defined(STLSOFT_FASTCALL)
# if defined(STLSOFT_CF_FASTCALL_SUPPORTED)
# error Compiler discrimination must define STLSOFT_FASTCALL if STLSOFT_CF_FASTCALL_SUPPORTED is defined
# else /* ? STLSOFT_CF_FASTCALL_SUPPORTED */
# define STLSOFT_FASTCALL
# endif /* STLSOFT_CF_FASTCALL_SUPPORTED */
#endif /* !STLSOFT_FASTCALL */
/** \def STLSOFT_STDCALL
* \brief Resolves to the <b>stdcall</b> keyword for the current compiler
*/
#if !defined(STLSOFT_STDCALL)
# if defined(STLSOFT_CF_STDCALL_SUPPORTED)
# error Compiler discrimination must define STLSOFT_STDCALL if STLSOFT_CF_STDCALL_SUPPORTED is defined
# else /* ? STLSOFT_CF_STDCALL_SUPPORTED */
# define STLSOFT_STDCALL
# endif /* STLSOFT_CF_STDCALL_SUPPORTED */
#endif /* !STLSOFT_STDCALL */
/* Calling convention facility values */
#if defined(STLSOFT_CF_CDECL_SUPPORTED)
# define STLSOFT_CDECL_VALUE (1) /*!< \brief A unique value indicating <b>cdecl</b> calling convention. */
#endif /* STLSOFT_CF_CDECL_SUPPORTED */
#if defined(STLSOFT_CF_FASTCALL_SUPPORTED)
# define STLSOFT_FASTCALL_VALUE (2) /*!< \brief A unique value indicating <b>fastcall</b> calling convention. */
#endif /* STLSOFT_CF_FASTCALL_SUPPORTED */
#if defined(STLSOFT_CF_STDCALL_SUPPORTED)
# define STLSOFT_STDCALL_VALUE (3) /*!< \brief A unique value indicating <b>stdcall</b> calling convention. */
#endif /* STLSOFT_CF_STDCALL_SUPPORTED */
/* /////////////////////////////////////////////////////////////////////////
* operator bool()
*
* If the symbol STLSOFT_CF_OPERATOR_BOOL_AS_OPERATOR_POINTER_TO_MEMBER_SUPPORT
* is defined, operator bool should be defined as follows: