mirror of
				https://github.com/boostorg/utility.git
				synced 2025-10-20 20:15:30 +02:00 
			
		
		
		
	Compare commits
	
		
			554 Commits
		
	
	
		
			svn-branch
			...
			sandbox-br
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
|  | 5ee30e2308 | ||
|  | 42e0001370 | ||
|  | cd8f85afee | ||
|  | bddd52c4b9 | ||
|  | 8f03aeac4e | ||
|  | 3bb2568fad | ||
|  | 01e91a3799 | ||
|  | 55f3c351a3 | ||
|  | 3f72b10182 | ||
|  | 71cb8cb574 | ||
|  | c950825ef4 | ||
|  | 66ca84a45d | ||
|  | 06404f7d39 | ||
|  | 2d860e2574 | ||
|  | 66514f61ff | ||
|  | 63cde4d3fd | ||
|  | 1950f292df | ||
|  | 92a0602190 | ||
|  | c9a3ab1d04 | ||
|  | 0782034333 | ||
|  | 0808883f3c | ||
|  | 2f69501e55 | ||
|  | 5b83f641a8 | ||
|  | c730ab4ffb | ||
|  | e55610a0d0 | ||
|  | bf968794c9 | ||
|  | ce6e9c6698 | ||
|  | 7ac180ed54 | ||
|  | 271ea9e901 | ||
|  | 7cd572a326 | ||
|  | 90c56ba2ce | ||
|  | a5439500f5 | ||
|  | c0f0a4f51d | ||
|  | 7594e00460 | ||
|  | f66e844ff1 | ||
|  | 62e8cc2b36 | ||
|  | 30236f8915 | ||
|  | 155e787ea3 | ||
|  | 1d60d49136 | ||
|  | 2dffdac9fe | ||
|  | ddf00eb29d | ||
|  | 0a6acd8ce8 | ||
|  | 745322e797 | ||
|  | 9f10fc03ce | ||
|  | 84fbb3c896 | ||
|  | 865c707756 | ||
|  | 871f3a6779 | ||
|  | aaca5ca871 | ||
|  | 5a4e19989f | ||
|  | 6ea398c446 | ||
|  | 1bd83d43e8 | ||
|  | 5ca5b4102b | ||
|  | aca7699046 | ||
|  | e702a944ca | ||
|  | a157c345ee | ||
|  | dcb2dd4736 | ||
|  | ae19cd6236 | ||
|  | 3ab4d38931 | ||
|  | 18c7fb72b5 | ||
|  | 6bb092a9b1 | ||
|  | f721b8b28c | ||
|  | e5ba34472d | ||
|  | 082ae17eaf | ||
|  | dd86e09ab4 | ||
|  | baff23116e | ||
|  | e549baf93a | ||
|  | 30d46adcb7 | ||
|  | e854726be0 | ||
|  | d198bd9d96 | ||
|  | 5eb23cecd0 | ||
|  | eff2c75bba | ||
|  | 325bd73df7 | ||
|  | 0fcc554abd | ||
|  | b685784155 | ||
|  | ac90fdc611 | ||
|  | 51077e49f5 | ||
|  | 0c3199f72d | ||
|  | 62675a3bcd | ||
|  | c26dbaa620 | ||
|  | 8201624959 | ||
|  | f2116413d6 | ||
|  | b0baebeb0a | ||
|  | fb943b77d5 | ||
|  | b4b39510fc | ||
|  | 6f0f05ba12 | ||
|  | f0b64b6229 | ||
|  | 4229488989 | ||
|  | acd2e6ef2b | ||
|  | c26aaed71f | ||
|  | 326d7ad4d7 | ||
|  | c76a2f4aab | ||
|  | d8b0ff2d7e | ||
|  | 996ce2d307 | ||
|  | 167fa4154f | ||
|  | 0c7e7c3c39 | ||
|  | 9d8f8f41dc | ||
|  | 39c4445b39 | ||
|  | 7819b022ad | ||
|  | 65d27e7f86 | ||
|  | 212a70bf77 | ||
|  | 6b5dc18a46 | ||
|  | 0917f83b9c | ||
|  | 7322bd3903 | ||
|  | e998010184 | ||
|  | 918a1c93e4 | ||
|  | 14c87853c2 | ||
|  | d5a5b84a40 | ||
|  | 35d3c03d19 | ||
|  | 8933fbb254 | ||
|  | c320330cd5 | ||
|  | 822b46a3df | ||
|  | a821ef6e2c | ||
|  | 491db15997 | ||
|  | b6c826a139 | ||
|  | 7b472a05ee | ||
|  | 9a07bc0d9b | ||
|  | 154d6bb198 | ||
|  | 0dde936e61 | ||
|  | 918bf25039 | ||
|  | 04fda4fb4e | ||
|  | e14a250d6e | ||
|  | 806745f24e | ||
|  | 4231f774e4 | ||
|  | dfc320124f | ||
|  | be43ba1569 | ||
|  | f3f879555a | ||
|  | 3155044abd | ||
|  | 484d184de5 | ||
|  | 3305cf1592 | ||
|  | ec36cd8c54 | ||
|  | 61fb5a0b8f | ||
|  | 8024c3e9c7 | ||
|  | 2f5945d0cd | ||
|  | 929517d6d7 | ||
|  | abcab174a5 | ||
|  | 801be90699 | ||
|  | 265c2348b8 | ||
|  | fb95bcc64c | ||
|  | aedc410525 | ||
|  | 7fa440c154 | ||
|  | 746e0fad2b | ||
|  | 1616f6f5a8 | ||
|  | ca3e7d8530 | ||
|  | f0f753ba6c | ||
|  | 532065b51b | ||
|  | 4bfb534bae | ||
|  | 95ba7a4381 | ||
|  | e92213431e | ||
|  | 7dd7daee1b | ||
|  | 953cc46220 | ||
|  | b5ae0ad86b | ||
|  | c86fcbf456 | ||
|  | 6ded8b9ad6 | ||
|  | bb6a6272e1 | ||
|  | 242634b3fc | ||
|  | 662cf14bf6 | ||
|  | fe3aaf62cd | ||
|  | cb189bd6be | ||
|  | f57c914b8f | ||
|  | 7cec198e14 | ||
|  | 52d3120528 | ||
|  | f1aff5670c | ||
|  | 632f682292 | ||
|  | d1d0d6b788 | ||
|  | 3bd833c8ff | ||
|  | 1ef77b0853 | ||
|  | 074007ab8c | ||
|  | c4b7aaf281 | ||
|  | 22b8494e9a | ||
|  | c1c8329403 | ||
|  | 20a89040e1 | ||
|  | 1c7a2a1476 | ||
|  | 7c40cc0b63 | ||
|  | 73a9e0d351 | ||
|  | dc9856744a | ||
|  | 88f4e47550 | ||
|  | 1be04eeec5 | ||
|  | 56acf9c325 | ||
|  | c6e3957efc | ||
|  | 25e8284950 | ||
|  | 37a6537a5b | ||
|  | 80df1d8f12 | ||
|  | 75afed7f17 | ||
|  | 1d7066aee1 | ||
|  | 12272a38d4 | ||
|  | 04f901e52e | ||
|  | fabfb31bf6 | ||
|  | 683701cd07 | ||
|  | 119c64be0b | ||
|  | d429c9a7d8 | ||
|  | 1e8216431b | ||
|  | e45b2e2136 | ||
|  | 9e6951009b | ||
|  | a009a209f1 | ||
|  | 97605056ed | ||
|  | 8fcfa33d33 | ||
|  | aa65e3da3b | ||
|  | b4cfadb4d5 | ||
|  | 45a6249668 | ||
|  | 1d601aef4d | ||
|  | 32fb45eba9 | ||
|  | 2b7d10aceb | ||
|  | 5dc62711e1 | ||
|  | 252c02aca0 | ||
|  | 9655beb7ba | ||
|  | f0ea53e77e | ||
|  | 4755b42909 | ||
|  | ef9af03c6c | ||
|  | 7439073cbf | ||
|  | aff985a563 | ||
|  | db425222d5 | ||
|  | e20af510f7 | ||
|  | d8230c6a73 | ||
|  | f5690787bf | ||
|  | a4fd7b32dd | ||
|  | f4336ec693 | ||
|  | 03d906976b | ||
|  | 4ba6a96822 | ||
|  | 1ea4140d56 | ||
|  | 351d4ecb15 | ||
|  | 7fbf84dcc6 | ||
|  | 3ff49b272d | ||
|  | 5b52e3d418 | ||
|  | 8c0eb498d3 | ||
|  | 48a81ef7ea | ||
|  | f7610c9b26 | ||
|  | 1755eaf019 | ||
|  | 6b8b218efb | ||
|  | 333d79b345 | ||
|  | f0fa436fe4 | ||
|  | 13e6d78fa8 | ||
|  | 7126ea2685 | ||
|  | a37518cb4a | ||
|  | 64b3e8c3bd | ||
|  | 339937380e | ||
|  | 6156f0d302 | ||
|  | 00560e8e17 | ||
|  | 029ff9828f | ||
|  | ec188c7c3e | ||
|  | 0a0296a5d0 | ||
|  | 6e26a5bbe7 | ||
|  | dc1b6246a0 | ||
|  | 15f69eaf14 | ||
|  | 4774a0d325 | ||
|  | be78ab72c9 | ||
|  | 0bc4a1b20d | ||
|  | c8b674d105 | ||
|  | b421d4725a | ||
|  | 1662bb5713 | ||
|  | ad79a21abd | ||
|  | 19645a52e6 | ||
|  | 74c3077c9a | ||
|  | 1f29191329 | ||
|  | 4b636a7680 | ||
|  | e6fc2555f3 | ||
|  | e27d0fcf2a | ||
|  | 2643c33b20 | ||
|  | 71af1e77c8 | ||
|  | 99e7406bd9 | ||
|  | 413265f497 | ||
|  | fe44cdf09b | ||
|  | e413428d71 | ||
|  | 88b9822db7 | ||
|  | 24045c0cd7 | ||
|  | d2aa9f4a84 | ||
|  | d2a5fd169f | ||
|  | 4e350d9934 | ||
|  | f3f697bbc8 | ||
|  | c7c09696db | ||
|  | dbcc58d984 | ||
|  | 8231310c4d | ||
|  | 2988140430 | ||
|  | 7387966005 | ||
|  | e0a5a61375 | ||
|  | 66ecd70689 | ||
|  | 67f4f45653 | ||
|  | 1bf28b3de2 | ||
|  | eb3c3435d7 | ||
|  | 8a81d8b16c | ||
|  | bc9d8b13d0 | ||
|  | 4768b167ab | ||
|  | 591ff70ed1 | ||
|  | 7bf2ad0b22 | ||
|  | 409c79b2e4 | ||
|  | d0410691a1 | ||
|  | 64e5115138 | ||
|  | 7ae912d83c | ||
|  | 2937f5876c | ||
|  | 8619c9b5c3 | ||
|  | e4d5684f6b | ||
|  | 3d69cf95da | ||
|  | 18944572b7 | ||
|  | 3e9d0f80c2 | ||
|  | a2c4d1990a | ||
|  | 404261c6ee | ||
|  | 87abc59612 | ||
|  | cb98ddf7db | ||
|  | 7d2e6c9025 | ||
|  | 75eaa14a18 | ||
|  | 082d6e3b32 | ||
|  | 35b3770b6f | ||
|  | 5b9d20c7e2 | ||
|  | 5bbed2372e | ||
|  | a9d407d239 | ||
|  | 3ca4a33a65 | ||
|  | 95197f427c | ||
|  | 84cdfb032c | ||
|  | ec2ceb9c96 | ||
|  | 6286c893fd | ||
|  | 354aef0e8c | ||
|  | 139e33c36d | ||
|  | e01de59cdd | ||
|  | 686f822dea | ||
|  | 9961d5c9af | ||
|  | 628be0d125 | ||
|  | 633e45f61a | ||
|  | 2f357c3805 | ||
|  | cda0894d0d | ||
|  | 117720a8bc | ||
|  | a6f6c3613a | ||
|  | 7914f5b931 | ||
|  | a1add0a6f6 | ||
|  | c032b337c4 | ||
|  | ec363261ae | ||
|  | 97cde2183d | ||
|  | 7f43c682db | ||
|  | 0c9eee3c6b | ||
|  | 3b1afa3ba6 | ||
|  | 93e6a75125 | ||
|  | 52f8a7c0ca | ||
|  | 55bfeb646f | ||
|  | 75c9dd3be1 | ||
|  | 6392e2788f | ||
|  | 6a97f3f9ba | ||
|  | 6e5f52e279 | ||
|  | 7f92bed902 | ||
|  | d68a11cc42 | ||
|  | 328a81e194 | ||
|  | 31d0908b74 | ||
|  | 32c77599f4 | ||
|  | 812ebf3562 | ||
|  | 37f476013d | ||
|  | 9f3104166f | ||
|  | 64cc0daf34 | ||
|  | d5d64df124 | ||
|  | 0edcfcd5c1 | ||
|  | 50ba2d419a | ||
|  | ff3a77ca5a | ||
|  | 4eaed6c23d | ||
|  | 4d0dd46471 | ||
|  | 9c2549bd00 | ||
|  | b7c8e0c17f | ||
|  | dd3cfe1837 | ||
|  | 43f525298e | ||
|  | 1bb1898ab9 | ||
|  | 9578f24be9 | ||
|  | 46fae3aed2 | ||
|  | e35f91a70a | ||
|  | 851052fcca | ||
|  | 5ef81b2952 | ||
|  | ef2851c053 | ||
|  | 0b4387cff5 | ||
|  | a40cf11fbf | ||
|  | 5c495cd223 | ||
|  | cf1296dff8 | ||
|  | d6d88db6e8 | ||
|  | 85c2a35257 | ||
|  | 836d8b1c64 | ||
|  | 98d8c8ab71 | ||
|  | db45013339 | ||
|  | a55c37e7f6 | ||
|  | 46a270fcca | ||
|  | 967856518e | ||
|  | 7f93e739fe | ||
|  | 2cd1422514 | ||
|  | feb370b201 | ||
|  | d1b34e64d8 | ||
|  | b9a1eead40 | ||
|  | 1e4bfac98c | ||
|  | 3bb504fbf3 | ||
|  | 5029791c90 | ||
|  | a1a68f0970 | ||
|  | f8543d79eb | ||
|  | f353415136 | ||
|  | 26240403b0 | ||
|  | 3a39729b58 | ||
|  | 096c961d9a | ||
|  | 01fe04a6a2 | ||
|  | 7ea4014993 | ||
|  | d50b374f88 | ||
|  | 27dfb25570 | ||
|  | b5ed77985e | ||
|  | 61243bd15f | ||
|  | 368b94d804 | ||
|  | a5adbbfd5f | ||
|  | a19d13f123 | ||
|  | 78886ab383 | ||
|  | 168012b465 | ||
|  | d9d58ea66e | ||
|  | 56f5f6e8d5 | ||
|  | 3cb6420eda | ||
|  | 60be2c1186 | ||
|  | ed210f6b2c | ||
|  | 029bc59d74 | ||
|  | 961c08a82f | ||
|  | 7ee484c614 | ||
|  | 05c6fbbf99 | ||
|  | 91078b7f7a | ||
|  | 20d804afc4 | ||
|  | c21f6d1cbf | ||
|  | 393e79c1fd | ||
|  | 8b92c8a085 | ||
|  | ff73dd94c9 | ||
|  | af43904f38 | ||
|  | 485074f265 | ||
|  | 2e0ee55b5e | ||
|  | e9105d32cb | ||
|  | 964d23f68c | ||
|  | be5aaaae7b | ||
|  | bf13bd7b3f | ||
|  | 352e392fcb | ||
|  | 083b1b02df | ||
|  | 648c6240a2 | ||
|  | 60cab840cb | ||
|  | 83a4380dab | ||
|  | de84fe8d98 | ||
|  | ed3cbfdb8e | ||
|  | fda44ca17d | ||
|  | 272025bb07 | ||
|  | 8e92bcf1b2 | ||
|  | 84f1ffdefe | ||
|  | 7e25450054 | ||
|  | 4a563fa266 | ||
|  | aa4c0ec000 | ||
|  | e1ecfbdc43 | ||
|  | a4e122a82e | ||
|  | 93216e8fb7 | ||
|  | 16272c210d | ||
|  | e104b00da1 | ||
|  | ce5c6bcc08 | ||
|  | 8694ce31fe | ||
|  | d960e5eadd | ||
|  | 2dc71e87a3 | ||
|  | 6bf17edde2 | ||
|  | 88573d515d | ||
|  | 89b9f77823 | ||
|  | 765d9be17d | ||
|  | 7135373008 | ||
|  | ee269884fc | ||
|  | 387540d5f1 | ||
|  | 2eba7b42a8 | ||
|  | 07115d26c7 | ||
|  | c43ed815a0 | ||
|  | ff01e36d12 | ||
|  | ac4798b16c | ||
|  | d4e14fed0e | ||
|  | 5f91259344 | ||
|  | 20a9d9645d | ||
|  | c86f6b4abd | ||
|  | d66489b5b2 | ||
|  | b743ee9f0c | ||
|  | 95ba69c00a | ||
|  | 2ac273739c | ||
|  | 5b4d28708c | ||
|  | 4cc4383488 | ||
|  | 8935232248 | ||
|  | 5c6dd2f172 | ||
|  | eeeb7ef5b9 | ||
|  | 2efc9c1178 | ||
|  | a84c46f6e3 | ||
|  | a5c3dcdd02 | ||
|  | 46f7a75eb7 | ||
|  | 94b6710c5b | ||
|  | d8dd3da9ab | ||
|  | 803ced004a | ||
|  | 0ea7d36ad0 | ||
|  | 87aafab759 | ||
|  | 994d310abd | ||
|  | 228cdcf05e | ||
|  | 42598e352c | ||
|  | 36a9e4d1da | ||
|  | 456dfd0dea | ||
|  | 155457e2b5 | ||
|  | b5c91485bf | ||
|  | c959cf7870 | ||
|  | 5878c88636 | ||
|  | ddcef2fb19 | ||
|  | 493d124c07 | ||
|  | f42060c616 | ||
|  | 834facc932 | ||
|  | f82d0b76ee | ||
|  | c25d225275 | ||
|  | c503a274b5 | ||
|  | 087069d215 | ||
|  | 826a6dd114 | ||
|  | f31483838d | ||
|  | d8a9b633d9 | ||
|  | c060e4466a | ||
|  | a9951376f4 | ||
|  | bda0c8f5e3 | ||
|  | 71902f23a2 | ||
|  | dfd6c85569 | ||
|  | 0e41b2cc1a | ||
|  | e5c81d0702 | ||
|  | 6caf7d4d5a | ||
|  | 98e87c8afb | ||
|  | d9e0f80d50 | ||
|  | 6396fdb5ff | ||
|  | 2470b53373 | ||
|  | 16334e92ca | ||
|  | c22d98a8ec | ||
|  | 28617afbb9 | ||
|  | 0c3bc42bec | ||
|  | e3d9745df1 | ||
|  | b8471c1015 | ||
|  | 045b09c9ef | ||
|  | 4ac07b97d3 | ||
|  | 34c847c17f | ||
|  | f694e557e1 | ||
|  | 6a0c3e92a0 | ||
|  | cba48df8e3 | ||
|  | a0e8d1bf36 | ||
|  | 912dedaca7 | ||
|  | 7dd90c3919 | ||
|  | 7c3a25a377 | ||
|  | c8fbca2d44 | ||
|  | f7ed0aaeed | ||
|  | 6e78270140 | ||
|  | ba354377d5 | ||
|  | 353c030918 | ||
|  | 331a2b8282 | ||
|  | 4bd6909ea1 | ||
|  | 26119613e1 | ||
|  | 45bfe0b607 | ||
|  | ce2f573ab2 | ||
|  | 66d5cc43f3 | ||
|  | e8265e09a3 | ||
|  | 860cf0b321 | ||
|  | 89c74708d7 | ||
|  | 74c8680350 | ||
|  | 3cd9f5b623 | ||
|  | 0936110741 | ||
|  | 6161ce15c7 | ||
|  | 28594a22f1 | ||
|  | 656517b059 | ||
|  | ad576863b4 | ||
|  | 775be75366 | ||
|  | 7ae6e5bac9 | ||
|  | c5915c23e7 | ||
|  | 1f2a827df3 | ||
|  | f51ee4ef2e | ||
|  | 75aadf0509 | ||
|  | 4f9b0bcb9b | ||
|  | 9628e5adb0 | 
							
								
								
									
										109
									
								
								Assignable.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										109
									
								
								Assignable.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,109 @@ | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <html> | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
|   <title>Assignable</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" link="#0000EE" text="#000000" vlink="#551A8B" alink= | ||||
| "#FF0000"> | ||||
|   <img src="../../boost.png" alt="C++ Boost" width="277" height= | ||||
|   "86"><br clear="none"> | ||||
|  | ||||
|   <h1>Assignable</h1> | ||||
|  | ||||
|   <h3>Description</h3> | ||||
|  | ||||
|   <p>A type is Assignable if it is possible to assign one object of the type | ||||
|   to another object of that type.</p> | ||||
|  | ||||
|   <h3>Notation</h3> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr> | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
|       <td valign="top">is type that is a model of Assignable</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>t</tt></td> | ||||
|  | ||||
|       <td valign="top">is an object of type <tt>T</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>u</tt></td> | ||||
|  | ||||
|       <td valign="top">is an object of type <tt>T</tt> or possibly <tt>const | ||||
|       T</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Definitions</h3> | ||||
|  | ||||
|   <h3>Valid expressions</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Assignment</td> | ||||
|  | ||||
|       <td valign="top"><tt>t = u</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>T&</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>t</tt> is equivalent to <tt>u</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Models</h3> | ||||
|  | ||||
|   <ul> | ||||
|     <li><tt>int</tt></li> | ||||
|  | ||||
|     <li><tt>std::pair</tt></li> | ||||
|   </ul> | ||||
|  | ||||
|   <h3>See also</h3> | ||||
|  | ||||
|   <p><a href= | ||||
|   "http://www.sgi.com/tech/stl/DefaultConstructible.html">DefaultConstructible</a> | ||||
|   and <a href="./CopyConstructible.html">CopyConstructible</a><br></p> | ||||
|   <hr> | ||||
|  | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr valign="top"> | ||||
|       <td nowrap><i>Copyright © 2000</i></td> | ||||
|  | ||||
|       <td><i><a href="http://www.lsc.nd.edu/~jsiek">Jeremy Siek</a>, Univ.of | ||||
|       Notre Dame (<a href= | ||||
|       "mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</a>)</i></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
							
								
								
									
										534
									
								
								Collection.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										534
									
								
								Collection.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,534 @@ | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <html> | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
|   <title>Collection</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" link="#0000EE" text="#000000" vlink="#551A8B" alink= | ||||
| "#FF0000"> | ||||
|   <h1><img src="../../boost.png" alt="boost logo" width="277" align="middle" | ||||
|   height="86"><br> | ||||
|   Collection</h1> | ||||
|  | ||||
|   <h3>Description</h3> | ||||
|  | ||||
|   <p>A Collection is a <i>concept</i> similar to the STL <a href= | ||||
|   "http://www.sgi.com/tech/stl/Container.html">Container</a> concept. A | ||||
|   Collection provides iterators for accessing a range of elements and | ||||
|   provides information about the number of elements in the Collection. | ||||
|   However, a Collection has fewer requirements than a Container. The | ||||
|   motivation for the Collection concept is that there are many useful | ||||
|   Container-like types that do not meet the full requirements of Container, | ||||
|   and many algorithms that can be written with this reduced set of | ||||
|   requirements. To summarize the reduction in requirements:</p> | ||||
|  | ||||
|   <ul> | ||||
|     <li>It is not required to "own" its elements: the lifetime of an element | ||||
|     in a Collection does not have to match the lifetime of the Collection | ||||
|     object, though the lifetime of the element should cover the lifetime of | ||||
|     the Collection object.</li> | ||||
|  | ||||
|     <li>The semantics of copying a Collection object is not defined (it could | ||||
|     be a deep or shallow copy or not even support copying).</li> | ||||
|  | ||||
|     <li>The associated reference type of a Collection does not have to be a | ||||
|     real C++ reference.</li> | ||||
|   </ul>Because of the reduced requirements, some care must be taken when | ||||
|   writing code that is meant to be generic for all Collection types. In | ||||
|   particular, a Collection object should be passed by-reference since | ||||
|   assumptions can not be made about the behaviour of the copy constructor. | ||||
|  | ||||
|   <h3>Associated types</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <td valign="top">Value type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::value_type</tt></td> | ||||
|  | ||||
|       <td valign="top">The type of the object stored in a Collection. If the | ||||
|       Collection is <i>mutable</i> then the value type must be <a href= | ||||
|       "http://www.sgi.com/tech/stl/Assignable.html">Assignable</a>. Otherwise | ||||
|       the value type must be <a href= | ||||
|       "./CopyConstructible.html">CopyConstructible</a>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Iterator type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::iterator</tt></td> | ||||
|  | ||||
|       <td valign="top">The type of iterator used to iterate through a | ||||
|       Collection's elements. The iterator's value type is expected to be the | ||||
|       Collection's value type. A conversion from the iterator type to the | ||||
|       const iterator type must exist. The iterator type must be an <a href= | ||||
|       "http://www.sgi.com/tech/stl/InputIterator.html">InputIterator</a>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Const iterator type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::const_iterator</tt></td> | ||||
|  | ||||
|       <td valign="top">A type of iterator that may be used to examine, but | ||||
|       not to modify, a Collection's elements.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Reference type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::reference</tt></td> | ||||
|  | ||||
|       <td valign="top">A type that behaves like a reference to the | ||||
|       Collection's value type. <a href="#n1">[1]</a></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Const reference type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::const_reference</tt></td> | ||||
|  | ||||
|       <td valign="top">A type that behaves like a const reference to the | ||||
|       Collection's value type.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Pointer type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::pointer</tt></td> | ||||
|  | ||||
|       <td valign="top">A type that behaves as a pointer to the Collection's | ||||
|       value type.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Distance type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::difference_type</tt></td> | ||||
|  | ||||
|       <td valign="top">A signed integral type used to represent the distance | ||||
|       between two of the Collection's iterators. This type must be the same | ||||
|       as the iterator's distance type.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Size type</td> | ||||
|  | ||||
|       <td valign="top"><tt>X::size_type</tt></td> | ||||
|  | ||||
|       <td valign="top">An unsigned integral type that can represent any | ||||
|       nonnegative value of the Collection's distance type.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Notation</h3> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr> | ||||
|       <td valign="top"><tt>X</tt></td> | ||||
|  | ||||
|       <td valign="top">A type that is a model of Collection.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>a</tt>, <tt>b</tt></td> | ||||
|  | ||||
|       <td valign="top">Object of type <tt>X</tt>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
|       <td valign="top">The value type of <tt>X</tt>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Valid expressions</h3> | ||||
|  | ||||
|   <p>The following expressions must be valid.</p> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Beginning of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.begin()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>iterator</tt> if <tt>a</tt> is mutable, | ||||
|       <tt>const_iterator</tt> otherwise</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">End of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.end()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>iterator</tt> if <tt>a</tt> is mutable, | ||||
|       <tt>const_iterator</tt> otherwise</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Size</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.size()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>size_type</tt></td> | ||||
|     </tr><!-- | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Maximum size | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>a.max_size()</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>size_type</tt> | ||||
| </TD> | ||||
| </TR> | ||||
| --> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Empty Collection</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.empty()</tt></td> | ||||
|  | ||||
|       <td valign="top">Convertible to <tt>bool</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Swap</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.swap(b)</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>void</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Expression semantics</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|  | ||||
|       <th>Postcondition</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Beginning of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.begin()</tt></td> | ||||
|  | ||||
|       <td valign="top">Returns an iterator pointing to the first element in | ||||
|       the Collection.</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.begin()</tt> is either dereferenceable or | ||||
|       past-the-end. It is past-the-end if and only if <tt>a.size() == | ||||
|       0</tt>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">End of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.end()</tt></td> | ||||
|  | ||||
|       <td valign="top">Returns an iterator pointing one past the last element | ||||
|       in the Collection.</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.end()</tt> is past-the-end.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Size</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.size()</tt></td> | ||||
|  | ||||
|       <td valign="top">Returns the size of the Collection, that is, its | ||||
|       number of elements.</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.size() >= 0</tt></td> | ||||
|     </tr><!-- | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Maximum size | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>a.max_size()</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
|   | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| Returns the largest size that this Collection can ever have. <A href="#8">[8]</A> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>a.max_size() >= 0 && a.max_size() >= a.size()</tt> | ||||
| </TD> | ||||
| </TR> | ||||
|  --> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Empty Collection</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.empty()</tt></td> | ||||
|  | ||||
|       <td valign="top">Equivalent to <tt>a.size() == 0</tt>. (But possibly | ||||
|       faster.)</td> | ||||
|  | ||||
|       <td valign="top"> </td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Swap</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.swap(b)</tt></td> | ||||
|  | ||||
|       <td valign="top">Equivalent to <tt>swap(a,b)</tt></td> | ||||
|  | ||||
|       <td valign="top"> </td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Complexity guarantees</h3> | ||||
|  | ||||
|   <p><tt>begin()</tt> and <tt>end()</tt> are amortized constant time.</p> | ||||
|  | ||||
|   <p><tt>size()</tt> is at most linear in the Collection's size. | ||||
|   <tt>empty()</tt> is amortized constant time.</p> | ||||
|  | ||||
|   <p><tt>swap()</tt> is at most linear in the size of the two | ||||
|   collections.</p> | ||||
|  | ||||
|   <h3>Invariants</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <td valign="top">Valid range</td> | ||||
|  | ||||
|       <td valign="top">For any Collection <tt>a</tt>, <tt>[a.begin(), | ||||
|       a.end())</tt> is a valid range.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Range size</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.size()</tt> is equal to the distance from | ||||
|       <tt>a.begin()</tt> to <tt>a.end()</tt>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Completeness</td> | ||||
|  | ||||
|       <td valign="top">An algorithm that iterates through the range | ||||
|       <tt>[a.begin(), a.end())</tt> will pass through every element of | ||||
|       <tt>a</tt>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Models</h3> | ||||
|  | ||||
|   <ul> | ||||
|     <li><tt>array</tt></li> | ||||
|  | ||||
|     <li><tt>array_ptr</tt></li> | ||||
|  | ||||
|     <li><tt>vector<bool></tt></li> | ||||
|   </ul> | ||||
|  | ||||
|   <h3>Collection Refinements</h3> | ||||
|  | ||||
|   <p>There are quite a few concepts that refine the Collection concept, | ||||
|   similar to the concepts that refine the Container concept. Here is a brief | ||||
|   overview of the refining concepts.</p> | ||||
|  | ||||
|   <h4>ForwardCollection</h4> | ||||
|  | ||||
|   <p>The elements are arranged in some order that does not change | ||||
|   spontaneously from one iteration to the next. As a result, a | ||||
|   ForwardCollection is <a href= | ||||
|   "http://www.sgi.com/tech/stl/EqualityComparable.html">EqualityComparable</a> | ||||
|   and <a href= | ||||
|   "http://www.sgi.com/tech/stl/LessThanComparable.html">LessThanComparable</a>. | ||||
|   In addition, the iterator type of a ForwardCollection is a | ||||
|   MultiPassInputIterator which is just an InputIterator with the added | ||||
|   requirements that the iterator can be used to make multiple passes through | ||||
|   a range, and that if <tt>it1 == it2</tt> and <tt>it1</tt> is | ||||
|   dereferenceable then <tt>++it1 == ++it2</tt>. The ForwardCollection also | ||||
|   has a <tt>front()</tt> method.</p> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Front</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.front()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>reference</tt> if <tt>a</tt> is mutable,<br> | ||||
|       <tt>const_reference</tt> otherwise.</td> | ||||
|  | ||||
|       <td valign="top">Equivalent to <tt>*(a.begin())</tt>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h4>ReversibleCollection</h4> | ||||
|  | ||||
|   <p>The container provides access to iterators that traverse in both | ||||
|   directions (forward and reverse). The iterator type must meet all of the | ||||
|   requirements of <a href= | ||||
|   "http://www.sgi.com/tech/stl/BidirectionalIterator.html">BidirectionalIterator</a> | ||||
|   except that the reference type does not have to be a real C++ reference. | ||||
|   The ReversibleCollection adds the following requirements to those of | ||||
|   ForwardCollection.</p> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Beginning of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.rbegin()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>reverse_iterator</tt> if <tt>a</tt> is mutable, | ||||
|       <tt>const_reverse_iterator</tt> otherwise.</td> | ||||
|  | ||||
|       <td valign="top">Equivalent to | ||||
|       <tt>X::reverse_iterator(a.end())</tt>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">End of range</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.rend()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>reverse_iterator</tt> if <tt>a</tt> is mutable, | ||||
|       <tt>const_reverse_iterator</tt> otherwise.</td> | ||||
|  | ||||
|       <td valign="top">Equivalent to | ||||
|       <tt>X::reverse_iterator(a.begin())</tt>.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Back</td> | ||||
|  | ||||
|       <td valign="top"><tt>a.back()</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>reference</tt> if <tt>a</tt> is mutable,<br> | ||||
|       <tt>const_reference</tt> otherwise.</td> | ||||
|  | ||||
|       <td valign="top">Equivalent to <tt>*(--a.end())</tt>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h4>SequentialCollection</h4> | ||||
|  | ||||
|   <p>The elements are arranged in a strict linear order. No extra methods are | ||||
|   required.</p> | ||||
|  | ||||
|   <h4>RandomAccessCollection</h4> | ||||
|  | ||||
|   <p>The iterators of a RandomAccessCollection satisfy all of the | ||||
|   requirements of <a href= | ||||
|   "http://www.sgi.com/tech/stl/RandomAccessIterator.html">RandomAccessIterator</a> | ||||
|   except that the reference type does not have to be a real C++ reference. In | ||||
|   addition, a RandomAccessCollection provides an element access operator.</p> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Element Access</td> | ||||
|  | ||||
|       <td valign="top"><tt>a[n]</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>reference</tt> if <tt>a</tt> is mutable, | ||||
|       <tt>const_reference</tt> otherwise.</td> | ||||
|  | ||||
|       <td valign="top">Returns the nth element of the Collection. <tt>n</tt> | ||||
|       must be convertible to <tt>size_type</tt>. Precondition: <tt>0 <= n | ||||
|       < a.size()</tt>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Notes</h3> | ||||
|  | ||||
|   <p><a name="n1" id="n1">[1]</a> The reference type does not have to be a | ||||
|   real C++ reference. The requirements of the reference type depend on the | ||||
|   context within which the Collection is being used. Specifically it depends | ||||
|   on the requirements the context places on the value type of the Collection. | ||||
|   The reference type of the Collection must meet the same requirements as the | ||||
|   value type. In addition, the reference objects must be equivalent to the | ||||
|   value type objects in the collection (which is trivially true if they are | ||||
|   the same object). Also, in a mutable Collection, an assignment to the | ||||
|   reference object must result in an assignment to the object in the | ||||
|   Collection (again, which is trivially true if they are the same object, but | ||||
|   non-trivial if the reference type is a proxy class).</p> | ||||
|  | ||||
|   <h3>See also</h3> | ||||
|  | ||||
|   <p><a href= | ||||
|   "http://www.sgi.com/tech/stl/Container.html">Container</a><br></p> | ||||
|   <hr> | ||||
|  | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 | ||||
|   December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr valign="top"> | ||||
|       <td nowrap><i>Copyright © 2000</i></td> | ||||
|  | ||||
|       <td><i><a href="http://www.boost.org/people/jeremy_siek.htm">Jeremy | ||||
|       Siek</a>, Univ.of Notre Dame and C++ Library & Compiler Group/SGI | ||||
|       (<a href="mailto:jsiek@engr.sgi.com">jsiek@engr.sgi.com</a>)</i></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
| @@ -1,188 +1,185 @@ | ||||
| <HTML> | ||||
| <!-- | ||||
|   -- Copyright (c) Jeremy Siek 2000 | ||||
|   -- | ||||
|   -- Permission to use, copy, modify, distribute and sell this software | ||||
|   -- and its documentation for any purpose is hereby granted without fee, | ||||
|   -- provided that the above copyright notice appears in all copies and | ||||
|   -- that both that copyright notice and this permission notice appear | ||||
|   -- in supporting documentation.  Silicon Graphics makes no | ||||
|   -- representations about the suitability of this software for any | ||||
|   -- purpose.  It is provided "as is" without express or implied warranty. | ||||
|   --> | ||||
| <Head> | ||||
| <Title>CopyConstructible</Title> | ||||
| </HEAD> | ||||
| <BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"  | ||||
|         ALINK="#ff0000">  | ||||
| <IMG SRC="../../c++boost.gif"  | ||||
|      ALT="C++ Boost">  | ||||
| <!--end header--> | ||||
| <BR Clear> | ||||
| <H1>CopyConstructible</H1> | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <h3>Description</h3> | ||||
| A type is CopyConstructible if it is possible to copy objects of that | ||||
| type. | ||||
| <html> | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
| <h3>Notation</h3> | ||||
| <Table> | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| <tt>T</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| is type that is a model of CopyConstructible | ||||
| </TD> | ||||
| </TR> | ||||
|   <title>Copy Constructible</title> | ||||
| </head> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| <tt>t</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| is an object of type <tt>T</tt> | ||||
| </TD> | ||||
| </tr> | ||||
| <body bgcolor="#FFFFFF" link="#0000EE" text="#000000" vlink="#551A8B" alink= | ||||
| "#FF0000"> | ||||
|   <img src="../../boost.png" alt="C++ Boost" width="277" height= | ||||
|   "86"><br clear="none"> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| <tt>u</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| is an object of type <tt>const T</tt> | ||||
| </TD> | ||||
| </tr> | ||||
|   <h1>Copy Constructible</h1> | ||||
|  | ||||
| </table> | ||||
| <h3>Definitions</h3> | ||||
| <h3>Valid expressions</h3> | ||||
| <Table border> | ||||
| <TR> | ||||
| <TH> | ||||
| Name | ||||
| </TH> | ||||
| <TH> | ||||
| Expression | ||||
| </TH> | ||||
| <TH> | ||||
| Return type | ||||
| </TH> | ||||
| <TH> | ||||
| Semantics | ||||
| </TH> | ||||
| </TR> | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Copy constructor | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T(t)</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>t</tt> is equivalent to <tt>T(t)</tt> | ||||
| </TD> | ||||
| </TR> | ||||
|   <h3>Description</h3> | ||||
|  | ||||
|   <p>A type is Copy Constructible if it is possible to copy objects of that | ||||
|   type.</p> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Copy constructor | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <pre> | ||||
|   <h3>Notation</h3> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr> | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
|       <td valign="top">is type that is a model of Copy Constructible</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>t</tt></td> | ||||
|  | ||||
|       <td valign="top">is an object of type <tt>T</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>u</tt></td> | ||||
|  | ||||
|       <td valign="top">is an object of type <tt>const T</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Definitions</h3> | ||||
|  | ||||
|   <h3>Valid expressions</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Copy constructor</td> | ||||
|  | ||||
|       <td valign="top"><tt>T(t)</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>t</tt> is equivalent to <tt>T(t)</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Copy constructor</td> | ||||
|  | ||||
|       <td valign="top"> | ||||
|         <pre> | ||||
| T(u) | ||||
| </pre> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>u</tt> is equivalent to <tt>T(u)</tt> | ||||
| </TD> | ||||
| </TR> | ||||
|       </td> | ||||
|  | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Destructor | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <pre> | ||||
|       <td valign="top"><tt>u</tt> is equivalent to <tt>T(u)</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Destructor</td> | ||||
|  | ||||
|       <td valign="top"> | ||||
|         <pre> | ||||
| t.~T() | ||||
| </pre> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
|   | ||||
| </TD> | ||||
| </TR> | ||||
|       </td> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Address Operator | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <pre> | ||||
|       <td valign="top"><tt>T</tt></td> | ||||
|  | ||||
|       <td valign="top"> </td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Address Operator</td> | ||||
|  | ||||
|       <td valign="top"> | ||||
|         <pre> | ||||
| &t | ||||
| </pre> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T*</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| denotes the address of <tt>t</tt> | ||||
| </TD> | ||||
| </TR> | ||||
|       </td> | ||||
|  | ||||
| <TR> | ||||
| <TD VAlign=top> | ||||
| Address Operator | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <pre> | ||||
|       <td valign="top"><tt>T*</tt></td> | ||||
|  | ||||
|       <td valign="top">denotes the address of <tt>t</tt></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Address Operator</td> | ||||
|  | ||||
|       <td valign="top"> | ||||
|         <pre> | ||||
| &u | ||||
| </pre> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| <tt>T*</tt> | ||||
| </TD> | ||||
| <TD VAlign=top> | ||||
| denotes the address of <tt>u</tt> | ||||
| </TD> | ||||
| </TR> | ||||
|       </td> | ||||
|  | ||||
|       <td valign="top"><tt>T*</tt></td> | ||||
|  | ||||
|       <td valign="top">denotes the address of <tt>u</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
| </table> | ||||
|   <h3>Models</h3> | ||||
|  | ||||
|   <ul> | ||||
|     <li><tt>int</tt></li> | ||||
|  | ||||
| </table> | ||||
| <h3>Models</h3> | ||||
|     <li><tt>std::pair</tt></li> | ||||
|   </ul> | ||||
|  | ||||
| <UL> | ||||
| <LI><tt>int</tt> | ||||
| <LI><tt>std::pair</tt> | ||||
| </UL> | ||||
|   <h3>Concept Checking Class</h3> | ||||
|   <pre> | ||||
|   template <class T> | ||||
|   struct CopyConstructibleConcept | ||||
|   { | ||||
|     void constraints() { | ||||
|       T a(b);            // require copy constructor | ||||
|       T* ptr = &a;       // require address of operator | ||||
|       const_constraints(a); | ||||
|       ignore_unused_variable_warning(ptr); | ||||
|     } | ||||
|     void const_constraints(const T& a) { | ||||
|       T c(a);            // require const copy constructor | ||||
|       const T* ptr = &a; // require const address of operator | ||||
|       ignore_unused_variable_warning(c); | ||||
|       ignore_unused_variable_warning(ptr); | ||||
|     } | ||||
|     T b; | ||||
|   }; | ||||
| </pre> | ||||
|  | ||||
| <h3>See also</h3> | ||||
| <A | ||||
| href="http://www.sgi.com/Technology/STL/DefaultConstructible.html">DefaultConstructible</A> | ||||
| and  | ||||
| <A href="http://www.sgi.com/Technology/STL/Assignable.html">Assignable</A> | ||||
|   <h3>See also</h3> | ||||
|  | ||||
| <br> | ||||
| <HR> | ||||
| <TABLE> | ||||
| <TR valign=top> | ||||
| <TD nowrap>Copyright © 2000</TD><TD> | ||||
| <A HREF=http://www.lsc.nd.edu/~jsiek>Jeremy Siek</A>, Univ.of Notre Dame (<A HREF="mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</A>) | ||||
| </TD></TR></TABLE> | ||||
|   <p><a href="http://www.sgi.com/tech/stl/DefaultConstructible.html">Default | ||||
|   Constructible</a> and <a href="./Assignable.html">Assignable</a><br></p> | ||||
|   <hr> | ||||
|  | ||||
| </BODY> | ||||
| </HTML>  | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 | ||||
|   December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr valign="top"> | ||||
|       <td nowrap><i>Copyright © 2000</i></td> | ||||
|  | ||||
|       <td><i><a href="http://www.lsc.nd.edu/~jsiek">Jeremy Siek</a>, Univ.of | ||||
|       Notre Dame (<a href= | ||||
|       "mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</a>)</i></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
|   | ||||
							
								
								
									
										210
									
								
								LessThanComparable.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										210
									
								
								LessThanComparable.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,210 @@ | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <html> | ||||
| <!-- | ||||
|   == Copyright (c) 1996-1999 | ||||
|   == Silicon Graphics Computer Systems, Inc. | ||||
|   == | ||||
|   == Permission to use, copy, modify, distribute and sell this software | ||||
|   == and its documentation for any purpose is hereby granted without fee, | ||||
|   == provided that the above copyright notice appears in all copies and | ||||
|   == that both that copyright notice and this permission notice appear | ||||
|   == in supporting documentation.  Silicon Graphics makes no | ||||
|   == representations about the suitability of this software for any | ||||
|   == purpose.  It is provided "as is" without express or implied warranty. | ||||
|   == | ||||
|   == Copyright (c) 1994 | ||||
|   == Hewlett-Packard Company | ||||
|   == | ||||
|   == Permission to use, copy, modify, distribute and sell this software | ||||
|   == and its documentation for any purpose is hereby granted without fee, | ||||
|   == provided that the above copyright notice appears in all copies and | ||||
|   == that both that copyright notice and this permission notice appear | ||||
|   == in supporting documentation.  Hewlett-Packard Company makes no | ||||
|   == representations about the suitability of this software for any | ||||
|   == purpose.  It is provided "as is" without express or implied warranty. | ||||
|   == | ||||
|   --> | ||||
|  | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
|   <title>LessThanComparable</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" link="#0000EE" text="#000000" vlink="#551A8B" alink= | ||||
| "#FF0000"> | ||||
|   <img src="../../boost.png" alt="C++ Boost" width="277" height= | ||||
|   "86"><br clear="none"> | ||||
|  | ||||
|   <h1>LessThanComparable</h1> | ||||
|  | ||||
|   <h3>Description</h3> | ||||
|  | ||||
|   <p>A type is LessThanComparable if it is ordered: it must be possible to | ||||
|   compare two objects of that type using <tt>operator<</tt>, and | ||||
|   <tt>operator<</tt> must be a strict weak ordering relation.</p> | ||||
|  | ||||
|   <h3>Refinement of</h3> | ||||
|  | ||||
|   <h3>Associated types</h3> | ||||
|  | ||||
|   <h3>Notation</h3> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr> | ||||
|       <td valign="top"><tt>X</tt></td> | ||||
|  | ||||
|       <td valign="top">A type that is a model of LessThanComparable</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top"><tt>x</tt>, <tt>y</tt>, <tt>z</tt></td> | ||||
|  | ||||
|       <td valign="top">Object of type <tt>X</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Definitions</h3> | ||||
|  | ||||
|   <p>Consider the relation <tt>!(x < y) && !(y < x)</tt>. If | ||||
|   this relation is transitive (that is, if <tt>!(x < y) && !(y | ||||
|   < x) && !(y < z) && !(z < y)</tt> implies <tt>!(x | ||||
|   < z) && !(z < x)</tt>), then it satisfies the mathematical | ||||
|   definition of an equivalence relation. In this case, <tt>operator<</tt> | ||||
|   is a <i>strict weak ordering</i>.</p> | ||||
|  | ||||
|   <p>If <tt>operator<</tt> is a strict weak ordering, and if each | ||||
|   equivalence class has only a single element, then <tt>operator<</tt> is | ||||
|   a <i>total ordering</i>.</p> | ||||
|  | ||||
|   <h3>Valid expressions</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Type requirements</th> | ||||
|  | ||||
|       <th>Return type</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Less</td> | ||||
|  | ||||
|       <td valign="top"><tt>x < y</tt></td> | ||||
|  | ||||
|       <td valign="top"> </td> | ||||
|  | ||||
|       <td valign="top">Convertible to <tt>bool</tt></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Expression semantics</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Name</th> | ||||
|  | ||||
|       <th>Expression</th> | ||||
|  | ||||
|       <th>Precondition</th> | ||||
|  | ||||
|       <th>Semantics</th> | ||||
|  | ||||
|       <th>Postcondition</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Less</td> | ||||
|  | ||||
|       <td valign="top"><tt>x < y</tt></td> | ||||
|  | ||||
|       <td valign="top"><tt>x</tt> and <tt>y</tt> are in the domain of | ||||
|       <tt><</tt></td> | ||||
|  | ||||
|       <td valign="top"> </td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Complexity guarantees</h3> | ||||
|  | ||||
|   <h3>Invariants</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <td valign="top">Irreflexivity</td> | ||||
|  | ||||
|       <td valign="top"><tt>x < x</tt> must be false.</td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Antisymmetry</td> | ||||
|  | ||||
|       <td valign="top"><tt>x < y</tt> implies !(y < x) <a href= | ||||
|       "#n2">[2]</a></td> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td valign="top">Transitivity</td> | ||||
|  | ||||
|       <td valign="top"><tt>x < y</tt> and <tt>y < z</tt> implies <tt>x | ||||
|       < z</tt> <a href="#n3">[3]</a></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Models</h3> | ||||
|  | ||||
|   <ul> | ||||
|     <li>int</li> | ||||
|   </ul> | ||||
|  | ||||
|   <h3>Notes</h3> | ||||
|  | ||||
|   <p><a name="n1" id="n1">[1]</a> Only <tt>operator<</tt> is fundamental; | ||||
|   the other inequality operators are essentially syntactic sugar.</p> | ||||
|  | ||||
|   <p><a name="n2" id="n2">[2]</a> Antisymmetry is a theorem, not an axiom: it | ||||
|   follows from irreflexivity and transitivity.</p> | ||||
|  | ||||
|   <p><a name="n3" id="n3">[3]</a> Because of irreflexivity and transitivity, | ||||
|   <tt>operator<</tt> always satisfies the definition of a <i>partial | ||||
|   ordering</i>. The definition of a <i>strict weak ordering</i> is stricter, | ||||
|   and the definition of a <i>total ordering</i> is stricter still.</p> | ||||
|  | ||||
|   <h3>See also</h3> | ||||
|  | ||||
|   <p><a href= | ||||
|   "http://www.sgi.com/tech/stl/EqualityComparable.html">EqualityComparable</a>, | ||||
|   <a href= | ||||
|   "http://www.sgi.com/tech/stl/StrictWeakOrdering.html">StrictWeakOrdering</a><br> | ||||
|   </p> | ||||
|   <hr> | ||||
|  | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 | ||||
|   December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr valign="top"> | ||||
|       <td nowrap><i>Copyright © 2000</i></td> | ||||
|  | ||||
|       <td><i><a href="http://www.lsc.nd.edu/~jsiek">Jeremy Siek</a>, Univ.of | ||||
|       Notre Dame (<a href= | ||||
|       "mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</a>)</i></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
| @@ -1,92 +1,95 @@ | ||||
| <HTML> | ||||
| <!-- | ||||
|   -- Copyright (c) Jeremy Siek 2000 | ||||
|   -- | ||||
|   -- Permission to use, copy, modify, distribute and sell this software | ||||
|   -- and its documentation for any purpose is hereby granted without fee, | ||||
|   -- provided that the above copyright notice appears in all copies and | ||||
|   -- that both that copyright notice and this permission notice appear | ||||
|   -- in supporting documentation.  Silicon Graphics makes no | ||||
|   -- representations about the suitability of this software for any | ||||
|   -- purpose.  It is provided "as is" without express or implied warranty. | ||||
|   --> | ||||
| <Head> | ||||
| <Title>MultiPassInputIterator</Title> | ||||
| <BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"  | ||||
| 	ALINK="#ff0000">  | ||||
| <IMG SRC="../../c++boost.gif"  | ||||
|      ALT="C++ Boost">  | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <BR Clear> | ||||
| <html> | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
| <H2> | ||||
| <A NAME="concept:MultiPassInputIterator"></A> | ||||
| MultiPassInputIterator | ||||
| </H2> | ||||
|   <title>MultiPassInputIterator</title> | ||||
| </head> | ||||
|  | ||||
| This concept is a refinement of <a | ||||
| href="http://www.sgi.com/Technology/STL/InputIterator.html">InputIterator</a>, | ||||
| adding the requirements that the iterator can be used to make multiple | ||||
| passes through a range, and that if <TT>it1 == it2</TT> and | ||||
| <TT>it1</TT> is dereferenceable then <TT>++it1 == ++it2</TT>. The | ||||
| MultiPassInputIterator is very similar to the <a | ||||
| href="http://www.sgi.com/Technology/STL/ForwardIterator.hmtl">ForwardIterator</a>. The | ||||
| only difference is that a <a | ||||
| href="http://www.sgi.com/Technology/STL/ForwardIterator.hmtl">ForwardIterator</a> | ||||
| requires the <TT>reference</TT> type to be <TT>value_type&</TT>, whereas | ||||
| MultiPassInputIterator is like <a | ||||
| href="http://www.sgi.com/Technology/STL/InputIterator.html">InputIterator</a> | ||||
| in that the <TT>reference</TT> type merely has to be convertible to | ||||
| <TT>value_type</TT>. | ||||
| <body bgcolor="#FFFFFF" link="#0000EE" text="#000000" vlink="#551A8B" alink= | ||||
| "#FF0000"> | ||||
|   <img src="../../boost.png" alt="C++ Boost" width="277" height= | ||||
|   "86"><br clear="none"> | ||||
|  | ||||
|   <h2><a name="concept:MultiPassInputIterator" id= | ||||
|   "concept:MultiPassInputIterator"></a> Multi-Pass Input Iterator</h2> | ||||
|  | ||||
| <h3>Design Notes</h3> | ||||
|   <p>This concept is a refinement of <a href= | ||||
|   "http://www.sgi.com/tech/stl/InputIterator.html">Input Iterator</a>, adding | ||||
|   the requirements that the iterator can be used to make multiple passes | ||||
|   through a range, and that if <tt>it1 == it2</tt> and <tt>it1</tt> is | ||||
|   dereferenceable then <tt>++it1 == ++it2</tt>. The Multi-Pass Input Iterator | ||||
|   is very similar to the <a href= | ||||
|   "http://www.sgi.com/tech/stl/ForwardIterator.html">Forward Iterator</a>. | ||||
|   The only difference is that a <a href= | ||||
|   "http://www.sgi.com/tech/stl/ForwardIterator.html">Forward Iterator</a> | ||||
|   requires the <tt>reference</tt> type to be <tt>value_type&</tt>, | ||||
|   whereas MultiPassInputIterator is like <a href= | ||||
|   "http://www.sgi.com/tech/stl/InputIterator.html">Input Iterator</a> in that | ||||
|   the <tt>reference</tt> type merely has to be convertible to | ||||
|   <tt>value_type</tt>.</p> | ||||
|  | ||||
| comments by Valentin Bonnard: | ||||
|   <h3>Design Notes</h3> | ||||
|  | ||||
| <p> I think that introducing MultiPassInputIterator isn't the right | ||||
| solution. Do you also want to define MultiPassBidirectionnalIterator | ||||
| and MultiPassRandomAccessIterator ? I don't, definitly. It only | ||||
| confuses the issue. The problem lies into the existing hierarchy of | ||||
| iterators, which mixes movabillity, modifiabillity and lvalue-ness, | ||||
| and these are clearly independant. | ||||
|   <p>comments by Valentin Bonnard:</p> | ||||
|  | ||||
| <p> The terms Forward, Bidirectionnal and RandomAccess are about | ||||
| movabillity and shouldn't be used to mean anything else.  In a | ||||
| completly orthogonal way, iterators can be immutable, mutable, or | ||||
| neither.  Lvalueness of iterators is also orthogonal with | ||||
| immutabillity.  With these clean concepts, your MultiPassInputIterator | ||||
| is just called a ForwardIterator. | ||||
|   <p>I think that introducing Multi-Pass Input Iterator isn't the right | ||||
|   solution. Do you also want to define Multi-Pass Bidirectionnal Iterator and | ||||
|   Multi-Pass Random Access Iterator ? I don't, definitly. It only confuses | ||||
|   the issue. The problem lies into the existing hierarchy of iterators, which | ||||
|   mixes movabillity, modifiabillity and lvalue-ness, and these are clearly | ||||
|   independant.</p> | ||||
|  | ||||
| <p>                 | ||||
| Other translations are:<br> | ||||
| std::ForwardIterator -> ForwardIterator & LvalueIterator<br> | ||||
| std::BidirectionnalIterator -> BidirectionnalIterator & LvalueIterator<br> | ||||
| std::RandomAccessIterator -> RandomAccessIterator & LvalueIterator<br> | ||||
|   <p>The terms Forward, Bidirectionnal and Random Access are about | ||||
|   movabillity and shouldn't be used to mean anything else. In a completly | ||||
|   orthogonal way, iterators can be immutable, mutable, or neither. Lvalueness | ||||
|   of iterators is also orthogonal with immutabillity. With these clean | ||||
|   concepts, your Multi-Pass Input Iterator is just called a Forward | ||||
|   Iterator.</p> | ||||
|  | ||||
| <p> | ||||
| Note that in practice the only operation not allowed on my  | ||||
| ForwardIterator which is allowed on std::ForwardIterator is  | ||||
| <tt>&*it</tt>. I think that <tt>&*</tt> is rarely needed in generic code. | ||||
|   <p>Other translations are:<br> | ||||
|   std::Forward Iterator -> ForwardIterator & Lvalue Iterator<br> | ||||
|   std::Bidirectionnal Iterator -> Bidirectionnal Iterator & Lvalue | ||||
|   Iterator<br> | ||||
|   std::Random Access Iterator -> Random Access Iterator & Lvalue | ||||
|   Iterator<br></p> | ||||
|  | ||||
| <p> | ||||
| reply by Jeremy Siek: | ||||
|   <p>Note that in practice the only operation not allowed on my Forward | ||||
|   Iterator which is allowed on std::Forward Iterator is <tt>&*it</tt>. I | ||||
|   think that <tt>&*</tt> is rarely needed in generic code.</p> | ||||
|  | ||||
| <p> | ||||
| The above analysis by Valentin is right on. Of course, there is | ||||
| the problem with backward compatibility. The current STL implementations | ||||
| are based on the old definition of ForwardIterator. The right course | ||||
| of action is to get ForwardIterator, etc. changed in the C++ standard. | ||||
| Once that is done we can drop MultiPassInputIterator. | ||||
|   <p>reply by Jeremy Siek:</p> | ||||
|  | ||||
|   <p>The above analysis by Valentin is right on. Of course, there is the | ||||
|   problem with backward compatibility. The current STL implementations are | ||||
|   based on the old definition of Forward Iterator. The right course of action | ||||
|   is to get Forward Iterator, etc. changed in the C++ standard. Once that is | ||||
|   done we can drop Multi-Pass Input Iterator.<br></p> | ||||
|   <hr> | ||||
|  | ||||
| <br> | ||||
| <HR> | ||||
| <TABLE> | ||||
| <TR valign=top> | ||||
| <TD nowrap>Copyright © 2000</TD><TD> | ||||
| <A HREF=http://www.boost.org/people/jeremy_siek.htm>Jeremy Siek</A>, Univ.of Notre Dame (<A HREF="mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</A>) | ||||
| </TD></TR></TABLE> | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
| </BODY> | ||||
| </HTML>  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 | ||||
|   December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <table summary=""> | ||||
|     <tr valign="top"> | ||||
|       <td nowrap><i>Copyright © 2000</i></td> | ||||
|  | ||||
|       <td><i><a href="http://www.lsc.nd.edu/~jsiek">Jeremy Siek</a>, Univ.of | ||||
|       Notre Dame (<a href= | ||||
|       "mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</a>)</i></td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
|   | ||||
							
								
								
									
										158
									
								
								OptionalPointee.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										158
									
								
								OptionalPointee.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,158 @@ | ||||
| <HTML> | ||||
| <Head> | ||||
| <Title>OptionalPointee Concept</Title> | ||||
| </HEAD> | ||||
| <BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"  | ||||
|         ALINK="#ff0000">  | ||||
| <IMG SRC="../../boost.png"  | ||||
|      ALT="C++ Boost" width="277" height="86">  | ||||
| <!--end header--> | ||||
| <BR Clear> | ||||
| <H1>Concept: OptionalPointee</H1> | ||||
|  | ||||
| <h3>Description</h3> | ||||
| A type is a model of <i>OptionalPointee</i> if it points to (or refers to) a value  | ||||
| that may not exist. That is, if it has a <b>pointee</b> which might be <b>valid</b> | ||||
| (existent) or <b>invalid</b> (inexistent); and it is possible to test whether the  | ||||
| pointee is valid or not. | ||||
| This model does <u>not</u> imply pointer semantics: i.e., it does not imply shallow copy nor | ||||
| aliasing. | ||||
| <h3>Notation</h3> | ||||
| <Table> | ||||
|   <TR> | ||||
|     <TD VAlign=top> <tt>T</tt> </TD> | ||||
|     <TD VAlign=top> is a type that is a model of OptionalPointee</TD> | ||||
|   </TR> | ||||
|   <TR> | ||||
|     <TD VAlign=top> <tt>t</tt> </TD> | ||||
|     <TD VAlign=top> is an object of type <tt>T</tt> or possibly <tt>const T</tt></TD> | ||||
|   </tr> | ||||
| </table> | ||||
| <h3>Definitions</h3> | ||||
| <h3>Valid expressions</h3> | ||||
| <Table border> | ||||
|   <TR> | ||||
|     <TH> Name </TH> | ||||
|     <TH> Expression </TH> | ||||
|     <TH> Return type </TH> | ||||
|     <TH> Semantics </TH> | ||||
|   </TR> | ||||
|   <TR> | ||||
|     <TD VAlign=top>Value Access</TD> | ||||
|     <TD VAlign=top> <tt>*t</tt></TD> | ||||
|     <TD VAlign=top> <tt>T&</tt></TD> | ||||
|     <TD VAlign=top>If the pointee is valid returns a reference to | ||||
|       the pointee.<br> | ||||
|       If the pointee is invalid the result is <i>undefined</i>.</TD> | ||||
|     <TD VAlign=top> </TD> | ||||
|   </TR> | ||||
|   <TR> | ||||
|     <TD VAlign=top>Value Access</TD> | ||||
|     <TD VAlign=top> <tt>t-><i>xyz</i></tt></TD> | ||||
|     <TD VAlign=top> <tt>T*</tt></TD> | ||||
|     <TD VAlign=top>If the pointee is valid returns a builtin pointer to the pointee.<br> | ||||
|       If the pointee is invalid the result is <i>undefined</i> (It might not even return NULL).<br> | ||||
|     </TD> | ||||
|     <TD VAlign=top> </TD> | ||||
|   </TR> | ||||
|   <TR> | ||||
|     <TD VAlign=top>Validity Test</TD> | ||||
|     <TD VAlign=top> <tt>t</tt><br> | ||||
|       <tt>t != 0</tt><br> | ||||
|       <tt>!!t</tt> | ||||
|      </TD> | ||||
|     <TD VAlign=top> bool </TD> | ||||
|     <TD VAlign=top>If the pointee is valid returns true.<br> | ||||
|       If the pointee is invalid returns false.</TD> | ||||
|     <TD VAlign=top></TD> | ||||
|   </TR> | ||||
|   <TR> | ||||
|     <TD VAlign=top>Invalidity Test</TD> | ||||
|     <TD VAlign=top> <tt>t == 0</tt><br> | ||||
|                     <tt>!t</tt> | ||||
|     </TD> | ||||
|     <TD VAlign=top> bool </TD> | ||||
|     <TD VAlign=top>If the pointee is valid returns false.<br> | ||||
|       If the pointee is invalid returns true.</TD> | ||||
|     <TD VAlign=top></TD> | ||||
|   </TR> | ||||
| </table> | ||||
|  | ||||
|  | ||||
| <h3>Models</h3> | ||||
|  | ||||
| <UL> | ||||
|   <LI><tt>pointers, both builtin and smart.</tt> | ||||
|   <LI><tt>boost::optional<></tt> | ||||
| </UL> | ||||
|  | ||||
| <HR> | ||||
| <h3>OptionalPointee and relational operations</h3> | ||||
| <p>This concept does not define any particular semantic for relational operations, therefore, | ||||
| a type which models this concept might have either shallow or deep relational semantics.<br> | ||||
| For instance, pointers, which are models of OptionalPointee, have shallow relational operators: | ||||
| comparisons of pointers do not involve comparisons of pointees. | ||||
| This makes sense for pointers because they have shallow copy semantics.<br> | ||||
| But boost::optional<T>, on the other hand, which is also a model of OptionalPointee, has | ||||
| deep-copy and deep-relational semantics.<br> | ||||
| If generic code is written for this concept, it is important not to use relational | ||||
| operators directly because the semantics might be different depending on the actual type.<br> | ||||
| Still, the concept itsef can be used to define <i>deep</i> relational tests that can | ||||
| be used in generic code with any type which models OptionalPointee:</p> | ||||
| <a name="equal"></a> | ||||
| <p><u>Equivalence relation:</u></p> | ||||
| <pre>template<class OptionalPointee> | ||||
| inline | ||||
| bool equal_pointees ( OptionalPointee const& x, OptionalPointee const& y ) | ||||
| { | ||||
|   return (!x) != (!y) ? false : ( !x ? true : (*x) == (*y) ) ; | ||||
| } | ||||
| template<class OptionalPointee> | ||||
| struct equal_pointees_t : std::binary_function<OptionalPointee,OptionalPointee,bool> | ||||
| { | ||||
|   bool operator() ( OptionalPointee const& x, OptionalPointee const& y ) const | ||||
|     { return equal_pointees(x,y) ; } | ||||
| } ; | ||||
| </pre> | ||||
| <p>The preceding generic function and function object have the following semantics:<br> | ||||
| If both <b>x</b> and <b>y</b> have valid pointees, it compares values via <code>(*x == *y)</code>.<br> | ||||
| If only one has a valid pointee, returns <code>false</code>.<br> | ||||
| If both have invalid pointees, returns <code>true</code>.</p> | ||||
| <a name="less"></a> | ||||
| <p><u>Less-than relation:</u></p> | ||||
| <pre>template<class OptionalPointee> | ||||
| inline | ||||
| bool less_pointees ( OptionalPointee const& x, OptionalPointee const& y ) | ||||
| { | ||||
|   return !y ? false : ( !x ? true : (*x) < (*y) ) ; | ||||
| } | ||||
| template<class OptionalPointee> | ||||
| struct less_pointees_t : std::binary_function<OptionalPointee,OptionalPointee,bool> | ||||
| { | ||||
|   bool operator() ( OptionalPointee const& x, OptionalPointee const& y ) const | ||||
|     { return less_pointees(x,y) ; } | ||||
| } ; | ||||
| </pre> | ||||
| <p>The preceding generic function and function object have the following semantics:<br> | ||||
| If <b>y</b> has an invalid pointee, returns <code>false</code>.<br> | ||||
| Else, if <b>x</b> has an invalid pointee, returns <code>true</code>.<br> | ||||
| Else, ( <b>x</b> and <b>y</b> have valid pointees), compares values via <code>(*x <  | ||||
| *y).</code></p> | ||||
| <p><br> | ||||
| All these functions and function  | ||||
| objects are is implemented in <a href="../../boost/utility/compare_pointees.hpp">compare_pointees.hpp</a></p> | ||||
| <p>Notice that OptionalPointee does not imply aliasing (and optional<> for instance does not alias); | ||||
| so direct usage of relational operators with the implied aliasing of shallow semantics | ||||
| -as with pointers- should not be used with generic code written for this concept.</p> | ||||
|  | ||||
| <br> | ||||
| <HR> | ||||
| <TABLE> | ||||
| <TR valign=top> | ||||
| <TD nowrap>Copyright © 2003</TD><TD> | ||||
| <A HREF="mailto:fernando_cacciola@hotmail.com">Fernando Cacciola</A>, | ||||
| based on the original concept developed by Augustus Saunders. | ||||
| </TD></TR></TABLE> | ||||
|  | ||||
| </BODY> | ||||
| </HTML> | ||||
							
								
								
									
										94
									
								
								addressof_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										94
									
								
								addressof_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,94 @@ | ||||
| // Copyright (C) 2002 Brad King (brad.king@kitware.com)  | ||||
| //                    Douglas Gregor (gregod@cs.rpi.edu) | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // For more information, see http://www.boost.org | ||||
|  | ||||
|  | ||||
| #include <boost/utility/addressof.hpp> | ||||
|  | ||||
| #if defined(BOOST_MSVC) && (BOOST_MSVC < 1300) | ||||
| #pragma warning(push, 3) | ||||
| #endif | ||||
|  | ||||
| #include <iostream> | ||||
|  | ||||
| #if defined(BOOST_MSVC) && (BOOST_MSVC < 1300) | ||||
| #pragma warning(pop) | ||||
| #endif | ||||
|  | ||||
| #include <boost/detail/lightweight_test.hpp> | ||||
|  | ||||
| template<class T> void scalar_test( T * = 0 ) | ||||
| { | ||||
|     T* px = new T(); | ||||
|  | ||||
|     T& x = *px; | ||||
|     BOOST_TEST( boost::addressof(x) == px ); | ||||
|  | ||||
|     const T& cx = *px; | ||||
|     const T* pcx = boost::addressof(cx); | ||||
|     BOOST_TEST( pcx == px ); | ||||
|  | ||||
|     volatile T& vx = *px; | ||||
|     volatile T* pvx = boost::addressof(vx); | ||||
|     BOOST_TEST( pvx == px ); | ||||
|  | ||||
|     const volatile T& cvx = *px; | ||||
|     const volatile T* pcvx = boost::addressof(cvx); | ||||
|     BOOST_TEST( pcvx == px ); | ||||
|  | ||||
|     delete px; | ||||
| } | ||||
|  | ||||
| template<class T> void array_test( T * = 0 ) | ||||
| { | ||||
|     T nrg[3] = {1,2,3}; | ||||
|     T (*pnrg)[3] = &nrg; | ||||
|     BOOST_TEST( boost::addressof(nrg) == pnrg ); | ||||
|  | ||||
|     T const cnrg[3] = {1,2,3}; | ||||
|     T const (*pcnrg)[3] = &cnrg; | ||||
|     BOOST_TEST( boost::addressof(cnrg) == pcnrg ); | ||||
| } | ||||
|  | ||||
| struct addressable | ||||
| { | ||||
|     addressable( int = 0 ) | ||||
|     { | ||||
|     } | ||||
| }; | ||||
|  | ||||
| struct useless_type {}; | ||||
|  | ||||
| class nonaddressable { | ||||
| public: | ||||
|  | ||||
|     nonaddressable( int = 0 ) | ||||
|     { | ||||
|     } | ||||
|  | ||||
|     void dummy(); // Silence GCC warning: all member of class are private | ||||
|  | ||||
| private: | ||||
|  | ||||
|     useless_type operator&() const; | ||||
| }; | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     scalar_test<char>(); | ||||
|     scalar_test<int>(); | ||||
|     scalar_test<addressable>(); | ||||
|     scalar_test<nonaddressable>(); | ||||
|  | ||||
|     array_test<char>(); | ||||
|     array_test<int>(); | ||||
|     array_test<addressable>(); | ||||
|     array_test<nonaddressable>(); | ||||
|  | ||||
|     return boost::report_errors(); | ||||
| } | ||||
| @@ -1,423 +0,0 @@ | ||||
|  | ||||
| /* | ||||
|  * | ||||
|  * Copyright (c) 1999 | ||||
|  * Dr John Maddock | ||||
|  * | ||||
|  * Permission to use, copy, modify, distribute and sell this software | ||||
|  * and its documentation for any purpose is hereby granted without fee, | ||||
|  * provided that the above copyright notice appear in all copies and | ||||
|  * that both that copyright notice and this permission notice appear | ||||
|  * in supporting documentation.  Dr John Maddock makes no representations | ||||
|  * about the suitability of this software for any purpose. | ||||
|  * It is provided "as is" without express or implied warranty. | ||||
|  * | ||||
|  * This file provides some example of type_traits usage - | ||||
|  * by "optimising" various algorithms: | ||||
|  * | ||||
|  * opt::copy - optimised for trivial copy (cf std::copy) | ||||
|  * opt::fill - optimised for trivial copy/small types (cf std::fill) | ||||
|  * opt::destroy_array - an example of optimisation based upon omitted destructor calls | ||||
|  * opt::iter_swap - uses type_traits to determine whether the iterator is a proxy | ||||
|  *                  in which case it uses a "safe" approach, otherwise calls swap | ||||
|  *                  on the assumption that swap may be specialised for the pointed-to type. | ||||
|  * | ||||
|  */ | ||||
|  | ||||
| /* Release notes: | ||||
|    23rd July 2000: | ||||
|       Added explicit failure for broken compilers that don't support these examples. | ||||
|       Fixed broken gcc support (broken using directive). | ||||
|       Reordered tests slightly. | ||||
| */ | ||||
|  | ||||
| #include <iostream> | ||||
| #include <typeinfo> | ||||
| #include <algorithm> | ||||
| #include <iterator> | ||||
| #include <vector> | ||||
| #include <memory> | ||||
|  | ||||
| #include <boost/timer.hpp> | ||||
| #include <boost/type_traits.hpp> | ||||
| #include <boost/call_traits.hpp> | ||||
|  | ||||
| using std::cout; | ||||
| using std::endl; | ||||
| using std::cin; | ||||
|  | ||||
| #ifdef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| #error "Sorry, without template partial specialisation support there isn't anything to test here..." | ||||
| #endif | ||||
|  | ||||
| namespace opt{ | ||||
|  | ||||
| // | ||||
| // algorithm destroy_array: | ||||
| // The reverse of std::unitialized_copy, takes a block of | ||||
| // unitialized memory and calls destructors on all objects therein. | ||||
| // | ||||
|  | ||||
| namespace detail{ | ||||
|  | ||||
| template <bool> | ||||
| struct array_destroyer | ||||
| { | ||||
|    template <class T> | ||||
|    static void destroy_array(T* i, T* j){ do_destroy_array(i, j); } | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct array_destroyer<true> | ||||
| { | ||||
|    template <class T> | ||||
|    static void destroy_array(T*, T*){} | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| void do_destroy_array(T* first, T* last) | ||||
| { | ||||
|    while(first != last) | ||||
|    { | ||||
|       first->~T(); | ||||
|       ++first; | ||||
|    } | ||||
| } | ||||
|  | ||||
| }; // namespace detail | ||||
|  | ||||
| template <class T> | ||||
| inline void destroy_array(T* p1, T* p2) | ||||
| { | ||||
|    detail::array_destroyer<boost::has_trivial_destructor<T>::value>::destroy_array(p1, p2); | ||||
| } | ||||
|  | ||||
| // | ||||
| // unoptimised versions of destroy_array: | ||||
| // | ||||
| template <class T> | ||||
| void destroy_array1(T* first, T* last) | ||||
| { | ||||
|    while(first != last) | ||||
|    { | ||||
|       first->~T(); | ||||
|       ++first; | ||||
|    } | ||||
| } | ||||
| template <class T> | ||||
| void destroy_array2(T* first, T* last) | ||||
| { | ||||
|    for(; first != last; ++first) first->~T(); | ||||
| } | ||||
|  | ||||
|  | ||||
| // | ||||
| // opt::copy | ||||
| // same semantics as std::copy | ||||
| // calls memcpy where appropiate. | ||||
| // | ||||
|  | ||||
| namespace detail{ | ||||
|  | ||||
| template <bool b> | ||||
| struct copier | ||||
| { | ||||
|    template<typename I1, typename I2> | ||||
|    static I2 do_copy(I1 first, I1 last, I2 out); | ||||
| }; | ||||
|  | ||||
| template <bool b> | ||||
| template<typename I1, typename I2> | ||||
| I2 copier<b>::do_copy(I1 first, I1 last, I2 out) | ||||
| { | ||||
|    while(first != last) | ||||
|    { | ||||
|       *out = *first; | ||||
|       ++out; | ||||
|       ++first; | ||||
|    } | ||||
|    return out; | ||||
| } | ||||
|  | ||||
| template <> | ||||
| struct copier<true> | ||||
| { | ||||
|    template<typename I1, typename I2> | ||||
|    static I2* do_copy(I1* first, I1* last, I2* out) | ||||
|    { | ||||
|       memcpy(out, first, (last-first)*sizeof(I2)); | ||||
|       return out+(last-first); | ||||
|    } | ||||
| }; | ||||
|  | ||||
|  | ||||
| } | ||||
|  | ||||
| template<typename I1, typename I2> | ||||
| inline I2 copy(I1 first, I1 last, I2 out) | ||||
| { | ||||
|    typedef typename boost::remove_cv<typename std::iterator_traits<I1>::value_type>::type v1_t; | ||||
|    typedef typename boost::remove_cv<typename std::iterator_traits<I2>::value_type>::type v2_t; | ||||
|    enum{ can_opt = boost::is_same<v1_t, v2_t>::value | ||||
|                    && boost::is_pointer<I1>::value | ||||
|                    && boost::is_pointer<I2>::value | ||||
|                    && boost::has_trivial_assign<v1_t>::value }; | ||||
|    return detail::copier<can_opt>::do_copy(first, last, out); | ||||
| } | ||||
|  | ||||
| // | ||||
| // fill | ||||
| // same as std::fill, uses memset where appropriate, along with call_traits | ||||
| // to "optimise" parameter passing. | ||||
| // | ||||
| namespace detail{ | ||||
|  | ||||
| template <bool opt> | ||||
| struct filler | ||||
| { | ||||
|    template <typename I, typename T> | ||||
|    static void do_fill(I first, I last, typename boost::call_traits<T>::param_type val); | ||||
|  }; | ||||
|  | ||||
| template <bool b> | ||||
| template <typename I, typename T> | ||||
| void filler<b>::do_fill(I first, I last, typename boost::call_traits<T>::param_type val) | ||||
| { | ||||
|    while(first != last) | ||||
|    { | ||||
|       *first = val; | ||||
|       ++first; | ||||
|    } | ||||
| } | ||||
|  | ||||
| template <> | ||||
| struct filler<true> | ||||
| { | ||||
|    template <typename I, typename T> | ||||
|    static void do_fill(I first, I last, T val) | ||||
|    { | ||||
|       memset(first, val, last-first); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| } | ||||
|  | ||||
| template <class I, class T> | ||||
| inline void fill(I first, I last, const T& val) | ||||
| { | ||||
|    enum{ can_opt = boost::is_pointer<I>::value | ||||
|                    && boost::is_arithmetic<T>::value | ||||
|                    && (sizeof(T) == 1) }; | ||||
|    typedef detail::filler<can_opt> filler_t; | ||||
|    filler_t::template do_fill<I,T>(first, last, val); | ||||
| } | ||||
|  | ||||
| // | ||||
| // iter_swap: | ||||
| // tests whether iterator is a proxying iterator or not, and | ||||
| // uses optimal form accordingly: | ||||
| // | ||||
| namespace detail{ | ||||
|  | ||||
| template <bool b> | ||||
| struct swapper | ||||
| { | ||||
|    template <typename I> | ||||
|    static void do_swap(I one, I two) | ||||
|    { | ||||
|       typedef typename std::iterator_traits<I>::value_type v_t; | ||||
|       v_t v = *one; | ||||
|       *one = *two; | ||||
|       *two = v; | ||||
|    } | ||||
| }; | ||||
|  | ||||
| #ifdef __GNUC__ | ||||
| using std::swap; | ||||
| #endif | ||||
|  | ||||
| template <> | ||||
| struct swapper<true> | ||||
| { | ||||
|    template <typename I> | ||||
|    static void do_swap(I one, I two) | ||||
|    { | ||||
|       using std::swap; | ||||
|       swap(*one, *two); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| } | ||||
|  | ||||
| template <typename I1, typename I2> | ||||
| inline void iter_swap(I1 one, I2 two) | ||||
| { | ||||
|    typedef typename std::iterator_traits<I1>::reference r1_t; | ||||
|    typedef typename std::iterator_traits<I2>::reference r2_t; | ||||
|    enum{ can_opt = boost::is_reference<r1_t>::value && boost::is_reference<r2_t>::value && boost::is_same<r1_t, r2_t>::value }; | ||||
|    detail::swapper<can_opt>::do_swap(one, two); | ||||
| } | ||||
|  | ||||
|  | ||||
| };   // namespace opt | ||||
|  | ||||
| // | ||||
| // define some global data: | ||||
| // | ||||
| const int array_size = 1000; | ||||
| int i_array[array_size] = {0,}; | ||||
| const int ci_array[array_size] = {0,}; | ||||
| char c_array[array_size] = {0,}; | ||||
| const char cc_array[array_size] = { 0,}; | ||||
|  | ||||
| const int iter_count = 1000000; | ||||
|  | ||||
|  | ||||
| int main() | ||||
| { | ||||
|    // | ||||
|    // test destroy_array, | ||||
|    // compare destruction time of an array of ints | ||||
|    // with unoptimised form. | ||||
|    // | ||||
|    cout << "Measuring times in micro-seconds per 1000 elements processed" << endl << endl; | ||||
|    cout << "testing destroy_array...\n" | ||||
|     "[Some compilers may be able to optimise the \"unoptimised\"\n versions as well as type_traits does.]" << endl; | ||||
|    /*cache load*/ opt::destroy_array(i_array, i_array + array_size); | ||||
|    boost::timer t; | ||||
|    double result; | ||||
|    int i; | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::destroy_array(i_array, i_array + array_size); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "destroy_array<int>: " << result << endl; | ||||
|    /*cache load*/ opt::destroy_array1(i_array, i_array + array_size); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::destroy_array1(i_array, i_array + array_size); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "destroy_array<int>(unoptimised#1): " << result << endl; | ||||
|    /*cache load*/ opt::destroy_array2(i_array, i_array + array_size); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::destroy_array2(i_array, i_array + array_size); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "destroy_array<int>(unoptimised#2): " << result << endl << endl; | ||||
|  | ||||
|    cout << "testing fill(char)...\n" | ||||
|    "[Some standard library versions may already perform this optimisation.]" << endl; | ||||
|    /*cache load*/ opt::fill<char*, char>(c_array, c_array + array_size, (char)3); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::fill<char*, char>(c_array, c_array + array_size, (char)3); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "opt::fill<char*, char>: " << result << endl; | ||||
|    /*cache load*/ std::fill(c_array, c_array + array_size, (char)3); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       std::fill(c_array, c_array + array_size, (char)3); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "std::fill<char*, char>: " << result << endl << endl; | ||||
|  | ||||
|    cout << "testing fill(int)...\n" | ||||
|    "[Tests the effect of call_traits pass-by-value optimisation -\nthe value of this optimisation may depend upon hardware characteristics.]" << endl; | ||||
|    /*cache load*/ opt::fill<int*, int>(i_array, i_array + array_size, 3); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::fill<int*, int>(i_array, i_array + array_size, 3); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "opt::fill<int*, int>: " << result << endl; | ||||
|    /*cache load*/ std::fill(i_array, i_array + array_size, 3); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       std::fill(i_array, i_array + array_size, 3); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "std::fill<int*, int>: " << result << endl << endl; | ||||
|  | ||||
|    cout << "testing copy...\n" | ||||
|    "[Some standard library versions may already perform this optimisation.]" << endl; | ||||
|    /*cache load*/ opt::copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "opt::copy<const int*, int*>: " << result << endl; | ||||
|    /*cache load*/ std::copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       std::copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "std::copy<const int*, int*>: " << result << endl; | ||||
|    /*cache load*/ opt::detail::copier<false>::template do_copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::detail::copier<false>::template do_copy<const int*, int*>(ci_array, ci_array + array_size, i_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "standard \"unoptimised\" copy: " << result << endl << endl; | ||||
|  | ||||
|    /*cache load*/ opt::copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "opt::copy<const char*, char*>: " << result << endl; | ||||
|    /*cache load*/ std::copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       std::copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "std::copy<const char*, char*>: " << result << endl; | ||||
|    /*cache load*/ opt::detail::copier<false>::template do_copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    t.restart(); | ||||
|    for(i = 0; i < iter_count; ++i) | ||||
|    { | ||||
|       opt::detail::copier<false>::template do_copy<const char*, char*>(cc_array, cc_array + array_size, c_array); | ||||
|    } | ||||
|    result = t.elapsed(); | ||||
|    cout << "standard \"unoptimised\" copy: " << result << endl << endl; | ||||
|  | ||||
|  | ||||
|    // | ||||
|    // testing iter_swap | ||||
|    // really just a check that it does in fact compile... | ||||
|    std::vector<int> v1; | ||||
|    v1.push_back(0); | ||||
|    v1.push_back(1); | ||||
|    std::vector<bool> v2; | ||||
|    v2.push_back(0); | ||||
|    v2.push_back(1); | ||||
|    opt::iter_swap(v1.begin(), v1.begin()+1); | ||||
|    opt::iter_swap(v2.begin(), v2.begin()+1); | ||||
|  | ||||
|    cout << "Press any key to exit..."; | ||||
|    cin.get(); | ||||
| } | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
							
								
								
									
										55
									
								
								assert.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										55
									
								
								assert.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,55 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||||
| <html> | ||||
| 	<head> | ||||
| 		<title>Boost: assert.hpp documentation</title> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| 	</head> | ||||
| 	<body bgcolor="white" style="MARGIN-LEFT: 5%; MARGIN-RIGHT: 5%"> | ||||
| 		<table border="0" width="100%"> | ||||
| 			<tr> | ||||
| 				<td width="277"><A href="../../index.htm"> <img src="../../boost.png" alt="boost.png (6897 bytes)" width="277" height="86" border="0"></A> | ||||
| 				</td> | ||||
| 				<td align="center"> | ||||
| 					<h1>assert.hpp</h1> | ||||
| 				</td> | ||||
| 			</tr> | ||||
| 			<tr> | ||||
| 				<td colspan="2" height="64"> </td> | ||||
| 			</tr> | ||||
| 		</table> | ||||
| 		<p> | ||||
| 			The header <STRONG><boost/assert.hpp></STRONG> defines the macro <b>BOOST_ASSERT</b>,  | ||||
| 			which is similar to the standard <STRONG>assert</STRONG> macro defined in <STRONG><cassert></STRONG>.  | ||||
| 			The macro is intended to be used in Boost libraries. | ||||
| 		</p> | ||||
| 		<P>By default, <tt>BOOST_ASSERT(expr)</tt> is equivalent to <tt>assert(expr)</tt>.</P> | ||||
| 		<P>When the macro <STRONG>BOOST_DISABLE_ASSERTS</STRONG> is defined when <STRONG><boost/assert.hpp></STRONG> | ||||
| 			is included, <tt>BOOST_ASSERT(expr)</tt> is defined as <tt>((void)0)</tt>. This  | ||||
| 			allows users to selectively disable <STRONG>BOOST_ASSERT</STRONG> without  | ||||
| 			affecting the definition of the standard <STRONG>assert</STRONG>.</P> | ||||
| 		<P>When the macro <STRONG>BOOST_ENABLE_ASSERT_HANDLER</STRONG> is defined when <STRONG><boost/assert.hpp></STRONG> | ||||
| 			is included, <tt>BOOST_ASSERT(expr)</tt> evaluates <b>expr</b> and, if the  | ||||
| 			result is false, evaluates the expression</P> | ||||
| 		<P><tt>::boost::assertion_failed(#expr, <a href="current_function.html">BOOST_CURRENT_FUNCTION</a>,  | ||||
| 				__FILE__, __LINE__)</tt></P> | ||||
| 		<P><STRONG>assertion_failed</STRONG> is declared in <STRONG><boost/assert.hpp></STRONG> | ||||
| 			as</P> | ||||
| 		<pre> | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| void assertion_failed(char const * expr, char const * function, char const * file, long line); | ||||
|  | ||||
| } | ||||
| </pre> | ||||
| 		<p>but it is never defined. The user is expected to supply an appropriate  | ||||
| 			definition.</p> | ||||
| 		<P>As is the case with <STRONG><cassert></STRONG>, <STRONG><boost/assert.hpp></STRONG> | ||||
| 			can be included multiple times in a single translation unit. <STRONG>BOOST_ASSERT</STRONG> | ||||
| 			will be redefined each time as specified above.</P> | ||||
| 		<p><br> | ||||
| 			<small>Copyright <20> 2002 by Peter Dimov. Distributed under the Boost Software License, Version  | ||||
| 				1.0. See accompanying file <A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or  | ||||
| 				copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>.</small></p> | ||||
| 	</body> | ||||
| </html> | ||||
							
								
								
									
										109
									
								
								assert_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										109
									
								
								assert_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,109 @@ | ||||
| // | ||||
| //  assert_test.cpp - a test for boost/assert.hpp | ||||
| // | ||||
| //  Copyright (c) 2002 Peter Dimov and Multi Media Ltd. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
|  | ||||
| #include <boost/detail/lightweight_test.hpp> | ||||
|  | ||||
| #include <boost/assert.hpp> | ||||
|  | ||||
| void test_default() | ||||
| { | ||||
|     int x = 1; | ||||
|  | ||||
|     BOOST_ASSERT(1); | ||||
|     BOOST_ASSERT(x); | ||||
|     BOOST_ASSERT(x == 1); | ||||
|     BOOST_ASSERT(&x); | ||||
| } | ||||
|  | ||||
| #define BOOST_DISABLE_ASSERTS | ||||
| #include <boost/assert.hpp> | ||||
|  | ||||
| void test_disabled() | ||||
| { | ||||
|     int x = 1; | ||||
|  | ||||
|     BOOST_ASSERT(1); | ||||
|     BOOST_ASSERT(x); | ||||
|     BOOST_ASSERT(x == 1); | ||||
|     BOOST_ASSERT(&x); | ||||
|  | ||||
|     BOOST_ASSERT(0); | ||||
|     BOOST_ASSERT(!x); | ||||
|     BOOST_ASSERT(x == 0); | ||||
|  | ||||
|     void * p = 0; | ||||
|  | ||||
|     BOOST_ASSERT(p); | ||||
|  | ||||
|     // supress warnings | ||||
|     p = &x; | ||||
|     p = &p; | ||||
| } | ||||
|  | ||||
| #undef BOOST_DISABLE_ASSERTS | ||||
|  | ||||
| #define BOOST_ENABLE_ASSERT_HANDLER | ||||
| #include <boost/assert.hpp> | ||||
| #include <boost/config.hpp> | ||||
| #include <cstdio> | ||||
|  | ||||
| int handler_invoked = 0; | ||||
|  | ||||
| void boost::assertion_failed(char const * expr, char const * function, char const * file, long line) | ||||
| { | ||||
| #if !defined(BOOST_NO_STDC_NAMESPACE) | ||||
|     using std::printf; | ||||
| #endif | ||||
|  | ||||
|     printf("Expression: %s\nFunction: %s\nFile: %s\nLine: %ld\n\n", expr, function, file, line); | ||||
|     ++handler_invoked; | ||||
| } | ||||
|  | ||||
| struct X | ||||
| { | ||||
|     static void f() | ||||
|     { | ||||
|         BOOST_ASSERT(0); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| void test_handler() | ||||
| { | ||||
|     int x = 1; | ||||
|  | ||||
|     BOOST_ASSERT(1); | ||||
|     BOOST_ASSERT(x); | ||||
|     BOOST_ASSERT(x == 1); | ||||
|     BOOST_ASSERT(&x); | ||||
|  | ||||
|     BOOST_ASSERT(0); | ||||
|     BOOST_ASSERT(!x); | ||||
|     BOOST_ASSERT(x == 0); | ||||
|  | ||||
|     void * p = 0; | ||||
|  | ||||
|     BOOST_ASSERT(p); | ||||
|  | ||||
|     X::f(); | ||||
|  | ||||
|     BOOST_ASSERT(handler_invoked == 5); | ||||
|     BOOST_TEST(handler_invoked == 5); | ||||
| } | ||||
|  | ||||
| #undef BOOST_ENABLE_ASSERT_HANDLER | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     test_default(); | ||||
|     test_disabled(); | ||||
|     test_handler(); | ||||
|  | ||||
|     return boost::report_errors(); | ||||
| } | ||||
							
								
								
									
										371
									
								
								base_from_member.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										371
									
								
								base_from_member.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,371 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> | ||||
| <html> | ||||
| <head> | ||||
| <title>Boost: Base-from-Member Idiom Documentation</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="white" link="blue" text="black" vlink="purple" alink="red">  | ||||
| <h1><img src="../../boost.png" alt="C++ Boost" align="middle" | ||||
| width="277" height="86">Base-from-Member Idiom</h1> | ||||
|  | ||||
| <p>The class template <code>boost::base_from_member</code> provides | ||||
| a workaround for a class that needs to initialize a base class with a | ||||
| member.  The class template is in <cite><a | ||||
| href="../../boost/utility/base_from_member.hpp">boost/utility/base_from_member.hpp</a></cite> | ||||
| which is included in <i><a href="../../boost/utility.hpp">boost/utility.hpp</a></i>.</p> | ||||
|  | ||||
| <p>There is test/example code in <cite><a | ||||
| href="base_from_member_test.cpp">base_from_member_test.cpp</a></cite>.</p> | ||||
|  | ||||
| <h2><a name="contents">Contents</a></h2> | ||||
|  | ||||
| <ul> | ||||
| 	<li><a href="#contents">Contents</a></li> | ||||
| 	<li><a href="#rationale">Rationale</a></li> | ||||
| 	<li><a href="#synopsis">Synopsis</a></li> | ||||
| 	<li><a href="#usage">Usage</a></li> | ||||
| 	<li><a href="#example">Example</a></li> | ||||
| 	<li><a href="#credits">Credits</a> | ||||
| 		<ul> | ||||
| 			<li><a href="#contributors">Contributors</a></li> | ||||
| 		</ul></li> | ||||
| </ul> | ||||
|  | ||||
| <h2><a name="rationale">Rationale</a></h2> | ||||
|  | ||||
| <p>When developing a class, sometimes a base class needs to be | ||||
| initialized with a member of the current class.  As a naïve | ||||
| example:</p> | ||||
|  | ||||
| <blockquote><pre> | ||||
| #include <streambuf>  <i>// for std::streambuf</i> | ||||
| #include <ostream>    <i>// for std::ostream</i> | ||||
|  | ||||
| class fdoutbuf | ||||
|     : public std::streambuf | ||||
| { | ||||
| public: | ||||
|     explicit fdoutbuf( int fd ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| class fdostream | ||||
|     : public std::ostream | ||||
| { | ||||
| protected: | ||||
|     fdoutbuf buf; | ||||
| public: | ||||
|     explicit fdostream( int fd ) | ||||
|         : buf( fd ), std::ostream( &buf ) | ||||
|         {} | ||||
|     //... | ||||
| }; | ||||
| </pre></blockquote> | ||||
|  | ||||
| <p>This is undefined because C++'s initialization order mandates that | ||||
| the base class is initialized before the member it uses.  <a | ||||
| href="http://www.moocat.org">R. Samuel Klatchko</a> developed a way | ||||
| around this by using the initialization order in his favor.  Base | ||||
| classes are intialized in order of declaration, so moving the desired | ||||
| member to another base class, that is initialized before the desired | ||||
| base class, can ensure proper initialization.</p> | ||||
|  | ||||
| <p>A custom base class can be made for this idiom:</p> | ||||
|  | ||||
| <blockquote><pre> | ||||
| #include <streambuf>  <i>// for std::streambuf</i> | ||||
| #include <ostream>    <i>// for std::ostream</i> | ||||
|  | ||||
| class fdoutbuf | ||||
|     : public std::streambuf | ||||
| { | ||||
| public: | ||||
|     explicit fdoutbuf( int fd ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| struct fdostream_pbase | ||||
| { | ||||
|     fdoutbuf sbuffer; | ||||
|  | ||||
|     explicit fdostream_pbase( int fd ) | ||||
|         : sbuffer( fd ) | ||||
|         {} | ||||
| }; | ||||
|  | ||||
| class fdostream | ||||
|     : private fdostream_pbase | ||||
|     , public std::ostream | ||||
| { | ||||
|     typedef fdostream_pbase  pbase_type; | ||||
|     typedef std::ostream     base_type; | ||||
|  | ||||
| public: | ||||
|     explicit fdostream( int fd ) | ||||
|         : pbase_type( fd ), base_type( &sbuffer ) | ||||
|         {} | ||||
|     //... | ||||
| }; | ||||
| </pre></blockquote> | ||||
|  | ||||
| <p>Other projects can use similar custom base classes.  The technique | ||||
| is basic enough to make a template, with a sample template class in | ||||
| this library.  The main template parameter is the type of the enclosed | ||||
| member.  The template class has several (explicit) constructor member | ||||
| templates, which implicitly type the constructor arguments and pass them | ||||
| to the member.  The template class uses implicit copy construction and | ||||
| assignment, cancelling them if the enclosed member is non-copyable.</p> | ||||
|  | ||||
| <p>Manually coding a base class may be better if the construction | ||||
| and/or copying needs are too complex for the supplied template class, | ||||
| or if the compiler is not advanced enough to use it.</p> | ||||
|  | ||||
| <p>Since base classes are unnamed, a class cannot have multiple (direct) | ||||
| base classes of the same type.  The supplied template class has an | ||||
| extra template parameter, an integer, that exists solely to provide type | ||||
| differentiation.  This parameter has a default value so a single use of a | ||||
| particular member type does not need to concern itself with the integer.</p> | ||||
|  | ||||
| <h2><a name="synopsis">Synopsis</a></h2> | ||||
|  | ||||
| <blockquote><pre> | ||||
| #ifndef BOOST_BASE_FROM_MEMBER_MAX_ARITY | ||||
| #define BOOST_BASE_FROM_MEMBER_MAX_ARITY  10 | ||||
| #endif | ||||
|  | ||||
| template < typename MemberType, int UniqueID = 0 > | ||||
| class boost::base_from_member | ||||
| { | ||||
| protected: | ||||
|     MemberType  member; | ||||
|  | ||||
|     base_from_member(); | ||||
|  | ||||
|     template< typename T1 > | ||||
|     explicit  base_from_member( T1 x1 ); | ||||
|  | ||||
|     template< typename T1, typename T2 > | ||||
|     base_from_member( T1 x1, T2 x2 ); | ||||
|  | ||||
|     //... | ||||
|  | ||||
|     template< typename T1, typename T2, typename T3, typename T4, | ||||
|      typename T5, typename T6, typename T7, typename T8, typename T9, | ||||
|      typename T10 > | ||||
|     base_from_member( T1 x1, T2 x2, T3 x3, T4 x4, T5 x5, T6 x6, T7 x7, | ||||
|      T8 x8, T9 x9, T10 x10 ); | ||||
| }; | ||||
| </pre></blockquote> | ||||
|  | ||||
| <p>The class template has a first template parameter | ||||
| <var>MemberType</var> representing the type of the based-member. | ||||
| It has a last template parameter <var>UniqueID</var>, that is an | ||||
| <code>int</code>, to differentiate between multiple base classes that use | ||||
| the same based-member type.  The last template parameter has a default | ||||
| value of zero if it is omitted.  The class template has a protected | ||||
| data member called <var>member</var> that the derived class can use | ||||
| for later base classes (or itself).</p> | ||||
|  | ||||
| <p>There is a default constructor and several constructor member | ||||
| templates.  These constructor templates can take as many arguments | ||||
| (currently up to ten) as possible and pass them to a constructor of | ||||
| the data member.  Since C++ does not allow any way to explicitly state | ||||
| the template parameters of a templated constructor, make sure that | ||||
| the arguments are already close as possible to the actual type used in | ||||
| the data member's desired constructor.</p> | ||||
|  | ||||
| <p>The <var>BOOST_BASE_FROM_MEMBER_MAX_ARITY</var> macro constant specifies | ||||
| the maximum argument length for the constructor templates.  The constant | ||||
| may be overridden if more (or less) argument configurations are needed.  The | ||||
| constant may be read for code that is expandable like the class template and | ||||
| needs to maintain the same maximum size.  (Example code would be a class that | ||||
| uses this class template as a base class for a member with a flexible set of | ||||
| constructors.)</p> | ||||
|  | ||||
| <h2><a name="usage">Usage</a></h2> | ||||
|  | ||||
| <p>With the starting example, the <code>fdoutbuf</code> sub-object needs | ||||
| to be encapsulated in a base class that is inheirited before | ||||
| <code>std::ostream</code>.</p> | ||||
|  | ||||
| <blockquote><pre> | ||||
| #include <boost/utility/base_from_member.hpp> | ||||
|  | ||||
| #include <streambuf>  <i>// for std::streambuf</i> | ||||
| #include <ostream>    <i>// for std::ostream</i> | ||||
|  | ||||
| class fdoutbuf | ||||
|     : public std::streambuf | ||||
| { | ||||
| public: | ||||
|     explicit fdoutbuf( int fd ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| class fdostream | ||||
|     : private boost::base_from_member<fdoutbuf> | ||||
|     , public std::ostream | ||||
| { | ||||
|     // Helper typedef's | ||||
|     typedef boost::base_from_member<fdoutbuf>  pbase_type; | ||||
|     typedef std::ostream                        base_type; | ||||
|  | ||||
| public: | ||||
|     explicit fdostream( int fd ) | ||||
|         : pbase_type( fd ), base_type( &member ) | ||||
|         {} | ||||
|     //... | ||||
| }; | ||||
| </pre></blockquote> | ||||
|  | ||||
| <p>The base-from-member idiom is an implementation detail, so it | ||||
| should not be visible to the clients (or any derived classes) of | ||||
| <code>fdostream</code>.  Due to the initialization order, the | ||||
| <code>fdoutbuf</code> sub-object will get initialized before the | ||||
| <code>std::ostream</code> sub-object does, making the former | ||||
| sub-object safe to use in the latter sub-object's construction.  Since the | ||||
| <code>fdoutbuf</code> sub-object of the final type is the only sub-object | ||||
| with the name "member," that name can be used | ||||
| unqualified within the final class.</p> | ||||
|  | ||||
| <h2><a name="example">Example</a></h2> | ||||
|  | ||||
| <p>The base-from-member class templates should commonly involve | ||||
| only one base-from-member sub-object, usually for attaching a | ||||
| stream-buffer to an I/O stream.  The next example demonstrates how | ||||
| to use multiple base-from-member sub-objects and the resulting | ||||
| qualification issues.</p> | ||||
|  | ||||
| <blockquote><pre> | ||||
| #include <boost/utility/base_from_member.hpp> | ||||
|  | ||||
| #include <cstddef>  <i>// for NULL</i> | ||||
|  | ||||
| struct an_int | ||||
| { | ||||
|     int  y; | ||||
|  | ||||
|     an_int( float yf ); | ||||
| }; | ||||
|  | ||||
| class switcher | ||||
| { | ||||
| public: | ||||
|     switcher(); | ||||
|     switcher( double, int * ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| class flow_regulator | ||||
| { | ||||
| public: | ||||
|     flow_regulator( switcher &, switcher & ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| template < unsigned Size > | ||||
| class fan | ||||
| { | ||||
| public: | ||||
|     explicit fan( switcher ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| class system | ||||
|     : private boost::base_from_member<an_int> | ||||
|     , private boost::base_from_member<switcher> | ||||
|     , private boost::base_from_member<switcher, 1> | ||||
|     , private boost::base_from_member<switcher, 2> | ||||
|     , protected flow_regulator | ||||
|     , public fan<6> | ||||
| { | ||||
|     // Helper typedef's | ||||
|     typedef boost::base_from_member<an_int>       pbase0_type; | ||||
|     typedef boost::base_from_member<switcher>     pbase1_type; | ||||
|     typedef boost::base_from_member<switcher, 1>  pbase2_type; | ||||
|     typedef boost::base_from_member<switcher, 2>  pbase3_type; | ||||
|  | ||||
|     typedef flow_regulator  base1_type; | ||||
|     typedef fan<6>          base2_type; | ||||
|  | ||||
| public: | ||||
|     system( double x ); | ||||
|     //... | ||||
| }; | ||||
|  | ||||
| system::system( double x ) | ||||
|     : pbase0_type( 0.2 ) | ||||
|     , pbase1_type() | ||||
|     , pbase2_type( -16, &this->pbase0_type::member ) | ||||
|     , pbase3_type( x, static_cast<int *>(NULL) ) | ||||
|     , base1_type( pbase3_type::member, pbase1_type::member ) | ||||
|     , base2_type( pbase2_type::member ) | ||||
| { | ||||
|     //... | ||||
| } | ||||
| </pre></blockquote> | ||||
|  | ||||
| <p>The final class has multiple sub-objects with the name | ||||
| "member," so any use of that name needs qualification by | ||||
| a name of the appropriate base type.  (Using <code>typedef</code>s | ||||
| ease mentioning the base types.)  However, the fix introduces a new | ||||
| problem when a pointer is needed.  Using the address operator with | ||||
| a sub-object qualified with its class's name results in a pointer-to-member | ||||
| (here, having a type of <code>an_int boost::base_from_member<an_int, | ||||
| 0> :: *</code>) instead of a pointer to the member (having a type of | ||||
| <code>an_int *</code>).  The new problem is fixed by qualifying the | ||||
| sub-object with "<code>this-></code>," and is needed just | ||||
| for pointers, and not for references or values.</p> | ||||
|  | ||||
| <p>There are some argument conversions in the initialization.  The | ||||
| constructor argument for <code>pbase0_type</code> is converted from | ||||
| <code>double</code> to <code>float</code>.  The first constructor | ||||
| argument for <code>pbase2_type</code> is converted from <code>int</code> | ||||
| to <code>double</code>.  The second constructor argument for | ||||
| <code>pbase3_type</code> is a special case of necessary conversion; all | ||||
| forms of the null-pointer literal in C++ also look like compile-time | ||||
| integral expressions, so C++ always interprets such code as an integer | ||||
| when it has overloads that can take either an integer or a pointer.  The | ||||
| last conversion is necessary for the compiler to call a constructor form | ||||
| with the exact pointer type used in <code>switcher</code>'s constructor.</p> | ||||
|  | ||||
| <h2><a name="credits">Credits</a></h2> | ||||
|  | ||||
| <h3><a name="contributors">Contributors</a></h3> | ||||
|  | ||||
| <dl> | ||||
| 	<dt><a href="../../people/ed_brey.htm">Ed Brey</a> | ||||
| 	<dd>Suggested some interface changes. | ||||
|  | ||||
| 	<dt><a href="http://www.moocat.org">R. Samuel Klatchko</a> (<a | ||||
| 	href="mailto:rsk@moocat.org">rsk@moocat.org</a>, <a | ||||
| 	href="mailto:rsk@brightmail.com">rsk@brightmail.com</a>) | ||||
| 	<dd>Invented the idiom of how to use a class member for initializing | ||||
| 		a base class. | ||||
|  | ||||
| 	<dt><a href="../../people/dietmar_kuehl.htm">Dietmar Kuehl</a> | ||||
| 	<dd>Popularized the base-from-member idiom in his | ||||
| 		<a href="http://www.informatik.uni-konstanz.de/~kuehl/c++/iostream/">IOStream | ||||
| 		example classes</a>. | ||||
|  | ||||
| 	<dt>Jonathan Turkanis | ||||
| 	<dd>Supplied an implementation of generating the constructor templates that | ||||
| 		can be controlled and automated with macros.  The implementation uses | ||||
| 		the <a href="../preprocessor/index.html">Preprocessor library</a>. | ||||
|  | ||||
| 	<dt><a href="../../people/daryle_walker.html">Daryle Walker</a> | ||||
| 	<dd>Started the library.  Contributed the test file <cite><a | ||||
| 		href="base_from_member_test.cpp">base_from_member_test.cpp</a></cite>. | ||||
| </dl> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <p>Revised: 28 August 2004</p> | ||||
|  | ||||
| <p>Copyright 2001, 2003, 2004 Daryle Walker.  Use, modification, and distribution | ||||
| are subject to the Boost Software License, Version 1.0.  (See accompanying | ||||
| file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or a copy at <<a | ||||
| href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>>.)</p> | ||||
|  | ||||
| </body> | ||||
| </html> | ||||
							
								
								
									
										595
									
								
								base_from_member_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										595
									
								
								base_from_member_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,595 @@ | ||||
| //  Boost test program for base-from-member class templates  -----------------// | ||||
|  | ||||
| //  Copyright 2001, 2003 Daryle Walker.  Use, modification, and distribution are | ||||
| //  subject to the Boost Software License, Version 1.0.  (See accompanying file | ||||
| //  LICENSE_1_0.txt or a copy at <http://www.boost.org/LICENSE_1_0.txt>.) | ||||
|  | ||||
| //  See <http://www.boost.org/libs/utility/> for the library's home page. | ||||
|  | ||||
| //  Revision History | ||||
| //  14 Jun 2003  Adjusted code for Boost.Test changes (Daryle Walker) | ||||
| //  29 Aug 2001  Initial Version (Daryle Walker) | ||||
|  | ||||
| #include <boost/test/minimal.hpp>  // for BOOST_CHECK, main | ||||
|  | ||||
| #include <boost/config.hpp>       // for BOOST_NO_MEMBER_TEMPLATES | ||||
| #include <boost/cstdlib.hpp>      // for boost::exit_success | ||||
| #include <boost/noncopyable.hpp>  // for boost::noncopyable | ||||
|  | ||||
| #include <boost/utility/base_from_member.hpp>  // for boost::base_from_member | ||||
|  | ||||
| #include <functional>  // for std::binary_function, std::less | ||||
| #include <iostream>    // for std::cout (std::ostream, std::endl indirectly) | ||||
| #include <set>         // for std::set | ||||
| #include <typeinfo>    // for std::type_info | ||||
| #include <utility>     // for std::pair, std::make_pair | ||||
| #include <vector>      // for std::vector | ||||
|  | ||||
|  | ||||
| // Control if extra information is printed | ||||
| #ifndef CONTROL_EXTRA_PRINTING | ||||
| #define CONTROL_EXTRA_PRINTING  1 | ||||
| #endif | ||||
|  | ||||
|  | ||||
| // A (sub)object can be identified by its memory location and its type. | ||||
| // Both are needed since an object can start at the same place as its | ||||
| // first base class subobject and/or contained subobject. | ||||
| typedef std::pair< void *, std::type_info const * >  object_id; | ||||
|  | ||||
| // Object IDs need to be printed | ||||
| std::ostream &  operator <<( std::ostream &os, object_id const &oi ); | ||||
|  | ||||
| // A way to generate an object ID | ||||
| template < typename T > | ||||
|   object_id  identify( T &obj ); | ||||
|  | ||||
| // A custom comparison type is needed | ||||
| struct object_id_compare | ||||
|     : std::binary_function<object_id, object_id, bool> | ||||
| { | ||||
|     bool  operator ()( object_id const &a, object_id const &b ) const; | ||||
|  | ||||
| };  // object_id_compare | ||||
|  | ||||
| // A singleton of this type coordinates the acknowledgements | ||||
| // of objects being created and used. | ||||
| class object_registrar | ||||
|     : private boost::noncopyable | ||||
| { | ||||
| public: | ||||
|  | ||||
|     #ifndef BOOST_NO_MEMBER_TEMPLATES | ||||
|     template < typename T > | ||||
|         void  register_object( T &obj ) | ||||
|             { this->register_object_imp( identify(obj) ); } | ||||
|     template < typename T, typename U > | ||||
|         void  register_use( T &owner, U &owned ) | ||||
|             { this->register_use_imp( identify(owner), identify(owned) ); } | ||||
|     template < typename T, typename U > | ||||
|         void  unregister_use( T &owner, U &owned ) | ||||
|             { this->unregister_use_imp( identify(owner), identify(owned) ); } | ||||
|     template < typename T > | ||||
|         void  unregister_object( T &obj ) | ||||
|             { this->unregister_object_imp( identify(obj) ); } | ||||
|     #endif | ||||
|  | ||||
|     void  register_object_imp( object_id obj ); | ||||
|     void  register_use_imp( object_id owner, object_id owned ); | ||||
|     void  unregister_use_imp( object_id owner, object_id owned ); | ||||
|     void  unregister_object_imp( object_id obj ); | ||||
|  | ||||
|     typedef std::set<object_id, object_id_compare>  set_type; | ||||
|  | ||||
|     typedef std::vector<object_id>  error_record_type; | ||||
|     typedef std::vector< std::pair<object_id, object_id> >  error_pair_type; | ||||
|  | ||||
|     set_type  db_; | ||||
|  | ||||
|     error_pair_type    defrauders_in_, defrauders_out_; | ||||
|     error_record_type  overeager_, overkilled_; | ||||
|  | ||||
| };  // object_registrar | ||||
|  | ||||
| // A sample type to be used by containing types | ||||
| class base_or_member | ||||
| { | ||||
| public: | ||||
|     explicit  base_or_member( int x = 1, double y = -0.25 ); | ||||
|              ~base_or_member(); | ||||
|  | ||||
| };  // base_or_member | ||||
|  | ||||
| // A sample type that uses base_or_member, used | ||||
| // as a base for the main demonstration classes | ||||
| class base_class | ||||
| { | ||||
| public: | ||||
|     explicit  base_class( base_or_member &x, base_or_member *y = 0, | ||||
|      base_or_member *z = 0 ); | ||||
|  | ||||
|     ~base_class(); | ||||
|  | ||||
| private: | ||||
|     base_or_member  *x_, *y_, *z_; | ||||
|  | ||||
| };  // base_class | ||||
|  | ||||
| // This bad class demonstrates the direct method of a base class needing | ||||
| // to be initialized by a member.  This is improper since the member | ||||
| // isn't initialized until after the base class. | ||||
| class bad_class | ||||
|     : public base_class | ||||
| { | ||||
| public: | ||||
|      bad_class(); | ||||
|     ~bad_class(); | ||||
|  | ||||
| private: | ||||
|     base_or_member  x_; | ||||
|  | ||||
| };  // bad_class | ||||
|  | ||||
| // The first good class demonstrates the correct way to initialize a | ||||
| // base class with a member.  The member is changed to another base | ||||
| // class, one that is initialized before the base that needs it. | ||||
| class good_class_1 | ||||
|     : private boost::base_from_member<base_or_member> | ||||
|     , public base_class | ||||
| { | ||||
|     typedef boost::base_from_member<base_or_member>  pbase_type; | ||||
|     typedef base_class                                base_type; | ||||
|  | ||||
| public: | ||||
|      good_class_1(); | ||||
|     ~good_class_1(); | ||||
|  | ||||
| };  // good_class_1 | ||||
|  | ||||
| // The second good class also demonstrates the correct way to initialize | ||||
| // base classes with other subobjects.  This class uses the other helpers | ||||
| // in the library, and shows the technique of using two base subobjects | ||||
| // of the "same" type. | ||||
| class good_class_2 | ||||
|     : private boost::base_from_member<base_or_member, 0> | ||||
|     , private boost::base_from_member<base_or_member, 1> | ||||
|     , private boost::base_from_member<base_or_member, 2> | ||||
|     , public base_class | ||||
| { | ||||
|     typedef boost::base_from_member<base_or_member, 0>  pbase_type0; | ||||
|     typedef boost::base_from_member<base_or_member, 1>  pbase_type1; | ||||
|     typedef boost::base_from_member<base_or_member, 2>  pbase_type2; | ||||
|     typedef base_class                                   base_type; | ||||
|  | ||||
| public: | ||||
|      good_class_2(); | ||||
|     ~good_class_2(); | ||||
|  | ||||
| };  // good_class_2 | ||||
|  | ||||
| // Declare/define the single object registrar | ||||
| object_registrar  obj_reg; | ||||
|  | ||||
|  | ||||
| // Main functionality | ||||
| int | ||||
| test_main( int , char * [] ) | ||||
| { | ||||
|     BOOST_CHECK( obj_reg.db_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.defrauders_in_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.defrauders_out_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.overeager_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.overkilled_.empty() ); | ||||
|  | ||||
|     // Make a separate block to examine pre- and post-effects | ||||
|     { | ||||
|         using std::cout; | ||||
|         using std::endl; | ||||
|  | ||||
|         bad_class  bc; | ||||
|         BOOST_CHECK( obj_reg.db_.size() == 3 ); | ||||
|         BOOST_CHECK( obj_reg.defrauders_in_.size() == 1 ); | ||||
|  | ||||
|         good_class_1  gc1; | ||||
|         BOOST_CHECK( obj_reg.db_.size() == 6 ); | ||||
|         BOOST_CHECK( obj_reg.defrauders_in_.size() == 1 ); | ||||
|  | ||||
|         good_class_2  gc2; | ||||
|         BOOST_CHECK( obj_reg.db_.size() == 11 ); | ||||
|         BOOST_CHECK( obj_reg.defrauders_in_.size() == 1 ); | ||||
|  | ||||
|         BOOST_CHECK( obj_reg.defrauders_out_.empty() ); | ||||
|         BOOST_CHECK( obj_reg.overeager_.empty() ); | ||||
|         BOOST_CHECK( obj_reg.overkilled_.empty() ); | ||||
|  | ||||
|         // Getting the addresses of the objects ensure | ||||
|         // that they're used, and not optimized away. | ||||
|         cout << "Object 'bc' is at " << &bc << '.' << endl; | ||||
|         cout << "Object 'gc1' is at " << &gc1 << '.' << endl; | ||||
|         cout << "Object 'gc2' is at " << &gc2 << '.' << endl; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( obj_reg.db_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.defrauders_in_.size() == 1 ); | ||||
|     BOOST_CHECK( obj_reg.defrauders_out_.size() == 1 ); | ||||
|     BOOST_CHECK( obj_reg.overeager_.empty() ); | ||||
|     BOOST_CHECK( obj_reg.overkilled_.empty() ); | ||||
|  | ||||
|     return boost::exit_success; | ||||
| } | ||||
|  | ||||
|  | ||||
| // Print an object's ID | ||||
| std::ostream & | ||||
| operator << | ||||
| ( | ||||
|     std::ostream &     os, | ||||
|     object_id const &  oi | ||||
| ) | ||||
| { | ||||
|     // I had an std::ostringstream to help, but I did not need it since | ||||
|     // the program never screws around with formatting.  Worse, using | ||||
|     // std::ostringstream is an issue with some compilers. | ||||
|  | ||||
|     return os << '[' << ( oi.second ? oi.second->name() : "NOTHING" ) | ||||
|      << " at " << oi.first << ']'; | ||||
| } | ||||
|  | ||||
| // Get an object ID given an object | ||||
| template < typename T > | ||||
| inline | ||||
| object_id | ||||
| identify | ||||
| ( | ||||
|     T &  obj | ||||
| ) | ||||
| { | ||||
|     return std::make_pair( static_cast<void *>(&obj), &(typeid( obj )) ); | ||||
| } | ||||
|  | ||||
| // Compare two object IDs | ||||
| bool | ||||
| object_id_compare::operator () | ||||
| ( | ||||
|     object_id const &  a, | ||||
|     object_id const &  b | ||||
| ) const | ||||
| { | ||||
|     std::less<void *>  vp_cmp; | ||||
|     if ( vp_cmp(a.first, b.first) ) | ||||
|     { | ||||
|         return true; | ||||
|     } | ||||
|     else if ( vp_cmp(b.first, a.first) ) | ||||
|     { | ||||
|         return false; | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|         // object pointers are equal, compare the types | ||||
|         if ( a.second == b.second ) | ||||
|         { | ||||
|             return false; | ||||
|         } | ||||
|         else if ( !a.second ) | ||||
|         { | ||||
|             return true;   // NULL preceeds anything else | ||||
|         } | ||||
|         else if ( !b.second ) | ||||
|         { | ||||
|             return false;  // NULL preceeds anything else | ||||
|         } | ||||
|         else | ||||
|         { | ||||
|             return a.second->before( *b.second ); | ||||
|         } | ||||
|     } | ||||
| } | ||||
|  | ||||
| // Let an object register its existence | ||||
| void | ||||
| object_registrar::register_object_imp | ||||
| ( | ||||
|     object_id  obj | ||||
| ) | ||||
| { | ||||
|     if ( db_.count(obj) <= 0 ) | ||||
|     { | ||||
|         db_.insert( obj ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Registered " << obj << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|         overeager_.push_back( obj ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Attempted to register a non-existant " << obj | ||||
|          << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
| } | ||||
|  | ||||
| // Let an object register its use of another object | ||||
| void | ||||
| object_registrar::register_use_imp | ||||
| ( | ||||
|     object_id  owner, | ||||
|     object_id  owned | ||||
| ) | ||||
| { | ||||
|     if ( db_.count(owned) > 0 ) | ||||
|     { | ||||
|         // We don't care to record usage registrations | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|         defrauders_in_.push_back( std::make_pair(owner, owned) ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Attempted to own a non-existant " << owned | ||||
|          << " by " << owner << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
| } | ||||
|  | ||||
| // Let an object un-register its use of another object | ||||
| void | ||||
| object_registrar::unregister_use_imp | ||||
| ( | ||||
|     object_id  owner, | ||||
|     object_id  owned | ||||
| ) | ||||
| { | ||||
|     if ( db_.count(owned) > 0 ) | ||||
|     { | ||||
|         // We don't care to record usage un-registrations | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|         defrauders_out_.push_back( std::make_pair(owner, owned) ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Attempted to disown a non-existant " << owned | ||||
|          << " by " << owner << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
| } | ||||
|  | ||||
| // Let an object un-register its existence | ||||
| void | ||||
| object_registrar::unregister_object_imp | ||||
| ( | ||||
|     object_id  obj | ||||
| ) | ||||
| { | ||||
|     set_type::iterator const  i = db_.find( obj ); | ||||
|  | ||||
|     if ( i != db_.end() ) | ||||
|     { | ||||
|         db_.erase( i ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Unregistered " << obj << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
|     else | ||||
|     { | ||||
|         overkilled_.push_back( obj ); | ||||
|  | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << "Attempted to unregister a non-existant " << obj | ||||
|          << '.' << std::endl; | ||||
|         #endif | ||||
|     } | ||||
| } | ||||
|  | ||||
| // Macros to abstract the registration of objects | ||||
| #ifndef BOOST_NO_MEMBER_TEMPLATES | ||||
| #define PRIVATE_REGISTER_BIRTH(o)     obj_reg.register_object( (o) ) | ||||
| #define PRIVATE_REGISTER_DEATH(o)     obj_reg.unregister_object( (o) ) | ||||
| #define PRIVATE_REGISTER_USE(o, w)    obj_reg.register_use( (o), (w) ) | ||||
| #define PRIVATE_UNREGISTER_USE(o, w)  obj_reg.unregister_use( (o), (w) ) | ||||
| #else | ||||
| #define PRIVATE_REGISTER_BIRTH(o)     obj_reg.register_object_imp( \ | ||||
|  identify((o)) ) | ||||
| #define PRIVATE_REGISTER_DEATH(o)     obj_reg.unregister_object_imp( \ | ||||
|  identify((o)) ) | ||||
| #define PRIVATE_REGISTER_USE(o, w)    obj_reg.register_use_imp( identify((o)), \ | ||||
|  identify((w)) ) | ||||
| #define PRIVATE_UNREGISTER_USE(o, w)  obj_reg.unregister_use_imp( \ | ||||
|  identify((o)), identify((w)) ) | ||||
| #endif | ||||
|  | ||||
| // Create a base_or_member, with arguments to simulate member initializations | ||||
| base_or_member::base_or_member | ||||
| ( | ||||
|     int     x,  // = 1 | ||||
|     double  y   // = -0.25 | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_BIRTH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy x-factor is " << x << " and my y-factor is " << y | ||||
|      << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Destroy a base_or_member | ||||
| inline | ||||
| base_or_member::~base_or_member | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_DEATH( *this ); | ||||
| } | ||||
|  | ||||
| // Create a base_class, registering any objects used | ||||
| base_class::base_class | ||||
| ( | ||||
|     base_or_member &  x, | ||||
|     base_or_member *  y,  // = 0 | ||||
|     base_or_member *  z   // = 0 | ||||
| ) | ||||
|     : x_( &x ), y_( y ), z_( z ) | ||||
| { | ||||
|     PRIVATE_REGISTER_BIRTH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy x-factor is " << x_; | ||||
|     #endif | ||||
|  | ||||
|     PRIVATE_REGISTER_USE( *this, *x_ ); | ||||
|  | ||||
|     if ( y_ ) | ||||
|     { | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << ", my y-factor is " << y_; | ||||
|         #endif | ||||
|  | ||||
|         PRIVATE_REGISTER_USE( *this, *y_ ); | ||||
|     } | ||||
|  | ||||
|     if ( z_ ) | ||||
|     { | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << ", my z-factor is " << z_; | ||||
|         #endif | ||||
|  | ||||
|         PRIVATE_REGISTER_USE( *this, *z_ ); | ||||
|     } | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Destroy a base_class, unregistering the objects it uses | ||||
| base_class::~base_class | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_DEATH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy x-factor was " << x_; | ||||
|     #endif | ||||
|  | ||||
|     PRIVATE_UNREGISTER_USE( *this, *x_ ); | ||||
|  | ||||
|     if ( y_ ) | ||||
|     { | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << ", my y-factor was " << y_; | ||||
|         #endif | ||||
|  | ||||
|         PRIVATE_UNREGISTER_USE( *this, *y_ ); | ||||
|     } | ||||
|  | ||||
|     if ( z_ ) | ||||
|     { | ||||
|         #if CONTROL_EXTRA_PRINTING | ||||
|         std::cout << ", my z-factor was " << z_; | ||||
|         #endif | ||||
|  | ||||
|         PRIVATE_UNREGISTER_USE( *this, *z_ ); | ||||
|     } | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Create a bad_class, noting the improper construction order | ||||
| bad_class::bad_class | ||||
| ( | ||||
| ) | ||||
|     : x_( -7, 16.75 ), base_class( x_ )  // this order doesn't matter | ||||
| { | ||||
|     PRIVATE_REGISTER_BIRTH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factor is at " << &x_ | ||||
|      << " and my base is at " << static_cast<base_class *>(this) << '.' | ||||
|      << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Destroy a bad_class, noting the improper destruction order | ||||
| bad_class::~bad_class | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_DEATH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factor was at " << &x_ | ||||
|      << " and my base was at " << static_cast<base_class *>(this) | ||||
|      << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Create a good_class_1, noting the proper construction order | ||||
| good_class_1::good_class_1 | ||||
| ( | ||||
| ) | ||||
|     : pbase_type( 8 ), base_type( member ) | ||||
| { | ||||
|     PRIVATE_REGISTER_BIRTH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factor is at " << &member | ||||
|      << " and my base is at " << static_cast<base_class *>(this) << '.' | ||||
|      << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Destroy a good_class_1, noting the proper destruction order | ||||
| good_class_1::~good_class_1 | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_DEATH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factor was at " << &member | ||||
|      << " and my base was at " << static_cast<base_class *>(this) | ||||
|      << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Create a good_class_2, noting the proper construction order | ||||
| good_class_2::good_class_2 | ||||
| ( | ||||
| ) | ||||
|     : pbase_type0(), pbase_type1(-16, 0.125), pbase_type2(2, -3) | ||||
|     , base_type( pbase_type1::member, &this->pbase_type0::member, | ||||
|        &this->pbase_type2::member ) | ||||
| { | ||||
|     PRIVATE_REGISTER_BIRTH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factors are at " << &this->pbase_type0::member | ||||
|      << ", " << &this->pbase_type1::member << ", " | ||||
|      << &this->pbase_type2::member << ", and my base is at " | ||||
|      << static_cast<base_class *>(this) << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
|  | ||||
| // Destroy a good_class_2, noting the proper destruction order | ||||
| good_class_2::~good_class_2 | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     PRIVATE_REGISTER_DEATH( *this ); | ||||
|  | ||||
|     #if CONTROL_EXTRA_PRINTING | ||||
|     std::cout << "\tMy factors were at " << &this->pbase_type0::member | ||||
|      << ", " << &this->pbase_type1::member << ", " | ||||
|      << &this->pbase_type2::member << ", and my base was at " | ||||
|      << static_cast<base_class *>(this) << '.' << std::endl; | ||||
|     #endif | ||||
| } | ||||
							
								
								
									
										258
									
								
								binary_search_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										258
									
								
								binary_search_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,258 @@ | ||||
| // (C) Copyright David Abrahams 2000. | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| #include <vector> | ||||
| #include <string> | ||||
| #include <memory> | ||||
| #include <climits> | ||||
| #include <iostream> | ||||
| #include <cassert> | ||||
| #include <stdlib.h> // for rand(). Would use cstdlib but VC6.4 doesn't put it in std:: | ||||
| #include <list> | ||||
| #include <algorithm> | ||||
| #include <boost/detail/binary_search.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
| #include <cstddef> | ||||
|  | ||||
| #if defined(__SGI_STL_PORT) ? defined(__SGI_STL_OWN_IOSTREAMS) : (!defined(__GNUC__) || __GNUC__ > 2) | ||||
| # define USE_SSTREAM | ||||
| #endif | ||||
|  | ||||
| #ifdef USE_SSTREAM | ||||
| # include <sstream> | ||||
| #else | ||||
| # include <strstream> | ||||
| #endif | ||||
|  | ||||
| namespace { | ||||
|  | ||||
| // In order to get ADL to find the comparison operators defined below, they have | ||||
| struct mystring : std::string | ||||
| { | ||||
|     typedef std::string base; | ||||
|      | ||||
|     mystring(std::string const& x) | ||||
|         : base(x) {} | ||||
| }; | ||||
|  | ||||
| typedef std::vector<mystring> string_vector; | ||||
|  | ||||
| const std::size_t sequence_length = 1000; | ||||
|  | ||||
| unsigned random_number() | ||||
| { | ||||
|     return static_cast<unsigned>(::rand()) % sequence_length; | ||||
| } | ||||
|  | ||||
| # ifndef USE_SSTREAM | ||||
| class unfreezer { | ||||
|  public: | ||||
|     unfreezer(std::ostrstream& s) : m_stream(s) {} | ||||
|     ~unfreezer() { m_stream.freeze(false); } | ||||
|  private: | ||||
|     std::ostrstream& m_stream; | ||||
| }; | ||||
| # endif | ||||
|  | ||||
| template <class T> | ||||
| void push_back_random_number_string(T& seq) | ||||
| { | ||||
|     unsigned value = random_number(); | ||||
| # if defined(__SGI_STL_PORT) ? defined(__SGI_STL_OWN_IOSTREAMS) : (!defined(__GNUC__) || __GNUC__ > 2) | ||||
|     std::ostringstream s; | ||||
|     s << value; | ||||
|     seq.push_back(s.str()); | ||||
| # else | ||||
|     std::ostrstream s; | ||||
|     auto unfreezer unfreeze(s); | ||||
|     s << value << char(0); | ||||
|     seq.push_back(std::string(s.str())); | ||||
| # endif | ||||
| } | ||||
|  | ||||
| inline unsigned to_int(unsigned x) { return x; } | ||||
| inline unsigned to_int(const std::string& x) { return atoi(x.c_str()); } | ||||
|  | ||||
| struct cmp | ||||
| { | ||||
|     template <class A1, class A2> | ||||
|     inline bool operator()(const A1& a1, const A2& a2) const | ||||
|     { | ||||
|         return to_int(a1) < to_int(a2); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| inline bool operator<(const mystring& x, const unsigned y) | ||||
| { | ||||
|     return to_int(x) < y; | ||||
| } | ||||
|  | ||||
| inline bool operator<(const unsigned y, const mystring& x) | ||||
| { | ||||
|     return y < to_int(x); | ||||
| } | ||||
|  | ||||
| template <class T> | ||||
| void sort_by_value(T& x); | ||||
|  | ||||
| template <class T> | ||||
| void sort_by_value_(T& v, long) | ||||
| { | ||||
|     std::sort(v.begin(), v.end(), cmp()); | ||||
| } | ||||
|  | ||||
| template <class T> | ||||
| void random_sorted_sequence(T& seq) | ||||
| { | ||||
|     seq.clear(); | ||||
|     for (std::size_t i = 0; i < sequence_length; ++i) | ||||
|     { | ||||
|         push_back_random_number_string(seq); | ||||
|     } | ||||
|     sort_by_value(seq); | ||||
| } | ||||
|  | ||||
| template <class T, class A> | ||||
| void sort_by_value_(std::list<T,A>& l, int) | ||||
| { | ||||
| # if BOOST_WORKAROUND(BOOST_DINKUMWARE_STDLIB, == 1) && !defined(__SGI_STL_PORT) | ||||
| // VC6's standard lib doesn't have a template member function for list::sort() | ||||
|     std::vector<T> seq; | ||||
|     seq.reserve(sequence_length); | ||||
|     std::copy(l.begin(), l.end(), std::back_inserter(seq)); | ||||
|     sort_by_value(seq); | ||||
|     std::copy(seq.begin(), seq.end(), l.begin()); | ||||
| # else | ||||
|     l.sort(cmp()); | ||||
| # endif | ||||
| } | ||||
|  | ||||
| template <class T> | ||||
| void sort_by_value(T& x) | ||||
| { | ||||
|     (sort_by_value_)(x, 1); | ||||
| } | ||||
|  | ||||
| // A way to select the comparisons with/without a Compare parameter for testing. | ||||
| template <class Compare> struct searches | ||||
| { | ||||
|     template <class Iterator, class Key> | ||||
|     static Iterator lower_bound(Iterator start, Iterator finish, Key key, Compare cmp) | ||||
|         { return boost::detail::lower_bound(start, finish, key, cmp); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static Iterator upper_bound(Iterator start, Iterator finish, Key key, Compare cmp) | ||||
|         { return boost::detail::upper_bound(start, finish, key, cmp); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static std::pair<Iterator, Iterator> equal_range(Iterator start, Iterator finish, Key key, Compare cmp) | ||||
|         { return boost::detail::equal_range(start, finish, key, cmp); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static bool binary_search(Iterator start, Iterator finish, Key key, Compare cmp) | ||||
|         { return boost::detail::binary_search(start, finish, key, cmp); } | ||||
| }; | ||||
|  | ||||
| struct no_compare {}; | ||||
|  | ||||
| template <> struct searches<no_compare> | ||||
| { | ||||
|     template <class Iterator, class Key> | ||||
|     static Iterator lower_bound(Iterator start, Iterator finish, Key key, no_compare) | ||||
|         { return boost::detail::lower_bound(start, finish, key); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static Iterator upper_bound(Iterator start, Iterator finish, Key key, no_compare) | ||||
|         { return boost::detail::upper_bound(start, finish, key); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static std::pair<Iterator, Iterator> equal_range(Iterator start, Iterator finish, Key key, no_compare) | ||||
|         { return boost::detail::equal_range(start, finish, key); } | ||||
|  | ||||
|     template <class Iterator, class Key> | ||||
|     static bool binary_search(Iterator start, Iterator finish, Key key, no_compare) | ||||
|         { return boost::detail::binary_search(start, finish, key); } | ||||
| }; | ||||
|  | ||||
| template <class Sequence, class Compare> | ||||
| void test_loop(Sequence& x, Compare cmp, unsigned long test_count) | ||||
| { | ||||
|     typedef typename Sequence::const_iterator const_iterator; | ||||
|      | ||||
|     for (unsigned long i = 0; i < test_count; ++i) | ||||
|     { | ||||
|         random_sorted_sequence(x); | ||||
|         const const_iterator start = x.begin(); | ||||
|         const const_iterator finish = x.end(); | ||||
|          | ||||
|         unsigned key = random_number(); | ||||
|         const const_iterator l = searches<Compare>::lower_bound(start, finish, key, cmp); | ||||
|         const const_iterator u = searches<Compare>::upper_bound(start, finish, key, cmp); | ||||
|  | ||||
|         bool found_l = false; | ||||
|         bool found_u = false; | ||||
|         std::size_t index = 0; | ||||
|         std::size_t count = 0; | ||||
|         unsigned last_value = 0; | ||||
|         for (const_iterator p = start; p != finish; ++p) | ||||
|         { | ||||
|             if (p == l) | ||||
|                 found_l = true; | ||||
|              | ||||
|             if (p == u) | ||||
|             { | ||||
|                 assert(found_l); | ||||
|                 found_u = true; | ||||
|             } | ||||
|  | ||||
|             unsigned value = to_int(*p); | ||||
|             assert(value >= last_value); | ||||
|             last_value = value; | ||||
|              | ||||
|             if (!found_l) | ||||
|             { | ||||
|                 ++index; | ||||
|                 assert(to_int(*p) < key); | ||||
|             } | ||||
|             else if (!found_u) | ||||
|             { | ||||
|                 ++count; | ||||
|                 assert(to_int(*p) == key); | ||||
|             } | ||||
|             else | ||||
|                 assert(to_int(*p) > key); | ||||
|         } | ||||
|         assert(found_l || l == finish); | ||||
|         assert(found_u || u == finish); | ||||
|  | ||||
|         std::pair<const_iterator, const_iterator> | ||||
|             range = searches<Compare>::equal_range(start, finish, key, cmp); | ||||
|         assert(range.first == l); | ||||
|         assert(range.second == u); | ||||
|  | ||||
|         bool found = searches<Compare>::binary_search(start, finish, key, cmp); | ||||
|         assert(found == (u != l)); | ||||
|         std::cout << "found " << count << " copies of " << key << " at index " << index << "\n"; | ||||
|     } | ||||
| } | ||||
|  | ||||
| } | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     string_vector x; | ||||
|     std::cout << "=== testing random-access iterators with <: ===\n"; | ||||
|     test_loop(x, no_compare(), 25); | ||||
|     std::cout << "=== testing random-access iterators with compare: ===\n"; | ||||
|     test_loop(x, cmp(), 25); | ||||
|      | ||||
|     std::list<mystring> y; | ||||
|     std::cout << "=== testing bidirectional iterators with <: ===\n"; | ||||
|     test_loop(y, no_compare(), 25); | ||||
|     std::cout << "=== testing bidirectional iterators with compare: ===\n"; | ||||
|     test_loop(y, cmp(), 25); | ||||
|     std::cerr << "******TEST PASSED******\n"; | ||||
|     return 0; | ||||
| } | ||||
| @@ -1,489 +0,0 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> | ||||
| <meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| <title>C++ Type traits</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" link="#0000FF" vlink="#800080"> | ||||
|  | ||||
| <h2 align="center">C++ Type traits</h2> | ||||
| <p align="center"><em>by John Maddock and Steve Cleary</em></p> | ||||
| <p align="center"><em>This is a draft of an article that will appear in a future | ||||
| issue of </em><a href="http://www.ddj.com"><em>Dr Dobb's Journal</em></a></p> | ||||
| <p>Generic programming (writing code which works with any data type meeting a | ||||
| set of requirements) has become the method of choice for providing reusable | ||||
| code. However, there are times in generic programming when "generic" | ||||
| just isn't good enough - sometimes the differences between types are too large | ||||
| for an efficient generic implementation. This is when the traits technique | ||||
| becomes important - by encapsulating those properties that need to be considered | ||||
| on a type by type basis inside a traits class, we can minimise the amount of | ||||
| code that has to differ from one type to another, and maximise the amount of | ||||
| generic code.</p> | ||||
| <p>Consider an example: when working with character strings, one common | ||||
| operation is to determine the length of a null terminated string. Clearly it's | ||||
| possible to write generic code that can do this, but it turns out that there are | ||||
| much more efficient methods available: for example, the C library functions <font size="2" face="Courier New">strlen</font> | ||||
| and <font size="2" face="Courier New">wcslen</font> are usually written in | ||||
| assembler, and with suitable hardware support can be considerably faster than a | ||||
| generic version written in C++. The authors of the C++ standard library realised | ||||
| this, and abstracted the properties of <font size="2" face="Courier New">char</font> | ||||
| and <font size="2" face="Courier New">wchar_t</font> into the class <font size="2" face="Courier New">char_traits</font>. | ||||
| Generic code that works with character strings can simply use <font size="2" face="Courier New">char_traits<>::length</font> | ||||
| to determine the length of a null terminated string, safe in the knowledge that | ||||
| specialisations of <font size="2" face="Courier New">char_traits</font> will use | ||||
| the most appropriate method available to them.</p> | ||||
| <h4>Type traits</h4> | ||||
| <p>Class <font size="2" face="Courier New">char_traits</font> is a classic | ||||
| example of a collection of type specific properties wrapped up in a single class | ||||
| - what Nathan Myers termed a <i>baggage class</i>[1]. In the Boost type-traits | ||||
| library, we[2] have written a set of very specific traits classes, each of which | ||||
| encapsulate a single trait from the C++ type system; for example, is a type a | ||||
| pointer or a reference type? Or does a type have a trivial constructor, or a | ||||
| const-qualifier? The type-traits classes share a unified design: each class has | ||||
| a single member <i>value</i>, a compile-time constant that is true if the type | ||||
| has the specified property, and false otherwise. As we will show, these classes | ||||
| can be used in generic programming to determine the properties of a given type | ||||
| and introduce optimisations that are appropriate for that case.</p> | ||||
| <p>The type-traits library also contains a set of classes that perform a | ||||
| specific transformation on a type; for example, they can remove a top-level | ||||
| const or volatile qualifier from a type. Each class that performs a | ||||
| transformation defines a single typedef-member <i>type</i> that is the result of | ||||
| the transformation. All of the type-traits classes are defined inside namespace <font size="2" face="Courier New">boost</font>; | ||||
| for brevity, namespace-qualification is omitted in most of the code samples | ||||
| given.</p> | ||||
| <h4>Implementation</h4> | ||||
| <p>There are far too many separate classes contained in the type-traits library | ||||
| to give a full implementation here - see the source code in the Boost library | ||||
| for the full details - however, most of the implementation is fairly repetitive | ||||
| anyway, so here we will just give you a flavour for how some of the classes are | ||||
| implemented. Beginning with possibly the simplest class in the library, is_void<T> | ||||
| has a member <i>value</i> that is true only if T is void.</p> | ||||
| <pre>template <typename T>  | ||||
| struct is_void | ||||
| { static const bool value = false; }; | ||||
|  | ||||
| template <>  | ||||
| struct is_void<void> | ||||
| { static const bool value = true; };</pre> | ||||
| <p>Here we define a primary version of the template class <font size="2" face="Courier New">is_void</font>, | ||||
| and provide a full-specialisation when T is void. While full specialisation of a | ||||
| template class is an important technique, sometimes we need a solution that is | ||||
| halfway between a fully generic solution, and a full specialisation. This is | ||||
| exactly the situation for which the standards committee defined partial | ||||
| template-class specialisation. As an example, consider the class | ||||
| boost::is_pointer<T>: here we needed a primary version that handles all | ||||
| the cases where T is not a pointer, and a partial specialisation to handle all | ||||
| the cases where T is a pointer:</p> | ||||
| <pre>template <typename T>  | ||||
| struct is_pointer  | ||||
| { static const bool value = false; }; | ||||
|  | ||||
| template <typename T>  | ||||
| struct is_pointer<T*>  | ||||
| { static const bool value = true; };</pre> | ||||
| <p>The syntax for partial specialisation is somewhat arcane and could easily | ||||
| occupy an article in its own right; like full specialisation, in order to write | ||||
| a partial specialisation for a class, you must first declare the primary | ||||
| template. The partial specialisation contains an extra <<EFBFBD>> after the | ||||
| class name that contains the partial specialisation parameters; these define the | ||||
| types that will bind to that partial specialisation rather than the default | ||||
| template. The rules for what can appear in a partial specialisation are somewhat | ||||
| convoluted, but as a rule of thumb if you can legally write two function | ||||
| overloads of the form:</p> | ||||
| <pre>void foo(T); | ||||
| void foo(U);</pre> | ||||
| <p>Then you can also write a partial specialisation of the form:</p> | ||||
| <pre>template <typename T> | ||||
| class c{ /*details*/ }; | ||||
|  | ||||
| template <typename T> | ||||
|  | ||||
| class c<U>{ /*details*/ };</pre> | ||||
| <p>This rule is by no means foolproof, but it is reasonably simple to remember | ||||
| and close enough to the actual rule to be useful for everyday use.</p> | ||||
| <p>As a more complex example of partial specialisation consider the class | ||||
| remove_bounds<T>. This class defines a single typedef-member <i>type</i> | ||||
| that is the same type as T but with any top-level array bounds removed; this is | ||||
| an example of a traits class that performs a transformation on a type:</p> | ||||
| <pre>template <typename T>  | ||||
| struct remove_bounds | ||||
| { typedef T type; }; | ||||
|  | ||||
| template <typename T, std::size_t N>  | ||||
| struct remove_bounds<T[N]> | ||||
| { typedef T type; };</pre> | ||||
| <p>The aim of remove_bounds is this: imagine a generic algorithm that is passed | ||||
| an array type as a template parameter, <font size="2" face="Courier New">remove_bounds</font> | ||||
| provides a means of determining the underlying type of the array. For example <code>remove_bounds<int[4][5]>::type</code> | ||||
| would evaluate to the type <code>int[5]</code>. This example also shows that the | ||||
| number of template parameters in a partial specialisation does not have to match | ||||
| the number in the default template. However, the number of parameters that | ||||
| appear after the class name do have to match the number and type of the | ||||
| parameters in the default template.</p> | ||||
| <h4>Optimised copy</h4> | ||||
| <p>As an example of how the type traits classes can be used, consider the | ||||
| standard library algorithm copy:</p> | ||||
| <pre>template<typename Iter1, typename Iter2> | ||||
| Iter2 copy(Iter1 first, Iter1 last, Iter2 out);</pre> | ||||
| <p>Obviously, there's no problem writing a generic version of copy that works | ||||
| for all iterator types Iter1 and Iter2; however, there are some circumstances | ||||
| when the copy operation can best be performed by a call to <font size="2" face="Courier New">memcpy</font>. | ||||
| In order to implement copy in terms of <font size="2" face="Courier New">memcpy</font> | ||||
| all of the following conditions need to be met:</p> | ||||
| <ul> | ||||
|   <li>Both of the iterator types Iter1 and Iter2 must be pointers.</li> | ||||
|   <li>Both Iter1 and Iter2 must point to the same type - excluding <font size="2" face="Courier New">const</font> | ||||
|     and <font size="2" face="Courier New">volatile</font>-qualifiers.</li> | ||||
|   <li>The type pointed to by Iter1 must have a trivial assignment operator.</li> | ||||
| </ul> | ||||
| <p>By trivial assignment operator we mean that the type is either a scalar | ||||
| type[3] or:</p> | ||||
| <ul> | ||||
|   <li>The type has no user defined assignment operator.</li> | ||||
|   <li>The type does not have any data members that are references.</li> | ||||
|   <li>All base classes, and all data member objects must have trivial assignment | ||||
|     operators.</li> | ||||
| </ul> | ||||
| <p>If all these conditions are met then a type can be copied using <font size="2" face="Courier New">memcpy</font> | ||||
| rather than using a compiler generated assignment operator. The type-traits | ||||
| library provides a class <i>has_trivial_assign</i>, such that <code>has_trivial_assign<T>::value</code> | ||||
| is true only if T has a trivial assignment operator. This class "just | ||||
| works" for scalar types, but has to be explicitly specialised for | ||||
| class/struct types that also happen to have a trivial assignment operator. In | ||||
| other words if <i>has_trivial_assign</i> gives the wrong answer, it will give | ||||
| the "safe" wrong answer - that trivial assignment is not allowable.</p> | ||||
| <p>The code for an optimised version of copy that uses <font size="2" face="Courier New">memcpy</font> | ||||
| where appropriate is given in listing 1. The code begins by defining a template | ||||
| class <i>copier</i>, that takes a single Boolean template parameter, and has a | ||||
| static template member function <font size="2" face="Courier New">do_copy</font> | ||||
| which performs the generic version of <font size="2">copy</font> (in other words | ||||
| the "slow but safe version"). Following that there is a specialisation | ||||
| for <i>copier<true></i>: again this defines a static template member | ||||
| function <font size="2" face="Courier New">do_copy</font>, but this version uses | ||||
| memcpy to perform an "optimised" copy.</p> | ||||
| <p>In order to complete the implementation, what we need now is a version of | ||||
| copy, that calls <code>copier<true>::do_copy</code> if it is safe to use <font size="2" face="Courier New">memcpy</font>, | ||||
| and otherwise calls <code>copier<false>::do_copy</code> to do a | ||||
| "generic" copy. This is what the version in listing 1 does. To | ||||
| understand how the code works look at the code for <font size="2" face="Courier New">copy</font> | ||||
| and consider first the two typedefs <i>v1_t</i> and <i>v2_t</i>. These use <code>std::iterator_traits<Iter1>::value_type</code> | ||||
| to determine what type the two iterators point to, and then feed the result into | ||||
| another type-traits class <i>remove_cv</i> that removes the top-level | ||||
| const-volatile-qualifiers: this will allow copy to compare the two types without | ||||
| regard to const- or volatile-qualifiers. Next, <font size="2" face="Courier New">copy</font> | ||||
| declares an enumerated value <i>can_opt</i> that will become the template | ||||
| parameter to copier - declaring this here as a constant is really just a | ||||
| convenience - the value could be passed directly to class <font size="2" face="Courier New">copier</font>. | ||||
| The value of <i>can_opt</i> is computed by verifying that all of the following | ||||
| are true:</p> | ||||
| <ul> | ||||
|   <li>first that the two iterators point to the same type by using a type-traits | ||||
|     class <i>is_same</i>.</li> | ||||
|   <li>Then that both iterators are real pointers - using the class <i>is_pointer</i> | ||||
|     described above.</li> | ||||
|   <li>Finally that the pointed-to types have a trivial assignment operator using | ||||
|     <i>has_trivial_assign</i>.</li> | ||||
| </ul> | ||||
| <p>Finally we can use the value of <i>can_opt</i> as the template argument to | ||||
| copier - this version of copy will now adapt to whatever parameters are passed | ||||
| to it, if its possible to use <font size="2" face="Courier New">memcpy</font>, | ||||
| then it will do so, otherwise it will use a generic copy.</p> | ||||
| <h4>Was it worth it?</h4> | ||||
| <p>It has often been repeated in these columns that "premature optimisation | ||||
| is the root of all evil" [4]. So the question must be asked: was our | ||||
| optimisation premature? To put this in perspective the timings for our version | ||||
| of copy compared a conventional generic copy[5] are shown in table 1.</p> | ||||
| <p>Clearly the optimisation makes a difference in this case; but, to be fair, | ||||
| the timings are loaded to exclude cache miss effects - without this accurate | ||||
| comparison between algorithms becomes difficult. However, perhaps we can add a | ||||
| couple of caveats to the premature optimisation rule:</p> | ||||
| <ul> | ||||
|   <li>If you use the right algorithm for the job in the first place then | ||||
|     optimisation will not be required; in some cases, <font size="2" face="Courier New">memcpy</font> | ||||
|     is the right algorithm.</li> | ||||
|   <li>If a component is going to be reused in many places by many people then | ||||
|     optimisations may well be worthwhile where they would not be so for a single | ||||
|     case - in other words, the likelihood that the optimisation will be | ||||
|     absolutely necessary somewhere, sometime is that much higher. Just as | ||||
|     importantly the perceived value of the stock implementation will be higher: | ||||
|     there is no point standardising an algorithm if users reject it on the | ||||
|     grounds that there are better, more heavily optimised versions available.</li> | ||||
| </ul> | ||||
| <h4>Table 1: Time taken to copy 1000 elements using copy<const T*, T*> | ||||
| (times in micro-seconds)</h4> | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="529"> | ||||
|   <tr> | ||||
|     <td valign="top" width="33%"> | ||||
|       <p align="center">Version</p> | ||||
|     </td> | ||||
|     <td valign="top" width="33%"> | ||||
|       <p align="center">T</p> | ||||
|     </td> | ||||
|     <td valign="top" width="33%"> | ||||
|       <p align="center">Time</p> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="33%">"Optimised" copy</td> | ||||
|     <td valign="top" width="33%">char</td> | ||||
|     <td valign="top" width="33%">0.99</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="33%">Conventional copy</td> | ||||
|     <td valign="top" width="33%">char</td> | ||||
|     <td valign="top" width="33%">8.07</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="33%">"Optimised" copy</td> | ||||
|     <td valign="top" width="33%">int</td> | ||||
|     <td valign="top" width="33%">2.52</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="33%">Conventional copy</td> | ||||
|     <td valign="top" width="33%">int</td> | ||||
|     <td valign="top" width="33%">8.02</td> | ||||
|   </tr> | ||||
| </table> | ||||
| <p> </p> | ||||
| <h4>Pair of References</h4> | ||||
| <p>The optimised copy example shows how type traits may be used to perform | ||||
| optimisation decisions at compile-time. Another important usage of type traits | ||||
| is to allow code to compile that otherwise would not do so unless excessive | ||||
| partial specialization is used. This is possible by delegating partial | ||||
| specialization to the type traits classes. Our example for this form of usage is | ||||
| a pair that can hold references [6].</p> | ||||
| <p>First, let us examine the definition of "std::pair", omitting the | ||||
| comparision operators, default constructor, and template copy constructor for | ||||
| simplicity:</p> | ||||
| <pre>template <typename T1, typename T2>  | ||||
| struct pair  | ||||
| { | ||||
|   typedef T1 first_type; | ||||
|   typedef T2 second_type; | ||||
|  | ||||
|   T1 first; | ||||
|   T2 second; | ||||
|  | ||||
|   pair(const T1 & nfirst, const T2 & nsecond) | ||||
|   :first(nfirst), second(nsecond) { } | ||||
| };</pre> | ||||
| <p>Now, this "pair" cannot hold references as it currently stands, | ||||
| because the constructor would require taking a reference to a reference, which | ||||
| is currently illegal [7]. Let us consider what the constructor's parameters | ||||
| would have to be in order to allow "pair" to hold non-reference types, | ||||
| references, and constant references:</p> | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="638"> | ||||
|   <tr> | ||||
|     <td valign="top" width="50%">Type of "T1"</td> | ||||
|     <td valign="top" width="50%">Type of parameter to initializing constructor</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>T</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>T &</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="50%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
| </table> | ||||
| <p>A little familiarity with the type traits classes allows us to construct a | ||||
| single mapping that allows us to determine the type of parameter from the type | ||||
| of the contained class. The type traits classes provide a transformation "add_reference", | ||||
| which adds a reference to its type, unless it is already a reference.</p> | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="580"> | ||||
|   <tr> | ||||
|     <td valign="top" width="21%">Type of "T1"</td> | ||||
|     <td valign="top" width="27%">Type of "const T1"</td> | ||||
|     <td valign="top" width="53%">Type of "add_reference<const | ||||
|       T1>::type"</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="21%"> | ||||
|       <pre>T</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="27%"> | ||||
|       <pre>const T</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="53%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="21%"> | ||||
|       <pre>T &</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="27%"> | ||||
|       <pre>T & [8]</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="53%"> | ||||
|       <pre>T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td valign="top" width="21%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="27%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|     <td valign="top" width="53%"> | ||||
|       <pre>const T &</pre> | ||||
|     </td> | ||||
|   </tr> | ||||
| </table> | ||||
| <p>This allows us to build a primary template definition for "pair" | ||||
| that can contain non-reference types, reference types, and constant reference | ||||
| types:</p> | ||||
| <pre>template <typename T1, typename T2>  | ||||
| struct pair  | ||||
| { | ||||
|   typedef T1 first_type; | ||||
|   typedef T2 second_type; | ||||
|  | ||||
|   T1 first; | ||||
|   T2 second; | ||||
|  | ||||
|   pair(boost::add_reference<const T1>::type nfirst, | ||||
|        boost::add_reference<const T2>::type nsecond) | ||||
|   :first(nfirst), second(nsecond) { } | ||||
| };</pre> | ||||
| <p>Add back in the standard comparision operators, default constructor, and | ||||
| template copy constructor (which are all the same), and you have a std::pair | ||||
| that can hold reference types!</p> | ||||
| <p>This same extension <i>could</i> have been done using partial template | ||||
| specialization of "pair", but to specialize "pair" in this | ||||
| way would require three partial specializations, plus the primary template. Type | ||||
| traits allows us to define a single primary template that adjusts itself | ||||
| auto-magically to any of these partial specializations, instead of a brute-force | ||||
| partial specialization approach. Using type traits in this fashion allows | ||||
| programmers to delegate partial specialization to the type traits classes, | ||||
| resulting in code that is easier to maintain and easier to understand.</p> | ||||
| <h4>Conclusion</h4> | ||||
| <p>We hope that in this article we have been able to give you some idea of what | ||||
| type-traits are all about. A more complete listing of the available classes are | ||||
| in the boost documentation, along with further examples using type traits. | ||||
| Templates have enabled C++ uses to take the advantage of the code reuse that | ||||
| generic programming brings; hopefully this article has shown that generic | ||||
| programming does not have to sink to the lowest common denominator, and that | ||||
| templates can be optimal as well as generic.</p> | ||||
| <h4>Acknowledgements</h4> | ||||
| <p>The authors would like to thank Beman Dawes and Howard Hinnant for their | ||||
| helpful comments when preparing this article.</p> | ||||
| <h4>References</h4> | ||||
| <ol> | ||||
|   <li>Nathan C. Myers, C++ Report, June 1995.</li> | ||||
|   <li>The type traits library is based upon contributions by Steve Cleary, Beman | ||||
|     Dawes, Howard Hinnant and John Maddock: it can be found at www.boost.org.</li> | ||||
|   <li>A scalar type is an arithmetic type (i.e. a built-in integer or floating | ||||
|     point type), an enumeration type, a pointer, a pointer to member, or a | ||||
|     const- or volatile-qualified version of one of these types.</li> | ||||
|   <li>This quote is from Donald Knuth, ACM Computing Surveys, December 1974, pg | ||||
|     268.</li> | ||||
|   <li>The test code is available as part of the boost utility library (see | ||||
|     algo_opt_examples.cpp), the code was compiled with gcc 2.95 with all | ||||
|     optimisations turned on, tests were conducted on a 400MHz Pentium II machine | ||||
|     running Microsoft Windows 98.</li> | ||||
|   <li>John Maddock and Howard Hinnant have submitted a "compressed_pair" | ||||
|     library to Boost, which uses a technique similar to the one described here | ||||
|     to hold references. Their pair also uses type traits to determine if any of | ||||
|     the types are empty, and will derive instead of contain to conserve space -- | ||||
|     hence the name "compressed".</li> | ||||
|   <li>This is actually an issue with the C++ Core Language Working Group (issue | ||||
|     #106), submitted by Bjarne Stroustrup. The tentative resolution is to allow | ||||
|     a "reference to a reference to T" to mean the same thing as a | ||||
|     "reference to T", but only in template instantiation, in a method | ||||
|     similar to multiple cv-qualifiers.</li> | ||||
|   <li>For those of you who are wondering why this shouldn't be const-qualified, | ||||
|     remember that references are always implicitly constant (for example, you | ||||
|     can't re-assign a reference). Remember also that "const T &" | ||||
|     is something completely different. For this reason, cv-qualifiers on | ||||
|     template type arguments that are references are ignored.</li> | ||||
| </ol> | ||||
| <h2>Listing 1</h2> | ||||
| <pre>namespace detail{ | ||||
|  | ||||
| template <bool b> | ||||
| struct copier | ||||
| { | ||||
|    template<typename I1, typename I2> | ||||
|    static I2 do_copy(I1 first,  | ||||
|                      I1 last, I2 out); | ||||
| }; | ||||
|  | ||||
| template <bool b> | ||||
| template<typename I1, typename I2> | ||||
| I2 copier<b>::do_copy(I1 first,  | ||||
|                       I1 last,  | ||||
|                       I2 out) | ||||
| { | ||||
|    while(first != last) | ||||
|    { | ||||
|       *out = *first; | ||||
|       ++out; | ||||
|       ++first; | ||||
|    } | ||||
|    return out; | ||||
| } | ||||
|  | ||||
| template <> | ||||
| struct copier<true> | ||||
| { | ||||
|    template<typename I1, typename I2> | ||||
|    static I2* do_copy(I1* first, I1* last, I2* out) | ||||
|    { | ||||
|       memcpy(out, first, (last-first)*sizeof(I2)); | ||||
|       return out+(last-first); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| } | ||||
|  | ||||
| template<typename I1, typename I2> | ||||
| inline I2 copy(I1 first, I1 last, I2 out) | ||||
| { | ||||
|    typedef typename  | ||||
|     boost::remove_cv< | ||||
|      typename std::iterator_traits<I1> | ||||
|       ::value_type>::type v1_t; | ||||
|  | ||||
|    typedef typename  | ||||
|     boost::remove_cv< | ||||
|      typename std::iterator_traits<I2> | ||||
|       ::value_type>::type v2_t; | ||||
|  | ||||
|    enum{ can_opt =  | ||||
|       boost::is_same<v1_t, v2_t>::value | ||||
|       && boost::is_pointer<I1>::value | ||||
|       && boost::is_pointer<I2>::value | ||||
|       && boost:: | ||||
|       has_trivial_assign<v1_t>::value  | ||||
|    }; | ||||
|  | ||||
|    return detail::copier<can_opt>:: | ||||
|       do_copy(first, last, out); | ||||
| }</pre> | ||||
| <hr> | ||||
| <p><EFBFBD> Copyright John Maddock and Steve Cleary, 2000</p> | ||||
|  | ||||
| </body> | ||||
|  | ||||
| </html> | ||||
							
								
								
									
										107
									
								
								call_traits.htm
									
									
									
									
									
								
							
							
						
						
									
										107
									
								
								call_traits.htm
									
									
									
									
									
								
							| @@ -12,7 +12,7 @@ content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> | ||||
| <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" | ||||
| vlink="#800080"> | ||||
|  | ||||
| <h1><img src="../../c++boost.gif" width="276" height="86">Header | ||||
| <h1><img src="../../boost.png" width="276" height="86">Header | ||||
| <<a href="../../boost/detail/call_traits.hpp">boost/call_traits.hpp</a>></h1> | ||||
|  | ||||
| <p>All of the contents of <boost/call_traits.hpp> are | ||||
| @@ -27,10 +27,16 @@ never occur, and that parameters are passed in the most efficient | ||||
| manner possible (see <a href="#examples">examples</a>). In each | ||||
| case if your existing practice is to use the type defined on the | ||||
| left, then replace it with the call_traits defined type on the | ||||
| right. Note that for compilers that do not support partial | ||||
| specialization, no benefit will occur from using call_traits: the | ||||
| call_traits defined types will always be the same as the existing | ||||
| practice in this case.</p> | ||||
| right. </p> | ||||
|  | ||||
| <p>Note that for compilers that do not support either partial | ||||
| specialization or member templates, no benefit will occur from | ||||
| using call_traits: the call_traits defined types will always be | ||||
| the same as the existing practice in this case. In addition if | ||||
| only member templates and not partial template specialisation is | ||||
| support by the compiler (for example Visual C++ 6) then | ||||
| call_traits can not be used with array types (although it can be | ||||
| used to solve the reference to reference problem).</p> | ||||
|  | ||||
| <table border="0" cellpadding="7" cellspacing="1" width="797"> | ||||
|     <tr> | ||||
| @@ -73,7 +79,8 @@ practice in this case.</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="17%"><p align="center">const T&<br> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         T&<br> | ||||
|         (return value)</p> | ||||
|         </td> | ||||
|         <td valign="top" width="35%"><p align="center"><code>call_traits<T>::const_reference</code></p> | ||||
| @@ -85,7 +92,8 @@ practice in this case.</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="17%"><p align="center">const T&<br> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         T&<br> | ||||
|         (function parameter)</p> | ||||
|         </td> | ||||
|         <td valign="top" width="35%"><p align="center"><code>call_traits<T>::param_type</code></p> | ||||
| @@ -326,8 +334,8 @@ possible:</p> | ||||
| <p>The following table shows the effect that call_traits has on | ||||
| various types, the table assumes that the compiler supports | ||||
| partial specialization: if it doesn't then all types behave in | ||||
| the same way as the entry for "myclass", and call_traits | ||||
| can not be used with reference or array types.</p> | ||||
| the same way as the entry for "myclass", and | ||||
| call_traits can not be used with reference or array types.</p> | ||||
|  | ||||
| <table border="0" cellpadding="7" cellspacing="1" width="766"> | ||||
|     <tr> | ||||
| @@ -382,7 +390,8 @@ can not be used with reference or array types.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">int const</p> | ||||
|         </td> | ||||
| @@ -414,7 +423,8 @@ can not be used with reference or array types.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">int&</p> | ||||
|         </td> | ||||
| @@ -426,13 +436,17 @@ can not be used with reference or array types.</p> | ||||
|         <td valign="top" width="17%" bgcolor="#C0C0C0"><p | ||||
|         align="center">const int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">const int&</p> | ||||
|         <td valign="top" width="17%"><p align="center">const | ||||
|         int&</p> | ||||
|         </td> | ||||
|         <td valign="top" width="17%"><p align="center">All | ||||
|         constant-references.</p> | ||||
| @@ -480,8 +494,8 @@ can not be used with reference or array types.</p> | ||||
|  | ||||
| <p>The following class is a trivial class that stores some type T | ||||
| by value (see the <a href="call_traits_test.cpp">call_traits_test.cpp</a> | ||||
| file), the aim is to illustrate how each of the available call_traits | ||||
| typedefs may be used:</p> | ||||
| file), the aim is to illustrate how each of the available | ||||
| call_traits typedefs may be used:</p> | ||||
|  | ||||
| <pre>template <class T> | ||||
| struct contained | ||||
| @@ -517,14 +531,14 @@ problem):</h4> | ||||
|  | ||||
| <pre>template <class Operation>  | ||||
| class binder1st :  | ||||
|    public unary_function<Operation::second_argument_type, Operation::result_type>  | ||||
|    public unary_function<typename Operation::second_argument_type, typename Operation::result_type>  | ||||
| {  | ||||
| protected:  | ||||
|    Operation op;  | ||||
|    Operation::first_argument_type value;  | ||||
|    typename Operation::first_argument_type value;  | ||||
| public:  | ||||
|    binder1st(const Operation& x, const Operation::first_argument_type& y);  | ||||
|    Operation::result_type operator()(const Operation::second_argument_type& x) const;  | ||||
|    binder1st(const Operation& x, const typename Operation::first_argument_type& y);  | ||||
|    typename Operation::result_type operator()(const typename Operation::second_argument_type& x) const;  | ||||
| }; </pre> | ||||
|  | ||||
| <p>Now consider what happens in the relatively common case that | ||||
| @@ -535,7 +549,7 @@ reference to a reference as an argument, and that is not | ||||
| currently legal. The solution here is to modify <code>operator()</code> | ||||
| to use call_traits:</p> | ||||
|  | ||||
| <pre>Operation::result_type operator()(call_traits<Operation::second_argument_type>::param_type x) const;</pre> | ||||
| <pre>typename Operation::result_type operator()(typename call_traits<typename Operation::second_argument_type>::param_type x) const;</pre> | ||||
|  | ||||
| <p>Now in the case that <code>Operation::second_argument_type</code> | ||||
| is a reference type, the argument is passed as a reference, and | ||||
| @@ -569,14 +583,17 @@ std::pair< | ||||
| degraded to pointers if the deduced types are arrays, similar | ||||
| situations occur in the standard binders and adapters: in | ||||
| principle in any function that "wraps" a temporary | ||||
| whose type is deduced.</p> | ||||
| whose type is deduced. Note that the function arguments to | ||||
| make_pair are not expressed in terms of call_traits: doing so | ||||
| would prevent template argument deduction from functioning.</p> | ||||
|  | ||||
| <h4><a name="ex4"></a>Example 4 (optimising fill):</h4> | ||||
|  | ||||
| <p>The call_traits template will "optimize" the passing | ||||
| of a small built-in type as a function parameter, this mainly has | ||||
| an effect when the parameter is used within a loop body. In the | ||||
| following example (see <a href="algo_opt_examples.cpp">algo_opt_examples.cpp</a>), | ||||
| following example (see <a | ||||
| href="../type_traits/examples/fill_example.cpp">fill_example.cpp</a>), | ||||
| a version of std::fill is optimized in two ways: if the type | ||||
| passed is a single byte built-in type then std::memset is used to | ||||
| effect the fill, otherwise a conventional C++ implemention is | ||||
| @@ -589,7 +606,7 @@ template <bool opt> | ||||
| struct filler | ||||
| { | ||||
|    template <typename I, typename T> | ||||
|    static void do_fill(I first, I last, typename boost::call_traits<T>::param_type val); | ||||
|    static void do_fill(I first, I last, typename boost::call_traits<T>::param_type val) | ||||
|    { | ||||
|       while(first != last) | ||||
|       { | ||||
| @@ -632,6 +649,14 @@ Exactly how much mileage you will get from this depends upon your | ||||
| compiler - we could really use some accurate benchmarking | ||||
| software as part of boost for cases like this.</p> | ||||
|  | ||||
| <p>Note that the function arguments to fill are not expressed in | ||||
| terms of call_traits: doing so would prevent template argument | ||||
| deduction from functioning. Instead fill acts as a "thin | ||||
| wrapper" that is there to perform template argument | ||||
| deduction, the compiler will optimise away the call to fill all | ||||
| together, replacing it with the call to filler<>::do_fill, | ||||
| which does use call_traits.</p> | ||||
|  | ||||
| <h3>Rationale</h3> | ||||
|  | ||||
| <p>The following notes are intended to briefly describe the | ||||
| @@ -650,10 +675,10 @@ be any worse than existing practice.</p> | ||||
| <p>Pointers follow the same rational as small built-in types.</p> | ||||
|  | ||||
| <p>For reference types the rational follows <a href="#refs">Example | ||||
| 2</a> - references to references are not allowed, so the call_traits | ||||
| members must be defined such that these problems do not occur. | ||||
| There is a proposal to modify the language such that "a | ||||
| reference to a reference is a reference" (issue #106, | ||||
| 2</a> - references to references are not allowed, so the | ||||
| call_traits members must be defined such that these problems do | ||||
| not occur. There is a proposal to modify the language such that | ||||
| "a reference to a reference is a reference" (issue #106, | ||||
| submitted by Bjarne Stroustrup), call_traits<T>::value_type | ||||
| and call_traits<T>::param_type both provide the same effect | ||||
| as that proposal, without the need for a language change (in | ||||
| @@ -671,11 +696,11 @@ struct A | ||||
|    void foo(T t); | ||||
| };</pre> | ||||
|  | ||||
| <p><font face="Times New Roman">In this case if we instantiate A<int[2]> | ||||
| then the declared type of the parameter passed to member function | ||||
| foo is int[2], but it's actual type is const int*, if we try to | ||||
| use the type T within the function body, then there is a strong | ||||
| likelyhood that our code will not compile:</font></p> | ||||
| <p><font face="Times New Roman">In this case if we instantiate | ||||
| A<int[2]> then the declared type of the parameter passed to | ||||
| member function foo is int[2], but it's actual type is const int*, | ||||
| if we try to use the type T within the function body, then there | ||||
| is a strong likelyhood that our code will not compile:</font></p> | ||||
|  | ||||
| <pre>template <class T> | ||||
| void A<T>::foo(T t) | ||||
| @@ -690,13 +715,13 @@ declared type:</p> | ||||
| <pre>template <class T> | ||||
| struct A | ||||
| { | ||||
|    void foo(call_traits<T>::value_type t); | ||||
|    void foo(typename call_traits<T>::value_type t); | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| void A<T>::foo(call_traits<T>::value_type t) | ||||
| void A<T>::foo(typename call_traits<T>::value_type t) | ||||
| { | ||||
|    call_traits<T>::value_type dup(t); // OK even if T is an array type. | ||||
|    typename call_traits<T>::value_type dup(t); // OK even if T is an array type. | ||||
| }</pre> | ||||
|  | ||||
| <p>For value_type (return by value), again only a pointer may be | ||||
| @@ -713,7 +738,7 @@ specialisation).</p> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <p>Revised 18 June 2000</p> | ||||
| <p>Revised 01 September 2000</p> | ||||
|  | ||||
| <p><EFBFBD> Copyright boost.org 2000. Permission to copy, use, modify, | ||||
| sell and distribute this document is granted provided this | ||||
| @@ -724,10 +749,11 @@ no claim as to its suitability for any purpose.</p> | ||||
| <p>Based on contributions by Steve Cleary, Beman Dawes, Howard | ||||
| Hinnant and John Maddock.</p> | ||||
|  | ||||
| <p>Maintained by <a href="mailto:John_Maddock@compuserve.com">John | ||||
| <p>Maintained by <a href="mailto:john@johnmaddock.co.uk">John | ||||
| Maddock</a>, the latest version of this file can be found at <a | ||||
| href="http://www.boost.org/">www.boost.org</a>, and the boost | ||||
| discussion list at <a href="http://www.egroups.com/list/boost">www.egroups.com/list/boost</a>.</p> | ||||
| discussion list at <a | ||||
| href="http://www.yahoogroups.com/list/boost">www.yahoogroups.com/list/boost</a>.</p> | ||||
|  | ||||
| <p>.</p> | ||||
|  | ||||
| @@ -736,3 +762,4 @@ discussion list at <a href="http://www.egroups.com/list/boost">www.egroups.com/l | ||||
| <p> </p> | ||||
| </body> | ||||
| </html> | ||||
|  | ||||
|   | ||||
| @@ -1,20 +1,29 @@ | ||||
|  // boost::compressed_pair test program    | ||||
| //  boost::compressed_pair test program    | ||||
|      | ||||
|  //  (C) Copyright John Maddock 2000. Permission to copy, use, modify, sell and    | ||||
|  //  distribute this software is granted provided this copyright notice appears    | ||||
|  //  in all copies. This software is provided "as is" without express or implied    | ||||
|  //  warranty, and with no claim as to its suitability for any purpose.    | ||||
| //  (C) Copyright John Maddock 2000.  | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
|  | ||||
|  | ||||
| // standalone test program for <boost/call_traits.hpp> | ||||
| // 18 Mar 2002: | ||||
| //    Changed some names to prevent conflicts with some new type_traits additions. | ||||
| // 03 Oct 2000: | ||||
| //    Enabled extra tests for VC6. | ||||
|  | ||||
| #include <cassert> | ||||
| #include <iostream> | ||||
| #include <iomanip> | ||||
| #include <algorithm> | ||||
| #include <typeinfo> | ||||
| #include <boost/call_traits.hpp> | ||||
|  | ||||
| #include "type_traits_test.hpp" | ||||
| #include <libs/type_traits/test/test.hpp> | ||||
| #include <libs/type_traits/test/check_type.hpp> | ||||
|  | ||||
| // a way prevent warnings for unused variables | ||||
| template<class T> inline void unused_variable(const T&) {} | ||||
|  | ||||
| // | ||||
| // struct contained models a type that contains a type (for example std::pair) | ||||
| // arrays are contained by value, and have to be treated as a special case: | ||||
| @@ -42,7 +51,7 @@ struct contained | ||||
|    reference get() { return v_; } | ||||
|    const_reference const_get()const { return v_; } | ||||
|    // pass value: | ||||
|    void call(param_type p){} | ||||
|    void call(param_type){} | ||||
|  | ||||
| }; | ||||
|  | ||||
| @@ -67,12 +76,12 @@ struct contained<T[N]> | ||||
|    // return by_ref: | ||||
|    reference get() { return v_; } | ||||
|    const_reference const_get()const { return v_; } | ||||
|    void call(param_type p){} | ||||
|    void call(param_type){} | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| template <class T> | ||||
| contained<typename boost::call_traits<T>::value_type> wrap(const T& t) | ||||
| contained<typename boost::call_traits<T>::value_type> test_wrap_type(const T& t) | ||||
| { | ||||
|    typedef typename boost::call_traits<T>::value_type ct; | ||||
|    return contained<ct>(t); | ||||
| @@ -96,37 +105,38 @@ std::pair< | ||||
| using namespace std; | ||||
|  | ||||
| // | ||||
| // struct checker: | ||||
| // struct call_traits_checker: | ||||
| // verifies behaviour of contained example: | ||||
| // | ||||
| template <class T> | ||||
| struct checker | ||||
| struct call_traits_checker | ||||
| { | ||||
|    typedef typename boost::call_traits<T>::param_type param_type; | ||||
|    void operator()(param_type); | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| void checker<T>::operator()(param_type p) | ||||
| void call_traits_checker<T>::operator()(param_type p) | ||||
| { | ||||
|    T t(p); | ||||
|    contained<T> c(t); | ||||
|    cout << "checking contained<" << typeid(T).name() << ">..." << endl; | ||||
|    assert(t == c.value()); | ||||
|    assert(t == c.get()); | ||||
|    assert(t == c.const_get()); | ||||
|  | ||||
|    cout << "typeof contained<" << typeid(T).name() << ">::v_ is:           " << typeid(&contained<T>::v_).name() << endl; | ||||
|    BOOST_CHECK(t == c.value()); | ||||
|    BOOST_CHECK(t == c.get()); | ||||
|    BOOST_CHECK(t == c.const_get()); | ||||
| #ifndef __ICL | ||||
|    //cout << "typeof contained<" << typeid(T).name() << ">::v_ is:           " << typeid(&contained<T>::v_).name() << endl; | ||||
|    cout << "typeof contained<" << typeid(T).name() << ">::value() is:      " << typeid(&contained<T>::value).name() << endl; | ||||
|    cout << "typeof contained<" << typeid(T).name() << ">::get() is:        " << typeid(&contained<T>::get).name() << endl; | ||||
|    cout << "typeof contained<" << typeid(T).name() << ">::const_get() is:  " << typeid(&contained<T>::const_get).name() << endl; | ||||
|    cout << "typeof contained<" << typeid(T).name() << ">::call() is:       " << typeid(&contained<T>::call).name() << endl; | ||||
|    cout << endl; | ||||
| #endif | ||||
| } | ||||
|  | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| template <class T, std::size_t N> | ||||
| struct checker<T[N]> | ||||
| struct call_traits_checker<T[N]> | ||||
| { | ||||
|    typedef typename boost::call_traits<T[N]>::param_type param_type; | ||||
|    void operator()(param_type t) | ||||
| @@ -135,11 +145,11 @@ struct checker<T[N]> | ||||
|       cout << "checking contained<" << typeid(T[N]).name() << ">..." << endl; | ||||
|       unsigned int i = 0; | ||||
|       for(i = 0; i < N; ++i) | ||||
|          assert(t[i] == c.value()[i]); | ||||
|          BOOST_CHECK(t[i] == c.value()[i]); | ||||
|       for(i = 0; i < N; ++i) | ||||
|          assert(t[i] == c.get()[i]); | ||||
|          BOOST_CHECK(t[i] == c.get()[i]); | ||||
|       for(i = 0; i < N; ++i) | ||||
|          assert(t[i] == c.const_get()[i]); | ||||
|          BOOST_CHECK(t[i] == c.const_get()[i]); | ||||
|  | ||||
|       cout << "typeof contained<" << typeid(T[N]).name() << ">::v_ is:         " << typeid(&contained<T[N]>::v_).name() << endl; | ||||
|       cout << "typeof contained<" << typeid(T[N]).name() << ">::value is:      " << typeid(&contained<T[N]>::value).name() << endl; | ||||
| @@ -153,11 +163,11 @@ struct checker<T[N]> | ||||
|  | ||||
| // | ||||
| // check_wrap: | ||||
| template <class T, class U> | ||||
| void check_wrap(const contained<T>& w, const U& u) | ||||
| template <class W, class U> | ||||
| void check_wrap(const W& w, const U& u) | ||||
| { | ||||
|    cout << "checking contained<" << typeid(T).name() << ">..." << endl; | ||||
|    assert(w.value() == u); | ||||
|    cout << "checking " << typeid(W).name() << "..." << endl; | ||||
|    BOOST_CHECK(w.value() == u); | ||||
| } | ||||
|  | ||||
| // | ||||
| @@ -168,47 +178,51 @@ template <class T, class U, class V> | ||||
| void check_make_pair(T c, U u, V v) | ||||
| { | ||||
|    cout << "checking std::pair<" << typeid(c.first).name() << ", " << typeid(c.second).name() << ">..." << endl; | ||||
|    assert(c.first == u); | ||||
|    assert(c.second == v); | ||||
|    BOOST_CHECK(c.first == u); | ||||
|    BOOST_CHECK(c.second == v); | ||||
|    cout << endl; | ||||
| } | ||||
|  | ||||
|  | ||||
| struct UDT | ||||
| struct comparible_UDT | ||||
| { | ||||
|    int i_; | ||||
|    UDT() : i_(2){} | ||||
|    bool operator == (const UDT& v){ return v.i_ == i_; } | ||||
|    comparible_UDT() : i_(2){} | ||||
|    comparible_UDT(const comparible_UDT& other) : i_(other.i_){} | ||||
|    comparible_UDT& operator=(const comparible_UDT& other) | ||||
|    {  | ||||
|       i_ = other.i_; | ||||
|       return *this; | ||||
|    } | ||||
|    bool operator == (const comparible_UDT& v){ return v.i_ == i_; } | ||||
| }; | ||||
|  | ||||
| int main() | ||||
| int main(int argc, char *argv[ ]) | ||||
| { | ||||
|    checker<UDT> c1; | ||||
|    UDT u; | ||||
|    call_traits_checker<comparible_UDT> c1; | ||||
|    comparible_UDT u; | ||||
|    c1(u); | ||||
|    checker<int> c2; | ||||
|    call_traits_checker<int> c2; | ||||
|    int i = 2; | ||||
|    c2(i); | ||||
|    int* pi = &i; | ||||
|    checker<int*> c3; | ||||
|    c3(pi); | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    checker<int&> c4; | ||||
|    c4(i); | ||||
|    checker<const int&> c5; | ||||
|    c5(i); | ||||
|  | ||||
|    int a[2] = {1,2}; | ||||
|    checker<int[2]> c6; | ||||
| #if defined(BOOST_MSVC6_MEMBER_TEMPLATES) && !defined(__ICL) | ||||
|    call_traits_checker<int*> c3; | ||||
|    c3(pi); | ||||
|    call_traits_checker<int&> c4; | ||||
|    c4(i); | ||||
|    call_traits_checker<const int&> c5; | ||||
|    c5(i); | ||||
| #if !defined (BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) && !defined(__MWERKS__) && !defined(__SUNPRO_CC) | ||||
|    call_traits_checker<int[2]> c6; | ||||
|    c6(a); | ||||
| #endif | ||||
| #endif | ||||
|  | ||||
|    check_wrap(wrap(2), 2); | ||||
|    const char ca[4] = "abc"; | ||||
|    // compiler can't deduce this for some reason: | ||||
|    //check_wrap(wrap(ca), ca); | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    check_wrap(wrap(a), a); | ||||
|    check_wrap(test_wrap_type(2), 2); | ||||
| #if !defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) && !defined(__SUNPRO_CC) | ||||
|    check_wrap(test_wrap_type(a), a); | ||||
|    check_make_pair(test::make_pair(a, a), a, a); | ||||
| #endif | ||||
|  | ||||
| @@ -217,59 +231,67 @@ int main() | ||||
|    typedef int& r_type; | ||||
|    typedef const r_type cr_type; | ||||
|  | ||||
|    type_test(UDT, boost::call_traits<UDT>::value_type) | ||||
|    type_test(UDT&, boost::call_traits<UDT>::reference) | ||||
|    type_test(const UDT&, boost::call_traits<UDT>::const_reference) | ||||
|    type_test(const UDT&, boost::call_traits<UDT>::param_type) | ||||
|    type_test(int, boost::call_traits<int>::value_type) | ||||
|    type_test(int&, boost::call_traits<int>::reference) | ||||
|    type_test(const int&, boost::call_traits<int>::const_reference) | ||||
|    type_test(const int, boost::call_traits<int>::param_type) | ||||
|    type_test(int*, boost::call_traits<int*>::value_type) | ||||
|    type_test(int*&, boost::call_traits<int*>::reference) | ||||
|    type_test(int*const&, boost::call_traits<int*>::const_reference) | ||||
|    type_test(int*const, boost::call_traits<int*>::param_type) | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    type_test(int&, boost::call_traits<int&>::value_type) | ||||
|    type_test(int&, boost::call_traits<int&>::reference) | ||||
|    type_test(const int&, boost::call_traits<int&>::const_reference) | ||||
|    type_test(int&, boost::call_traits<int&>::param_type) | ||||
| #if !(defined(__GNUC__) && (__GNUC__ < 3)) | ||||
|    type_test(int&, boost::call_traits<cr_type>::value_type) | ||||
|    type_test(int&, boost::call_traits<cr_type>::reference) | ||||
|    type_test(const int&, boost::call_traits<cr_type>::const_reference) | ||||
|    type_test(int&, boost::call_traits<cr_type>::param_type) | ||||
|    BOOST_CHECK_TYPE(comparible_UDT, boost::call_traits<comparible_UDT>::value_type); | ||||
|    BOOST_CHECK_TYPE(comparible_UDT&, boost::call_traits<comparible_UDT>::reference); | ||||
|    BOOST_CHECK_TYPE(const comparible_UDT&, boost::call_traits<comparible_UDT>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const comparible_UDT&, boost::call_traits<comparible_UDT>::param_type); | ||||
|    BOOST_CHECK_TYPE(int, boost::call_traits<int>::value_type); | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<int>::reference); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<int>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const int, boost::call_traits<int>::param_type); | ||||
|    BOOST_CHECK_TYPE(int*, boost::call_traits<int*>::value_type); | ||||
|    BOOST_CHECK_TYPE(int*&, boost::call_traits<int*>::reference); | ||||
|    BOOST_CHECK_TYPE(int*const&, boost::call_traits<int*>::const_reference); | ||||
|    BOOST_CHECK_TYPE(int*const, boost::call_traits<int*>::param_type); | ||||
| #if defined(BOOST_MSVC6_MEMBER_TEMPLATES) | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<int&>::value_type); | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<int&>::reference); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<int&>::const_reference); | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<int&>::param_type); | ||||
| #if !(defined(__GNUC__) && ((__GNUC__ < 3) || (__GNUC__ == 3) && (__GNUC_MINOR__ < 1))) | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<cr_type>::value_type); | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<cr_type>::reference); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<cr_type>::const_reference); | ||||
|    BOOST_CHECK_TYPE(int&, boost::call_traits<cr_type>::param_type); | ||||
| #else | ||||
|    std::cout << "Your compiler cannot instantiate call_traits<int&const>, skipping four tests (4 errors)" << std::endl; | ||||
|    failures += 4; | ||||
|    test_count += 4; | ||||
| #endif | ||||
|    type_test(const int&, boost::call_traits<const int&>::value_type) | ||||
|    type_test(const int&, boost::call_traits<const int&>::reference) | ||||
|    type_test(const int&, boost::call_traits<const int&>::const_reference) | ||||
|    type_test(const int&, boost::call_traits<const int&>::param_type) | ||||
|    type_test(const int*, boost::call_traits<int[3]>::value_type) | ||||
|    type_test(int(&)[3], boost::call_traits<int[3]>::reference) | ||||
|    type_test(const int(&)[3], boost::call_traits<int[3]>::const_reference) | ||||
|    type_test(const int*const, boost::call_traits<int[3]>::param_type) | ||||
|    type_test(const int*, boost::call_traits<const int[3]>::value_type) | ||||
|    type_test(const int(&)[3], boost::call_traits<const int[3]>::reference) | ||||
|    type_test(const int(&)[3], boost::call_traits<const int[3]>::const_reference) | ||||
|    type_test(const int*const, boost::call_traits<const int[3]>::param_type) | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<const int&>::value_type); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<const int&>::reference); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<const int&>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const int&, boost::call_traits<const int&>::param_type); | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    BOOST_CHECK_TYPE(const int*, boost::call_traits<int[3]>::value_type); | ||||
|    BOOST_CHECK_TYPE(int(&)[3], boost::call_traits<int[3]>::reference); | ||||
|    BOOST_CHECK_TYPE(const int(&)[3], boost::call_traits<int[3]>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const int*const, boost::call_traits<int[3]>::param_type); | ||||
|    BOOST_CHECK_TYPE(const int*, boost::call_traits<const int[3]>::value_type); | ||||
|    BOOST_CHECK_TYPE(const int(&)[3], boost::call_traits<const int[3]>::reference); | ||||
|    BOOST_CHECK_TYPE(const int(&)[3], boost::call_traits<const int[3]>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const int*const, boost::call_traits<const int[3]>::param_type); | ||||
|    // test with abstract base class: | ||||
|    BOOST_CHECK_TYPE(test_abc1, boost::call_traits<test_abc1>::value_type); | ||||
|    BOOST_CHECK_TYPE(test_abc1&, boost::call_traits<test_abc1>::reference); | ||||
|    BOOST_CHECK_TYPE(const test_abc1&, boost::call_traits<test_abc1>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const test_abc1&, boost::call_traits<test_abc1>::param_type); | ||||
| #else | ||||
|    std::cout << "You're compiler does not support partial template instantiation, skipping 20 tests (20 errors)" << std::endl; | ||||
|    failures += 20; | ||||
|    test_count += 20; | ||||
|    std::cout << "You're compiler does not support partial template specialiation, skipping 8 tests (8 errors)" << std::endl; | ||||
| #endif | ||||
| #else | ||||
|    std::cout << "You're compiler does not support partial template specialiation, skipping 20 tests (20 errors)" << std::endl; | ||||
| #endif | ||||
|    // test with an incomplete type: | ||||
|    BOOST_CHECK_TYPE(incomplete_type, boost::call_traits<incomplete_type>::value_type); | ||||
|    BOOST_CHECK_TYPE(incomplete_type&, boost::call_traits<incomplete_type>::reference); | ||||
|    BOOST_CHECK_TYPE(const incomplete_type&, boost::call_traits<incomplete_type>::const_reference); | ||||
|    BOOST_CHECK_TYPE(const incomplete_type&, boost::call_traits<incomplete_type>::param_type); | ||||
|  | ||||
|    std::cout << std::endl << test_count << " tests completed (" << failures << " failures)... press any key to exit"; | ||||
|    std::cin.get(); | ||||
|    return failures; | ||||
|    return 0; | ||||
| } | ||||
|  | ||||
| // | ||||
| // define call_traits tests to check that the assertions in the docs do actually work | ||||
| // this is an instantiate only set of tests: | ||||
| // this is an compile-time only set of tests: | ||||
| // | ||||
| template <typename T, bool isarray = false> | ||||
| struct call_traits_test | ||||
| @@ -304,6 +326,19 @@ void call_traits_test<T, isarray>::assert_construct(typename call_traits_test<T, | ||||
|    param_type p2(v); | ||||
|    param_type p3(r); | ||||
|    param_type p4(p); | ||||
|     | ||||
|    unused_variable(v2); | ||||
|    unused_variable(v3); | ||||
|    unused_variable(v4); | ||||
|    unused_variable(r2); | ||||
|    unused_variable(r3); | ||||
|    unused_variable(cr2); | ||||
|    unused_variable(cr3); | ||||
|    unused_variable(cr4); | ||||
|    unused_variable(cr5); | ||||
|    unused_variable(p2); | ||||
|    unused_variable(p3); | ||||
|    unused_variable(p4); | ||||
| } | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| template <typename T> | ||||
| @@ -318,7 +353,7 @@ struct call_traits_test<T, true> | ||||
| }; | ||||
|  | ||||
| template <typename T> | ||||
| void call_traits_test<T, true>::assert_construct(boost::call_traits<T>::param_type val) | ||||
| void call_traits_test<T, true>::assert_construct(typename boost::call_traits<T>::param_type val) | ||||
| { | ||||
|    // | ||||
|    // this is to check that the call_traits assertions are valid: | ||||
| @@ -340,6 +375,19 @@ void call_traits_test<T, true>::assert_construct(boost::call_traits<T>::param_ty | ||||
|    param_type p2(v); | ||||
|    param_type p3(r); | ||||
|    param_type p4(p); | ||||
|     | ||||
|    unused_variable(v2); | ||||
|    unused_variable(v3); | ||||
|    unused_variable(v4); | ||||
|    unused_variable(v5); | ||||
| #ifndef __BORLANDC__ | ||||
|    unused_variable(r2); | ||||
|    unused_variable(cr2); | ||||
| #endif | ||||
|    unused_variable(cr3); | ||||
|    unused_variable(p2); | ||||
|    unused_variable(p3); | ||||
|    unused_variable(p4); | ||||
| } | ||||
| #endif //BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| // | ||||
| @@ -347,9 +395,11 @@ void call_traits_test<T, true>::assert_construct(boost::call_traits<T>::param_ty | ||||
| template struct call_traits_test<int>; | ||||
| template struct call_traits_test<const int>; | ||||
| template struct call_traits_test<int*>; | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| #if defined(BOOST_MSVC6_MEMBER_TEMPLATES) | ||||
| template struct call_traits_test<int&>; | ||||
| template struct call_traits_test<const int&>; | ||||
| #if !defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) && !defined(__SUNPRO_CC) | ||||
| template struct call_traits_test<int[2], true>; | ||||
| #endif | ||||
| #endif | ||||
|  | ||||
|   | ||||
							
								
								
									
										148
									
								
								cast.htm
									
									
									
									
									
								
							
							
						
						
									
										148
									
								
								cast.htm
									
									
									
									
									
								
							| @@ -1,148 +0,0 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> | ||||
| <meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| <title>Header boost/cast.hpp Documentation</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|  | ||||
| <h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="center" width="277" height="86">Header | ||||
| <a href="../../boost/cast.hpp">boost/cast.hpp</a></h1> | ||||
| <h2><a name="Cast Functions">Cast Functions</a></h2> | ||||
| <p>The <code>header <a href="../../boost/cast.hpp">boost/cast.hpp</a></code> | ||||
| provides <a href="#Polymorphic_cast"><b>polymorphic_cast</b></a>, <a href="#Polymorphic_cast"><b>polymorphic_downcast</b></a>, | ||||
| and <a href="#numeric_cast"><b>numeric_cast</b></a> template functions designed | ||||
| to complement the C++ Standard's built-in casts.</p> | ||||
| <p>The program <a href="cast_test.cpp">cast_test.cpp</a> can be used to | ||||
| verify these function templates work as expected.</p> | ||||
| <p><b>polymorphic_cast</b> was suggested by Bjarne Stroustrup in "The C++ | ||||
| Programming Language".<br> | ||||
| <b>polymorphic_downcast</b> was contributed by <a href="../../people/dave_abrahams.htm">Dave | ||||
| Abrahams</a>.<b><br> | ||||
| numeric_cast</b> was contributed by <a href="../../people/kevlin_henney.htm">Kevlin | ||||
| Henney</a>.</p> | ||||
| <h3>Namespace synopsis</h3> | ||||
| <blockquote> | ||||
|   <pre>namespace boost { | ||||
|     namespace cast { | ||||
|         // all synopsis below included here | ||||
|     } | ||||
|   using ::boost::cast::polymorphic_cast; | ||||
|   using ::boost::cast::polymorphic_downcast; | ||||
|   using ::boost::cast::bad_numeric_cast; | ||||
|   using ::boost::cast::numeric_cast; | ||||
| }</pre> | ||||
| </blockquote> | ||||
| <h3><a name="Polymorphic_cast">Polymorphic casts</a></h3> | ||||
| <p>Pointers to polymorphic objects (objects of classes which define at least one | ||||
| virtual function) are sometimes downcast or crosscast.  Downcasting means | ||||
| casting from a base class to a derived class.  Crosscasting means casting | ||||
| across an inheritance hierarchy diagram, such as from one base to the other in a | ||||
| <b>Y</b> diagram hierarchy.</p> | ||||
| <p>Such casts can be done with old-style casts, but this approach is never to be | ||||
| recommended.  Old-style casts are sorely lacking in type safety, suffer | ||||
| poor readability, and are difficult to locate with search tools.</p> | ||||
| <p>The C++ built-in <b>static_cast</b> can be used for efficiently downcasting | ||||
| pointers to polymorphic objects, but provides no error detection for the case | ||||
| where the pointer being cast actually points to the wrong derived class. The <b>polymorphic_downcast</b> | ||||
| template retains the efficiency of <b>static_cast</b> for non-debug | ||||
| compilations, but for debug compilations adds safety via an assert() that a <b>dynamic_cast</b> | ||||
| succeeds. <b> </b></p> | ||||
| <p>The C++ built-in <b>dynamic_cast</b> can be used for downcasts and crosscasts | ||||
| of pointers to polymorphic objects, but error notification in the form of a | ||||
| returned value of 0 is inconvenient to test, or worse yet, easy to forget to | ||||
| test.  The <b>polymorphic_cast</b> template performs a <b>dynamic_cast</b>, | ||||
| and throws an exception if the <b>dynamic_cast</b> returns 0.</p> | ||||
| <p>A <b>polymorphic_downcast</b> is preferred when debug-mode tests will cover | ||||
| 100% of the object types possibly cast and when non-debug-mode efficiency is an | ||||
| issue. If these two conditions are not present, <b>polymorphic_cast</b> is | ||||
| preferred.  It must also be used for crosscasts.  It does an assert( | ||||
| dynamic_cast<Derived>(x) == x ) where x is the base pointer, ensuring that | ||||
| not only is a non-zero pointer returned, but also that it correct in the | ||||
| presence of multiple inheritance. .<b> Warning:</b>: Because <b>polymorphic_downcast</b> | ||||
| uses assert(), it violates the One Definition Rule if NDEBUG is inconsistently | ||||
| defined across translation units.</p> | ||||
| <p>The C++ built-in <b>dynamic_cast</b> must be used to cast references rather | ||||
| than pointers.  It is also the only cast that can be used to check whether | ||||
| a given interface is supported; in that case a return of 0 isn't an error | ||||
| condition.</p> | ||||
| <h3>polymorphic_cast and polymorphic_downcast synopsis</h3> | ||||
| <blockquote> | ||||
|   <pre>template <class Derived, class Base> | ||||
| inline Derived polymorphic_cast(Base* x); | ||||
| // Throws: std::bad_cast if ( dynamic_cast<Derived>(x) == 0 ) | ||||
| // Returns: dynamic_cast<Derived>(x) | ||||
|  | ||||
| template <class Derived, class Base> | ||||
| inline Derived polymorphic_downcast(Base* x); | ||||
| // Effects: assert( dynamic_cast<Derived>(x) == x ); | ||||
| // Returns: static_cast<Derived>(x)</pre> | ||||
| </blockquote> | ||||
| <h3>polymorphic_downcast example</h3> | ||||
| <blockquote> | ||||
|   <pre>#include <boost/cast.hpp> | ||||
| ... | ||||
| class Fruit { public: virtual ~Fruit(){}; ... }; | ||||
| class Banana : public Fruit { ... }; | ||||
| ... | ||||
| void f( Fruit * fruit ) { | ||||
| // ... logic which leads us to believe it is a Banana | ||||
|   Banana * banana = boost::polymorphic_downcast<Banana*>(fruit); | ||||
|   ...</pre> | ||||
| </blockquote> | ||||
| <h3><a name="numeric_cast">numeric_cast</a></h3> | ||||
| <p>A <b>static_cast</b>, <b>implicit_cast</b> or implicit conversion will not | ||||
| detect failure to preserve range for numeric casts. The <b>numeric_cast</b> | ||||
| template function are similar to <b>static_cast</b> and certain (dubious) | ||||
| implicit conversions in this respect, except that they detect loss of numeric | ||||
| range. An exception is thrown when a runtime value preservation check fails.</p> | ||||
| <p>The requirements on the argument and result types are:</p> | ||||
| <blockquote> | ||||
|   <ul> | ||||
|     <li>Both argument and result types are CopyConstructible [20.1.3].</li> | ||||
|     <li>Both argument and result types are Numeric, defined by <code>std::numeric_limits<>::is_specialized</code> | ||||
|       being true.</li> | ||||
|     <li>The argument can be converted to the result type using <b>static_cast</b>.</li> | ||||
|   </ul> | ||||
| </blockquote> | ||||
| <h3>numeric_cast synopsis</h3> | ||||
| <blockquote> | ||||
|   <pre>class bad_numeric_cast : public std::bad_cast {...}; | ||||
|  | ||||
| template<typename Target, typename Source> | ||||
|   inline Target numeric_cast(Source arg); | ||||
|     // Throws:  bad_numeric_cast unless, in converting arg from Source to Target, | ||||
|     //          there is no loss of negative range, and no underflow, and no | ||||
|     //          overflow, as determined by std::numeric_limits | ||||
|     // Returns: static_cast<Target>(arg)</pre> | ||||
| </blockquote> | ||||
| <h3>numeric_cast example</h3> | ||||
| <blockquote> | ||||
|   <pre>#include <boost/cast.hpp> | ||||
| using namespace boost::cast; | ||||
|  | ||||
| void ariane(double vx) | ||||
| { | ||||
|     ... | ||||
|     unsigned short dx = numeric_cast<unsigned short>(vx); | ||||
|     ... | ||||
| }</pre> | ||||
| </blockquote> | ||||
| <h3>numeric_cast rationale</h3> | ||||
| <p>The form of the throws condition is specified so that != is not a required | ||||
| operation.</p> | ||||
| <hr> | ||||
| <p>Revised  <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan | ||||
| -->28 June, 2000<!--webbot bot="Timestamp" endspan i-checksum="19846" | ||||
| --></p> | ||||
| <p><EFBFBD> Copyright boost.org 1999. Permission to copy, use, modify, sell and | ||||
| distribute this document is granted provided this copyright notice appears in | ||||
| all copies. This document is provided "as is" without express or | ||||
| implied warranty, and with no claim as to its suitability for any purpose.</p> | ||||
|  | ||||
| </body> | ||||
|  | ||||
| </html> | ||||
							
								
								
									
										149
									
								
								cast_test.cpp
									
									
									
									
									
								
							
							
						
						
									
										149
									
								
								cast_test.cpp
									
									
									
									
									
								
							| @@ -1,149 +0,0 @@ | ||||
| //  boost utility cast test program  -----------------------------------------// | ||||
|  | ||||
| //  (C) Copyright boost.org 1999. Permission to copy, use, modify, sell | ||||
| //  and distribute this software is granted provided this copyright | ||||
| //  notice appears in all copies. This software is provided "as is" without | ||||
| //  express or implied warranty, and with no claim as to its suitability for | ||||
| //  any purpose. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
|  | ||||
| //  Revision History | ||||
| //   28 Jun 00  implicit_cast removed (Beman Dawes) | ||||
| //   30 Aug 99  value_cast replaced by numeric_cast | ||||
| //    3 Aug 99  Initial Version | ||||
|  | ||||
| #include <iostream> | ||||
| #include <climits> | ||||
| #include <limits> | ||||
| #include <boost/cast.hpp> | ||||
|  | ||||
| #  if SCHAR_MAX == LONG_MAX | ||||
| #      error "This test program doesn't work if SCHAR_MAX == LONG_MAX" | ||||
| #  endif  | ||||
|  | ||||
| using namespace boost; | ||||
| using std::cout; | ||||
|  | ||||
| namespace | ||||
| { | ||||
|     struct Base | ||||
|     {  | ||||
|         virtual char kind() { return 'B'; } | ||||
|     }; | ||||
|      | ||||
|     struct Base2 | ||||
|     {  | ||||
|         virtual char kind2() { return '2'; } | ||||
|     }; | ||||
|      | ||||
|     struct Derived : public Base, Base2 | ||||
|     { | ||||
|         virtual char kind() { return 'D'; } | ||||
|     };  | ||||
| }    | ||||
|  | ||||
|  | ||||
| int main( int argc, char * argv[] ) | ||||
| { | ||||
|     cout << "Usage: test_casts [n], where n omitted or is:\n" | ||||
|             "  1 = execute #1 assert failure (#ifndef NDEBUG)\n" | ||||
|             "  2 = execute #2 assert failure (#ifndef NDEBUG)\n" | ||||
|             "Example: test_casts 2\n\n"; | ||||
|  | ||||
| #   ifdef NDEBUG | ||||
|         cout << "NDEBUG is defined\n"; | ||||
| #   else | ||||
|         cout << "NDEBUG is not defined\n"; | ||||
| #   endif | ||||
|  | ||||
|     cout << "\nBeginning tests...\n";         | ||||
|  | ||||
| //  test polymorphic_cast  ---------------------------------------------------// | ||||
|      | ||||
|     //  tests which should succeed | ||||
|     Base *    base = new Derived; | ||||
|     Base2 *   base2 = 0; | ||||
|     Derived * derived = 0; | ||||
|     derived = polymorphic_downcast<Derived*>( base );  // downcast | ||||
|     assert( derived->kind() == 'D' ); | ||||
|  | ||||
|     derived = 0; | ||||
|     derived = polymorphic_cast<Derived*>( base ); // downcast, throw on error | ||||
|     assert( derived->kind() == 'D' ); | ||||
|  | ||||
|     base2 = polymorphic_cast<Base2*>( base ); // crosscast | ||||
|     assert( base2->kind2() == '2' ); | ||||
|  | ||||
|      //  tests which should result in errors being detected | ||||
|     int err_count = 0; | ||||
|     base = new Base; | ||||
|  | ||||
|     if ( argc > 1 && *argv[1] == '1' ) | ||||
|         { derived = polymorphic_downcast<Derived*>( base ); } // #1 assert failure | ||||
|  | ||||
|     bool caught_exception = false; | ||||
|     try { derived = polymorphic_cast<Derived*>( base ); } | ||||
|     catch (std::bad_cast) | ||||
|         { cout<<"caught bad_cast\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|     //  the following is just so generated code can be inspected | ||||
|     if ( derived->kind() == 'B' ) ++err_count; | ||||
|  | ||||
| //  test implicit_cast and numeric_cast  -------------------------------------// | ||||
|      | ||||
|     //  tests which should succeed | ||||
|     long small_value = 1; | ||||
|     long small_negative_value = -1; | ||||
|     long large_value = std::numeric_limits<long>::max(); | ||||
|     long large_negative_value = std::numeric_limits<long>::min(); | ||||
|     signed char c = 0; | ||||
|  | ||||
|     c = large_value;  // see if compiler generates warning | ||||
|  | ||||
|     c = numeric_cast<signed char>( small_value ); | ||||
|     assert( c == 1 ); | ||||
|     c = 0; | ||||
|     c = numeric_cast<signed char>( small_value ); | ||||
|     assert( c == 1 ); | ||||
|     c = 0; | ||||
|     c = numeric_cast<signed char>( small_negative_value ); | ||||
|     assert( c == -1 ); | ||||
|  | ||||
|     //  tests which should result in errors being detected | ||||
|  | ||||
|     caught_exception = false; | ||||
|     try { c = numeric_cast<signed char>( large_value ); } | ||||
|     catch (bad_numeric_cast) | ||||
|         { cout<<"caught bad_numeric_cast #1\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|  | ||||
|     caught_exception = false; | ||||
|     try { c = numeric_cast<signed char>( large_negative_value ); } | ||||
|     catch (bad_numeric_cast) | ||||
|         { cout<<"caught bad_numeric_cast #2\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|  | ||||
|     unsigned long ul; | ||||
|     caught_exception = false; | ||||
|     try { ul = numeric_cast<unsigned long>( large_negative_value ); } | ||||
|     catch (bad_numeric_cast) | ||||
|         { cout<<"caught bad_numeric_cast #3\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|  | ||||
|     caught_exception = false; | ||||
|     try { ul = numeric_cast<unsigned long>( small_negative_value ); } | ||||
|     catch (bad_numeric_cast) | ||||
|         { cout<<"caught bad_numeric_cast #4\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|  | ||||
|     caught_exception = false; | ||||
|     try { numeric_cast<int>( std::numeric_limits<double>::max() ); } | ||||
|     catch (bad_numeric_cast) | ||||
|         { cout<<"caught bad_numeric_cast #5\n"; caught_exception = true; } | ||||
|     if ( !caught_exception ) ++err_count; | ||||
|  | ||||
|     cout << err_count << " errors detected\nTest " | ||||
|          << (err_count==0 ? "passed\n" : "failed\n"); | ||||
|     return err_count; | ||||
| }   // main | ||||
							
								
								
									
										122
									
								
								checked_delete.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										122
									
								
								checked_delete.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,122 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||||
| <html> | ||||
| 	<head> | ||||
| 		<title>Boost: checked_delete.hpp documentation</title> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| 	</head> | ||||
| 	<body bgcolor="white" style="MARGIN-LEFT: 5%; MARGIN-RIGHT: 5%"> | ||||
| 		<table border="0" width="100%"> | ||||
| 			<tr> | ||||
| 				<td width="277"><A href="../../index.htm"> <img src="../../boost.png" alt="boost.png (6897 bytes)" width="277" height="86" border="0"></A> | ||||
| 				</td> | ||||
| 				<td align="center"> | ||||
| 					<h1>checked_delete.hpp</h1> | ||||
| 				</td> | ||||
| 			</tr> | ||||
| 			<tr> | ||||
| 				<td colspan="2" height="64"> </td> | ||||
| 			</tr> | ||||
| 		</table> | ||||
| 		<p> | ||||
| 			The header <STRONG><boost/checked_delete.hpp></STRONG> defines two  | ||||
| 			function templates, <STRONG>checked_delete</STRONG> and <STRONG>checked_array_delete</STRONG>,  | ||||
| 			and two class templates, <STRONG>checked_deleter</STRONG> and <STRONG>checked_array_deleter</STRONG>. | ||||
| 		</p> | ||||
| 		<P>The C++ Standard allows, in 5.3.5/5, pointers to incomplete class types to be  | ||||
| 			deleted with a <EM>delete-expression</EM>. When the class has a non-trivial  | ||||
| 			destructor, or a class-specific operator delete, the behavior is undefined.  | ||||
| 			Some compilers issue a warning when an incomplete type is deleted, but  | ||||
| 			unfortunately, not all do, and programmers sometimes ignore or disable  | ||||
| 			warnings.</P> | ||||
| 		<P>A particularly troublesome case is when a smart pointer's destructor, such as <STRONG> | ||||
| 				boost::scoped_ptr<T>::~scoped_ptr</STRONG>, is instantiated with an  | ||||
| 			incomplete type. This can often lead to silent, hard to track failures.</P> | ||||
| 		<P>The supplied function and class templates can be used to prevent these problems,  | ||||
| 			as they require a complete type, and cause a compilation error otherwise.</P> | ||||
| 		<h3><a name="Synopsis">Synopsis</a></h3> | ||||
| 		<pre> | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| template<class T> void checked_delete(T * p); | ||||
| template<class T> void checked_array_delete(T * p); | ||||
| template<class T> struct checked_deleter; | ||||
| template<class T> struct checked_array_deleter; | ||||
|  | ||||
| } | ||||
| </pre> | ||||
| 		<h3>checked_delete</h3> | ||||
| 		<h4><a name="checked_delete">template<class T> void checked_delete(T * p);</a></h4> | ||||
| 		<blockquote> | ||||
| 			<p> | ||||
| 				<b>Requires:</b> <b>T</b> must be a complete type. The expression <tt>delete p</tt> | ||||
| 				must be well-formed. | ||||
| 			</p> | ||||
| 			<p> | ||||
| 				<b>Effects:</b> <tt>delete p;</tt> | ||||
| 			</p> | ||||
| 		</blockquote> | ||||
| 		<h3>checked_array_delete</h3> | ||||
| 		<h4><a name="checked_array_delete">template<class T> void checked_array_delete(T  | ||||
| 				* p);</a></h4> | ||||
| 		<blockquote> | ||||
| 			<p> | ||||
| 				<b>Requires:</b> <b>T</b> must be a complete type. The expression <tt>delete [] p</tt> | ||||
| 				must be well-formed. | ||||
| 			</p> | ||||
| 			<p> | ||||
| 				<b>Effects:</b> <tt>delete [] p;</tt> | ||||
| 			</p> | ||||
| 		</blockquote> | ||||
| 		<h3>checked_deleter</h3> | ||||
| 		<pre> | ||||
| template<class T> struct checked_deleter | ||||
| { | ||||
|     typedef void result_type; | ||||
|     typedef T * argument_type; | ||||
|     void operator()(T * p) const; | ||||
| }; | ||||
| </pre> | ||||
| 		<h4>void checked_deleter<T>::operator()(T * p) const;</h4> | ||||
| 		<blockquote> | ||||
| 			<p> | ||||
| 				<b>Requires:</b> <b>T</b> must be a complete type. The expression <tt>delete p</tt> | ||||
| 				must be well-formed. | ||||
| 			</p> | ||||
| 			<p> | ||||
| 				<b>Effects:</b> <tt>delete p;</tt> | ||||
| 			</p> | ||||
| 		</blockquote> | ||||
| 		<h3>checked_array_deleter</h3> | ||||
| 		<pre> | ||||
| template<class T> struct checked_array_deleter | ||||
| { | ||||
|     typedef void result_type; | ||||
|     typedef T * argument_type; | ||||
|     void operator()(T * p) const; | ||||
| }; | ||||
| </pre> | ||||
| 		<h4>void checked_array_deleter<T>::operator()(T * p) const;</h4> | ||||
| 		<blockquote> | ||||
| 			<p> | ||||
| 				<b>Requires:</b> <b>T</b> must be a complete type. The expression <tt>delete [] p</tt> | ||||
| 				must be well-formed. | ||||
| 			</p> | ||||
| 			<p> | ||||
| 				<b>Effects:</b> <tt>delete [] p;</tt> | ||||
| 			</p> | ||||
| 		</blockquote> | ||||
| 		<h3><a name="Acknowledgements">Acknowledgements</a></h3> | ||||
| 		<p> | ||||
| 			The function templates <STRONG>checked_delete</STRONG> and <STRONG>checked_array_delete</STRONG> | ||||
| 			were originally part of <STRONG><boost/utility.hpp></STRONG>, and the  | ||||
| 			documentation acknowledged Beman Dawes, Dave Abrahams, Vladimir Prus, Rainer  | ||||
| 			Deyke, John Maddock, and others as contributors. | ||||
| 		</p> | ||||
| 		<p> | ||||
| 			<br> | ||||
| 			<small>Copyright <20> 2002 by Peter Dimov. Distributed under the Boost Software License, Version  | ||||
| 				1.0. See accompanying file <A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or  | ||||
| 				copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>.</small></p> | ||||
| 	</body> | ||||
| </html> | ||||
							
								
								
									
										28
									
								
								checked_delete_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										28
									
								
								checked_delete_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,28 @@ | ||||
| //  Boost checked_delete test program  ---------------------------------------// | ||||
|  | ||||
| //  Copyright Beman Dawes 2001.  Distributed under the Boost | ||||
| //  Software License, Version 1.0. (See accompanying file | ||||
| //  LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org/libs/utility for documentation. | ||||
|  | ||||
| //  Revision History | ||||
| //  21 May 01  Initial version (Beman Dawes) | ||||
|  | ||||
| #include <boost/checked_delete.hpp>  // for checked_delete | ||||
|  | ||||
| //  This program demonstrates compiler errors when trying to delete an | ||||
| //  incomplete type. | ||||
|  | ||||
| namespace | ||||
| { | ||||
|     class Incomplete; | ||||
| } | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     Incomplete * p = 0; | ||||
|     boost::checked_delete(p);          // should cause compile time error | ||||
|     boost::checked_array_delete(p);    // should cause compile time error | ||||
|     return 0; | ||||
| }   // main | ||||
| @@ -1,29 +1,19 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" | ||||
| content="text/html; charset=iso-8859-1"> | ||||
| <meta name="Template" | ||||
| content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0"> | ||||
| <title>Header <boost/compressed_pair.hpp></title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" | ||||
| vlink="#800080"> | ||||
|  | ||||
| <h2><img src="../../c++boost.gif" width="276" height="86">Header | ||||
| <<a href="../../boost/detail/call_traits.hpp">boost/compressed_pair.hpp</a>></h2> | ||||
|  | ||||
| <p>All of the contents of <boost/compressed_pair.hpp> are | ||||
| defined inside namespace boost.</p> | ||||
|  | ||||
| <p>The class compressed pair is very similar to std::pair, but if | ||||
| either of the template arguments are empty classes, then the | ||||
| "empty member optimisation" is applied to compress the | ||||
| size of the pair.</p> | ||||
|  | ||||
| <pre>template <class T1, class T2> | ||||
|    <head> | ||||
|       <title>Header </title> | ||||
|       <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
|       <meta name="Template" content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> | ||||
|       <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0"> | ||||
|       <boostcompressed_pair.hpp> | ||||
|    </head> | ||||
|    <body bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#800080"> | ||||
|       <h2><img src="../../boost.png" width="276" height="86">Header <<a href="../../boost/detail/compressed_pair.hpp">boost/compressed_pair.hpp</a>></h2> | ||||
|       <p>All of the contents of <boost/compressed_pair.hpp> are defined inside  | ||||
|          namespace boost.</p> | ||||
|       <p>The class compressed pair is very similar to std::pair, but if either of the  | ||||
|          template arguments are empty classes, then the "empty base-class optimisation"  | ||||
|          is applied to compress the size of the pair.</p> | ||||
|       <pre>template <class T1, class T2> | ||||
| class compressed_pair | ||||
| { | ||||
| public: | ||||
| @@ -41,6 +31,8 @@ public: | ||||
| 	explicit compressed_pair(first_param_type x); | ||||
| 	explicit compressed_pair(second_param_type y); | ||||
|  | ||||
| 	compressed_pair& operator=(const compressed_pair&); | ||||
|  | ||||
| 	first_reference       first(); | ||||
| 	first_const_reference first() const; | ||||
|  | ||||
| @@ -49,44 +41,35 @@ public: | ||||
|  | ||||
| 	void swap(compressed_pair& y); | ||||
| };</pre> | ||||
|  | ||||
| <p>The two members of the pair can be accessed using the member | ||||
| functions first() and second(). Note that not all member | ||||
| functions can be instantiated for all template parameter types. | ||||
| In particular compressed_pair can be instantiated for reference | ||||
| and array types, however in these cases the range of constructors | ||||
| that can be used are limited. If types T1 and T2 are the same | ||||
| type, then there is only one version of the single-argument | ||||
| constructor, and this constructor initialises both values in the | ||||
| pair to the passed value.</p> | ||||
|  | ||||
| <p>Note that compressed_pair can not be instantiated if either of | ||||
| the template arguments is an enumerator type, unless there is | ||||
| compiler support for boost::is_enum, or if boost::is_enum is | ||||
| specialised for the enumerator type.</p> | ||||
|  | ||||
| <p>Finally, compressed_pair requires compiler support for partial | ||||
| specialisation of class templates - without that support | ||||
| compressed_pair behaves just like std::pair.</p> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <p>Revised 08 March 2000</p> | ||||
|  | ||||
| <p><EFBFBD> Copyright boost.org 2000. Permission to copy, use, modify, | ||||
| sell and distribute this document is granted provided this | ||||
| copyright notice appears in all copies. This document is provided | ||||
| "as is" without express or implied warranty, and with | ||||
| no claim as to its suitability for any purpose.</p> | ||||
|  | ||||
| <p>Based on contributions by Steve Cleary, Beman Dawes, Howard | ||||
| Hinnant and John Maddock.</p> | ||||
|  | ||||
| <p>Maintained by <a href="mailto:John_Maddock@compuserve.com">John | ||||
| Maddock</a>, the latest version of this file can be found at <a | ||||
| href="http://www.boost.org">www.boost.org</a>, and the boost | ||||
| discussion list at <a href="http://www.egroups.com/list/boost">www.egroups.com/list/boost</a>.</p> | ||||
|  | ||||
| <p> </p> | ||||
| </body> | ||||
|       <p>The two members of the pair can be accessed using the member functions first()  | ||||
|          and second(). Note that not all member functions can be instantiated for all  | ||||
|          template parameter types. In particular compressed_pair can be instantiated for  | ||||
|          reference and array types, however in these cases the range of constructors  | ||||
|          that can be used are limited. If types T1 and T2 are the same type, then there  | ||||
|          is only one version of the single-argument constructor, and this constructor  | ||||
|          initialises both values in the pair to the passed value.</p> | ||||
|       <P>Note that if either member is a POD type, then that member is not  | ||||
|          zero-initialized by the compressed_pair default constructor: it's up to you to  | ||||
|          supply an initial value for these types if you want them to have a default  | ||||
|          value.</P> | ||||
|       <p>Note that compressed_pair can not be instantiated if either of the template  | ||||
|          arguments is a union type, unless there is compiler support for  | ||||
|          boost::is_union, or if boost::is_union is specialised for the union type.</p> | ||||
|       <p>Finally, a word of caution for Visual C++ 6 users: if either argument is an  | ||||
|          empty type, then assigning to that member will produce memory corruption,  | ||||
|          unless the empty type has a "do nothing" assignment operator defined. This is  | ||||
|          due to a bug in the way VC6 generates implicit assignment operators.</p> | ||||
|       <hr> | ||||
|       <p>Revised 08 May 2001</p> | ||||
|       <p><EFBFBD> Copyright boost.org 2000. Permission to copy, use, modify, sell and  | ||||
|          distribute this document is granted provided this copyright notice appears in  | ||||
|          all copies. This document is provided "as is" without express or implied  | ||||
|          warranty, and with no claim as to its suitability for any purpose.</p> | ||||
|       <p>Based on contributions by Steve Cleary, Beman Dawes, Howard Hinnant and John  | ||||
|          Maddock.</p> | ||||
|       <p>Maintained by <a href="mailto:john@johnmaddock.co.uk">John Maddock</a>, the  | ||||
|          latest version of this file can be found at <a href="http://www.boost.org">www.boost.org</a>,  | ||||
|          and the boost discussion list at <a href="http://www.yahoogroups.com/list/boost">www.yahoogroups.com/list/boost</a>.</p> | ||||
|       <p> </p> | ||||
|    </body> | ||||
| </html> | ||||
|   | ||||
| @@ -1,125 +1,393 @@ | ||||
|  // boost::compressed_pair test program    | ||||
| //  boost::compressed_pair test program    | ||||
|      | ||||
|  //  (C) Copyright John Maddock 2000. Permission to copy, use, modify, sell and    | ||||
|  //  distribute this software is granted provided this copyright notice appears    | ||||
|  //  in all copies. This software is provided "as is" without express or implied    | ||||
|  //  warranty, and with no claim as to its suitability for any purpose.    | ||||
| //  (C) Copyright John Maddock 2000.  | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
|  | ||||
| // standalone test program for <boost/compressed_pair.hpp> | ||||
| // Revised 03 Oct 2000:  | ||||
| //    Enabled tests for VC6. | ||||
|  | ||||
| #include <iostream> | ||||
| #include <typeinfo> | ||||
| #include <cassert> | ||||
|  | ||||
| #include <boost/compressed_pair.hpp> | ||||
| #include "type_traits_test.hpp" | ||||
| #include <boost/test/test_tools.hpp> | ||||
|  | ||||
| using namespace boost; | ||||
|  | ||||
| struct empty_POD_UDT{}; | ||||
| struct empty_UDT | ||||
| { | ||||
|   ~empty_UDT(){}; | ||||
|    ~empty_UDT(){}; | ||||
|    empty_UDT& operator=(const empty_UDT&){ return *this; } | ||||
|    bool operator==(const empty_UDT&)const | ||||
|    { return true; } | ||||
| }; | ||||
| namespace boost { | ||||
| #ifndef BOOST_NO_INCLASS_MEMBER_INITIALIZATION | ||||
| template <> struct is_empty<empty_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_empty<empty_POD_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_POD<empty_POD_UDT> | ||||
| { static const bool value = true; }; | ||||
| #else | ||||
| template <> struct is_empty<empty_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_empty<empty_POD_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_POD<empty_POD_UDT> | ||||
| { enum{ value = true }; }; | ||||
| #endif | ||||
| } | ||||
|  | ||||
|  | ||||
| int main() | ||||
| struct empty_POD_UDT | ||||
| { | ||||
|    compressed_pair<int, double> cp1(1, 1.3); | ||||
|    assert(cp1.first() == 1); | ||||
|    assert(cp1.second() == 1.3); | ||||
|    compressed_pair<int, double> cp1b(2, 2.3); | ||||
|    assert(cp1b.first() == 2); | ||||
|    assert(cp1b.second() == 2.3); | ||||
|    swap(cp1, cp1b); | ||||
|    assert(cp1b.first() == 1); | ||||
|    assert(cp1b.second() == 1.3); | ||||
|    assert(cp1.first() == 2); | ||||
|    assert(cp1.second() == 2.3); | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    compressed_pair<empty_UDT, int> cp2(2); | ||||
|    assert(cp2.second() == 2); | ||||
| #endif | ||||
|    compressed_pair<int, empty_UDT> cp3(1); | ||||
|    assert(cp3.first() ==1); | ||||
|    compressed_pair<empty_UDT, empty_UDT> cp4; | ||||
|    compressed_pair<empty_UDT, empty_POD_UDT> cp5; | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    int i = 0; | ||||
|    compressed_pair<int&, int&> cp6(i,i); | ||||
|    assert(cp6.first() == i); | ||||
|    assert(cp6.second() == i); | ||||
|    assert(&cp6.first() == &i); | ||||
|    assert(&cp6.second() == &i); | ||||
|    compressed_pair<int, double[2]> cp7; | ||||
|    cp7.first(); | ||||
|    double* pd = cp7.second(); | ||||
| #endif | ||||
|    value_test(true, (sizeof(compressed_pair<empty_UDT, int>) < sizeof(std::pair<empty_UDT, int>))) | ||||
|    value_test(true, (sizeof(compressed_pair<int, empty_UDT>) < sizeof(std::pair<int, empty_UDT>))) | ||||
|    value_test(true, (sizeof(compressed_pair<empty_UDT, empty_UDT>) < sizeof(std::pair<empty_UDT, empty_UDT>))) | ||||
|    value_test(true, (sizeof(compressed_pair<empty_UDT, empty_POD_UDT>) < sizeof(std::pair<empty_UDT, empty_POD_UDT>))) | ||||
|    value_test(true, (sizeof(compressed_pair<empty_UDT, compressed_pair<empty_POD_UDT, int> >) < sizeof(std::pair<empty_UDT, std::pair<empty_POD_UDT, int> >))) | ||||
|    empty_POD_UDT& operator=(const empty_POD_UDT&){ return *this; } | ||||
|    bool operator==(const empty_POD_UDT&)const | ||||
|    { return true; } | ||||
| }; | ||||
|  | ||||
|    std::cout << std::endl << test_count << " tests completed (" << failures << " failures)... press any key to exit"; | ||||
|    std::cin.get(); | ||||
|    return failures; | ||||
| struct non_empty1 | ||||
| {  | ||||
|    int i; | ||||
|    non_empty1() : i(1){} | ||||
|    non_empty1(int v) : i(v){} | ||||
|    friend bool operator==(const non_empty1& a, const non_empty1& b) | ||||
|    { return a.i == b.i; } | ||||
| }; | ||||
|  | ||||
| struct non_empty2 | ||||
| {  | ||||
|    int i; | ||||
|    non_empty2() : i(3){} | ||||
|    non_empty2(int v) : i(v){} | ||||
|    friend bool operator==(const non_empty2& a, const non_empty2& b) | ||||
|    { return a.i == b.i; } | ||||
| }; | ||||
|  | ||||
| #ifdef __GNUC__ | ||||
| using std::swap; | ||||
| #endif | ||||
|  | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4) | ||||
| { | ||||
| #ifndef __GNUC__ | ||||
|    // gcc 2.90 can't cope with function scope using | ||||
|    // declarations, and generates an internal compiler error... | ||||
|    using std::swap; | ||||
| #endif | ||||
|    // default construct: | ||||
|    boost::compressed_pair<T1,T2> cp1; | ||||
|    // first param construct: | ||||
|    boost::compressed_pair<T1,T2> cp2(p1); | ||||
|    cp2.second() = p2; | ||||
|    BOOST_CHECK(cp2.first() == p1); | ||||
|    BOOST_CHECK(cp2.second() == p2); | ||||
|    // second param construct: | ||||
|    boost::compressed_pair<T1,T2> cp3(p2); | ||||
|    cp3.first() = p1; | ||||
|    BOOST_CHECK(cp3.second() == p2); | ||||
|    BOOST_CHECK(cp3.first() == p1); | ||||
|    // both param construct: | ||||
|    boost::compressed_pair<T1,T2> cp4(p1, p2); | ||||
|    BOOST_CHECK(cp4.first() == p1); | ||||
|    BOOST_CHECK(cp4.second() == p2); | ||||
|    boost::compressed_pair<T1,T2> cp5(p3, p4); | ||||
|    BOOST_CHECK(cp5.first() == p3); | ||||
|    BOOST_CHECK(cp5.second() == p4); | ||||
|    // check const members: | ||||
|    const boost::compressed_pair<T1,T2>& cpr1 = cp4; | ||||
|    BOOST_CHECK(cpr1.first() == p1); | ||||
|    BOOST_CHECK(cpr1.second() == p2); | ||||
|  | ||||
|    // copy construct: | ||||
|    boost::compressed_pair<T1,T2> cp6(cp4); | ||||
|    BOOST_CHECK(cp6.first() == p1); | ||||
|    BOOST_CHECK(cp6.second() == p2); | ||||
|    // assignment: | ||||
|    cp1 = cp4; | ||||
|    BOOST_CHECK(cp1.first() == p1); | ||||
|    BOOST_CHECK(cp1.second() == p2); | ||||
|    cp1 = cp5; | ||||
|    BOOST_CHECK(cp1.first() == p3); | ||||
|    BOOST_CHECK(cp1.second() == p4); | ||||
|    // swap: | ||||
|    cp4.swap(cp5); | ||||
|    BOOST_CHECK(cp4.first() == p3); | ||||
|    BOOST_CHECK(cp4.second() == p4); | ||||
|    BOOST_CHECK(cp5.first() == p1); | ||||
|    BOOST_CHECK(cp5.second() == p2); | ||||
|    swap(cp4,cp5); | ||||
|    BOOST_CHECK(cp4.first() == p1); | ||||
|    BOOST_CHECK(cp4.second() == p2); | ||||
|    BOOST_CHECK(cp5.first() == p3); | ||||
|    BOOST_CHECK(cp5.second() == p4); | ||||
| } | ||||
|  | ||||
| // | ||||
| // instanciate some compressed pairs: | ||||
| #ifdef __MWERKS__ | ||||
| template class compressed_pair<int, double>; | ||||
| template class compressed_pair<int, int>; | ||||
| template class compressed_pair<empty_UDT, int>; | ||||
| template class compressed_pair<int, empty_UDT>; | ||||
| template class compressed_pair<empty_UDT, empty_UDT>; | ||||
| template class compressed_pair<empty_UDT, empty_POD_UDT>; | ||||
| #else | ||||
| template class boost::compressed_pair<int, double>; | ||||
| template class boost::compressed_pair<int, int>; | ||||
| template class boost::compressed_pair<empty_UDT, int>; | ||||
| template class boost::compressed_pair<int, empty_UDT>; | ||||
| template class boost::compressed_pair<empty_UDT, empty_UDT>; | ||||
| template class boost::compressed_pair<empty_UDT, empty_POD_UDT>; | ||||
| #endif | ||||
| // tests for case where one or both  | ||||
| // parameters are reference types: | ||||
| // | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_reference_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_reference_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4) | ||||
| { | ||||
| #ifndef __GNUC__ | ||||
|    // gcc 2.90 can't cope with function scope using | ||||
|    // declarations, and generates an internal compiler error... | ||||
|    using std::swap; | ||||
| #endif | ||||
|    // both param construct: | ||||
|    boost::compressed_pair<T1,T2> cp4(p1, p2); | ||||
|    BOOST_CHECK(cp4.first() == p1); | ||||
|    BOOST_CHECK(cp4.second() == p2); | ||||
|    boost::compressed_pair<T1,T2> cp5(p3, p4); | ||||
|    BOOST_CHECK(cp5.first() == p3); | ||||
|    BOOST_CHECK(cp5.second() == p4); | ||||
|    // check const members: | ||||
|    const boost::compressed_pair<T1,T2>& cpr1 = cp4; | ||||
|    BOOST_CHECK(cpr1.first() == p1); | ||||
|    BOOST_CHECK(cpr1.second() == p2); | ||||
|  | ||||
|    // copy construct: | ||||
|    boost::compressed_pair<T1,T2> cp6(cp4); | ||||
|    BOOST_CHECK(cp6.first() == p1); | ||||
|    BOOST_CHECK(cp6.second() == p2); | ||||
|    // assignment: | ||||
|    // VC6 bug: | ||||
|    // When second() is an empty class, VC6 performs the | ||||
|    // assignment by doing a memcpy - even though the empty | ||||
|    // class is really a zero sized base class, the result | ||||
|    // is that the memory of first() gets trampled over. | ||||
|    // Similar arguments apply to the case that first() is  | ||||
|    // an empty base class. | ||||
|    // Strangely the problem is dependent upon the compiler | ||||
|    // settings - some generate the problem others do not. | ||||
|    cp4.first() = p3; | ||||
|    cp4.second() = p4; | ||||
|    BOOST_CHECK(cp4.first() == p3); | ||||
|    BOOST_CHECK(cp4.second() == p4); | ||||
| } | ||||
| // | ||||
| // supplimentary tests for case where first arg only is a reference type: | ||||
| // | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_reference1_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_reference1_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type, second_param_type) | ||||
| { | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| // | ||||
| // now some for which only a few specific members can be instantiated, | ||||
| // first references: | ||||
| template double& compressed_pair<double, int&>::first(); | ||||
| template int& compressed_pair<double, int&>::second(); | ||||
| template compressed_pair<double, int&>::compressed_pair(int&); | ||||
| template compressed_pair<double, int&>::compressed_pair(call_traits<double>::param_type,int&); | ||||
| // | ||||
| // and then arrays: | ||||
| #ifndef __MWERKS__ | ||||
| #ifndef __BORLANDC__ | ||||
| template call_traits<int[2]>::reference compressed_pair<double, int[2]>::second(); | ||||
|    // first param construct: | ||||
|    boost::compressed_pair<T1,T2> cp2(p1); | ||||
|    cp2.second() = p2; | ||||
|    BOOST_CHECK(cp2.first() == p1); | ||||
|    BOOST_CHECK(cp2.second() == p2); | ||||
| #endif | ||||
| template call_traits<double>::reference compressed_pair<double, int[2]>::first(); | ||||
| template compressed_pair<double, int[2]>::compressed_pair(const double&); | ||||
| template compressed_pair<double, int[2]>::compressed_pair(); | ||||
| #endif // __MWERKS__ | ||||
| #endif // BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| } | ||||
| // | ||||
| // supplimentary tests for case where second arg only is a reference type: | ||||
| // | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_reference2_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_reference2_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type, second_param_type) | ||||
| { | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    // second param construct: | ||||
|    boost::compressed_pair<T1,T2> cp3(p2); | ||||
|    cp3.first() = p1; | ||||
|    BOOST_CHECK(cp3.second() == p2); | ||||
|    BOOST_CHECK(cp3.first() == p1); | ||||
| #endif | ||||
| } | ||||
|  | ||||
| // | ||||
| // tests for where one or the other parameter is an array: | ||||
| // | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_array1_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_array1_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type, second_param_type) | ||||
| { | ||||
|   // default construct: | ||||
|    boost::compressed_pair<T1,T2> cp1; | ||||
|    // second param construct: | ||||
|    boost::compressed_pair<T1,T2> cp3(p2); | ||||
|    cp3.first()[0] = p1[0]; | ||||
|    BOOST_CHECK(cp3.second() == p2); | ||||
|    BOOST_CHECK(cp3.first()[0] == p1[0]); | ||||
|    // check const members: | ||||
|    const boost::compressed_pair<T1,T2>& cpr1 = cp3; | ||||
|    BOOST_CHECK(cpr1.first()[0] == p1[0]); | ||||
|    BOOST_CHECK(cpr1.second() == p2); | ||||
|  | ||||
|    BOOST_CHECK(sizeof(T1) == sizeof(cp1.first())); | ||||
| } | ||||
|  | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_array2_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_array2_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type, second_param_type) | ||||
| { | ||||
|    // default construct: | ||||
|    boost::compressed_pair<T1,T2> cp1; | ||||
|    // first param construct: | ||||
|    boost::compressed_pair<T1,T2> cp2(p1); | ||||
|    cp2.second()[0] = p2[0]; | ||||
|    BOOST_CHECK(cp2.first() == p1); | ||||
|    BOOST_CHECK(cp2.second()[0] == p2[0]); | ||||
|    // check const members: | ||||
|    const boost::compressed_pair<T1,T2>& cpr1 = cp2; | ||||
|    BOOST_CHECK(cpr1.first() == p1); | ||||
|    BOOST_CHECK(cpr1.second()[0] == p2[0]); | ||||
|  | ||||
|    BOOST_CHECK(sizeof(T2) == sizeof(cp1.second())); | ||||
| } | ||||
|  | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_array_tester | ||||
| { | ||||
|    // define the types we need: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    // define our test proc: | ||||
|    static void test(first_param_type p1, second_param_type p2, first_param_type p3, second_param_type p4); | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| void compressed_pair_array_tester<T1, T2>::test(first_param_type p1, second_param_type p2, first_param_type, second_param_type) | ||||
| { | ||||
|    // default construct: | ||||
|    boost::compressed_pair<T1,T2> cp1; | ||||
|    cp1.first()[0] = p1[0]; | ||||
|    cp1.second()[0] = p2[0]; | ||||
|    BOOST_CHECK(cp1.first()[0] == p1[0]); | ||||
|    BOOST_CHECK(cp1.second()[0] == p2[0]); | ||||
|    // check const members: | ||||
|    const boost::compressed_pair<T1,T2>& cpr1 = cp1; | ||||
|    BOOST_CHECK(cpr1.first()[0] == p1[0]); | ||||
|    BOOST_CHECK(cpr1.second()[0] == p2[0]); | ||||
|  | ||||
|    BOOST_CHECK(sizeof(T1) == sizeof(cp1.first())); | ||||
|    BOOST_CHECK(sizeof(T2) == sizeof(cp1.second())); | ||||
| } | ||||
|  | ||||
| int test_main(int, char *[]) | ||||
| { | ||||
|    // declare some variables to pass to the tester: | ||||
|    non_empty1 ne1(2); | ||||
|    non_empty1 ne2(3); | ||||
|    non_empty2 ne3(4); | ||||
|    non_empty2 ne4(5); | ||||
|    empty_POD_UDT  e1; | ||||
|    empty_UDT      e2; | ||||
|  | ||||
|    // T1 != T2, both non-empty | ||||
|    compressed_pair_tester<non_empty1,non_empty2>::test(ne1, ne3, ne2, ne4); | ||||
|    // T1 != T2, T2 empty | ||||
|    compressed_pair_tester<non_empty1,empty_POD_UDT>::test(ne1, e1, ne2, e1); | ||||
|    // T1 != T2, T1 empty | ||||
|    compressed_pair_tester<empty_POD_UDT,non_empty2>::test(e1, ne3, e1, ne4); | ||||
|    // T1 != T2, both empty | ||||
|    compressed_pair_tester<empty_POD_UDT,empty_UDT>::test(e1, e2, e1, e2); | ||||
|    // T1 == T2, both non-empty | ||||
|    compressed_pair_tester<non_empty1,non_empty1>::test(ne1, ne1, ne2, ne2); | ||||
|    // T1 == T2, both empty | ||||
|    compressed_pair_tester<empty_UDT,empty_UDT>::test(e2, e2, e2, e2); | ||||
|  | ||||
|  | ||||
|    // test references: | ||||
|  | ||||
|    // T1 != T2, both non-empty | ||||
|    compressed_pair_reference_tester<non_empty1&,non_empty2>::test(ne1, ne3, ne2, ne4); | ||||
|    compressed_pair_reference_tester<non_empty1,non_empty2&>::test(ne1, ne3, ne2, ne4); | ||||
|    compressed_pair_reference1_tester<non_empty1&,non_empty2>::test(ne1, ne3, ne2, ne4); | ||||
|    compressed_pair_reference2_tester<non_empty1,non_empty2&>::test(ne1, ne3, ne2, ne4); | ||||
|    // T1 != T2, T2 empty | ||||
|    compressed_pair_reference_tester<non_empty1&,empty_POD_UDT>::test(ne1, e1, ne2, e1); | ||||
|    compressed_pair_reference1_tester<non_empty1&,empty_POD_UDT>::test(ne1, e1, ne2, e1); | ||||
|    // T1 != T2, T1 empty | ||||
|    compressed_pair_reference_tester<empty_POD_UDT,non_empty2&>::test(e1, ne3, e1, ne4); | ||||
|    compressed_pair_reference2_tester<empty_POD_UDT,non_empty2&>::test(e1, ne3, e1, ne4); | ||||
|    // T1 == T2, both non-empty | ||||
|    compressed_pair_reference_tester<non_empty1&,non_empty1&>::test(ne1, ne1, ne2, ne2); | ||||
|  | ||||
|    // tests arrays: | ||||
|    non_empty1 nea1[2]; | ||||
|    non_empty1 nea2[2]; | ||||
|    non_empty2 nea3[2]; | ||||
|    non_empty2 nea4[2]; | ||||
|    nea1[0] = non_empty1(5); | ||||
|    nea2[0] = non_empty1(6); | ||||
|    nea3[0] = non_empty2(7); | ||||
|    nea4[0] = non_empty2(8); | ||||
|     | ||||
|    // T1 != T2, both non-empty | ||||
|    compressed_pair_array1_tester<non_empty1[2],non_empty2>::test(nea1, ne3, nea2, ne4); | ||||
|    compressed_pair_array2_tester<non_empty1,non_empty2[2]>::test(ne1, nea3, ne2, nea4); | ||||
|    compressed_pair_array_tester<non_empty1[2],non_empty2[2]>::test(nea1, nea3, nea2, nea4); | ||||
|    // T1 != T2, T2 empty | ||||
|    compressed_pair_array1_tester<non_empty1[2],empty_POD_UDT>::test(nea1, e1, nea2, e1); | ||||
|    // T1 != T2, T1 empty | ||||
|    compressed_pair_array2_tester<empty_POD_UDT,non_empty2[2]>::test(e1, nea3, e1, nea4); | ||||
|    // T1 == T2, both non-empty | ||||
|    compressed_pair_array_tester<non_empty1[2],non_empty1[2]>::test(nea1, nea1, nea2, nea2); | ||||
|    return 0; | ||||
| } | ||||
|  | ||||
|  | ||||
| unsigned int expected_failures = 0; | ||||
|  | ||||
|  | ||||
|  | ||||
|   | ||||
							
								
								
									
										36
									
								
								current_function.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								current_function.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||||
| <html> | ||||
| 	<head> | ||||
| 		<title>Boost: current_function.hpp documentation</title> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| 	</head> | ||||
| 	<body bgcolor="white" style="MARGIN-LEFT: 5%; MARGIN-RIGHT: 5%"> | ||||
| 		<table border="0" width="100%"> | ||||
| 			<tr> | ||||
| 				<td width="277"><A href="../../index.htm"> <img src="../../boost.png" alt="boost.png (6897 bytes)" width="277" height="86" border="0"></A> | ||||
| 				</td> | ||||
| 				<td align="center"> | ||||
| 					<h1>current_function.hpp</h1> | ||||
| 				</td> | ||||
| 			</tr> | ||||
| 			<tr> | ||||
| 				<td colspan="2" height="64"> </td> | ||||
| 			</tr> | ||||
| 		</table> | ||||
| 		<p> | ||||
| 			The header <STRONG><boost/current_function.hpp></STRONG> defines a single  | ||||
| 			macro, <STRONG>BOOST_CURRENT_FUNCTION</STRONG>,<STRONG> </STRONG>similar to the  | ||||
| 			C99 predefined identifier <STRONG>__func__</STRONG>. | ||||
| 		</p> | ||||
| 		<P><STRONG>BOOST_CURRENT_FUNCTION</STRONG> expands to a string literal containing  | ||||
| 			the (fully qualified, if possible) name of the enclosing function. If there is  | ||||
| 			no enclosing function, the behavior is undefined.</P> | ||||
| 		<p>Some compilers do not provide a way to obtain the name of the current enclosing  | ||||
| 			function. On such compilers, the string literal has an unspecified value.</p> | ||||
| 		<p> | ||||
| 			<br> | ||||
| 			<small>Copyright <20> 2002 by Peter Dimov. Distributed under the Boost Software License, Version  | ||||
| 				1.0. See accompanying file <A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or  | ||||
| 				copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>.</small></p> | ||||
| 	</body> | ||||
| </html> | ||||
							
								
								
									
										40
									
								
								current_function_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										40
									
								
								current_function_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,40 @@ | ||||
| #include <boost/config.hpp> | ||||
|  | ||||
| #if defined(BOOST_MSVC) | ||||
| #pragma warning(disable: 4786)  // identifier truncated in debug info | ||||
| #pragma warning(disable: 4710)  // function not inlined | ||||
| #pragma warning(disable: 4711)  // function selected for automatic inline expansion | ||||
| #pragma warning(disable: 4514)  // unreferenced inline removed | ||||
| #endif | ||||
|  | ||||
| // | ||||
| //  current_function_test.cpp - a test for boost/current_function.hpp | ||||
| // | ||||
| //  Copyright (c) 2002 Peter Dimov and Multi Media Ltd. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
|  | ||||
| #include <boost/current_function.hpp> | ||||
| #include <boost/config.hpp> | ||||
| #include <cstdio> | ||||
|  | ||||
| void message(char const * file, long line, char const * func, char const * msg) | ||||
| { | ||||
| #if !defined(BOOST_NO_STDC_NAMESPACE) | ||||
|     using std::printf; | ||||
| #endif | ||||
|  | ||||
|     printf("%s(%ld): %s in function '%s'\n", file, line, msg, func); | ||||
| } | ||||
|  | ||||
| #define MESSAGE(msg) message(__FILE__, __LINE__, BOOST_CURRENT_FUNCTION, msg) | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     MESSAGE("assertion failed"); | ||||
|  | ||||
|     return 0; | ||||
| } | ||||
							
								
								
									
										388
									
								
								enable_if.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										388
									
								
								enable_if.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,388 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" | ||||
|             "http://www.w3.org/TR/REC-html40/loose.dtd"> | ||||
| <HTML> | ||||
| <HEAD><TITLE>enable_if</TITLE> | ||||
|  | ||||
| <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | ||||
| <META name="GENERATOR" content="Microsoft FrontPage 5.0"> | ||||
| </HEAD> | ||||
| <BODY > | ||||
| <!--HEVEA command line is: hevea -nosymb -noiso -pedantic -v enable_if_docs_for_boost.tex --> | ||||
| <!--HTMLHEAD--> | ||||
| <!--ENDHTML--> | ||||
| <!--PREFIX <ARG ></ARG>--> | ||||
| <!--CUT DEF section 1 --> | ||||
| <BR> | ||||
| <BR> | ||||
|  | ||||
|  | ||||
| <h1> | ||||
| <img border="0" src="../../boost.png" align="center" width="277" height="86">enable_if</h1> | ||||
| <BR> | ||||
| <BR> | ||||
| Copyright 2003 Jaakko Järvi, Jeremiah Willcock, Andrew Lumsdaine.<BR> | ||||
| <BR> | ||||
| <!--TOC section Introduction--> | ||||
|  | ||||
| <H2><A NAME="htoc1">1</A>  Introduction</H2><!--SEC END --> | ||||
|  | ||||
| <A NAME="introduction"></A> | ||||
| The <TT>enable_if</TT> family of templates is a set of tools to allow a function template or a class template specialization  | ||||
| to include or exclude itself from a set of matching functions or specializations | ||||
| based on properties of its template arguments.  | ||||
| For example, one can define function templates that | ||||
| are only enabled for, and thus only match, an arbitrary set of types | ||||
| defined by a traits class. The <TT>enable_if</TT> templates can also be | ||||
| applied to enable class template specializations. Applications of | ||||
| <TT>enable_if</TT> are discussed in length | ||||
| in [<A HREF="#jarvi:03:cuj_arbitrary_overloading"><CITE>1</CITE></A>] and [<A HREF="#jarvi:03:c++typeclasses"><CITE>2</CITE></A>].<BR> | ||||
| <BR> | ||||
| <!--TOC subsection Synopsis--> | ||||
|  | ||||
| <H3><A NAME="htoc2">1.1</A>  Synopsis</H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:synopsis"></A> | ||||
| <PRE>namespace boost { | ||||
|   template <class Cond, class T = void> struct enable_if; | ||||
|   template <class Cond, class T = void> struct disable_if; | ||||
|   template <class Cond, class T> struct lazy_enable_if; | ||||
|   template <class Cond, class T> struct lazy_disable_if; | ||||
|  | ||||
|   template <bool B, class T = void> struct enable_if_c; | ||||
|   template <bool B, class T = void> struct disable_if_c; | ||||
|   template <bool B, class T> struct lazy_enable_if_c; | ||||
|   template <bool B, class T> struct lazy_disable_if_c; | ||||
| } | ||||
| </PRE> | ||||
| <!--TOC subsection Background--> | ||||
|  | ||||
| <H3><A NAME="htoc3">1.2</A>  Background</H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:background"></A> | ||||
| Sensible operation of template function overloading in C++ relies | ||||
| on the <EM>SFINAE</EM> (substitution-failure-is-not-an-error) | ||||
| principle [<A HREF="#vandevoorde2002:templates"><CITE>3</CITE></A>]: if an invalid argument | ||||
| or return type is formed during the instantiation of a function | ||||
| template, the instantiation is removed from the overload resolution | ||||
| set instead of causing a compilation error. The following example,  | ||||
| taken from [<A HREF="#jarvi:03:cuj_arbitrary_overloading"><CITE>1</CITE></A>], | ||||
| demonstrates why this is important: | ||||
| <PRE>int negate(int i) { return -i; } | ||||
|  | ||||
| template <class F> | ||||
| typename F::result_type negate(const F& f) { return -f(); } | ||||
|  | ||||
| </PRE> | ||||
| Suppose the compiler encounters the call <TT>negate(1)</TT>. The first | ||||
| definition is obviously a better match, but the compiler must | ||||
| nevertheless consider (and instantiate the prototypes) of both | ||||
| definitions to find this out. Instantiating the latter definition with | ||||
| <TT>F</TT> as <TT>int</TT> would result in: | ||||
| <PRE>int::result_type negate(const int&); | ||||
|  | ||||
| </PRE> | ||||
| where the return type is invalid. If this was an error, adding an unrelated function template  | ||||
| (that was never called) could break otherwise valid code. | ||||
| Due to the SFINAE principle the above example is not, however, erroneous.  | ||||
| The latter definition of <TT>negate</TT> is simply removed from the overload resolution set.<BR> | ||||
| <BR> | ||||
| The <TT>enable_if</TT> templates are tools for controlled creation of the SFINAE | ||||
| conditions.<BR> | ||||
| <BR> | ||||
| <!--TOC section The <TT>enable_if</TT> templates--> | ||||
|  | ||||
| <H2><A NAME="htoc4">2</A>  The <TT>enable_if</TT> templates</H2><!--SEC END --> | ||||
|  | ||||
| <A NAME="enable_if"></A> | ||||
| The names of the <TT>enable_if</TT> templates have three parts: an optional <TT>lazy_</TT> tag,  | ||||
| either <TT>enable_if</TT> or <TT>disable_if</TT>, and an optional <TT>_c</TT> tag. | ||||
| All eight combinations of these parts are supported. | ||||
| The meaning of the <TT>lazy_</TT> tag is described in Section <A HREF="#sec:enable_if_lazy">3.3</A>. | ||||
| The second part of the name indicates whether a true condition argument should  | ||||
| enable or disable the current overload. | ||||
| The third part of the name indicates whether the condition argument is a <TT>bool</TT> value  | ||||
| (<TT>_c</TT> suffix), or a type containing a static <TT>bool</TT> constant named <TT>value</TT> (no suffix). | ||||
| The latter version interoperates with Boost.MPL. <BR> | ||||
| <BR> | ||||
| The definitions of <TT>enable_if_c</TT> and <TT>enable_if</TT> are as follows (we use <TT>enable_if</TT> templates  | ||||
| unqualified but they are in the <TT>boost</TT> namespace). | ||||
| <PRE>template <bool B, class T = void> | ||||
| struct enable_if_c { | ||||
|   typedef T type; | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| struct enable_if_c<false, T> {}; | ||||
|  | ||||
| template <class Cond, class T = void> | ||||
| struct enable_if : public enable_if_c<Cond::value, T> {}; | ||||
|  | ||||
| </PRE> | ||||
| An instantiation of the <TT>enable_if_c</TT> template with the parameter | ||||
| <TT>B</TT> as <TT>true</TT> contains a member type <TT>type</TT>, defined | ||||
| to be <TT>T</TT>. If <TT>B</TT> is | ||||
| <TT>false</TT>, no such member is defined. Thus  | ||||
| <TT>enable_if_c<B, T>::type</TT> is either a valid or an invalid type | ||||
| expression, depending on the value of <TT>B</TT>. | ||||
| When valid, <TT>enable_if_c<B, T>::type</TT> equals <TT>T</TT>. | ||||
| The <TT>enable_if_c</TT> template can thus be used for controlling when functions are considered for | ||||
| overload resolution and when they are not.  | ||||
| For example, the following function is defined for all arithmetic types (according to the | ||||
| classification of the <A HREF="../type_traits/index.html">Boost type_traits library</A>): | ||||
| <PRE>template <class T> | ||||
| typename enable_if_c<boost::is_arithmetic<T>::value, T>::type  | ||||
| foo(T t) { return t; } | ||||
|  | ||||
| </PRE> | ||||
| The <TT>disable_if_c</TT> template is provided as well, and has the | ||||
| same functionality as <TT>enable_if_c</TT> except for the negated condition. The following | ||||
| function is enabled for all non-arithmetic types. | ||||
| <PRE>template <class T> | ||||
| typename disable_if_c<boost::is_arithmetic<T>::value, T>::type  | ||||
| bar(T t) { return t; } | ||||
|  | ||||
| </PRE> | ||||
| For easier syntax in some cases and interoperation with Boost.MPL we provide versions of | ||||
| the <TT>enable_if</TT> templates taking any type with a <TT>bool</TT> member constant named  | ||||
| <TT>value</TT> as the condition argument. | ||||
| The MPL <TT>bool_</TT>, <TT>and_</TT>, <TT>or_</TT>, and <TT>not_</TT> templates are likely to be  | ||||
| useful for creating such types. Also, the traits classes in the Boost.Type_traits library  | ||||
| follow this convention.  | ||||
| For example, the above example function <TT>foo</TT> can be alternatively written as: | ||||
| <PRE>template <class T> | ||||
| typename enable_if<boost::is_arithmetic<T>, T>::type  | ||||
| foo(T t) { return t; } | ||||
|  | ||||
| </PRE> | ||||
| <!--TOC section Using <TT>enable_if</TT>--> | ||||
|  | ||||
| <H2><A NAME="htoc5">3</A>  Using <TT>enable_if</TT></H2><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:using_enable_if"></A> | ||||
| The <TT>enable_if</TT> templates are defined in | ||||
| <TT>boost/utility/enable_if.hpp</TT>, which is included by <TT>boost/utility.hpp</TT>.<BR> | ||||
| <BR> | ||||
| The <TT>enable_if</TT> template can be used either as the return type, or as an  | ||||
| extra argument. For example, the <TT>foo</TT> function in the previous section could also be written | ||||
| as: | ||||
| <PRE>template <class T> | ||||
| T foo(T t, typename enable_if<boost::is_arithmetic<T> >::type* dummy = 0);  | ||||
|  | ||||
| </PRE>Hence, an extra parameter of type <TT>void*</TT> is added, but it is given  | ||||
| a default value to keep the parameter hidden from client code. | ||||
| Note that the second template argument was not given to <TT>enable_if</TT>, as the default  | ||||
| <TT>void</TT> gives the desired behavior.<BR> | ||||
| <BR> | ||||
| Whether to write the enabler as an argument or within the return type is | ||||
| largely a matter of taste, but for certain functions, only one | ||||
| alternative is possible: | ||||
| <UL><LI> | ||||
| Operators have a fixed number of arguments, thus <TT>enable_if</TT> must be used in the return type. | ||||
| <LI>Constructors and destructors do not have a return type; an extra argument is the only option. | ||||
| <LI>There does not seem to be a way to specify an enabler for a conversion operator. Converting constructors, | ||||
| however, can have enablers as extra default arguments. | ||||
| </UL> | ||||
| <!--TOC subsection Enabling template class specializations--> | ||||
|  | ||||
| <H3><A NAME="htoc6">3.1</A>  Enabling template class specializations</H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:enable_if_classes"></A> | ||||
| Class template specializations can be enabled or disabled with <TT>enable_if</TT>. | ||||
| One extra template parameter needs to be added for the enabler expressions. | ||||
| This parameter has the default value <TT>void</TT>. | ||||
| For example: | ||||
| <PRE>template <class T, class Enable = void>  | ||||
| class A { ... }; | ||||
|  | ||||
| template <class T> | ||||
| class A<T, typename enable_if<is_integral<T> >::type> { ... }; | ||||
|  | ||||
| template <class T> | ||||
| class A<T, typename enable_if<is_float<T> >::type> { ... }; | ||||
|  | ||||
| </PRE>Instantiating <TT>A</TT> with any integral type matches the first specialization, | ||||
| whereas any floating point type matches the second one. All other types | ||||
| match the primary template. | ||||
| The condition can be any compile-time boolean expression that depends on the  | ||||
| template arguments of the class. | ||||
| Note that again, the second argument to <TT>enable_if</TT> is not needed; the default (<TT>void</TT>)  | ||||
| is the correct value.<BR> | ||||
| <BR> | ||||
| <!--TOC subsection Overlapping enabler conditions--> | ||||
|  | ||||
| <H3><A NAME="htoc7">3.2</A>  Overlapping enabler conditions</H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:overlapping_conditions"></A> | ||||
| Once the compiler has examined the enabling conditions and included the | ||||
| function into the overload resolution set, normal C++ overload resolution  | ||||
| rules are used to select the best matching function. | ||||
| In particular, there is no ordering between enabling conditions. | ||||
| Function templates with enabling conditions that are not mutually exclusive can  | ||||
| lead to ambiguities. For example: | ||||
| <PRE>template <class T> | ||||
| typename enable_if<boost::is_integral<T>, void>::type  | ||||
| foo(T t) {} | ||||
|  | ||||
| template <class T> | ||||
| typename enable_if<boost::is_arithmetic<T>, void>::type  | ||||
| foo(T t) {} | ||||
|  | ||||
| </PRE> | ||||
| All integral types are also arithmetic. Therefore, say, for the call <TT>foo(1)</TT>, | ||||
| both conditions are true and both functions are thus in the overload resolution set. | ||||
| They are both equally good matches and thus ambiguous. | ||||
| Of course, more than one enabling condition can be simultaneously true as long as  | ||||
| other arguments disambiguate the functions.<BR> | ||||
| <BR> | ||||
| The above discussion applies to using <TT>enable_if</TT> in class template | ||||
| partial specializations as well.<BR> | ||||
| <BR> | ||||
| <!--TOC subsection Lazy <TT>enable_if</TT>--> | ||||
|  | ||||
| <H3><A NAME="htoc8">3.3</A>  Lazy <TT>enable_if</TT></H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:enable_if_lazy"></A> | ||||
| In some cases it is necessary to avoid instantiating part of a | ||||
| function signature unless an enabling condition is true. For example: | ||||
| <PRE>template <class T, class U> class mult_traits; | ||||
|  | ||||
| template <class T, class U> | ||||
| typename enable_if<is_multipliable<T, U>, typename mult_traits<T, U>::type>::type | ||||
| operator*(const T& t, const U& u) { ... } | ||||
|  | ||||
| </PRE>Assume the class template <TT>mult_traits</TT> is a traits class defining  | ||||
| the resulting type of a multiplication operator. The <TT>is_multipliable</TT> traits | ||||
| class specifies for which types to enable the operator. Whenever | ||||
| <TT>is_multipliable<A, B>::value</TT> is <TT>true</TT> for some types <TT>A</TT> and <TT>B</TT>, | ||||
| then <TT>mult_traits<A, B>::type</TT> is defined.<BR> | ||||
| <BR> | ||||
| Now, trying to invoke (some other overload) of <TT>operator*</TT> with, say, operand types <TT>C</TT> and <TT>D</TT>  | ||||
| for which <TT>is_multipliable<C, D>::value</TT> is <TT>false</TT>  | ||||
| and <TT>mult_traits<C, D>::type</TT> is not defined is an error on some compilers.  | ||||
| The SFINAE principle is not applied because | ||||
| the invalid type occurs as an argument to another template. The <TT>lazy_enable_if</TT>  | ||||
| and <TT>lazy_disable_if</TT> templates (and their <TT>_c</TT> versions) can be used in such | ||||
| situations: | ||||
| <PRE>template<class T, class U> | ||||
| typename lazy_enable_if<is_multipliable<T, U>, mult_traits<T, U> >::type | ||||
| operator*(const T& t, const U& u) { ... } | ||||
|  | ||||
| </PRE>The second argument of <TT>lazy_enable_if</TT> must be a class type | ||||
| that defines a nested type named <TT>type</TT> whenever the first | ||||
| parameter (the condition) is true.<BR> | ||||
| <BR> | ||||
| <!--TOC paragraph Note--> | ||||
|  | ||||
| <H5>Note</H5><!--SEC END --> | ||||
|  | ||||
| Referring to one member type or static constant in a traits class | ||||
| causes all of the members (type and static constant) of that | ||||
| specialization to be instantiated. Therefore, if your traits classes | ||||
| can sometimes contain invalid types, you should use two distinct | ||||
| templates for describing the conditions and the type mappings. In the | ||||
| above example, <TT>is_multipliable<T, U>::value</TT> defines when | ||||
| <TT>mult_traits<T, U>::type</TT> is valid.<BR> | ||||
| <BR> | ||||
| <!--TOC subsection Compiler workarounds--> | ||||
|  | ||||
| <H3><A NAME="htoc9">3.4</A>  Compiler workarounds</H3><!--SEC END --> | ||||
|  | ||||
| <A NAME="sec:workarounds"></A> | ||||
| Some compilers flag functions as ambiguous if the only distinguishing factor is a different  | ||||
| condition in an enabler (even though the functions could never be ambiguous). For example, | ||||
| some compilers (e.g. GCC 3.2) diagnose the following two functions as ambiguous: | ||||
| <PRE>template <class T> | ||||
| typename enable_if<boost::is_arithmetic<T>, T>::type  | ||||
| foo(T t); | ||||
|  | ||||
| template <class T> | ||||
| typename disable_if<boost::is_arithmetic<T>, T>::type  | ||||
| foo(T t); | ||||
|  | ||||
| </PRE>Two workarounds can be applied: | ||||
| <UL><LI> | ||||
| Use an extra dummy parameter which disambiguates the functions. Use a default value for | ||||
| it to hide the parameter from the caller. For example: | ||||
| <PRE>template <int> struct dummy { dummy(int) {} }; | ||||
|  | ||||
| template <class T> | ||||
| typename enable_if<boost::is_arithmetic<T>, T>::type  | ||||
| foo(T t, dummy<0> = 0); | ||||
|  | ||||
| template <class T> | ||||
| typename disable_if<boost::is_arithmetic<T>, T>::type  | ||||
| foo(T t, dummy<1> = 0); | ||||
| </PRE><BR> | ||||
| <BR> | ||||
| <LI>Define the functions in different namespaces and bring them into a common | ||||
| namespace with <TT>using</TT> declarations: | ||||
| <PRE>namespace A { | ||||
|   template <class T> | ||||
|   typename enable_if<boost::is_arithmetic<T>, T>::type  | ||||
|   foo(T t); | ||||
| } | ||||
|  | ||||
| namespace B { | ||||
|   template <class T> | ||||
|   typename disable_if<boost::is_arithmetic<T>, T>::type  | ||||
|   foo(T t); | ||||
| } | ||||
|  | ||||
| using A::foo; | ||||
| using B::foo; | ||||
|  | ||||
| </PRE> | ||||
| Note that the second workaround above cannot be used for member | ||||
| templates. On the other hand, operators do not accept extra arguments, | ||||
| which makes the first workaround unusable. As the net effect, | ||||
| neither of the workarounds are of assistance for templated operators that | ||||
| need to be defined as member functions (assignment and | ||||
| subscript operators). | ||||
| </UL> | ||||
| <!--TOC section Acknowledgements--> | ||||
|  | ||||
| <H2><A NAME="htoc10">4</A>  Acknowledgements</H2><!--SEC END --> | ||||
|  | ||||
| We are grateful to Howard Hinnant, Jason Shirk, Paul Mensonides, and Richard | ||||
| Smith whose findings have influenced the library.<BR> | ||||
| <BR> | ||||
| <!--TOC section References--> | ||||
|  | ||||
| <H2>References</H2><!--SEC END --> | ||||
| <DL COMPACT=compact><DT><A NAME="jarvi:03:cuj_arbitrary_overloading"><FONT COLOR=purple>[1]</FONT></A><DD> | ||||
| Jaakko Järvi, Jeremiah Willcock, Howard Hinnant, and Andrew Lumsdaine. | ||||
| Function overloading based on arbitrary properties of types. | ||||
| <EM>C/C++ Users Journal</EM>, 21(6):25--32, June 2003.<BR> | ||||
| <BR> | ||||
| <DT><A NAME="jarvi:03:c++typeclasses"><FONT COLOR=purple>[2]</FONT></A><DD> | ||||
| Jaakko Järvi, Jeremiah Willcock, and Andrew Lumsdaine. | ||||
| Concept-controlled polymorphism. | ||||
| In Frank Pfennig and Yannis Smaragdakis, editors, <EM>Generative | ||||
|  Programming and Component Engineering</EM>, volume 2830 of <EM>LNCS</EM>, pages | ||||
|  228--244. Springer Verlag, September 2003.<BR> | ||||
| <BR> | ||||
| <DT><A NAME="vandevoorde2002:templates"><FONT COLOR=purple>[3]</FONT></A><DD> | ||||
| David Vandevoorde and Nicolai M. Josuttis. | ||||
| <EM>C++ Templates: The Complete Guide</EM>. | ||||
| Addison-Wesley, 2002.</DL> | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
| <hr></hr> | ||||
|  | ||||
| <B>Contributed by:</B> <BR> | ||||
| Jaakko Järvi, Jeremiah Willcock and Andrew Lumsdaine<BR> | ||||
| <EM>{jajarvi|jewillco|lums}@osl.iu.edu</EM><BR> | ||||
| Indiana University<BR> | ||||
| Open Systems Lab | ||||
| <!--HTMLFOOT--> | ||||
| <!--ENDHTML--> | ||||
| <!--FOOTER--> | ||||
| <HR SIZE=2> | ||||
| <BLOCKQUOTE><EM>This document was translated from L<sup>A</sup>T<sub>E</sub>X by | ||||
| </EM><A HREF="http://pauillac.inria.fr/~maranget/hevea/index.html"><EM>H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A</EM></A><EM>. | ||||
| </EM></BLOCKQUOTE> | ||||
| </BODY> | ||||
| </HTML> | ||||
							
								
								
									
										23
									
								
								enable_if/test/Jamfile.v2
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										23
									
								
								enable_if/test/Jamfile.v2
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,23 @@ | ||||
| # Copyright David Abrahams 2003. | ||||
| # Distributed under the Boost Software License, Version 1.0.  | ||||
| # (See accompanying file LICENSE_1_0.txt or copy at  | ||||
| # http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| # For more information, see http://www.boost.org/ | ||||
|  | ||||
| project | ||||
|     : requirements <library>/boost/test//boost_test_exec_monitor | ||||
|     ; | ||||
|  | ||||
| test-suite utility/enable_if | ||||
|         : | ||||
|         [ run constructors.cpp ] | ||||
|         [ run dummy_arg_disambiguation.cpp ] | ||||
|         [ run lazy.cpp ] | ||||
|         [ run lazy_test.cpp ] | ||||
|         [ run member_templates.cpp ] | ||||
|         [ run namespace_disambiguation.cpp ] | ||||
|         [ run no_disambiguation.cpp ] | ||||
|         [ run partial_specializations.cpp ] | ||||
|     ; | ||||
|  | ||||
							
								
								
									
										62
									
								
								enable_if/test/constructors.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										62
									
								
								enable_if/test/constructors.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,62 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits.hpp> | ||||
|  | ||||
| using boost::enable_if; | ||||
| using boost::disable_if; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| struct container { | ||||
|   bool my_value; | ||||
|  | ||||
|   template <class T> | ||||
|   container(const T&, const typename enable_if<is_arithmetic<T>, T>::type * = 0): | ||||
|   my_value(true) {} | ||||
|  | ||||
|   template <class T> | ||||
|   container(const T&, const typename disable_if<is_arithmetic<T>, T>::type * = 0): | ||||
|   my_value(false) {} | ||||
| }; | ||||
|  | ||||
| // example from Howard Hinnant (tests enable_if template members of a templated class) | ||||
| template <class charT> | ||||
| struct xstring | ||||
| { | ||||
|   template <class It> | ||||
|   xstring(It begin, It end, typename  | ||||
|           disable_if<is_arithmetic<It> >::type* = 0) | ||||
|     : data(end-begin) {} | ||||
|    | ||||
|   int data; | ||||
| }; | ||||
|  | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   | ||||
|   BOOST_CHECK(container(1).my_value); | ||||
|   BOOST_CHECK(container(1.0).my_value); | ||||
|  | ||||
|   BOOST_CHECK(!container("1").my_value);   | ||||
|   BOOST_CHECK(!container(static_cast<void*>(0)).my_value);   | ||||
|  | ||||
|   char sa[] = "123456"; | ||||
|   BOOST_CHECK(xstring<char>(sa, sa+6).data == 6); | ||||
|  | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										46
									
								
								enable_if/test/dummy_arg_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										46
									
								
								enable_if/test/dummy_arg_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,46 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
|  | ||||
| using boost::enable_if; | ||||
| using boost::disable_if; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| template <int N> struct dummy { | ||||
|   dummy(int) {}; | ||||
| }; | ||||
|  | ||||
| template<class T> | ||||
| typename enable_if<is_arithmetic<T>, bool>::type | ||||
| arithmetic_object(T t, dummy<0> = 0) { return true; } | ||||
|  | ||||
| template<class T> | ||||
| typename disable_if<is_arithmetic<T>, bool>::type | ||||
| arithmetic_object(T t, dummy<1> = 0) { return false; } | ||||
|  | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   | ||||
|   BOOST_CHECK(arithmetic_object(1)); | ||||
|   BOOST_CHECK(arithmetic_object(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!arithmetic_object("1"));   | ||||
|   BOOST_CHECK(!arithmetic_object(static_cast<void*>(0)));   | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										82
									
								
								enable_if/test/lazy.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										82
									
								
								enable_if/test/lazy.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,82 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_same.hpp> | ||||
|  | ||||
| using boost::enable_if_c; | ||||
| using boost::lazy_enable_if_c; | ||||
|  | ||||
| // This class provides a reduced example of a traits class for | ||||
| // computing the result of multiplying two types.  The member typedef | ||||
| // 'type' in this traits class defines the return type of this | ||||
| // operator.  The return type member is invalid unless both arguments | ||||
| // for mult_traits are values that mult_traits expects (ints in this | ||||
| // case).  This kind of situation may arise if a traits class only | ||||
| // makes sense for some set of types, not all C++ types. | ||||
|  | ||||
| template <class T> struct is_int { | ||||
|   BOOST_STATIC_CONSTANT(bool, value = (boost::is_same<T, int>::value)); | ||||
| }; | ||||
|  | ||||
| template <class T, class U> | ||||
| struct mult_traits { | ||||
|   typedef typename T::does_not_exist type; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct mult_traits<int, int> { | ||||
|   typedef int type; | ||||
| }; | ||||
|  | ||||
|  | ||||
| // Next, a forwarding function mult() is defined.  It is enabled only | ||||
| // when both arguments are of type int.  The first version, using | ||||
| // non-lazy enable_if_c does not work. | ||||
|  | ||||
| #if 0 | ||||
| template <class T, class U> | ||||
| typename enable_if_c< | ||||
|   is_int<T>::value && is_int<U>::value, | ||||
|   typename mult_traits<T, U>::type | ||||
| >::type | ||||
| mult(const T& x, const U& y) {return x * y;} | ||||
| #endif | ||||
|  | ||||
| // A correct version uses lazy_enable_if_c. | ||||
| // This template removes compiler errors from invalid code used as an | ||||
| // argument to enable_if_c. | ||||
|  | ||||
| #if 1 | ||||
| template <class T, class U> | ||||
| typename lazy_enable_if_c< | ||||
|   is_int<T>::value & is_int<U>::value, | ||||
|   mult_traits<T, U>  | ||||
| >::type | ||||
| mult(const T& x, const U& y) {return x * y;} | ||||
| #endif | ||||
|  | ||||
| double mult(int i, double d) { return (double)i * d; } | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|  | ||||
|  | ||||
|   BOOST_CHECK(mult(1, 2) == 2); | ||||
|  | ||||
|   BOOST_CHECK(mult(1, 3.0) == 3.0); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										100
									
								
								enable_if/test/lazy_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										100
									
								
								enable_if/test/lazy_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,100 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| // Testing all variations of lazy_enable_if. | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
| #include <boost/mpl/not.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_same.hpp> | ||||
|  | ||||
| using boost::lazy_enable_if; | ||||
| using boost::lazy_disable_if; | ||||
|  | ||||
| using boost::lazy_enable_if_c; | ||||
| using boost::lazy_disable_if_c; | ||||
|  | ||||
|  | ||||
| template <class T> | ||||
| struct is_int_or_double { | ||||
|   BOOST_STATIC_CONSTANT(bool,  | ||||
|     value = (boost::is_same<T, int>::value ||  | ||||
|              boost::is_same<T, double>::value)); | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| struct some_traits { | ||||
|   typedef typename T::does_not_exist type; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct some_traits<int> { | ||||
|   typedef bool type; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct some_traits<double> { | ||||
|   typedef bool type; | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| struct make_bool { | ||||
|   typedef bool type; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct make_bool<int> {}; | ||||
|  | ||||
| template <> | ||||
| struct make_bool<double> {}; | ||||
|  | ||||
| namespace A { | ||||
|  | ||||
|   template<class T> | ||||
|   typename lazy_enable_if<is_int_or_double<T>, some_traits<T> >::type | ||||
|   foo(T t) { return true; } | ||||
|  | ||||
|   template<class T> | ||||
|   typename lazy_enable_if_c<is_int_or_double<T>::value, some_traits<T> >::type | ||||
|   foo2(T t) { return true; } | ||||
| } | ||||
|  | ||||
| namespace B { | ||||
|   template<class T> | ||||
|   typename lazy_disable_if<is_int_or_double<T>, make_bool<T> >::type | ||||
|   foo(T t) { return false; } | ||||
|  | ||||
|   template<class T> | ||||
|   typename lazy_disable_if_c<is_int_or_double<T>::value, make_bool<T> >::type | ||||
|   foo2(T t) { return false; } | ||||
| } | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   using namespace A; | ||||
|   using namespace B; | ||||
|   BOOST_CHECK(foo(1)); | ||||
|   BOOST_CHECK(foo(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!foo("1"));   | ||||
|   BOOST_CHECK(!foo(static_cast<void*>(0)));   | ||||
|  | ||||
|   BOOST_CHECK(foo2(1)); | ||||
|   BOOST_CHECK(foo2(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!foo2("1"));   | ||||
|   BOOST_CHECK(!foo2(static_cast<void*>(0)));   | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										43
									
								
								enable_if/test/member_templates.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										43
									
								
								enable_if/test/member_templates.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,43 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
|  | ||||
| using boost::enable_if; | ||||
| using boost::disable_if; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| struct container { | ||||
|   template <class T> | ||||
|   typename enable_if<is_arithmetic<T>, bool>::type | ||||
|   arithmetic_object(const T&, const int* /* disambiguate */ = 0) {return true;} | ||||
|  | ||||
|   template <class T> | ||||
|   typename disable_if<is_arithmetic<T>, bool>::type | ||||
|   arithmetic_object(const T&) {return false;} | ||||
| }; | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   | ||||
|   BOOST_CHECK(container().arithmetic_object(1)); | ||||
|   BOOST_CHECK(container().arithmetic_object(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!container().arithmetic_object("1"));   | ||||
|   BOOST_CHECK(!container().arithmetic_object(static_cast<void*>(0)));   | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										47
									
								
								enable_if/test/namespace_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										47
									
								
								enable_if/test/namespace_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,47 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
| #include <boost/mpl/not.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
|  | ||||
| using boost::enable_if; | ||||
| using boost::mpl::not_; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| namespace A { | ||||
|   template<class T> | ||||
|   typename enable_if<is_arithmetic<T>, bool>::type | ||||
|   arithmetic_object(T t) { return true; } | ||||
| } | ||||
|  | ||||
| namespace B { | ||||
|   template<class T> | ||||
|   typename enable_if<not_<is_arithmetic<T> >, bool>::type | ||||
|   arithmetic_object(T t) { return false; } | ||||
| } | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   using namespace A; | ||||
|   using namespace B; | ||||
|   BOOST_CHECK(arithmetic_object(1)); | ||||
|   BOOST_CHECK(arithmetic_object(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!arithmetic_object("1"));   | ||||
|   BOOST_CHECK(!arithmetic_object(static_cast<void*>(0)));   | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										43
									
								
								enable_if/test/no_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										43
									
								
								enable_if/test/no_disambiguation.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,43 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
| #include <boost/mpl/not.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
|  | ||||
| using boost::mpl::not_; | ||||
| using boost::enable_if; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| template<class T> | ||||
| typename enable_if<is_arithmetic<T>, bool>::type | ||||
| arithmetic_object(T t) { return true; } | ||||
|  | ||||
| template<class T> | ||||
| typename enable_if<not_<is_arithmetic<T> >, bool>::type | ||||
| arithmetic_object(T t) { return false; } | ||||
|  | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   | ||||
|   BOOST_CHECK(arithmetic_object(1)); | ||||
|   BOOST_CHECK(arithmetic_object(1.0)); | ||||
|  | ||||
|   BOOST_CHECK(!arithmetic_object("1"));   | ||||
|   BOOST_CHECK(!arithmetic_object(static_cast<void*>(0)));   | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										67
									
								
								enable_if/test/partial_specializations.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										67
									
								
								enable_if/test/partial_specializations.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,67 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
| #include <boost/test/minimal.hpp> | ||||
|  | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
|  | ||||
| using boost::enable_if_c; | ||||
| using boost::disable_if_c; | ||||
| using boost::enable_if; | ||||
| using boost::disable_if; | ||||
| using boost::is_arithmetic; | ||||
|  | ||||
| template <class T, class Enable = void> | ||||
| struct tester; | ||||
|  | ||||
| template <class T> | ||||
| struct tester<T, typename enable_if_c<is_arithmetic<T>::value>::type> { | ||||
|   BOOST_STATIC_CONSTANT(bool, value = true); | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| struct tester<T, typename disable_if_c<is_arithmetic<T>::value>::type> { | ||||
|   BOOST_STATIC_CONSTANT(bool, value = false); | ||||
| }; | ||||
|  | ||||
| template <class T, class Enable = void> | ||||
| struct tester2; | ||||
|  | ||||
| template <class T> | ||||
| struct tester2<T, typename enable_if<is_arithmetic<T> >::type> { | ||||
|   BOOST_STATIC_CONSTANT(bool, value = true); | ||||
| }; | ||||
|  | ||||
| template <class T> | ||||
| struct tester2<T, typename disable_if<is_arithmetic<T> >::type> { | ||||
|   BOOST_STATIC_CONSTANT(bool, value = false); | ||||
| }; | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|   | ||||
|   BOOST_CHECK(tester<int>::value); | ||||
|   BOOST_CHECK(tester<double>::value); | ||||
|  | ||||
|   BOOST_CHECK(!tester<char*>::value); | ||||
|   BOOST_CHECK(!tester<void*>::value); | ||||
|  | ||||
|   BOOST_CHECK(tester2<int>::value); | ||||
|   BOOST_CHECK(tester2<double>::value); | ||||
|  | ||||
|   BOOST_CHECK(!tester2<char*>::value); | ||||
|   BOOST_CHECK(!tester2<void*>::value); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
							
								
								
									
										163
									
								
								generator_iterator.htm
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										163
									
								
								generator_iterator.htm
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,163 @@ | ||||
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | ||||
|  | ||||
| <html> | ||||
| <head> | ||||
|   <meta http-equiv="Content-Language" content="en-us"> | ||||
|   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> | ||||
|  | ||||
|   <title>Generator Iterator Adaptor Documentation</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|   <img src="../../boost.png" alt="boost.png (6897 bytes)" align="middle" | ||||
|   width="277" height="86"> | ||||
|  | ||||
|   <h1>Generator Iterator Adaptor</h1> | ||||
|  | ||||
|   <p>Defined in header <a href= | ||||
|   "../../boost/generator_iterator.hpp">boost/generator_iterator.hpp</a></p> | ||||
|  | ||||
|   <p>The generator iterator adaptor makes it easier to create custom input | ||||
|   iterators from 0-ary functions and function objects. The adaptor takes a | ||||
|   <a href="http://www.sgi.com/tech/stl/Generator.html">Generator</a> and | ||||
|   creates a model of <a href= | ||||
|   "http://www.sgi.com/tech/stl/InputIterator.html">Input Iterator</a>. Each | ||||
|   increment retrieves an item from the generator and makes it available to be | ||||
|   retrieved by dereferencing. The motivation for this iterator is that some | ||||
|   concepts can be more naturally expressed as a generator, while most STL | ||||
|   algorithms expect an iterator. An example is the <a href= | ||||
|   "../random/index.html">Random Number</a> library.</p> | ||||
|  | ||||
|   <h2>Synopsis</h2> | ||||
|  | ||||
|   <blockquote> | ||||
|     <pre> | ||||
| namespace boost { | ||||
|   template <class Generator> | ||||
|   class generator_iterator_policies; | ||||
|  | ||||
|   template <class Generator> | ||||
|   class generator_iterator_generator; | ||||
|  | ||||
|   template <class Generator> | ||||
|   typename generator_iterator_generator<Generator>::type | ||||
|   make_generator_iterator(Generator & gen); | ||||
| } | ||||
| </pre> | ||||
|   </blockquote> | ||||
|   <hr> | ||||
|  | ||||
|   <h2>The Generator Iterator Generator Class</h2> | ||||
|  | ||||
|   <p>The class generator_iterator_generator is a helper class whose purpose | ||||
|   is to construct a generator iterator type. The template parameter for this | ||||
|   class is the Generator function object type that is being wrapped. The | ||||
|   generator iterator adaptor only holds a reference (or pointer) to the | ||||
|   function object, therefore the function object must outlive the generator | ||||
|   iterator adaptor constructed from it.</p> | ||||
|   <pre> | ||||
| template <class Generator> | ||||
| class generator_iterator_generator | ||||
| { | ||||
| public: | ||||
|   typedef <i>unspecified</i> type; // the resulting generator iterator type  | ||||
| } | ||||
| </pre> | ||||
|  | ||||
|   <h3>Template Parameters</h3> | ||||
|  | ||||
|   <table border summary=""> | ||||
|     <tr> | ||||
|       <th>Parameter</th> | ||||
|  | ||||
|       <th>Description</th> | ||||
|     </tr> | ||||
|  | ||||
|     <tr> | ||||
|       <td><tt><a href= | ||||
|       "http://www.sgi.com/tech/stl/Generator.html">Generator</a></tt></td> | ||||
|  | ||||
|       <td>The generator (0-ary function object) type being wrapped. The | ||||
|       return type of the function must be defined as | ||||
|       <tt>Generator::result_type</tt>. The function object must be a model of | ||||
|       <a href= | ||||
|       "http://www.sgi.com/tech/stl/Generator.html">Generator</a>.</td> | ||||
|     </tr> | ||||
|   </table> | ||||
|  | ||||
|   <h3>Concept Model</h3> | ||||
|  | ||||
|   <p>The generator iterator class is a model of <a href= | ||||
|   "http://www.sgi.com/tech/stl/InputIterator.html">Input Iterator</a>.</p> | ||||
|  | ||||
|   <h3>Members</h3> | ||||
|  | ||||
|   <p>The generator iterator implements the member functions and operators | ||||
|   required of the <a href= | ||||
|   "http://www.sgi.com/tech/stl/InputIterator.html">Input Iterator</a> | ||||
|   concept.<br></p> | ||||
|   <hr> | ||||
|  | ||||
|   <h2><a name="make_generator_iterator" id="make_generator_iterator">The | ||||
|   Generator Iterator Object Generator</a></h2> | ||||
|  | ||||
|   <p>The <tt>make_generator_iterator()</tt> function provides a convenient | ||||
|   way to create generator iterator objects. The function saves the user the | ||||
|   trouble of explicitly writing out the iterator types.</p> | ||||
|  | ||||
|   <blockquote> | ||||
|     <pre> | ||||
| template <class Generator> | ||||
| typename generator_iterator_generator<Generator>::type | ||||
| make_generator_iterator(Generator & gen); | ||||
| </pre> | ||||
|   </blockquote> | ||||
|   <hr> | ||||
|  | ||||
|   <h3>Example</h3> | ||||
|  | ||||
|   <p>The following program shows how <code>generator_iterator</code> | ||||
|   transforms a generator into an input iterator.</p> | ||||
|  | ||||
|   <blockquote> | ||||
|     <pre> | ||||
| #include <iostream> | ||||
| #include <boost/generator_iterator.hpp> | ||||
|  | ||||
| class my_generator | ||||
| { | ||||
| public: | ||||
|   typedef int result_type; | ||||
|   my_generator() : state(0) { } | ||||
|   int operator()() { return ++state; } | ||||
| private: | ||||
|   int state; | ||||
| }; | ||||
|  | ||||
| int main() | ||||
| { | ||||
|   my_generator gen; | ||||
|   boost::generator_iterator_generator<my_generator>::type it = boost::make_generator_iterator(gen); | ||||
|   for(int i = 0; i < 10; ++i, ++it) | ||||
|     std::cout << *it << std::endl; | ||||
| } | ||||
| </pre> | ||||
|   </blockquote> | ||||
|   <hr> | ||||
|  | ||||
|   <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src= | ||||
|   "http://www.w3.org/Icons/valid-html401" alt="Valid HTML 4.01 Transitional" | ||||
|   height="31" width="88"></a></p> | ||||
|  | ||||
|   <p>Revised  | ||||
|   <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->05 December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38516" --></p> | ||||
|  | ||||
|   <p><i>Copyright © 2001 <a href= | ||||
|   "../../people/jens_maurer.htm">Jens Maurer</a></i></p> | ||||
|  | ||||
|   <p><i>Distributed under the Boost Software License, Version 1.0. (See | ||||
|   accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or | ||||
|   copy at <a href= | ||||
|   "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p> | ||||
| </body> | ||||
| </html> | ||||
							
								
								
									
										296
									
								
								in_place_factories.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										296
									
								
								in_place_factories.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,296 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//SoftQuad Software//DTD HoTMetaL PRO 5.0::19981217::extensions to HTML 4.0//EN" "hmpro5.dtd"> | ||||
|  | ||||
| <HTML> | ||||
|  | ||||
| <HEAD> | ||||
| <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252"> | ||||
| <TITLE>In_place_factory Documentation</TITLE> | ||||
| </HEAD> | ||||
|  | ||||
| <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080"> | ||||
| <H2 align="left"><IMG SRC="../../boost.png" WIDTH="276" HEIGHT="86"></H2> | ||||
|  | ||||
| <blockquote> | ||||
|   <blockquote> | ||||
|     <blockquote> | ||||
|       <blockquote> | ||||
|         <blockquote> | ||||
|           <blockquote> | ||||
| <H2 align="left">Header <<A | ||||
| HREF="../../boost/utility/in_place_factory.hpp">boost/utility/in_place_factory.hpp</A>> </H2> | ||||
|  | ||||
| <H2 align="left">Header <<A | ||||
| HREF="../../boost/utility/typed_in_place_factory.hpp">boost/utility/typed_in_place_factory.hpp</A>> </H2> | ||||
|  | ||||
|           </blockquote> | ||||
|         </blockquote> | ||||
|       </blockquote> | ||||
|     </blockquote> | ||||
|   </blockquote> | ||||
| </blockquote> | ||||
| <p> </p> | ||||
|  | ||||
| <H2>Contents</H2> | ||||
| <DL CLASS="page-index"> | ||||
|   <DT><A HREF="#mot">Motivation</A></DT> | ||||
|   <DT><A HREF="#framework">Framework</A></DT> | ||||
|   <DT><A HREF="#specification">Specification</A></DT> | ||||
|   <DT><A HREF="#container-usage">Container-side Usage</A></DT> | ||||
|   <DT><A HREF="#user-usage">User-side Usage</A></DT> | ||||
| </DL> | ||||
|  | ||||
| <HR> | ||||
|  | ||||
| <H2><A NAME="mot"></A>Motivation</H2> | ||||
|  | ||||
| <p>Suppose we have a class</p> | ||||
| <pre>struct X | ||||
| { | ||||
|   X ( int, std:::string ) ; | ||||
| } ;</pre> | ||||
| <p>And a container for it which supports an empty state (that is, which can contain zero objects):</p> | ||||
| <pre>struct C | ||||
| { | ||||
|    C() : contained_(0) {} | ||||
|   ~C() { delete contained_ ; } | ||||
|   X* contained_ ; | ||||
| } ;</pre> | ||||
| <p>A container designed to support an empty state typically doesn't require the contained type to be DefaultConstructible, | ||||
| but it typically requires it to be CopyConstructible as a mechanism to | ||||
| initialize the object to store:</p> | ||||
| <pre>struct C | ||||
| { | ||||
|    C() : contained_(0) {} | ||||
|    C ( X const& v ) : contained_ ( new X(v) ) {} | ||||
|   ~C() { delete contained_ ; } | ||||
|   X* contained_ ; | ||||
| } ;</pre> | ||||
| <p>There is a subtle problem with this: since the mechanism used to initialize the stored object is copy construction, | ||||
| there must exist a previously constructed source object to copy from. This | ||||
| object is likely to be temporary and serve no purpose besides being the source</p> | ||||
| <pre>void foo() | ||||
| { | ||||
|   // Temporary object created. | ||||
|   C c( X(123,"hello") ) ; | ||||
| } | ||||
| </pre> | ||||
| <p>A solution to this problem is to support direct construction of the contained | ||||
| object right in the container's storage.<br> | ||||
| In this scheme, the user supplies the arguments for the X constructor | ||||
| directly to the container:</p> | ||||
| <pre>struct C | ||||
| { | ||||
|    C() : contained_(0) {} | ||||
|    C ( X const& v ) : contained_ ( new X(v) ) {} | ||||
|    C ( int a0, std::string a1 ) : contained_ ( new X(a0,a1) ) {} | ||||
|   ~C() { delete contained_ ; } | ||||
|   X* contained_ ; | ||||
| } ;</pre> | ||||
| <pre>void foo() | ||||
| { | ||||
|   // Wrapped object constructed in-place | ||||
|   // No temporary created. | ||||
|   C c(123,"hello") ; | ||||
| } | ||||
| </pre> | ||||
| <p>Clearly, this solution doesn't scale well since the container must duplicate all the constructor overloads from the contained type | ||||
| (at least all those which are to be supported directly in the container).</p> | ||||
|  | ||||
| <H2><A NAME="framework"></A>Framework</H2> | ||||
| <p> | ||||
| This library proposes a framework to allow some containers to directly contruct contained objects in-place without requiring | ||||
| the entire set of constructor overloads ftom the contained type. It also allows the container to remove the CopyConstuctible | ||||
| requirement from the contained type since objects can be directly constructed in-place without need of a copy.<br> | ||||
| The only requirement on the container is that it must provide proper storage (that is, correctly aligned and sized). | ||||
| Naturally, the container will typically support uninitialized storage to avoid the in-place construction to override | ||||
| a fully-constructed object (as this would defeat the purpose of in-place construction) | ||||
| </p> | ||||
| <p>For this purpose, the framework provides two families of classes collectively called: InPlaceFactories and TypedInPlaceFactories.<br> | ||||
| Essentially, these classes hold a sequence of actual parameters and a method to contruct an object in place using these parameters. | ||||
| Each member of the family differs only in the number (and type) of the parameter list. The first family | ||||
| takes the type of the object to construct directly in method provided for that | ||||
| purpose, whereas the second family incorporates that type in the factory class | ||||
| itself..</p> | ||||
| <p>From the container POV, using the framework amounts to calling the factory's method to contruct the object in place. | ||||
| From the user POV, it amounts to creating the right factory object to hold the parameters and pass it to the container.<br> | ||||
| The following simplified example shows the basic idea. A complete example follows the formal specification of the framework:</p> | ||||
| <pre>struct C | ||||
| { | ||||
|    template<class InPlaceFactory> | ||||
|    C ( InPlaceFactory const& aFactoty ) | ||||
|     : | ||||
|     contained_ ( uninitialized_storage() ) | ||||
|    { | ||||
|      aFactory.template apply<X>(contained_); | ||||
|    } | ||||
|  | ||||
|   ~C()  | ||||
|   {  | ||||
|     contained_ -> X::~X(); | ||||
|     delete[] contained_ ;  | ||||
|   } | ||||
|  | ||||
|   char* uninitialized_storage() { return new char[sizeof(X)] ; } | ||||
|  | ||||
|   char* contained_ ; | ||||
| } ; | ||||
|  | ||||
| void foo() | ||||
| { | ||||
|   C c( in_place(123,"hello") ) ; | ||||
| } | ||||
| </pre> | ||||
|  | ||||
| <HR> | ||||
|  | ||||
| <H2><A NAME="specification">Specification</A></H2> | ||||
|  | ||||
| <p>The following is the first member of the family of 'in_place_factory' classes, along with its corresponding helper template function. | ||||
| The rest of the family varies only in the number and type of template (and constructor) parameters.</p> | ||||
| <PRE>namespace boost { | ||||
|  | ||||
| struct in_place_factory_base {} ; | ||||
|  | ||||
| template<class A0> | ||||
| class in_place_factory : public in_place_factory_base | ||||
| { | ||||
|   public:</PRE> | ||||
|  | ||||
| <PRE>    in_place_factory ( A0 const& a0 ) : m_a0(a0) {} | ||||
|  | ||||
|     template< class T > | ||||
|     void apply ( void* address ) const | ||||
|     { | ||||
|       new (address) T(m_a0); | ||||
|     } | ||||
|  | ||||
|   private:</PRE> | ||||
|  | ||||
| <PRE>    A0 const& m_a0 ; | ||||
| } ; | ||||
|  | ||||
| template<class A0> | ||||
| in_place_factory<A0> in_place ( A0 const& a0 ) | ||||
| { | ||||
|   return in_place_factory<A0>(a0); | ||||
| } | ||||
| </PRE> | ||||
|  | ||||
| <p>Similarly, the following is the first member of the family of 'typed_in_place_factory' classes, along with its corresponding | ||||
| helper template function. The rest of the family varies only in the number and type of template (and constructor) parameters.</p> | ||||
| <PRE>namespace boost { | ||||
|  | ||||
| struct typed_in_place_factory_base {} ; | ||||
|  | ||||
| template<class T, class A0> | ||||
| class typed_in_place_factory : public typed_in_place_factory_base | ||||
| { | ||||
|   public:</PRE> | ||||
|  | ||||
| <PRE>    typed_in_place_factory ( A0 const& a0 ) : m_a0(a0) {} | ||||
|  | ||||
|     void apply ( void* address ) const | ||||
|     { | ||||
|       new (address) T(m_a0); | ||||
|     } | ||||
|  | ||||
|   private:</PRE> | ||||
|  | ||||
| <PRE>    A0 const& m_a0 ; | ||||
| } ; | ||||
|  | ||||
| template<class T, class A0> | ||||
| typed_in_place_factory<A0> in_place ( A0 const& a0 ) | ||||
| { | ||||
|   return typed_in_place_factory<T,A0>(a0); | ||||
| }</PRE> | ||||
|  | ||||
| <PRE>} | ||||
| </PRE> | ||||
|  | ||||
| <p>As you can see, the 'in_place_factory' and 'typed_in_place_factory' template classes varies only in the way they specify | ||||
| the target type: in the first family, the type is given as a template argument to the apply member function while in the | ||||
| second it is given directly as part of the factory class.<br> | ||||
| When the container holds a unique non-polymorphic type (such as the case of Boost.Optional), it knows the exact dynamic-type | ||||
| of the contained object and can pass it to the apply() method of a (non-typed) factory. | ||||
| In this case, end users can use an 'in_place_factory' instance which can be constructed without the type of the object to construct.<br> | ||||
| However, if the container holds heterogeneous or polymorphic objects (such as the case of Boost.Variant), the dynamic-type | ||||
| of the object to be constructed must be known by the factory itslef. In this case, end users must use a 'typed_in_place_factory' | ||||
| instead.</p> | ||||
|  | ||||
| <HR> | ||||
|  | ||||
| <h2><A NAME="container-usage">Container-side Usage</a></h2> | ||||
|  | ||||
| <p>As shown in the introductory simplified example, the container class must | ||||
| contain methods that accept an instance of | ||||
| these factories and pass the object's storage to the factory's apply method.<br> | ||||
| However, the type of the factory class cannot be completly specified in the container class because that would | ||||
| defeat the whole purpose of the factories which is to allow the container to accept a variadic argument list | ||||
| for the constructor of its contained object.<br> | ||||
| The correct function overload must be based on the only distinctive and common | ||||
| characteristic of all the classes in each family, the base class.<br> | ||||
| Depending on the container class, you can use 'enable_if' to generate the right overload, or use the following | ||||
| dispatch technique (used in the Boost.Optional class): | ||||
| </p> | ||||
| <pre>struct C | ||||
| { | ||||
|    C() : contained_(0) {} | ||||
|    C ( X const& v ) : contained_ ( new X(v) ) {} | ||||
|  | ||||
|    template<class Expr> | ||||
|    C ( Expr const& expr ) | ||||
|     : | ||||
|     contained_ ( uninitialized_storage() ) | ||||
|    { | ||||
|     construct(expr,&expr) | ||||
|    } | ||||
|  | ||||
|   ~C() { delete contained_ ; } | ||||
|  | ||||
|   template<class InPlaceFactory> | ||||
|   void construct ( InPlaceFactory const& aFactory, boost::in_place_factory_base* ) | ||||
|   { | ||||
|     aFactory.template apply<X>(contained_); | ||||
|   } | ||||
|  | ||||
|   template<class TypedInPlaceFactory> | ||||
|   void construct ( TypedInPlaceFactory const& aFactory, boost::typed_in_place_factory_base* ) | ||||
|   { | ||||
|     aFactory.apply(contained_); | ||||
|   } | ||||
|  | ||||
|   X* uninitialized_storage() { return static_cast<X*>(new char[sizeof(X)]) ; } | ||||
|  | ||||
|   X* contained_ ; | ||||
| } ; | ||||
| </pre> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <h2><A NAME="user-usage">User-side Usage</a></h2> | ||||
|  | ||||
| <p>End users pass to the container an instance of a factory object holding the actual parameters needed to construct the | ||||
| contained object directly within the container. For this, the helper template function 'in_place' is used.<br> | ||||
| The call 'in_place(a0,a1,a2,...,an)' constructs a (non-typed) 'in_place_factory' instance with the given argument list.<br> | ||||
| The call 'in_place<T>(a0,a1,a2,...,an)' constructs a 'typed_in_place_factory' instance with the given argument list for the | ||||
| type 'T'.</p> | ||||
| <pre>void foo() | ||||
| { | ||||
|   C a( in_place(123,"hello") ) ;    // in_place_factory passed | ||||
|   C b( in_place<X>(456,"world") ) ; // typed_in_place_factory passed | ||||
| } | ||||
| </pre> | ||||
|  | ||||
| <P>Revised September 17, 2004</P> | ||||
| <p><EFBFBD> Copyright Fernando Luis Cacciola Carballal, 2004</p> | ||||
| <p> Use, modification, and distribution are subject to the Boost Software | ||||
| License, Version 1.0. (See accompanying file <a href="../../LICENSE_1_0.txt"> | ||||
| LICENSE_1_0.txt</a> or copy at <a href="http://www.boost.org/LICENSE_1_0.txt"> | ||||
| www.boost.org/LICENSE_1_0.txt</a>)</p> | ||||
| <P>Developed by <A HREF="mailto:fernando_cacciola@hotmail.com">Fernando Cacciola</A>, | ||||
| the latest version of this file can be found at <A | ||||
| HREF="http://www.boost.org">www.boost.org</A>, and the boost | ||||
| <A HREF="http://www.boost.org/more/mailing_lists.htm#main">discussion lists</A></P> | ||||
| </BODY> | ||||
| </HTML> | ||||
							
								
								
									
										37
									
								
								include/boost/assert.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										37
									
								
								include/boost/assert.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,37 @@ | ||||
| // | ||||
| //  boost/assert.hpp - BOOST_ASSERT(expr) | ||||
| // | ||||
| //  Copyright (c) 2001, 2002 Peter Dimov and Multi Media Ltd. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| //  Note: There are no include guards. This is intentional. | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility/assert.html for documentation. | ||||
| // | ||||
|  | ||||
| #undef BOOST_ASSERT | ||||
|  | ||||
| #if defined(BOOST_DISABLE_ASSERTS) | ||||
|  | ||||
| # define BOOST_ASSERT(expr) ((void)0) | ||||
|  | ||||
| #elif defined(BOOST_ENABLE_ASSERT_HANDLER) | ||||
|  | ||||
| #include <boost/current_function.hpp> | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| void assertion_failed(char const * expr, char const * function, char const * file, long line); // user defined | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #define BOOST_ASSERT(expr) ((expr)? ((void)0): ::boost::assertion_failed(#expr, BOOST_CURRENT_FUNCTION, __FILE__, __LINE__)) | ||||
|  | ||||
| #else | ||||
| # include <assert.h> // .h to support old libraries w/o <cassert> - effect is the same | ||||
| # define BOOST_ASSERT(expr) assert(expr) | ||||
| #endif | ||||
| @@ -1,9 +1,10 @@ | ||||
| //  (C) Copyright Boost.org 2000. Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  See boost/detail/call_traits.hpp and boost/detail/ob_call_traits.hpp | ||||
| //  for full copyright notices. | ||||
|  | ||||
|   | ||||
							
								
								
									
										69
									
								
								include/boost/checked_delete.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										69
									
								
								include/boost/checked_delete.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,69 @@ | ||||
| #ifndef BOOST_CHECKED_DELETE_HPP_INCLUDED | ||||
| #define BOOST_CHECKED_DELETE_HPP_INCLUDED | ||||
|  | ||||
| // MS compatible compilers support #pragma once | ||||
|  | ||||
| #if defined(_MSC_VER) && (_MSC_VER >= 1020) | ||||
| # pragma once | ||||
| #endif | ||||
|  | ||||
| // | ||||
| //  boost/checked_delete.hpp | ||||
| // | ||||
| //  Copyright (c) 2002, 2003 Peter Dimov | ||||
| //  Copyright (c) 2003 Daniel Frey | ||||
| //  Copyright (c) 2003 Howard Hinnant | ||||
| // | ||||
| //  Distributed under the Boost Software License, Version 1.0. (See | ||||
| //  accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility/checked_delete.html for documentation. | ||||
| // | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| // verify that types are complete for increased safety | ||||
|  | ||||
| template<class T> inline void checked_delete(T * x) | ||||
| { | ||||
|     // intentionally complex - simplification causes regressions | ||||
|     typedef char type_must_be_complete[ sizeof(T)? 1: -1 ]; | ||||
|     (void) sizeof(type_must_be_complete); | ||||
|     delete x; | ||||
| } | ||||
|  | ||||
| template<class T> inline void checked_array_delete(T * x) | ||||
| { | ||||
|     typedef char type_must_be_complete[ sizeof(T)? 1: -1 ]; | ||||
|     (void) sizeof(type_must_be_complete); | ||||
|     delete [] x; | ||||
| } | ||||
|  | ||||
| template<class T> struct checked_deleter | ||||
| { | ||||
|     typedef void result_type; | ||||
|     typedef T * argument_type; | ||||
|  | ||||
|     void operator()(T * x) const | ||||
|     { | ||||
|         // boost:: disables ADL | ||||
|         boost::checked_delete(x); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| template<class T> struct checked_array_deleter | ||||
| { | ||||
|     typedef void result_type; | ||||
|     typedef T * argument_type; | ||||
|  | ||||
|     void operator()(T * x) const | ||||
|     { | ||||
|         boost::checked_array_delete(x); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif  // #ifndef BOOST_CHECKED_DELETE_HPP_INCLUDED | ||||
| @@ -1,9 +1,10 @@ | ||||
| //  (C) Copyright Boost.org 2000. Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  See boost/detail/compressed_pair.hpp and boost/detail/ob_compressed_pair.hpp | ||||
| //  for full copyright notices. | ||||
|  | ||||
|   | ||||
							
								
								
									
										67
									
								
								include/boost/current_function.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										67
									
								
								include/boost/current_function.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,67 @@ | ||||
| #ifndef BOOST_CURRENT_FUNCTION_HPP_INCLUDED | ||||
| #define BOOST_CURRENT_FUNCTION_HPP_INCLUDED | ||||
|  | ||||
| // MS compatible compilers support #pragma once | ||||
|  | ||||
| #if defined(_MSC_VER) && (_MSC_VER >= 1020) | ||||
| # pragma once | ||||
| #endif | ||||
|  | ||||
| // | ||||
| //  boost/current_function.hpp - BOOST_CURRENT_FUNCTION | ||||
| // | ||||
| //  Copyright (c) 2002 Peter Dimov and Multi Media Ltd. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| //  http://www.boost.org/libs/utility/current_function.html | ||||
| // | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| namespace detail | ||||
| { | ||||
|  | ||||
| inline void current_function_helper() | ||||
| { | ||||
|  | ||||
| #if defined(__GNUC__) || (defined(__MWERKS__) && (__MWERKS__ >= 0x3000)) || (defined(__ICC) && (__ICC >= 600)) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __PRETTY_FUNCTION__ | ||||
|  | ||||
| #elif defined(__DMC__) && (__DMC__ >= 0x810) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __PRETTY_FUNCTION__ | ||||
|  | ||||
| #elif defined(__FUNCSIG__) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __FUNCSIG__ | ||||
|  | ||||
| #elif (defined(__INTEL_COMPILER) && (__INTEL_COMPILER >= 600)) || (defined(__IBMCPP__) && (__IBMCPP__ >= 500)) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __FUNCTION__ | ||||
|  | ||||
| #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x550) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __FUNC__ | ||||
|  | ||||
| #elif defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901) | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION __func__ | ||||
|  | ||||
| #else | ||||
|  | ||||
| # define BOOST_CURRENT_FUNCTION "(unknown)" | ||||
|  | ||||
| #endif | ||||
|  | ||||
| } | ||||
|  | ||||
| } // namespace detail | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif // #ifndef BOOST_CURRENT_FUNCTION_HPP_INCLUDED | ||||
| @@ -1,10 +1,9 @@ | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
|  | ||||
| // call_traits: defines typedefs for function usage | ||||
| // (see libs/utility/call_traits.htm) | ||||
| @@ -22,31 +21,44 @@ | ||||
| #ifndef BOOST_CONFIG_HPP | ||||
| #include <boost/config.hpp> | ||||
| #endif | ||||
| #include <cstddef> | ||||
|  | ||||
| #ifndef BOOST_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits.hpp> | ||||
| #endif | ||||
| #include <boost/type_traits/is_arithmetic.hpp> | ||||
| #include <boost/type_traits/is_pointer.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
|  | ||||
| namespace boost{ | ||||
|  | ||||
| namespace detail{ | ||||
|  | ||||
| template <typename T, bool isp, bool b1, bool b2> | ||||
| template <typename T, bool small_> | ||||
| struct ct_imp2 | ||||
| { | ||||
|    typedef const T& param_type; | ||||
| }; | ||||
|  | ||||
| template <typename T> | ||||
| struct ct_imp2<T, true> | ||||
| { | ||||
|    typedef const T param_type; | ||||
| }; | ||||
|  | ||||
| template <typename T, bool isp, bool b1> | ||||
| struct ct_imp | ||||
| { | ||||
|    typedef const T& param_type; | ||||
| }; | ||||
|  | ||||
| template <typename T, bool isp> | ||||
| struct ct_imp<T, isp, true, true> | ||||
| struct ct_imp<T, isp, true> | ||||
| { | ||||
|    typedef T const param_type; | ||||
|    typedef typename ct_imp2<T, sizeof(T) <= sizeof(void*)>::param_type param_type; | ||||
| }; | ||||
|  | ||||
| template <typename T, bool b1, bool b2> | ||||
| struct ct_imp<T, true, b1, b2> | ||||
| template <typename T, bool b1> | ||||
| struct ct_imp<T, true, b1> | ||||
| { | ||||
|    typedef T const param_type; | ||||
|    typedef const T param_type; | ||||
| }; | ||||
|  | ||||
| } | ||||
| @@ -64,7 +76,11 @@ public: | ||||
|    // however compiler bugs prevent this - instead pass three bool's to | ||||
|    // ct_imp<T,bool,bool,bool> and add an extra partial specialisation | ||||
|    // of ct_imp to handle the logic. (JM) | ||||
|    typedef typename detail::ct_imp<T, ::boost::is_pointer<typename remove_const<T>::type>::value, ::boost::is_arithmetic<typename remove_const<T>::type>::value, sizeof(T) <= sizeof(void*)>::param_type param_type; | ||||
|    typedef typename boost::detail::ct_imp< | ||||
|       T, | ||||
|       ::boost::is_pointer<T>::value, | ||||
|       ::boost::is_arithmetic<T>::value | ||||
|    >::param_type param_type; | ||||
| }; | ||||
|  | ||||
| template <typename T> | ||||
| @@ -76,7 +92,7 @@ struct call_traits<T&> | ||||
|    typedef T& param_type;  // hh removed const | ||||
| }; | ||||
|  | ||||
| #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551) | ||||
| #if BOOST_WORKAROUND( __BORLANDC__,  BOOST_TESTED_AT( 0x581 ) ) | ||||
| // these are illegal specialisations; cv-qualifies applied to | ||||
| // references have no effect according to [8.3.2p1], | ||||
| // C++ Builder requires them though as it treats cv-qualified | ||||
| @@ -105,8 +121,17 @@ struct call_traits<T&const volatile> | ||||
|    typedef const T& const_reference; | ||||
|    typedef T& param_type;  // hh removed const | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| template <typename T> | ||||
| struct call_traits< T * > | ||||
| { | ||||
|    typedef T * value_type; | ||||
|    typedef T * & reference; | ||||
|    typedef T * const & const_reference; | ||||
|    typedef T * const param_type;  // hh removed const | ||||
| }; | ||||
| #endif | ||||
| #if !defined(BOOST_NO_ARRAY_TYPE_SPECIALIZATIONS) | ||||
| template <typename T, std::size_t N> | ||||
| struct call_traits<T [N]> | ||||
| { | ||||
| @@ -132,6 +157,7 @@ public: | ||||
|    typedef const array_type& const_reference; | ||||
|    typedef const T* const param_type; | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| } | ||||
|  | ||||
|   | ||||
| @@ -1,14 +1,16 @@ | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
|  | ||||
| // compressed_pair: pair that "compresses" empty members | ||||
| // (see libs/utility/compressed_pair.htm) | ||||
| // | ||||
| // JM changes 25 Jan 2004: | ||||
| // For the case where T1 == T2 and both are empty, then first() and second() | ||||
| // should return different objects. | ||||
| // JM changes 25 Jan 2000: | ||||
| // Removed default arguments from compressed_pair_switch to get | ||||
| // C++ Builder 4 to accept them | ||||
| @@ -19,16 +21,23 @@ | ||||
| #define BOOST_DETAIL_COMPRESSED_PAIR_HPP | ||||
|  | ||||
| #include <algorithm> | ||||
| #ifndef BOOST_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits.hpp> | ||||
| #endif | ||||
| #ifndef BOOST_CALL_TRAITS_HPP | ||||
| #include <boost/call_traits.hpp> | ||||
| #endif | ||||
|  | ||||
| #include <boost/type_traits/remove_cv.hpp> | ||||
| #include <boost/type_traits/is_empty.hpp> | ||||
| #include <boost/type_traits/is_same.hpp> | ||||
| #include <boost/call_traits.hpp> | ||||
|  | ||||
| #ifdef BOOST_MSVC | ||||
| # pragma warning(push) | ||||
| # pragma warning(disable:4512) | ||||
| #endif  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| template <class T1, class T2> | ||||
| class compressed_pair; | ||||
|  | ||||
|  | ||||
| // compressed_pair | ||||
|  | ||||
| namespace details | ||||
| @@ -75,7 +84,9 @@ namespace details | ||||
|    template <typename T> | ||||
|    inline void cp_swap(T& t1, T& t2) | ||||
|    { | ||||
| #ifndef __GNUC__ | ||||
|       using std::swap; | ||||
| #endif | ||||
|       swap(t1, t2); | ||||
|    } | ||||
|  | ||||
| @@ -99,10 +110,10 @@ namespace details | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : first_(x), second_(y) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_(x) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(second_param_type y) | ||||
|       compressed_pair_imp(second_param_type y) | ||||
|          : second_(y) {} | ||||
|  | ||||
|       first_reference       first()       {return first_;} | ||||
| @@ -111,10 +122,10 @@ namespace details | ||||
|       second_reference       second()       {return second_;} | ||||
|       second_const_reference second() const {return second_;} | ||||
|  | ||||
|       void swap(compressed_pair_imp& y) | ||||
|       void swap(::boost::compressed_pair<T1, T2>& y) | ||||
|       { | ||||
|          cp_swap(first_, y.first_); | ||||
|          cp_swap(second_, y.second_); | ||||
|          cp_swap(first_, y.first()); | ||||
|          cp_swap(second_, y.second()); | ||||
|       } | ||||
|    private: | ||||
|       first_type first_; | ||||
| @@ -125,7 +136,7 @@ namespace details | ||||
|  | ||||
|    template <class T1, class T2> | ||||
|    class compressed_pair_imp<T1, T2, 1> | ||||
|       : private T1 | ||||
|       : protected ::boost::remove_cv<T1>::type | ||||
|    { | ||||
|    public: | ||||
|       typedef T1                                                 first_type; | ||||
| @@ -142,10 +153,10 @@ namespace details | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : first_type(x), second_(y) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_type(x) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(second_param_type y) | ||||
|       compressed_pair_imp(second_param_type y) | ||||
|          : second_(y) {} | ||||
|  | ||||
|       first_reference       first()       {return *this;} | ||||
| @@ -154,10 +165,10 @@ namespace details | ||||
|       second_reference       second()       {return second_;} | ||||
|       second_const_reference second() const {return second_;} | ||||
|  | ||||
|       void swap(compressed_pair_imp& y) | ||||
|       void swap(::boost::compressed_pair<T1,T2>& y) | ||||
|       { | ||||
|          // no need to swap empty base class: | ||||
|          cp_swap(second_, y.second_); | ||||
|          cp_swap(second_, y.second()); | ||||
|       } | ||||
|    private: | ||||
|       second_type second_; | ||||
| @@ -167,7 +178,7 @@ namespace details | ||||
|  | ||||
|    template <class T1, class T2> | ||||
|    class compressed_pair_imp<T1, T2, 2> | ||||
|       : private T2 | ||||
|       : protected ::boost::remove_cv<T2>::type | ||||
|    { | ||||
|    public: | ||||
|       typedef T1                                                 first_type; | ||||
| @@ -184,10 +195,10 @@ namespace details | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : second_type(y), first_(x) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_(x) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(second_param_type y) | ||||
|       compressed_pair_imp(second_param_type y) | ||||
|          : second_type(y) {} | ||||
|  | ||||
|       first_reference       first()       {return first_;} | ||||
| @@ -196,10 +207,10 @@ namespace details | ||||
|       second_reference       second()       {return *this;} | ||||
|       second_const_reference second() const {return *this;} | ||||
|  | ||||
|       void swap(compressed_pair_imp& y) | ||||
|       void swap(::boost::compressed_pair<T1,T2>& y) | ||||
|       { | ||||
|          // no need to swap empty base class: | ||||
|          cp_swap(first_, y.first_); | ||||
|          cp_swap(first_, y.first()); | ||||
|       } | ||||
|  | ||||
|    private: | ||||
| @@ -210,8 +221,8 @@ namespace details | ||||
|  | ||||
|    template <class T1, class T2> | ||||
|    class compressed_pair_imp<T1, T2, 3> | ||||
|       : private T1, | ||||
|         private T2 | ||||
|       : protected ::boost::remove_cv<T1>::type, | ||||
|         protected ::boost::remove_cv<T2>::type | ||||
|    { | ||||
|    public: | ||||
|       typedef T1                                                 first_type; | ||||
| @@ -228,10 +239,10 @@ namespace details | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : first_type(x), second_type(y) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_type(x) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(second_param_type y) | ||||
|       compressed_pair_imp(second_param_type y) | ||||
|          : second_type(y) {} | ||||
|  | ||||
|       first_reference       first()       {return *this;} | ||||
| @@ -241,16 +252,19 @@ namespace details | ||||
|       second_const_reference second() const {return *this;} | ||||
|       // | ||||
|       // no need to swap empty bases: | ||||
|       void swap(compressed_pair_imp&) {} | ||||
|       void swap(::boost::compressed_pair<T1,T2>&) {} | ||||
|    }; | ||||
|  | ||||
|    // JM | ||||
|    // 4    T1 == T2, T1 and T2 both empty | ||||
|    //      Note does not actually store an instance of T2 at all - | ||||
|    //      but reuses T1 base class for both first() and second(). | ||||
|    //      Originally this did not store an instance of T2 at all | ||||
|    //      but that led to problems beause it meant &x.first() == &x.second() | ||||
|    //      which is not true for any other kind of pair, so now we store an instance | ||||
|    //      of T2 just in case the user is relying on first() and second() returning | ||||
|    //      different objects (albeit both empty). | ||||
|    template <class T1, class T2> | ||||
|    class compressed_pair_imp<T1, T2, 4> | ||||
|       : private T1 | ||||
|       : protected ::boost::remove_cv<T1>::type | ||||
|    { | ||||
|    public: | ||||
|       typedef T1                                                 first_type; | ||||
| @@ -264,20 +278,21 @@ namespace details | ||||
|  | ||||
|       compressed_pair_imp() {} | ||||
|  | ||||
|       compressed_pair_imp(first_param_type x, second_param_type) | ||||
|          : first_type(x) {} | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : first_type(x), m_second(y) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|          : first_type(x) {} | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_type(x), m_second(x) {} | ||||
|  | ||||
|       first_reference       first()       {return *this;} | ||||
|       first_const_reference first() const {return *this;} | ||||
|  | ||||
|       second_reference       second()       {return *this;} | ||||
|       second_const_reference second() const {return *this;} | ||||
|       second_reference       second()       {return m_second;} | ||||
|       second_const_reference second() const {return m_second;} | ||||
|  | ||||
|       void swap(compressed_pair_imp&) {} | ||||
|       void swap(::boost::compressed_pair<T1,T2>&) {} | ||||
|    private: | ||||
|       T2 m_second; | ||||
|    }; | ||||
|  | ||||
|    // 5    T1 == T2 and are not empty:   //JM | ||||
| @@ -300,7 +315,7 @@ namespace details | ||||
|       compressed_pair_imp(first_param_type x, second_param_type y) | ||||
|          : first_(x), second_(y) {} | ||||
|  | ||||
|       explicit compressed_pair_imp(first_param_type x) | ||||
|       compressed_pair_imp(first_param_type x) | ||||
|          : first_(x), second_(x) {} | ||||
|  | ||||
|       first_reference       first()       {return first_;} | ||||
| @@ -309,10 +324,10 @@ namespace details | ||||
|       second_reference       second()       {return second_;} | ||||
|       second_const_reference second() const {return second_;} | ||||
|  | ||||
|       void swap(compressed_pair_imp<T1, T2, 5>& y) | ||||
|       void swap(::boost::compressed_pair<T1, T2>& y) | ||||
|       { | ||||
|          cp_swap(first_, y.first_); | ||||
|          cp_swap(second_, y.second_); | ||||
|          cp_swap(first_, y.first()); | ||||
|          cp_swap(second_, y.second()); | ||||
|       } | ||||
|    private: | ||||
|       first_type first_; | ||||
| @@ -396,7 +411,10 @@ public: | ||||
|  | ||||
|             compressed_pair() : base() {} | ||||
|             compressed_pair(first_param_type x, second_param_type y) : base(x, y) {} | ||||
|    explicit compressed_pair(first_param_type x) : base(x) {} | ||||
| #if !(defined(__SUNPRO_CC) && (__SUNPRO_CC <= 0x530)) | ||||
|    explicit  | ||||
| #endif | ||||
|       compressed_pair(first_param_type x) : base(x) {} | ||||
|  | ||||
|    first_reference       first()       {return base::first();} | ||||
|    first_const_reference first() const {return base::first();} | ||||
| @@ -404,7 +422,7 @@ public: | ||||
|    second_reference       second()       {return base::second();} | ||||
|    second_const_reference second() const {return base::second();} | ||||
|  | ||||
|    void swap(compressed_pair& y) { base::swap(y); } | ||||
|    void swap(::boost::compressed_pair<T,T>& y) { base::swap(y); } | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| @@ -417,6 +435,9 @@ swap(compressed_pair<T1, T2>& x, compressed_pair<T1, T2>& y) | ||||
|  | ||||
| } // boost | ||||
|  | ||||
| #ifdef BOOST_MSVC | ||||
| # pragma warning(pop) | ||||
| #endif  | ||||
|  | ||||
| #endif // BOOST_DETAIL_COMPRESSED_PAIR_HPP | ||||
|  | ||||
|  | ||||
|   | ||||
| @@ -1,14 +1,21 @@ | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
| // | ||||
| //  Crippled version for crippled compilers: | ||||
| //  see libs/utility/call_traits.htm | ||||
| // | ||||
|  | ||||
| /* Release notes: | ||||
|    01st October 2000: | ||||
|       Fixed call_traits on VC6, using "poor man's partial specialisation", | ||||
|       using ideas taken from "Generative programming" by Krzysztof Czarnecki  | ||||
|       & Ulrich Eisenecker. | ||||
| */ | ||||
|  | ||||
| #ifndef BOOST_OB_CALL_TRAITS_HPP | ||||
| #define BOOST_OB_CALL_TRAITS_HPP | ||||
|  | ||||
| @@ -16,12 +23,135 @@ | ||||
| #include <boost/config.hpp> | ||||
| #endif | ||||
|  | ||||
| #ifndef BOOST_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits.hpp> | ||||
| #ifndef BOOST_ARITHMETIC_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits/arithmetic_traits.hpp> | ||||
| #endif | ||||
| #ifndef BOOST_COMPOSITE_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits/composite_traits.hpp> | ||||
| #endif | ||||
|  | ||||
| namespace boost{ | ||||
|  | ||||
| #ifdef BOOST_MSVC6_MEMBER_TEMPLATES | ||||
| // | ||||
| // use member templates to emulate | ||||
| // partial specialisation: | ||||
| // | ||||
| namespace detail{ | ||||
|  | ||||
| template <class T> | ||||
| struct standard_call_traits | ||||
| { | ||||
|    typedef T value_type; | ||||
|    typedef T& reference; | ||||
|    typedef const T& const_reference; | ||||
|    typedef const T& param_type; | ||||
| }; | ||||
| template <class T> | ||||
| struct simple_call_traits | ||||
| { | ||||
|    typedef T value_type; | ||||
|    typedef T& reference; | ||||
|    typedef const T& const_reference; | ||||
|    typedef const T param_type; | ||||
| }; | ||||
| template <class T> | ||||
| struct reference_call_traits | ||||
| { | ||||
|    typedef T value_type; | ||||
|    typedef T reference; | ||||
|    typedef T const_reference; | ||||
|    typedef T param_type; | ||||
| }; | ||||
|  | ||||
| template <bool pointer, bool arithmetic, bool reference> | ||||
| struct call_traits_chooser | ||||
| { | ||||
|    template <class T> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef standard_call_traits<T> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct call_traits_chooser<true, false, false> | ||||
| { | ||||
|    template <class T> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef simple_call_traits<T> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct call_traits_chooser<false, false, true> | ||||
| { | ||||
|    template <class T> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef reference_call_traits<T> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <bool size_is_small>  | ||||
| struct call_traits_sizeof_chooser2 | ||||
| { | ||||
|    template <class T> | ||||
|    struct small_rebind | ||||
|    { | ||||
|       typedef simple_call_traits<T> small_type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template<>  | ||||
| struct call_traits_sizeof_chooser2<false> | ||||
| { | ||||
|    template <class T> | ||||
|    struct small_rebind | ||||
|    { | ||||
|       typedef standard_call_traits<T> small_type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct call_traits_chooser<false, true, false> | ||||
| { | ||||
|    template <class T> | ||||
|    struct rebind | ||||
|    { | ||||
|       enum { sizeof_choice = (sizeof(T) <= sizeof(void*)) }; | ||||
|       typedef call_traits_sizeof_chooser2<(sizeof(T) <= sizeof(void*))> chooser; | ||||
|       typedef typename chooser::template small_rebind<T> bound_type; | ||||
|       typedef typename bound_type::small_type type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| } // namespace detail | ||||
| template <typename T> | ||||
| struct call_traits | ||||
| { | ||||
| private: | ||||
|     typedef detail::call_traits_chooser< | ||||
|          ::boost::is_pointer<T>::value, | ||||
|          ::boost::is_arithmetic<T>::value,  | ||||
|          ::boost::is_reference<T>::value | ||||
|       > chooser; | ||||
|    typedef typename chooser::template rebind<T> bound_type; | ||||
|    typedef typename bound_type::type call_traits_type; | ||||
| public: | ||||
|    typedef typename call_traits_type::value_type       value_type; | ||||
|    typedef typename call_traits_type::reference        reference; | ||||
|    typedef typename call_traits_type::const_reference  const_reference; | ||||
|    typedef typename call_traits_type::param_type       param_type; | ||||
| }; | ||||
|  | ||||
| #else | ||||
| // | ||||
| // sorry call_traits is completely non-functional | ||||
| // blame your broken compiler: | ||||
| // | ||||
|  | ||||
| template <typename T> | ||||
| struct call_traits | ||||
| { | ||||
| @@ -31,6 +161,8 @@ struct call_traits | ||||
|    typedef const T& param_type; | ||||
| }; | ||||
|  | ||||
| #endif // member templates | ||||
|  | ||||
| } | ||||
|  | ||||
| #endif // BOOST_OB_CALL_TRAITS_HPP | ||||
|   | ||||
| @@ -1,13 +1,18 @@ | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
| //  Use, modification and distribution are subject to the Boost Software License, | ||||
| //  Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt). | ||||
| // | ||||
| //  See http://www.boost.org/libs/utility for most recent version including documentation. | ||||
| //  see libs/utility/compressed_pair.hpp | ||||
| // | ||||
| /* Release notes: | ||||
|    20 Jan 2001: | ||||
|         Fixed obvious bugs (David Abrahams) | ||||
|    07 Oct 2000: | ||||
|       Added better single argument constructor support. | ||||
|    03 Oct 2000: | ||||
|       Added VC6 support (JM). | ||||
|    23rd July 2000: | ||||
|       Additional comments added. (JM) | ||||
|    Jan 2000: | ||||
| @@ -20,8 +25,11 @@ | ||||
| #define BOOST_OB_COMPRESSED_PAIR_HPP | ||||
|  | ||||
| #include <algorithm> | ||||
| #ifndef BOOST_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits.hpp> | ||||
| #ifndef BOOST_OBJECT_TYPE_TRAITS_HPP | ||||
| #include <boost/type_traits/object_traits.hpp> | ||||
| #endif | ||||
| #ifndef BOOST_SAME_TRAITS_HPP | ||||
| #include <boost/type_traits/same_traits.hpp> | ||||
| #endif | ||||
| #ifndef BOOST_CALL_TRAITS_HPP | ||||
| #include <boost/call_traits.hpp> | ||||
| @@ -29,6 +37,426 @@ | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
| #ifdef BOOST_MSVC6_MEMBER_TEMPLATES | ||||
| // | ||||
| // use member templates to emulate | ||||
| // partial specialisation.  Note that due to | ||||
| // problems with overload resolution with VC6 | ||||
| // each of the compressed_pair versions that follow | ||||
| // have one template single-argument constructor | ||||
| // in place of two specific constructors: | ||||
| // | ||||
|  | ||||
| template <class T1, class T2> | ||||
| class compressed_pair; | ||||
|  | ||||
| namespace detail{ | ||||
|  | ||||
| template <class A, class T1, class T2> | ||||
| struct best_conversion_traits | ||||
| { | ||||
|    typedef char one; | ||||
|    typedef char (&two)[2]; | ||||
|    static A a; | ||||
|    static one test(T1); | ||||
|    static two test(T2); | ||||
|  | ||||
|    enum { value = sizeof(test(a)) }; | ||||
| }; | ||||
|  | ||||
| template <int> | ||||
| struct init_one; | ||||
|  | ||||
| template <> | ||||
| struct init_one<1> | ||||
| { | ||||
|    template <class A, class T1, class T2> | ||||
|    static void init(const A& a, T1* p1, T2*) | ||||
|    { | ||||
|       *p1 = a; | ||||
|    } | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct init_one<2> | ||||
| { | ||||
|    template <class A, class T1, class T2> | ||||
|    static void init(const A& a, T1*, T2* p2) | ||||
|    { | ||||
|       *p2 = a; | ||||
|    } | ||||
| }; | ||||
|  | ||||
|  | ||||
| // T1 != T2, both non-empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_0 | ||||
| { | ||||
| private: | ||||
|    T1 _first; | ||||
|    T2 _second; | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_0() : _first(), _second() {} | ||||
|             compressed_pair_0(first_param_type x, second_param_type y) : _first(x), _second(y) {} | ||||
|    template <class A> | ||||
|    explicit compressed_pair_0(const A& val) | ||||
|    { | ||||
|       init_one<best_conversion_traits<A, T1, T2>::value>::init(val, &_first, &_second); | ||||
|    } | ||||
|    compressed_pair_0(const ::boost::compressed_pair<T1,T2>& x) | ||||
|       : _first(x.first()), _second(x.second()) {} | ||||
|  | ||||
| #if 0 | ||||
|   compressed_pair_0& operator=(const compressed_pair_0& x) { | ||||
|     cout << "assigning compressed pair 0" << endl; | ||||
|     _first = x._first; | ||||
|     _second = x._second; | ||||
|     cout << "finished assigning compressed pair 0" << endl; | ||||
|     return *this; | ||||
|   } | ||||
| #endif | ||||
|  | ||||
|    first_reference       first()       { return _first; } | ||||
|    first_const_reference first() const { return _first; } | ||||
|  | ||||
|    second_reference       second()       { return _second; } | ||||
|    second_const_reference second() const { return _second; } | ||||
|  | ||||
|    void swap(compressed_pair_0& y) | ||||
|    { | ||||
|       using std::swap; | ||||
|       swap(_first, y._first); | ||||
|       swap(_second, y._second); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| // T1 != T2, T2 empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_1 : T2 | ||||
| { | ||||
| private: | ||||
|    T1 _first; | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_1() : T2(), _first() {} | ||||
|             compressed_pair_1(first_param_type x, second_param_type y) : T2(y), _first(x) {} | ||||
|  | ||||
|    template <class A> | ||||
|    explicit compressed_pair_1(const A& val) | ||||
|    { | ||||
|       init_one<best_conversion_traits<A, T1, T2>::value>::init(val, &_first, static_cast<T2*>(this)); | ||||
|    } | ||||
|  | ||||
|    compressed_pair_1(const ::boost::compressed_pair<T1,T2>& x) | ||||
|       : T2(x.second()), _first(x.first()) {} | ||||
|  | ||||
| #if defined(BOOST_MSVC) && BOOST_MSVC <= 1300 | ||||
|   // Total weirdness. If the assignment to _first is moved after | ||||
|   // the call to the inherited operator=, then this breaks graph/test/graph.cpp | ||||
|   // by way of iterator_adaptor. | ||||
|   compressed_pair_1& operator=(const compressed_pair_1& x) { | ||||
|     _first = x._first; | ||||
|     T2::operator=(x); | ||||
|     return *this; | ||||
|   } | ||||
| #endif | ||||
|  | ||||
|    first_reference       first()       { return _first; } | ||||
|    first_const_reference first() const { return _first; } | ||||
|  | ||||
|    second_reference       second()       { return *this; } | ||||
|    second_const_reference second() const { return *this; } | ||||
|  | ||||
|    void swap(compressed_pair_1& y) | ||||
|    { | ||||
|       // no need to swap empty base class: | ||||
|       using std::swap; | ||||
|       swap(_first, y._first); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| // T1 != T2, T1 empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_2 : T1 | ||||
| { | ||||
| private: | ||||
|    T2 _second; | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_2() : T1(), _second() {} | ||||
|             compressed_pair_2(first_param_type x, second_param_type y) : T1(x), _second(y) {} | ||||
|    template <class A> | ||||
|    explicit compressed_pair_2(const A& val) | ||||
|    { | ||||
|       init_one<best_conversion_traits<A, T1, T2>::value>::init(val, static_cast<T1*>(this), &_second); | ||||
|    } | ||||
|    compressed_pair_2(const ::boost::compressed_pair<T1,T2>& x) | ||||
|       : T1(x.first()), _second(x.second()) {} | ||||
|  | ||||
| #if 0 | ||||
|   compressed_pair_2& operator=(const compressed_pair_2& x) { | ||||
|     cout << "assigning compressed pair 2" << endl; | ||||
|     T1::operator=(x); | ||||
|     _second = x._second; | ||||
|     cout << "finished assigning compressed pair 2" << endl; | ||||
|     return *this; | ||||
|   } | ||||
| #endif | ||||
|    first_reference       first()       { return *this; } | ||||
|    first_const_reference first() const { return *this; } | ||||
|  | ||||
|    second_reference       second()       { return _second; } | ||||
|    second_const_reference second() const { return _second; } | ||||
|  | ||||
|    void swap(compressed_pair_2& y) | ||||
|    { | ||||
|       // no need to swap empty base class: | ||||
|       using std::swap; | ||||
|       swap(_second, y._second); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| // T1 != T2, both empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_3 : T1, T2 | ||||
| { | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_3() : T1(), T2() {} | ||||
|             compressed_pair_3(first_param_type x, second_param_type y) : T1(x), T2(y) {} | ||||
|    template <class A> | ||||
|    explicit compressed_pair_3(const A& val) | ||||
|    { | ||||
|       init_one<best_conversion_traits<A, T1, T2>::value>::init(val, static_cast<T1*>(this), static_cast<T2*>(this)); | ||||
|    } | ||||
|    compressed_pair_3(const ::boost::compressed_pair<T1,T2>& x) | ||||
|       : T1(x.first()), T2(x.second()) {} | ||||
|  | ||||
|    first_reference       first()       { return *this; } | ||||
|    first_const_reference first() const { return *this; } | ||||
|  | ||||
|    second_reference       second()       { return *this; } | ||||
|    second_const_reference second() const { return *this; } | ||||
|  | ||||
|    void swap(compressed_pair_3& y) | ||||
|    { | ||||
|       // no need to swap empty base classes: | ||||
|    } | ||||
| }; | ||||
|  | ||||
| // T1 == T2, and empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_4 : T1 | ||||
| { | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_4() : T1() {} | ||||
|             compressed_pair_4(first_param_type x, second_param_type y) : T1(x), m_second(y) {} | ||||
|    // only one single argument constructor since T1 == T2 | ||||
|    explicit compressed_pair_4(first_param_type x) : T1(x), m_second(x) {} | ||||
|    compressed_pair_4(const ::boost::compressed_pair<T1,T2>& x) | ||||
|       : T1(x.first()), m_second(x.second()) {} | ||||
|  | ||||
|    first_reference       first()       { return *this; } | ||||
|    first_const_reference first() const { return *this; } | ||||
|  | ||||
|    second_reference       second()       { return m_second; } | ||||
|    second_const_reference second() const { return m_second; } | ||||
|  | ||||
|    void swap(compressed_pair_4& y) | ||||
|    { | ||||
|       // no need to swap empty base classes: | ||||
|    } | ||||
| private: | ||||
|    T2 m_second; | ||||
| }; | ||||
|  | ||||
| // T1 == T2, not empty | ||||
| template <class T1, class T2> | ||||
| class compressed_pair_5 | ||||
| { | ||||
| private: | ||||
|    T1 _first; | ||||
|    T2 _second; | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair_5() : _first(), _second() {} | ||||
|             compressed_pair_5(first_param_type x, second_param_type y) : _first(x), _second(y) {} | ||||
|    // only one single argument constructor since T1 == T2 | ||||
|    explicit compressed_pair_5(first_param_type x) : _first(x), _second(x) {} | ||||
|    compressed_pair_5(const ::boost::compressed_pair<T1,T2>& c)  | ||||
|       : _first(c.first()), _second(c.second()) {} | ||||
|  | ||||
|    first_reference       first()       { return _first; } | ||||
|    first_const_reference first() const { return _first; } | ||||
|  | ||||
|    second_reference       second()       { return _second; } | ||||
|    second_const_reference second() const { return _second; } | ||||
|  | ||||
|    void swap(compressed_pair_5& y) | ||||
|    { | ||||
|       using std::swap; | ||||
|       swap(_first, y._first); | ||||
|       swap(_second, y._second); | ||||
|    } | ||||
| }; | ||||
|  | ||||
| template <bool e1, bool e2, bool same> | ||||
| struct compressed_pair_chooser | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_0<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct compressed_pair_chooser<false, true, false> | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_1<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct compressed_pair_chooser<true, false, false> | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_2<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct compressed_pair_chooser<true, true, false> | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_3<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct compressed_pair_chooser<true, true, true> | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_4<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <> | ||||
| struct compressed_pair_chooser<false, false, true> | ||||
| { | ||||
|    template <class T1, class T2> | ||||
|    struct rebind | ||||
|    { | ||||
|       typedef compressed_pair_5<T1, T2> type; | ||||
|    }; | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| struct compressed_pair_traits | ||||
| { | ||||
| private: | ||||
|    typedef compressed_pair_chooser<is_empty<T1>::value, is_empty<T2>::value, is_same<T1,T2>::value> chooser; | ||||
|    typedef typename chooser::template rebind<T1, T2> bound_type; | ||||
| public: | ||||
|    typedef typename bound_type::type type; | ||||
| }; | ||||
|  | ||||
| } // namespace detail | ||||
|  | ||||
| template <class T1, class T2> | ||||
| class compressed_pair : public detail::compressed_pair_traits<T1, T2>::type | ||||
| { | ||||
| private: | ||||
|    typedef typename detail::compressed_pair_traits<T1, T2>::type base_type; | ||||
| public: | ||||
|    typedef T1                                                 first_type; | ||||
|    typedef T2                                                 second_type; | ||||
|    typedef typename call_traits<first_type>::param_type       first_param_type; | ||||
|    typedef typename call_traits<second_type>::param_type      second_param_type; | ||||
|    typedef typename call_traits<first_type>::reference        first_reference; | ||||
|    typedef typename call_traits<second_type>::reference       second_reference; | ||||
|    typedef typename call_traits<first_type>::const_reference  first_const_reference; | ||||
|    typedef typename call_traits<second_type>::const_reference second_const_reference; | ||||
|  | ||||
|             compressed_pair() : base_type() {} | ||||
|             compressed_pair(first_param_type x, second_param_type y) : base_type(x, y) {} | ||||
|    template <class A> | ||||
|    explicit compressed_pair(const A& x) : base_type(x){} | ||||
|  | ||||
|    first_reference       first()       { return base_type::first(); } | ||||
|    first_const_reference first() const { return base_type::first(); } | ||||
|  | ||||
|    second_reference       second()       { return base_type::second(); } | ||||
|    second_const_reference second() const { return base_type::second(); } | ||||
| }; | ||||
|  | ||||
| template <class T1, class T2> | ||||
| inline void swap(compressed_pair<T1, T2>& x, compressed_pair<T1, T2>& y) | ||||
| { | ||||
|    x.swap(y); | ||||
| } | ||||
|  | ||||
| #else | ||||
| // no partial specialisation, no member templates: | ||||
|  | ||||
| template <class T1, class T2> | ||||
| class compressed_pair | ||||
| @@ -72,7 +500,11 @@ inline void swap(compressed_pair<T1, T2>& x, compressed_pair<T1, T2>& y) | ||||
|    x.swap(y); | ||||
| } | ||||
|  | ||||
| #endif | ||||
|  | ||||
| } // boost | ||||
|  | ||||
| #endif // BOOST_OB_COMPRESSED_PAIR_HPP | ||||
|  | ||||
|  | ||||
|  | ||||
|   | ||||
							
								
								
									
										80
									
								
								include/boost/generator_iterator.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										80
									
								
								include/boost/generator_iterator.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,80 @@ | ||||
| // (C) Copyright Jens Maurer 2001. | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // Revision History: | ||||
|  | ||||
| // 15 Nov 2001   Jens Maurer | ||||
| //      created. | ||||
|  | ||||
| //  See http://www.boost.org/libs/utility/iterator_adaptors.htm for documentation. | ||||
|  | ||||
| #ifndef BOOST_ITERATOR_ADAPTOR_GENERATOR_ITERATOR_HPP | ||||
| #define BOOST_ITERATOR_ADAPTOR_GENERATOR_ITERATOR_HPP | ||||
|  | ||||
| #include <boost/iterator/iterator_facade.hpp> | ||||
| #include <boost/ref.hpp> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| template<class Generator> | ||||
| class generator_iterator | ||||
|   : public iterator_facade< | ||||
|         generator_iterator<Generator> | ||||
|       , typename Generator::result_type | ||||
|       , single_pass_traversal_tag | ||||
|       , typename Generator::result_type const& | ||||
|     > | ||||
| { | ||||
|     typedef iterator_facade< | ||||
|         generator_iterator<Generator> | ||||
|       , typename Generator::result_type | ||||
|       , single_pass_traversal_tag | ||||
|       , typename Generator::result_type const& | ||||
|     > super_t; | ||||
|      | ||||
|  public: | ||||
|     generator_iterator() {} | ||||
|     generator_iterator(Generator* g) : m_g(g), m_value((*m_g)()) {} | ||||
|  | ||||
|     void increment() | ||||
|     { | ||||
|         m_value = (*m_g)(); | ||||
|     } | ||||
|  | ||||
|     const typename Generator::result_type& | ||||
|     dereference() const | ||||
|     { | ||||
|         return m_value; | ||||
|     } | ||||
|  | ||||
|     bool equal(generator_iterator const& y) const | ||||
|     { | ||||
|         return this->m_g == y.m_g && this->m_value == y.m_value; | ||||
|     } | ||||
|  | ||||
|  private: | ||||
|     Generator* m_g; | ||||
|     typename Generator::result_type m_value; | ||||
| }; | ||||
|  | ||||
| template<class Generator> | ||||
| struct generator_iterator_generator | ||||
| { | ||||
|   typedef generator_iterator<Generator> type; | ||||
| }; | ||||
|  | ||||
| template <class Generator> | ||||
| inline generator_iterator<Generator> | ||||
| make_generator_iterator(Generator & gen) | ||||
| { | ||||
|   typedef generator_iterator<Generator> result_t; | ||||
|   return result_t(&gen); | ||||
| } | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
|  | ||||
| #endif // BOOST_ITERATOR_ADAPTOR_GENERATOR_ITERATOR_HPP | ||||
|  | ||||
							
								
								
									
										51
									
								
								include/boost/next_prior.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										51
									
								
								include/boost/next_prior.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,51 @@ | ||||
| //  Boost next_prior.hpp header file  ---------------------------------------// | ||||
|  | ||||
| //  (C) Copyright Dave Abrahams and Daniel Walker 1999-2003. Distributed under the Boost | ||||
| //  Software License, Version 1.0. (See accompanying file | ||||
| //  LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org/libs/utility for documentation. | ||||
|  | ||||
| //  Revision History | ||||
| //  13 Dec 2003  Added next(x, n) and prior(x, n) (Daniel Walker) | ||||
|  | ||||
| #ifndef BOOST_NEXT_PRIOR_HPP_INCLUDED | ||||
| #define BOOST_NEXT_PRIOR_HPP_INCLUDED | ||||
|  | ||||
| #include <iterator> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| //  Helper functions for classes like bidirectional iterators not supporting | ||||
| //  operator+ and operator- | ||||
| // | ||||
| //  Usage: | ||||
| //    const std::list<T>::iterator p = get_some_iterator(); | ||||
| //    const std::list<T>::iterator prev = boost::prior(p); | ||||
| //    const std::list<T>::iterator next = boost::next(prev, 2); | ||||
|  | ||||
| //  Contributed by Dave Abrahams | ||||
|  | ||||
| template <class T> | ||||
| inline T next(T x) { return ++x; } | ||||
|  | ||||
| template <class T, class Distance> | ||||
| inline T next(T x, Distance n) | ||||
| { | ||||
|     std::advance(x, n); | ||||
|     return x; | ||||
| } | ||||
|  | ||||
| template <class T> | ||||
| inline T prior(T x) { return --x; } | ||||
|  | ||||
| template <class T, class Distance> | ||||
| inline T prior(T x, Distance n) | ||||
| { | ||||
|     std::advance(x, -n); | ||||
|     return x; | ||||
| } | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif  // BOOST_NEXT_PRIOR_HPP_INCLUDED | ||||
							
								
								
									
										36
									
								
								include/boost/noncopyable.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								include/boost/noncopyable.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| //  Boost noncopyable.hpp header file  --------------------------------------// | ||||
|  | ||||
| //  (C) Copyright Beman Dawes 1999-2003. Distributed under the Boost | ||||
| //  Software License, Version 1.0. (See accompanying file | ||||
| //  LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org/libs/utility for documentation. | ||||
|  | ||||
| #ifndef BOOST_NONCOPYABLE_HPP_INCLUDED | ||||
| #define BOOST_NONCOPYABLE_HPP_INCLUDED | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| //  Private copy constructor and copy assignment ensure classes derived from | ||||
| //  class noncopyable cannot be copied. | ||||
|  | ||||
| //  Contributed by Dave Abrahams | ||||
|  | ||||
| namespace noncopyable_  // protection from unintended ADL | ||||
| { | ||||
|   class noncopyable | ||||
|   { | ||||
|    protected: | ||||
|       noncopyable() {} | ||||
|       ~noncopyable() {} | ||||
|    private:  // emphasize the following members are private | ||||
|       noncopyable( const noncopyable& ); | ||||
|       const noncopyable& operator=( const noncopyable& ); | ||||
|   }; | ||||
| } | ||||
|  | ||||
| typedef noncopyable_::noncopyable noncopyable; | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif  // BOOST_NONCOPYABLE_HPP_INCLUDED | ||||
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
							
								
								
									
										178
									
								
								include/boost/ref.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										178
									
								
								include/boost/ref.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,178 @@ | ||||
| #ifndef BOOST_REF_HPP_INCLUDED | ||||
| #define BOOST_REF_HPP_INCLUDED | ||||
|  | ||||
| // MS compatible compilers support #pragma once | ||||
|  | ||||
| #if defined(_MSC_VER) && (_MSC_VER >= 1020) | ||||
| # pragma once | ||||
| #endif | ||||
|  | ||||
| #include <boost/config.hpp> | ||||
| #include <boost/utility/addressof.hpp> | ||||
| #include <boost/mpl/bool.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
|  | ||||
| // | ||||
| //  ref.hpp - ref/cref, useful helper functions | ||||
| // | ||||
| //  Copyright (C) 1999, 2000 Jaakko J<>rvi (jaakko.jarvi@cs.utu.fi) | ||||
| //  Copyright (C) 2001, 2002 Peter Dimov | ||||
| //  Copyright (C) 2002 David Abrahams | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| //  See http://www.boost.org/libs/bind/ref.html for documentation. | ||||
| // | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| template<class T> class reference_wrapper | ||||
| {  | ||||
| public: | ||||
|     typedef T type; | ||||
|  | ||||
| #if defined( BOOST_MSVC ) && BOOST_WORKAROUND( BOOST_MSVC, < 1300 ) | ||||
|  | ||||
|     explicit reference_wrapper(T& t): t_(&t) {} | ||||
|  | ||||
| #else | ||||
|  | ||||
|     explicit reference_wrapper(T& t): t_(boost::addressof(t)) {} | ||||
|  | ||||
| #endif | ||||
|  | ||||
|     operator T& () const { return *t_; } | ||||
|  | ||||
|     T& get() const { return *t_; } | ||||
|  | ||||
|     T* get_pointer() const { return t_; } | ||||
|  | ||||
| private: | ||||
|  | ||||
|     T* t_; | ||||
| }; | ||||
|  | ||||
| # if defined( __BORLANDC__ ) && BOOST_WORKAROUND( __BORLANDC__, BOOST_TESTED_AT(0x581) ) | ||||
| #  define BOOST_REF_CONST | ||||
| # else | ||||
| #  define BOOST_REF_CONST const | ||||
| # endif | ||||
|  | ||||
| template<class T> inline reference_wrapper<T> BOOST_REF_CONST ref(T & t) | ||||
| {  | ||||
|     return reference_wrapper<T>(t); | ||||
| } | ||||
|  | ||||
| template<class T> inline reference_wrapper<T const> BOOST_REF_CONST cref(T const & t) | ||||
| { | ||||
|     return reference_wrapper<T const>(t); | ||||
| } | ||||
|  | ||||
| # undef BOOST_REF_CONST | ||||
|  | ||||
| # ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|  | ||||
| template<typename T> | ||||
| class is_reference_wrapper | ||||
|     : public mpl::false_ | ||||
| { | ||||
| }; | ||||
|  | ||||
| template<typename T> | ||||
| class unwrap_reference | ||||
| { | ||||
|  public: | ||||
|     typedef T type; | ||||
| }; | ||||
|  | ||||
| #  define AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF(X) \ | ||||
| template<typename T> \ | ||||
| class is_reference_wrapper< X > \ | ||||
|     : public mpl::true_ \ | ||||
| { \ | ||||
| }; \ | ||||
| \ | ||||
| template<typename T> \ | ||||
| class unwrap_reference< X > \ | ||||
| { \ | ||||
|  public: \ | ||||
|     typedef T type; \ | ||||
| }; \ | ||||
| /**/ | ||||
|  | ||||
| AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF(reference_wrapper<T>) | ||||
| #if !defined(BOOST_NO_CV_SPECIALIZATIONS) | ||||
| AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF(reference_wrapper<T> const) | ||||
| AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF(reference_wrapper<T> volatile) | ||||
| AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF(reference_wrapper<T> const volatile) | ||||
| #endif | ||||
|  | ||||
| #  undef AUX_REFERENCE_WRAPPER_METAFUNCTIONS_DEF | ||||
|  | ||||
| # else // no partial specialization | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #include <boost/type.hpp> | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| namespace detail | ||||
| { | ||||
|   typedef char (&yes_reference_wrapper_t)[1]; | ||||
|   typedef char (&no_reference_wrapper_t)[2]; | ||||
|        | ||||
|   no_reference_wrapper_t is_reference_wrapper_test(...); | ||||
|  | ||||
|   template<typename T> | ||||
|   yes_reference_wrapper_t is_reference_wrapper_test(type< reference_wrapper<T> >); | ||||
|  | ||||
|   template<bool wrapped> | ||||
|   struct reference_unwrapper | ||||
|   { | ||||
|       template <class T> | ||||
|       struct apply | ||||
|       { | ||||
|           typedef T type; | ||||
|       }; | ||||
|   }; | ||||
|  | ||||
|   template<> | ||||
|   struct reference_unwrapper<true> | ||||
|   { | ||||
|       template <class T> | ||||
|       struct apply | ||||
|       { | ||||
|           typedef typename T::type type; | ||||
|       }; | ||||
|   }; | ||||
| } | ||||
|  | ||||
| template<typename T> | ||||
| class is_reference_wrapper | ||||
| { | ||||
|  public: | ||||
|     BOOST_STATIC_CONSTANT( | ||||
|         bool, value = ( | ||||
|              sizeof(detail::is_reference_wrapper_test(type<T>())) | ||||
|             == sizeof(detail::yes_reference_wrapper_t))); | ||||
|      | ||||
|     typedef ::boost::mpl::bool_<value> type; | ||||
| }; | ||||
|  | ||||
| template <typename T> | ||||
| class unwrap_reference | ||||
|     : public detail::reference_unwrapper< | ||||
|         is_reference_wrapper<T>::value | ||||
|       >::template apply<T> | ||||
| {}; | ||||
|  | ||||
| # endif // BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif // #ifndef BOOST_REF_HPP_INCLUDED | ||||
| @@ -1,96 +1,19 @@ | ||||
| //  boost utility.hpp header file  -------------------------------------------// | ||||
| //  Boost utility.hpp header file  -------------------------------------------// | ||||
|  | ||||
| //  (C) Copyright boost.org 1999. Permission to copy, use, modify, sell | ||||
| //  and distribute this software is granted provided this copyright | ||||
| //  notice appears in all copies. This software is provided "as is" without | ||||
| //  express or implied warranty, and with no claim as to its suitability for | ||||
| //  any purpose. | ||||
| //  Copyright 1999-2003 Aleksey Gurtovoy.  Use, modification, and distribution are | ||||
| //  subject to the Boost Software License, Version 1.0.  (See accompanying file | ||||
| //  LICENSE_1_0.txt or a copy at <http://www.boost.org/LICENSE_1_0.txt>.) | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
|  | ||||
| //  Classes appear in alphabetical order | ||||
|  | ||||
| //  Revision History | ||||
| //  26 Jan 00  protected noncopyable destructor added (Miki Jovanovic) | ||||
| //  10 Dec 99  next() and prior() templates added (Dave Abrahams) | ||||
| //  30 Aug 99  moved cast templates to cast.hpp (Beman Dawes) | ||||
| //   3 Aug 99  cast templates added | ||||
| //  20 Jul 99  name changed to utility.hpp  | ||||
| //   9 Jun 99  protected noncopyable default ctor | ||||
| //   2 Jun 99  Initial Version. Class noncopyable only contents (Dave Abrahams) | ||||
| //  See <http://www.boost.org/libs/utility/> for the library's home page. | ||||
|  | ||||
| #ifndef BOOST_UTILITY_HPP | ||||
| #define BOOST_UTILITY_HPP | ||||
|  | ||||
| #include <boost/config.hpp> | ||||
| #include <cstddef>            // for size_t | ||||
| #include <utility>            // for std::pair | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| //  next() and prior() template functions  -----------------------------------// | ||||
|  | ||||
|     //  Helper functions for classes like bidirectional iterators not supporting | ||||
|     //  operator+ and operator-. | ||||
|     // | ||||
|     //  Usage: | ||||
|     //    const std::list<T>::iterator p = get_some_iterator(); | ||||
|     //    const std::list<T>::iterator prev = boost::prior(p); | ||||
|  | ||||
|     //  Contributed by Dave Abrahams | ||||
|  | ||||
|     template <class T> | ||||
|     T next(T x) { return ++x; } | ||||
|  | ||||
|     template <class T> | ||||
|     T prior(T x) { return --x; } | ||||
|  | ||||
|  | ||||
| //  class noncopyable  -------------------------------------------------------// | ||||
|  | ||||
|     //  Private copy constructor and copy assignment ensure classes derived from | ||||
|     //  class noncopyable cannot be copied. | ||||
|  | ||||
|     //  Contributed by Dave Abrahams | ||||
|  | ||||
|     class noncopyable | ||||
|     { | ||||
|     protected: | ||||
|         noncopyable(){} | ||||
|         ~noncopyable(){} | ||||
|     private:  // emphasize the following members are private | ||||
|         noncopyable( const noncopyable& ); | ||||
|         const noncopyable& operator=( const noncopyable& ); | ||||
|     }; // noncopyable | ||||
|  | ||||
| //  class tied  -------------------------------------------------------// | ||||
|  | ||||
|     // A helper for conveniently assigning the two values from a pair | ||||
|     // into separate variables. The idea for this comes from Jaakko J<>rvi's | ||||
|     // Binder/Lambda Library. | ||||
|  | ||||
|     // Constributed by Jeremy Siek | ||||
|  | ||||
|     template <class A, class B> | ||||
|     class tied { | ||||
|     public: | ||||
|       inline tied(A& a, B& b) : _a(a), _b(b) { } | ||||
|       template <class U, class V> | ||||
|       inline tied& operator=(const std::pair<U,V>& p) { | ||||
| 	_a = p.first; | ||||
| 	_b = p.second; | ||||
| 	return *this; | ||||
|       } | ||||
|     protected: | ||||
|       A& _a; | ||||
|       B& _b; | ||||
|     }; | ||||
|  | ||||
|     template <class A, class B> | ||||
|     inline tied<A,B> tie(A& a, B& b) { return tied<A,B>(a, b); } | ||||
|  | ||||
| } // namespace boost | ||||
| #include <boost/utility/addressof.hpp> | ||||
| #include <boost/utility/base_from_member.hpp>   | ||||
| #include <boost/utility/enable_if.hpp> | ||||
| #include <boost/checked_delete.hpp> | ||||
| #include <boost/next_prior.hpp> | ||||
| #include <boost/noncopyable.hpp> | ||||
|  | ||||
| #endif  // BOOST_UTILITY_HPP | ||||
|  | ||||
|   | ||||
							
								
								
									
										58
									
								
								include/boost/utility/addressof.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										58
									
								
								include/boost/utility/addressof.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,58 @@ | ||||
| // Copyright (C) 2002 Brad King (brad.king@kitware.com)  | ||||
| //                    Douglas Gregor (gregod@cs.rpi.edu) | ||||
| //                    Peter Dimov | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // For more information, see http://www.boost.org | ||||
|  | ||||
| #ifndef BOOST_UTILITY_ADDRESSOF_HPP | ||||
| # define BOOST_UTILITY_ADDRESSOF_HPP | ||||
|  | ||||
| # include <boost/config.hpp> | ||||
| # include <boost/detail/workaround.hpp> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| // Do not make addressof() inline. Breaks MSVC 7. (Peter Dimov) | ||||
|  | ||||
| // VC7 strips const from nested classes unless we add indirection here | ||||
| # if BOOST_WORKAROUND(BOOST_MSVC, == 1300) | ||||
|  | ||||
| template<class T> struct _addp | ||||
| { | ||||
|     typedef T * type; | ||||
| }; | ||||
|      | ||||
| template <typename T> typename _addp<T>::type | ||||
|  | ||||
| # else | ||||
| template <typename T> T* | ||||
| # endif | ||||
| addressof(T& v) | ||||
| { | ||||
|   return reinterpret_cast<T*>( | ||||
|        &const_cast<char&>(reinterpret_cast<const volatile char &>(v))); | ||||
| } | ||||
|  | ||||
| // Borland doesn't like casting an array reference to a char reference | ||||
| // but these overloads work around the problem. | ||||
| # if BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) | ||||
| template<typename T,std::size_t N> | ||||
| T (*addressof(T (&t)[N]))[N] | ||||
| { | ||||
|    return reinterpret_cast<T(*)[N]>(&t); | ||||
| } | ||||
|  | ||||
| template<typename T,std::size_t N> | ||||
| const T (*addressof(const T (&t)[N]))[N] | ||||
| { | ||||
|    return reinterpret_cast<const T(*)[N]>(&t); | ||||
| } | ||||
| # endif | ||||
|  | ||||
| } | ||||
|  | ||||
| #endif // BOOST_UTILITY_ADDRESSOF_HPP | ||||
							
								
								
									
										87
									
								
								include/boost/utility/base_from_member.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										87
									
								
								include/boost/utility/base_from_member.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,87 @@ | ||||
| //  boost utility/base_from_member.hpp header file  --------------------------// | ||||
|  | ||||
| //  Copyright 2001, 2003, 2004 Daryle Walker.  Use, modification, and | ||||
| //  distribution are subject to the Boost Software License, Version 1.0.  (See | ||||
| //  accompanying file LICENSE_1_0.txt or a copy at | ||||
| //  <http://www.boost.org/LICENSE_1_0.txt>.) | ||||
|  | ||||
| //  See <http://www.boost.org/libs/utility/> for the library's home page. | ||||
|  | ||||
| #ifndef BOOST_UTILITY_BASE_FROM_MEMBER_HPP | ||||
| #define BOOST_UTILITY_BASE_FROM_MEMBER_HPP | ||||
|  | ||||
| #include <boost/preprocessor/arithmetic/inc.hpp> | ||||
| #include <boost/preprocessor/repetition/enum_binary_params.hpp> | ||||
| #include <boost/preprocessor/repetition/enum_params.hpp> | ||||
| #include <boost/preprocessor/repetition/repeat_from_to.hpp> | ||||
|  | ||||
|  | ||||
| //  Base-from-member arity configuration macro  ------------------------------// | ||||
|  | ||||
| // The following macro determines how many arguments will be in the largest | ||||
| // constructor template of base_from_member.  Constructor templates will be | ||||
| // generated from one argument to this maximum.  Code from other files can read | ||||
| // this number if they need to always match the exact maximum base_from_member | ||||
| // uses.  The maximum constructor length can be changed by overriding the | ||||
| // #defined constant.  Make sure to apply the override, if any, for all source | ||||
| // files during project compiling for consistency. | ||||
|  | ||||
| // Contributed by Jonathan Turkanis | ||||
|  | ||||
| #ifndef BOOST_BASE_FROM_MEMBER_MAX_ARITY | ||||
| #define BOOST_BASE_FROM_MEMBER_MAX_ARITY  10 | ||||
| #endif | ||||
|  | ||||
|  | ||||
| //  An iteration of a constructor template for base_from_member  -------------// | ||||
|  | ||||
| // A macro that should expand to: | ||||
| //     template < typename T1, ..., typename Tn > | ||||
| //     base_from_member( T1 x1, ..., Tn xn ) | ||||
| //         : member( x1, ..., xn ) | ||||
| //         {} | ||||
| // This macro should only persist within this file. | ||||
|  | ||||
| #define BOOST_PRIVATE_CTR_DEF( z, n, data )                            \ | ||||
|     template < BOOST_PP_ENUM_PARAMS(n, typename T) >                   \ | ||||
|     explicit base_from_member( BOOST_PP_ENUM_BINARY_PARAMS(n, T, x) )  \ | ||||
|         : member( BOOST_PP_ENUM_PARAMS(n, x) )                         \ | ||||
|         {}                                                             \ | ||||
|     /**/ | ||||
|  | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| //  Base-from-member class template  -----------------------------------------// | ||||
|  | ||||
| // Helper to initialize a base object so a derived class can use this | ||||
| // object in the initialization of another base class.  Used by | ||||
| // Dietmar Kuehl from ideas by Ron Klatcho to solve the problem of a | ||||
| // base class needing to be initialized by a member. | ||||
|  | ||||
| // Contributed by Daryle Walker | ||||
|  | ||||
| template < typename MemberType, int UniqueID = 0 > | ||||
| class base_from_member | ||||
| { | ||||
| protected: | ||||
|     MemberType  member; | ||||
|  | ||||
|     base_from_member() | ||||
|         : member() | ||||
|         {} | ||||
|  | ||||
|     BOOST_PP_REPEAT_FROM_TO( 1, BOOST_PP_INC(BOOST_BASE_FROM_MEMBER_MAX_ARITY), | ||||
|      BOOST_PRIVATE_CTR_DEF, _ ) | ||||
|  | ||||
| };  // boost::base_from_member | ||||
|  | ||||
| }  // namespace boost | ||||
|  | ||||
|  | ||||
| // Undo any private macros | ||||
| #undef BOOST_PRIVATE_CTR_DEF | ||||
|  | ||||
|  | ||||
| #endif  // BOOST_UTILITY_BASE_FROM_MEMBER_HPP | ||||
							
								
								
									
										68
									
								
								include/boost/utility/compare_pointees.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										68
									
								
								include/boost/utility/compare_pointees.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,68 @@ | ||||
| // Copyright (C) 2003, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // See http://www.boost.org/lib/optional for documentation. | ||||
| // | ||||
| // You are welcome to contact the author at: | ||||
| //  fernando_cacciola@hotmail.com | ||||
| // | ||||
| #ifndef BOOST_UTILITY_COMPARE_POINTEES_25AGO2003_HPP | ||||
| #define BOOST_UTILITY_COMPARE_POINTEES_25AGO2003_HPP | ||||
|  | ||||
| #include<functional> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| // template<class OP> bool equal_pointees(OP const& x, OP const& y); | ||||
| // template<class OP> struct equal_pointees_t; | ||||
| // | ||||
| // Being OP a model of OptionalPointee (either a pointer or an optional): | ||||
| // | ||||
| // If both x and y have valid pointees, returns the result of (*x == *y) | ||||
| // If only one has a valid pointee, returns false. | ||||
| // If none have valid pointees, returns true. | ||||
| // No-throw | ||||
| template<class OptionalPointee> | ||||
| inline | ||||
| bool equal_pointees ( OptionalPointee const& x, OptionalPointee const& y ) | ||||
| { | ||||
|   return (!x) != (!y) ? false : ( !x ? true : (*x) == (*y) ) ; | ||||
| } | ||||
|  | ||||
| template<class OptionalPointee> | ||||
| struct equal_pointees_t : std::binary_function<OptionalPointee,OptionalPointee,bool> | ||||
| { | ||||
|   bool operator() ( OptionalPointee const& x, OptionalPointee const& y ) const | ||||
|     { return equal_pointees(x,y) ; } | ||||
| } ; | ||||
|  | ||||
| // template<class OP> bool less_pointees(OP const& x, OP const& y); | ||||
| // template<class OP> struct less_pointees_t; | ||||
| // | ||||
| // Being OP a model of OptionalPointee (either a pointer or an optional): | ||||
| // | ||||
| // If y has not a valid pointee, returns false. | ||||
| // ElseIf x has not a valid pointee, returns true. | ||||
| // ElseIf both x and y have valid pointees, returns the result of (*x < *y) | ||||
| // No-throw | ||||
| template<class OptionalPointee> | ||||
| inline | ||||
| bool less_pointees ( OptionalPointee const& x, OptionalPointee const& y ) | ||||
| { | ||||
|   return !y ? false : ( !x ? true : (*x) < (*y) ) ; | ||||
| } | ||||
|  | ||||
| template<class OptionalPointee> | ||||
| struct less_pointees_t : std::binary_function<OptionalPointee,OptionalPointee,bool> | ||||
| { | ||||
|   bool operator() ( OptionalPointee const& x, OptionalPointee const& y ) const | ||||
|     { return less_pointees(x,y) ; } | ||||
| } ; | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										36
									
								
								include/boost/utility/detail/in_place_factory_prefix.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								include/boost/utility/detail/in_place_factory_prefix.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| // Copyright (C) 2003, Fernando Luis Cacciola Carballal. | ||||
| // Copyright (C) 2007, Tobias Schwinger. | ||||
| // | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // See http://www.boost.org/lib/optional for documentation. | ||||
| // | ||||
| // You are welcome to contact the author at: | ||||
| //  fernando_cacciola@hotmail.com | ||||
| // | ||||
| #ifndef BOOST_UTILITY_DETAIL_INPLACE_FACTORY_PREFIX_04APR2007_HPP | ||||
| #define BOOST_UTILITY_DETAIL_INPLACE_FACTORY_PREFIX_04APR2007_HPP | ||||
|  | ||||
| #include <new> | ||||
| #include <cstddef> | ||||
| #include <boost/config.hpp> | ||||
| #include <boost/preprocessor/cat.hpp> | ||||
| #include <boost/preprocessor/punctuation/paren.hpp> | ||||
| #include <boost/preprocessor/iteration/iterate.hpp> | ||||
| #include <boost/preprocessor/repetition/repeat.hpp> | ||||
| #include <boost/preprocessor/repetition/enum.hpp> | ||||
| #include <boost/preprocessor/repetition/enum_params.hpp> | ||||
| #include <boost/preprocessor/repetition/enum_binary_params.hpp> | ||||
| #include <boost/preprocessor/repetition/enum_trailing_params.hpp> | ||||
|  | ||||
| #define BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_INIT(z,n,_) BOOST_PP_CAT(m_a,n) BOOST_PP_LPAREN() BOOST_PP_CAT(a,n) BOOST_PP_RPAREN() | ||||
| #define BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_DECL(z,n,_) BOOST_PP_CAT(A,n) const& BOOST_PP_CAT(m_a,n); | ||||
|  | ||||
| #define BOOST_MAX_INPLACE_FACTORY_ARITY 10 | ||||
|  | ||||
| #undef BOOST_UTILITY_DETAIL_INPLACE_FACTORY_SUFFIX_04APR2007_HPP | ||||
|  | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										23
									
								
								include/boost/utility/detail/in_place_factory_suffix.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										23
									
								
								include/boost/utility/detail/in_place_factory_suffix.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,23 @@ | ||||
| // Copyright (C) 2003, Fernando Luis Cacciola Carballal. | ||||
| // Copyright (C) 2007, Tobias Schwinger. | ||||
| // | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // See http://www.boost.org/lib/optional for documentation. | ||||
| // | ||||
| // You are welcome to contact the author at: | ||||
| //  fernando_cacciola@hotmail.com | ||||
| // | ||||
| #ifndef BOOST_UTILITY_DETAIL_INPLACE_FACTORY_SUFFIX_04APR2007_HPP | ||||
| #define BOOST_UTILITY_DETAIL_INPLACE_FACTORY_SUFFIX_04APR2007_HPP | ||||
|  | ||||
| #undef BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_INIT | ||||
| #undef BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_DECL | ||||
| #undef BOOST_MAX_INPLACE_FACTORY_ARITY | ||||
|  | ||||
| #undef BOOST_UTILITY_DETAIL_INPLACE_FACTORY_PREFIX_04APR2007_HPP | ||||
|  | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										89
									
								
								include/boost/utility/detail/result_of_iterate.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										89
									
								
								include/boost/utility/detail/result_of_iterate.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,89 @@ | ||||
| // Boost result_of library | ||||
|  | ||||
| //  Copyright Douglas Gregor 2004. Use, modification and | ||||
| //  distribution is subject to the Boost Software License, Version | ||||
| //  1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // For more information, see http://www.boost.org/libs/utility | ||||
| #if !defined(BOOST_PP_IS_ITERATING) | ||||
| # error Boost result_of - do not include this file! | ||||
| #endif | ||||
|  | ||||
| // CWPro8 requires an argument in a function type specialization | ||||
| #if BOOST_WORKAROUND(__MWERKS__, BOOST_TESTED_AT(0x3002)) && BOOST_PP_ITERATION() == 0 | ||||
| # define BOOST_RESULT_OF_ARGS void | ||||
| #else | ||||
| # define BOOST_RESULT_OF_ARGS BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),T) | ||||
| #endif | ||||
|  | ||||
| #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x551)) | ||||
| template<typename F BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of<F(BOOST_RESULT_OF_ARGS)> | ||||
|     : boost::detail::result_of_impl<F, F(BOOST_RESULT_OF_ARGS), (boost::detail::has_result_type<F>::value)> {}; | ||||
| #endif | ||||
|  | ||||
| #undef BOOST_RESULT_OF_ARGS | ||||
|  | ||||
| #if BOOST_PP_ITERATION() >= 1  | ||||
|  | ||||
| namespace detail { | ||||
|  | ||||
| template<typename R,  typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (*)(BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),T)), FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename R,  typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (&)(BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),T)), FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x551)) | ||||
| template<typename R, typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (T0::*) | ||||
|                      (BOOST_PP_ENUM_SHIFTED_PARAMS(BOOST_PP_ITERATION(),T)), | ||||
|                  FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename R, typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (T0::*) | ||||
|                      (BOOST_PP_ENUM_SHIFTED_PARAMS(BOOST_PP_ITERATION(),T)) | ||||
|                      const, | ||||
|                  FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename R, typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (T0::*) | ||||
|                      (BOOST_PP_ENUM_SHIFTED_PARAMS(BOOST_PP_ITERATION(),T)) | ||||
|                      volatile, | ||||
|                  FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename R, typename FArgs BOOST_PP_COMMA_IF(BOOST_PP_ITERATION()) | ||||
|          BOOST_PP_ENUM_PARAMS(BOOST_PP_ITERATION(),typename T)> | ||||
| struct result_of_impl<R (T0::*) | ||||
|                      (BOOST_PP_ENUM_SHIFTED_PARAMS(BOOST_PP_ITERATION(),T)) | ||||
|                      const volatile, | ||||
|                  FArgs, false> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| } | ||||
| #endif | ||||
							
								
								
									
										119
									
								
								include/boost/utility/enable_if.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										119
									
								
								include/boost/utility/enable_if.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,119 @@ | ||||
| // Boost enable_if library | ||||
|  | ||||
| // Copyright 2003 <20> The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //    Authors: Jaakko J<>rvi (jajarvi at osl.iu.edu) | ||||
| //             Jeremiah Willcock (jewillco at osl.iu.edu) | ||||
| //             Andrew Lumsdaine (lums at osl.iu.edu) | ||||
|  | ||||
|  | ||||
| #ifndef BOOST_UTILITY_ENABLE_IF_HPP | ||||
| #define BOOST_UTILITY_ENABLE_IF_HPP | ||||
|  | ||||
| #include "boost/config.hpp" | ||||
|  | ||||
| // Even the definition of enable_if causes problems on some compilers, | ||||
| // so it's macroed out for all compilers that do not support SFINAE | ||||
|  | ||||
| #ifndef BOOST_NO_SFINAE | ||||
|  | ||||
| namespace boost | ||||
| { | ||||
|   | ||||
|   template <bool B, class T = void> | ||||
|   struct enable_if_c { | ||||
|     typedef T type; | ||||
|   }; | ||||
|  | ||||
|   template <class T> | ||||
|   struct enable_if_c<false, T> {}; | ||||
|  | ||||
|   template <class Cond, class T = void>  | ||||
|   struct enable_if : public enable_if_c<Cond::value, T> {}; | ||||
|  | ||||
|   template <bool B, class T> | ||||
|   struct lazy_enable_if_c { | ||||
|     typedef typename T::type type; | ||||
|   }; | ||||
|  | ||||
|   template <class T> | ||||
|   struct lazy_enable_if_c<false, T> {}; | ||||
|  | ||||
|   template <class Cond, class T>  | ||||
|   struct lazy_enable_if : public lazy_enable_if_c<Cond::value, T> {}; | ||||
|  | ||||
|  | ||||
|   template <bool B, class T = void> | ||||
|   struct disable_if_c { | ||||
|     typedef T type; | ||||
|   }; | ||||
|  | ||||
|   template <class T> | ||||
|   struct disable_if_c<true, T> {}; | ||||
|  | ||||
|   template <class Cond, class T = void>  | ||||
|   struct disable_if : public disable_if_c<Cond::value, T> {}; | ||||
|  | ||||
|   template <bool B, class T> | ||||
|   struct lazy_disable_if_c { | ||||
|     typedef typename T::type type; | ||||
|   }; | ||||
|  | ||||
|   template <class T> | ||||
|   struct lazy_disable_if_c<true, T> {}; | ||||
|  | ||||
|   template <class Cond, class T>  | ||||
|   struct lazy_disable_if : public lazy_disable_if_c<Cond::value, T> {}; | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #else | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
|   namespace detail { typedef void enable_if_default_T; } | ||||
|  | ||||
|   template <typename T> | ||||
|   struct enable_if_does_not_work_on_this_compiler; | ||||
|  | ||||
|   template <bool B, class T = detail::enable_if_default_T> | ||||
|   struct enable_if_c : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <bool B, class T = detail::enable_if_default_T>  | ||||
|   struct disable_if_c : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <bool B, class T = detail::enable_if_default_T>  | ||||
|   struct lazy_enable_if_c : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <bool B, class T = detail::enable_if_default_T>  | ||||
|   struct lazy_disable_if_c : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <class Cond, class T = detail::enable_if_default_T>  | ||||
|   struct enable_if : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <class Cond, class T = detail::enable_if_default_T>  | ||||
|   struct disable_if : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <class Cond, class T = detail::enable_if_default_T>  | ||||
|   struct lazy_enable_if : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
|   template <class Cond, class T = detail::enable_if_default_T>  | ||||
|   struct lazy_disable_if : enable_if_does_not_work_on_this_compiler<T> | ||||
|   { }; | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #endif // BOOST_NO_SFINAE | ||||
|  | ||||
| #endif | ||||
							
								
								
									
										88
									
								
								include/boost/utility/in_place_factory.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										88
									
								
								include/boost/utility/in_place_factory.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,88 @@ | ||||
| // Copyright (C) 2003, Fernando Luis Cacciola Carballal. | ||||
| // Copyright (C) 2007, Tobias Schwinger. | ||||
| // | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // See http://www.boost.org/lib/optional for documentation. | ||||
| // | ||||
| // You are welcome to contact the author at: | ||||
| //  fernando_cacciola@hotmail.com | ||||
| // | ||||
| #ifndef BOOST_UTILITY_INPLACE_FACTORY_04APR2007_HPP | ||||
| #ifndef BOOST_PP_IS_ITERATING | ||||
|  | ||||
| #include <boost/utility/detail/in_place_factory_prefix.hpp> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| class in_place_factory_base {} ; | ||||
|  | ||||
| #define  BOOST_PP_ITERATION_LIMITS (0, BOOST_MAX_INPLACE_FACTORY_ARITY) | ||||
| #define  BOOST_PP_FILENAME_1 <boost/utility/in_place_factory.hpp> | ||||
| #include BOOST_PP_ITERATE() | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #include <boost/utility/detail/in_place_factory_suffix.hpp> | ||||
|  | ||||
| #define BOOST_UTILITY_INPLACE_FACTORY_04APR2007_HPP | ||||
| #else | ||||
| #define N BOOST_PP_ITERATION() | ||||
|  | ||||
| #if N | ||||
| template< BOOST_PP_ENUM_PARAMS(N, class A) > | ||||
| #endif | ||||
| class BOOST_PP_CAT(in_place_factory,N) | ||||
|   :  | ||||
|   public in_place_factory_base | ||||
| { | ||||
| public: | ||||
|  | ||||
|   explicit BOOST_PP_CAT(in_place_factory,N) | ||||
|       ( BOOST_PP_ENUM_BINARY_PARAMS(N,A,const& a) ) | ||||
| #if N > 0 | ||||
|     : BOOST_PP_ENUM(N, BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_INIT, _) | ||||
| #endif | ||||
|   {} | ||||
|  | ||||
|   template<class T> | ||||
|   void* apply(void* address | ||||
|       BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(T)) const | ||||
|   { | ||||
|     return new(address) T( BOOST_PP_ENUM_PARAMS(N, m_a) ); | ||||
|   } | ||||
|  | ||||
|   template<class T> | ||||
|   void* apply(void* address, std::size_t n | ||||
|       BOOST_APPEND_EXPLICIT_TEMPLATE_TYPE(T)) const | ||||
|   { | ||||
|     for(char* next = address = this->BOOST_NESTED_TEMPLATE apply<T>(address); | ||||
|         !! --n;) | ||||
|       this->BOOST_NESTED_TEMPLATE apply<T>(next = next+sizeof(T)); | ||||
|     return address;  | ||||
|   } | ||||
|  | ||||
|   BOOST_PP_REPEAT(N, BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_DECL, _) | ||||
| }; | ||||
|  | ||||
| #if N > 0 | ||||
| template< BOOST_PP_ENUM_PARAMS(N, class A) > | ||||
| inline BOOST_PP_CAT(in_place_factory,N)< BOOST_PP_ENUM_PARAMS(N, A) > | ||||
| in_place( BOOST_PP_ENUM_BINARY_PARAMS(N, A, const& a) ) | ||||
| { | ||||
|   return BOOST_PP_CAT(in_place_factory,N)< BOOST_PP_ENUM_PARAMS(N, A) > | ||||
|       ( BOOST_PP_ENUM_PARAMS(N, a) ); | ||||
| } | ||||
| #else | ||||
| inline in_place_factory0 in_place() | ||||
| { | ||||
|   return in_place_factory0(); | ||||
| } | ||||
| #endif | ||||
|  | ||||
| #undef N | ||||
| #endif | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										88
									
								
								include/boost/utility/result_of.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										88
									
								
								include/boost/utility/result_of.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,88 @@ | ||||
| // Boost result_of library | ||||
|  | ||||
| //  Copyright Douglas Gregor 2004. Use, modification and | ||||
| //  distribution is subject to the Boost Software License, Version | ||||
| //  1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // For more information, see http://www.boost.org/libs/utility | ||||
| #ifndef BOOST_RESULT_OF_HPP | ||||
| #define BOOST_RESULT_OF_HPP | ||||
|  | ||||
| #include <boost/config.hpp> | ||||
| #include <boost/type_traits/ice.hpp> | ||||
| #include <boost/type.hpp> | ||||
| #include <boost/preprocessor.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
| #include <boost/mpl/has_xxx.hpp> | ||||
| #include <boost/mpl/if.hpp> | ||||
| #include <boost/mpl/bool.hpp> | ||||
|  | ||||
| #ifndef BOOST_RESULT_OF_NUM_ARGS | ||||
| #  define BOOST_RESULT_OF_NUM_ARGS 10 | ||||
| #endif | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| template<typename F> struct result_of; | ||||
|  | ||||
| #if !defined(BOOST_NO_SFINAE) && !defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) | ||||
| namespace detail { | ||||
|  | ||||
| BOOST_MPL_HAS_XXX_TRAIT_DEF(result_type) | ||||
|  | ||||
| template<typename F, typename FArgs, bool HasResultType> struct result_of_impl; | ||||
|  | ||||
| template<typename F> | ||||
| struct result_of_void_impl | ||||
| { | ||||
|   typedef void type; | ||||
| }; | ||||
|  | ||||
| template<typename R> | ||||
| struct result_of_void_impl<R (*)(void)> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename R> | ||||
| struct result_of_void_impl<R (&)(void)> | ||||
| { | ||||
|   typedef R type; | ||||
| }; | ||||
|  | ||||
| template<typename F, typename FArgs> | ||||
| struct result_of_impl<F, FArgs, true> | ||||
| { | ||||
|   typedef typename F::result_type type; | ||||
| }; | ||||
|  | ||||
| template<typename FArgs> | ||||
| struct is_function_with_no_args : mpl::false_ {}; | ||||
|  | ||||
| template<typename F> | ||||
| struct is_function_with_no_args<F(void)> : mpl::true_ {}; | ||||
|  | ||||
| template<typename F, typename FArgs> | ||||
| struct result_of_nested_result : F::template result<FArgs> | ||||
| {}; | ||||
|  | ||||
| template<typename F, typename FArgs> | ||||
| struct result_of_impl<F, FArgs, false> | ||||
|   : mpl::if_<is_function_with_no_args<FArgs>, | ||||
| 	     result_of_void_impl<F>, | ||||
| 	     result_of_nested_result<F, FArgs> >::type | ||||
| {}; | ||||
|  | ||||
| } // end namespace detail | ||||
|  | ||||
| #define BOOST_PP_ITERATION_PARAMS_1 (3,(0,BOOST_RESULT_OF_NUM_ARGS,<boost/utility/detail/result_of_iterate.hpp>)) | ||||
| #include BOOST_PP_ITERATE() | ||||
|  | ||||
| #else | ||||
| #  define BOOST_NO_RESULT_OF 1 | ||||
| #endif | ||||
|  | ||||
| } | ||||
|  | ||||
| #endif // BOOST_RESULT_OF_HPP | ||||
							
								
								
									
										77
									
								
								include/boost/utility/typed_in_place_factory.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										77
									
								
								include/boost/utility/typed_in_place_factory.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,77 @@ | ||||
| // Copyright (C) 2003, Fernando Luis Cacciola Carballal. | ||||
| // Copyright (C) 2007, Tobias Schwinger. | ||||
| // | ||||
| // Use, modification, and distribution is subject to the Boost Software | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // See http://www.boost.org/lib/optional for documentation. | ||||
| // | ||||
| // You are welcome to contact the author at: | ||||
| //  fernando_cacciola@hotmail.com | ||||
| // | ||||
| #ifndef BOOST_UTILITY_TYPED_INPLACE_FACTORY_04APR2007_HPP | ||||
| #ifndef BOOST_PP_IS_ITERATING | ||||
|  | ||||
| #include <boost/utility/detail/in_place_factory_prefix.hpp> | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| class typed_in_place_factory_base {} ; | ||||
|  | ||||
| #define  BOOST_PP_ITERATION_LIMITS (0, BOOST_MAX_INPLACE_FACTORY_ARITY) | ||||
| #define  BOOST_PP_FILENAME_1 <boost/utility/typed_in_place_factory.hpp> | ||||
| #include BOOST_PP_ITERATE() | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
| #include <boost/utility/detail/in_place_factory_suffix.hpp> | ||||
|  | ||||
| #define BOOST_UTILITY_TYPED_INPLACE_FACTORY_04APR2007_HPP | ||||
| #else  | ||||
| #define N BOOST_PP_ITERATION() | ||||
|  | ||||
| template< class T BOOST_PP_ENUM_TRAILING_PARAMS(N,class A) > | ||||
| class BOOST_PP_CAT(typed_in_place_factory,N)  | ||||
|   :  | ||||
|   public typed_in_place_factory_base | ||||
| { | ||||
| public: | ||||
|  | ||||
|   typedef T value_type; | ||||
|  | ||||
|   explicit BOOST_PP_CAT(typed_in_place_factory,N)  | ||||
|       ( BOOST_PP_ENUM_BINARY_PARAMS(N, A, const& a) ) | ||||
| #if N > 0 | ||||
|     : BOOST_PP_ENUM(N, BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_INIT, _) | ||||
| #endif | ||||
|   {} | ||||
|  | ||||
|   void* apply (void* address) const | ||||
|   { | ||||
|     return new(address) T( BOOST_PP_ENUM_PARAMS(N, m_a) ); | ||||
|   } | ||||
|  | ||||
|   void* apply (void* address, std::size_t n) const | ||||
|   { | ||||
|     for(void* next = address = this->apply(address); !! --n;) | ||||
|       this->apply(next = static_cast<char *>(next) + sizeof(T)); | ||||
|     return address;  | ||||
|   } | ||||
|  | ||||
|   BOOST_PP_REPEAT(N, BOOST_DEFINE_INPLACE_FACTORY_CLASS_MEMBER_DECL, _) | ||||
| }; | ||||
|  | ||||
| template< class T BOOST_PP_ENUM_TRAILING_PARAMS(N, class A) > | ||||
| inline BOOST_PP_CAT(typed_in_place_factory,N)< | ||||
|     T BOOST_PP_ENUM_TRAILING_PARAMS(N, A) > | ||||
| in_place( BOOST_PP_ENUM_BINARY_PARAMS(N, A, const& a) ) | ||||
| { | ||||
|   return BOOST_PP_CAT(typed_in_place_factory,N)<  | ||||
|       T BOOST_PP_ENUM_TRAILING_PARAMS(N, A) >( BOOST_PP_ENUM_PARAMS(N, a) ); | ||||
| } | ||||
|  | ||||
| #undef N | ||||
| #endif | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										180
									
								
								include/boost/utility/value_init.hpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										180
									
								
								include/boost/utility/value_init.hpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,180 @@ | ||||
| // (C) Copyright 2002-2007, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // 21 Ago 2002 (Created) Fernando Cacciola | ||||
| // 07 Set 2007 (Worked around MSVC++ bug) Fernando Cacciola, Niels Dekker | ||||
| // | ||||
| #ifndef BOOST_UTILITY_VALUE_INIT_21AGO2002_HPP | ||||
| #define BOOST_UTILITY_VALUE_INIT_21AGO2002_HPP | ||||
|  | ||||
| #include <boost/detail/select_type.hpp> | ||||
| #include <boost/type_traits/cv_traits.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
|  | ||||
| #if BOOST_WORKAROUND(BOOST_MSVC, BOOST_TESTED_AT(1500) ) | ||||
| // Microsoft Visual C++ does not correctly support value initialization, as reported by | ||||
| // Pavel Kuznetsov (MetaCommunications Engineering), 7/28/2005, Feedback ID 100744, | ||||
| // Feedback Title: Value-initialization in new-expression | ||||
| // https://connect.microsoft.com/VisualStudio/feedback/ViewFeedback.aspx?FeedbackID=100744 | ||||
| // The report was closed at 11/14/2006, and its status was set to "Closed (Won't Fix)". | ||||
| // Luckily, even in the presence of this compiler bug, boost::value_initialized will still | ||||
| // do its job correctly, when using the following workaround: | ||||
| #define BOOST_UTILITY_VALUE_INIT_WORKAROUND | ||||
| #endif | ||||
|  | ||||
| #ifdef BOOST_UTILITY_VALUE_INIT_WORKAROUND | ||||
| #include <boost/aligned_storage.hpp> | ||||
| #include <boost/type_traits/alignment_of.hpp> | ||||
| #include <cstring> | ||||
| #include <new> | ||||
|  | ||||
| #ifdef BOOST_MSVC | ||||
| #pragma warning(push) | ||||
| #if _MSC_VER >= 1310 | ||||
| // When using MSVC 7.1 or higher, placement new, "new (&x) T()", may trigger warning C4345: | ||||
| // "behavior change: an object of POD type constructed with an initializer of the form () | ||||
| // will be default-initialized".  There is no need to worry about this, though. | ||||
| #pragma warning(disable: 4345) | ||||
| #endif | ||||
| #endif | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| namespace vinit_detail { | ||||
|  | ||||
| template<class T> | ||||
| class const_T_base | ||||
| { | ||||
|   protected : | ||||
|  | ||||
|     const_T_base() | ||||
|     { | ||||
|       std::memset(&x, 0, sizeof(x)); | ||||
|       new (&x) T(); | ||||
|     } | ||||
|  | ||||
|     ~const_T_base() | ||||
|     { | ||||
|       void const * ptr = &x; | ||||
|       static_cast<T*>(ptr)->T::~T(); | ||||
|     } | ||||
|  | ||||
|     T & get() const | ||||
|     { | ||||
|       void const * ptr = &x; | ||||
|       return *static_cast<T*>(ptr); | ||||
|     } | ||||
|  | ||||
|   private : | ||||
|     typename ::boost::aligned_storage<sizeof(T), ::boost::alignment_of<T>::value>::type x; | ||||
| } ; | ||||
|  | ||||
| template<class T> | ||||
| class non_const_T_base | ||||
| { | ||||
|   protected : | ||||
|  | ||||
|     non_const_T_base() | ||||
|     { | ||||
|       std::memset(&x, 0, sizeof(x)); | ||||
|       new (&x) T(); | ||||
|     } | ||||
|  | ||||
|     ~non_const_T_base() | ||||
|     { | ||||
|       void * ptr = &x; | ||||
|       static_cast<T*>(ptr)->T::~T(); | ||||
|     } | ||||
|  | ||||
|     T & get() const | ||||
|     {  | ||||
|       void * ptr = &x; | ||||
|       return *static_cast<T*>(ptr); | ||||
|     } | ||||
|  | ||||
|   private : | ||||
|     mutable typename ::boost::aligned_storage<sizeof(T), ::boost::alignment_of<T>::value>::type x; | ||||
| } ; | ||||
|  | ||||
| #ifdef BOOST_MSVC | ||||
| // Restores the state of warning C4345. | ||||
| #pragma warning(pop) | ||||
| #endif | ||||
|  | ||||
| #else | ||||
|  | ||||
| namespace boost { | ||||
|  | ||||
| namespace vinit_detail { | ||||
|  | ||||
| template<class T> | ||||
| class const_T_base | ||||
| { | ||||
|   protected : | ||||
|  | ||||
|    const_T_base() : x() {} | ||||
|    T & get() const { return x; } | ||||
|  | ||||
|   private : | ||||
|    T x ; | ||||
| } ; | ||||
|  | ||||
| template<class T> | ||||
| class non_const_T_base | ||||
| { | ||||
|   protected : | ||||
|  | ||||
|    non_const_T_base() : x() {} | ||||
|    T & get() const { return x; } | ||||
|  | ||||
|   private : | ||||
|    mutable T x ; | ||||
| } ; | ||||
|  | ||||
| #endif | ||||
|  | ||||
| template<class T> | ||||
| struct select_base | ||||
| { | ||||
|   typedef | ||||
| #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) | ||||
|   typename | ||||
| #endif  | ||||
|     ::boost::detail::if_true< ::boost::is_const<T>::value > | ||||
|       ::template then< const_T_base<T>, non_const_T_base<T> >::type type ; | ||||
| } ; | ||||
|  | ||||
| } // namespace vinit_detail | ||||
|  | ||||
| template<class T> | ||||
| class value_initialized : private vinit_detail::select_base<T>::type | ||||
| { | ||||
|   public : | ||||
|  | ||||
|     value_initialized() {} | ||||
|  | ||||
|     operator T&() const { return this->get(); } | ||||
|  | ||||
|     T& data() const { return this->get(); } | ||||
|  | ||||
| } ; | ||||
|  | ||||
| template<class T> | ||||
| T const& get ( value_initialized<T> const& x ) | ||||
| { | ||||
|   return x.data() ; | ||||
| } | ||||
| template<class T> | ||||
| T& get ( value_initialized<T>& x ) | ||||
| { | ||||
|   return x.data() ; | ||||
| } | ||||
|  | ||||
| } // namespace boost | ||||
|  | ||||
|  | ||||
| #endif | ||||
|  | ||||
							
								
								
									
										72
									
								
								index.htm
									
									
									
									
									
								
							
							
						
						
									
										72
									
								
								index.htm
									
									
									
									
									
								
							| @@ -1,72 +0,0 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> | ||||
| <meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| <title>Boost Utility Library</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|  | ||||
| <table border="1" cellpadding="2" bgcolor="#007F7F"> | ||||
|   <tr> | ||||
|     <td bgcolor="#FFFFFF"><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" width="277" height="86"></td> | ||||
|     <td><a href="../../index.htm"><font color="#FFFFFF" size="4" face="Arial">Home</font></a></td> | ||||
|     <td><a href="../../libraries.htm"><font color="#FFFFFF" size="4" face="Arial">Libraries</font></a></td> | ||||
|     <td><a href="../../people.htm"><font color="#FFFFFF" size="4" face="Arial">People</font></a></td> | ||||
|     <td><a href="../../more/faq.htm"><font color="#FFFFFF" size="4" face="Arial">FAQ</font></a></td> | ||||
|     <td><a href="../../more/index.htm"><font color="#FFFFFF" size="4" face="Arial">More</font></a></td> | ||||
|   </tr> | ||||
| </table> | ||||
| <h1>Boost Utility Library</h1> | ||||
| <table border="1" cellpadding="5"> | ||||
|   <tr> | ||||
|     <td><b><i>Header</i></b></td> | ||||
|     <td><b><i>Contents</i></b></td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/utility.hpp"><code>boost/utility.hpp<br> | ||||
|       </code></a><a href="utility.htm">[Documentation]</a></td> | ||||
|     <td>Class <b>noncopyable</b> plus <b>next()</b> and <b>prior()</b> template | ||||
|       functions.</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/cast.hpp"><code>boost/cast.hpp</code></a><br> | ||||
|       <a href="cast.htm">[Documentation]</a></td> | ||||
|     <td><b>polymorphic_cast</b>, <b>implicit_cast</b>, and <b>numeric_cast</b> | ||||
|       function templates. | ||||
|       <p><i>[Beta.]</i></p> | ||||
|     </td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/operators.hpp">boost/operators.hpp</a><br> | ||||
|       <a href="operators.htm">[Documentation]</a></td> | ||||
|     <td>Templates <b>equality_comparable</b>, <b>less_than_comparable</b>, <b>addable</b>, | ||||
|       and the like ease the task of defining comparison and arithmetic | ||||
|       operators, and iterators.</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/detail/type_traits.hpp">boost/type_traits.hpp</a><br> | ||||
|       [<a href="type_traits.htm">Documentation</a>]</td> | ||||
|     <td>Template classes that describe the fundamental properties of a type. [<a href="c++_type_traits.htm">DDJ | ||||
|       Article "C++ type traits"</a>]</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/detail/call_traits.hpp">boost/call_traits.hpp</a><br> | ||||
|       [<a href="call_traits.htm">Documentation</a>]</td> | ||||
|     <td>Template class call_traits<T>, that defines types used for passing | ||||
|       parameters to and from a proceedure.</td> | ||||
|   </tr> | ||||
|   <tr> | ||||
|     <td><a href="../../boost/detail/compressed_pair.hpp">boost/compressed_pair.hpp</a><br> | ||||
|       [<a href="compressed_pair.htm">Documentation</a>]</td> | ||||
|     <td>Template class compressed_pait<T1, T2> which pairs two values | ||||
|       using the empty member optimisation where appropriate.</td> | ||||
|   </tr> | ||||
| </table> | ||||
| <p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B %Y" startspan -->27 July 2000<!--webbot bot="Timestamp" endspan i-checksum="18770" --></p> | ||||
|  | ||||
| </body> | ||||
|  | ||||
| </html> | ||||
							
								
								
									
										40
									
								
								index.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										40
									
								
								index.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,40 @@ | ||||
| <html> | ||||
| 	<head> | ||||
| 		<meta http-equiv="Content-Language" content="en-us"> | ||||
| 		<meta name="GENERATOR" content="Microsoft FrontPage 5.0"> | ||||
| 		<meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> | ||||
| 		<title>Boost Utility Library</title> | ||||
| 	</head> | ||||
| 	<body bgcolor="#FFFFFF"> | ||||
| 		<h1><IMG SRC="../../boost.png" WIDTH="276" HEIGHT="86" align="center">Boost  | ||||
| 			Utility Library</h1> | ||||
| 		<p>The Boost Utility Library isn't really a single library at all. It is just a  | ||||
| 			collection for components too small to be called libraries in their own right.</p> | ||||
| 		<p>But that doesn't mean there isn't useful stuff here. Take a look:</p> | ||||
| 		<blockquote> | ||||
| 			<p> | ||||
| 				<a href="assert.html">assert</a><br> | ||||
| 				<a href="base_from_member.html">base_from_member</a><br> | ||||
| 				<a href="call_traits.htm">call_traits</a><br> | ||||
| 				<a href="checked_delete.html">checked_delete</a><br> | ||||
| 				<a href="compressed_pair.htm">compressed_pair</a><br> | ||||
| 				<a href="current_function.html">current_function</a><br> | ||||
| 				<a href="enable_if.html">enable_if</a><br> | ||||
|                 <a href="iterator_adaptors.htm">iterator_adaptors</a><br> | ||||
| 				<a href="operators.htm">operators</a><br> | ||||
| 				<a href="throw_exception.html">throw_exception</a><br> | ||||
| 				<a href="utility.htm">utility</a><br> | ||||
|                 <a href="value_init.htm">value_init</a></p> | ||||
| 		</blockquote> | ||||
| 		<hr> | ||||
| 		<p><EFBFBD> Copyright Beman Dawes, 2001</p> | ||||
|         <p>Distributed under the Boost Software License, Version 1.0. (See  | ||||
|         accompanying file <a href="../../LICENSE_1_0.txt"> | ||||
|         LICENSE_1_0.txt</a> or copy at | ||||
|         <a href="http://www.boost.org/LICENSE_1_0.txt"> | ||||
|         www.boost.org/LICENSE_1_0.txt</a>)</p> | ||||
| 		<p>Revised  | ||||
| 			<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->07 November, 2006<!--webbot bot="Timestamp" endspan i-checksum="39368" --></p> | ||||
| 		</body> | ||||
| </html> | ||||
| @@ -1,45 +0,0 @@ | ||||
| // (C) Copyright Jeremy Siek 2000. Permission to copy, use, modify, sell and | ||||
| // distribute this software is granted provided this copyright notice appears | ||||
| // in all copies. This software is provided "as is" without express or implied | ||||
| // warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
|  | ||||
| #include <functional> | ||||
| #include <algorithm> | ||||
| #include <iostream> | ||||
| #include <boost/iterator_adaptors.hpp> | ||||
|  | ||||
| int | ||||
| main(int, char*[]) | ||||
| { | ||||
|   // This is a simple example of using the transform_iterators class to | ||||
|   // generate iterators that multiply the value returned by dereferencing | ||||
|   // the iterator. In this case we are multiplying by 2. | ||||
|  | ||||
|   int x[] = { 1, 2, 3, 4, 5, 6, 7, 8 }; | ||||
|  | ||||
|   typedef std::binder1st< std::multiplies<int> > Function; | ||||
|   typedef boost::transform_iterator<Function, int*,  | ||||
|     boost::iterator<std::random_access_iterator_tag, int> | ||||
|   >::type doubling_iterator; | ||||
|  | ||||
|   doubling_iterator i(x, std::bind1st(std::multiplies<int>(), 2)), | ||||
|     i_end(x + sizeof(x)/sizeof(int), std::bind1st(std::multiplies<int>(), 2)); | ||||
|  | ||||
|   std::cout << "multiplying the array by 2:" << std::endl; | ||||
|   while (i != i_end) | ||||
|     std::cout << *i++ << " "; | ||||
|   std::cout << std::endl; | ||||
|  | ||||
|   // Here is an example of counting from 0 to 5 using the integer_range class. | ||||
|  | ||||
|   boost::integer_range<int> r(0,5); | ||||
|  | ||||
|   std::cout << "counting to from 0 to 4:" << std::endl; | ||||
|   std::copy(r.begin(), r.end(), std::ostream_iterator<int>(std::cout, " ")); | ||||
|   std::cout << std::endl; | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
|  | ||||
| @@ -1,629 +1,11 @@ | ||||
| <!-- Copyright David Abrahams 2004. Distributed under the Boost --> | ||||
| <!-- Software License, Version 1.0. (See accompanying --> | ||||
| <!-- file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) --> | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> | ||||
| <meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| <title>Header boost/iterator_adaptors.hpp Documentation</title> | ||||
| <meta http-equiv="refresh" content="0; URL=../iterator/doc/index.html"> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|  | ||||
| <img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" | ||||
| align="center" width="277" height="86"> | ||||
|  | ||||
| <h1>Header | ||||
| <a href="../../boost/pending/iterator_adaptors.hpp">boost/iterator_adaptors.hpp</a></h1> | ||||
|  | ||||
| <p>The file <tt>boost/iterator_adaptors.hpp</tt> | ||||
| includes the main <tt>iterator_adaptors</tt> class and several other classes | ||||
| for constructing commonly used iterator adaptors.</p> | ||||
|  | ||||
| <ul> | ||||
|   <li><a href="#iterator_adaptors"><tt>iterator_adaptors</tt></a>. | ||||
|   <li><a href="#iterator_adaptor"><tt>iterator_adaptor</tt></a>. | ||||
|   <li><a href="#transform_iterator"><tt>transform_iterator</tt></a> | ||||
|   <li><a href="#indirect_iterators"><tt>indirect_iterators</tt></a> | ||||
|   <li><a href="#reverse_iterators"><tt>reverse_iterators</tt></a> | ||||
|   <li><a href="#integer_range"><tt>integer_range</tt></a> | ||||
| </ul> | ||||
|  | ||||
|  | ||||
| <!-- put in something about Andrei Alexandrescu's contribution? --> | ||||
|  | ||||
| <p><a href="http://www.boost.org/people/dave_abrahams.htm">Dave | ||||
| Abrahams</a> started the library, coming up with the idea to use | ||||
| policy classes and how to handle the const/non-const iterator | ||||
| interactions. He also contributed the <tt>indirect_iterators</tt> and | ||||
| <tt>reverse_iterators</tt> classes.<br> | ||||
|  | ||||
| <a href="http://www.boost.org/people/jeremy_siek.htm">Jeremy Siek</a> | ||||
| contributed <tt>transform_iterator</tt>, <tt>integer_range</tt>, | ||||
| and this documentation. | ||||
|  | ||||
| <h3><a name="iterator_adaptors">The Iterator Adaptors Class</a></h3> | ||||
|  | ||||
| Implementing standard conforming iterators is a non-trivial task. | ||||
| There are some fine-points such as iterator/const_iterator | ||||
| interactions and there are the myriad of operators that should be | ||||
| implemented but are easily forgotten such as | ||||
| <tt>operator->()</tt>. The purpose of the | ||||
| <tt>iterator_adaptors</tt> class is to make it easier to implement an | ||||
| iterator class, and even easier to extend and adapt existing iterator | ||||
| types. The <tt>iterator_adaptors</tt> class itself is not an adaptor | ||||
| class but a <i>type generator</i>. It generates a pair of adaptor classes, | ||||
| one class for the mutable iterator and one class for the const | ||||
| iterator. The definition of the <tt>iterator_adaptors</tt> class is as | ||||
| follows: | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| template <class Iterator,  | ||||
|           class ConstIterator,  | ||||
|           class Traits = std::iterator_traits<Iterator>, | ||||
|           class ConstTraits = std::iterator_traits<ConstIterator>,  | ||||
|           class Policies = default_iterator_policies> | ||||
| struct iterator_adaptors | ||||
| { | ||||
|   typedef ... iterator; | ||||
|   typedef ... const_iterator; | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <p>The <tt>Iterator</tt> and <tt>ConstIterator</tt> template parameters | ||||
| are the iterator types that you want to adapt. The <tt>Traits</tt> and | ||||
| <tt>ConstTraits</tt> must be iterator traits classes.  The traits | ||||
| parameters default to the specialization of the | ||||
| <tt>std::iterator_traits</tt> class for the adapted iterators. If you | ||||
| want the traits for your new iterator adaptor (<tt>value_type</tt>, | ||||
| <tt>iterator_category</tt>, etc.) to be the same as the adapted | ||||
| iterator then use the default, otherwise create your own traits | ||||
| classes and pass them in <a href="#1">[1]</a>.  | ||||
|  | ||||
|  | ||||
| <p>The <tt>Policies</tt> class that you pass in will become the heart of | ||||
| the iterator adaptor. The policy class determines how your new adaptor | ||||
| class will behave. The <tt>Policies</tt> class must implement 3, 4, or | ||||
| 7 of the core iterator operations depending on whether you wish the | ||||
| new iterator adaptor class to be a | ||||
| <a href="http://www.sgi.com/Technology/STL/ForwardIterator.html"> | ||||
| ForwardIterator</a>, | ||||
| <a href="http://www.sgi.com/Technology/STL/BidirectionalIterator.html"> | ||||
| BidirectionalIterator</a>, or <a | ||||
| href="http://www.sgi.com/Technology/STL/RandomAccessIterator.html"> | ||||
| RandomAccessIterator</a>. Make sure that the | ||||
| <tt>iterator_category</tt> type of the traits class you pass in | ||||
| matches the category of iterator that you want to create. The default | ||||
| policy class, <tt>default_iterator_policies</tt>, implements all 7 of | ||||
| the core operations in the usual way. If you wish to create an | ||||
| iterator adaptor that only changes a few of the iterator's behaviors, | ||||
| then you can have your new policy class inherit from | ||||
| <tt>default_iterator_policies</tt> to avoid retyping the usual | ||||
| behaviours. You should also look at <tt>default_iterator_policies</tt> | ||||
| as the "boiler-plate" for your own policy classes. The | ||||
| following is definition of the <tt>default_iterator_policies</tt> | ||||
| class: | ||||
|  | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| struct default_iterator_policies | ||||
| { | ||||
|   // required for a ForwardIterator | ||||
|   template <class Reference, class Iterator> | ||||
|   Reference dereference(type<Reference>, const Iterator& x) const | ||||
|     { return *x; } | ||||
|  | ||||
|   template <class Iterator> | ||||
|   void increment(Iterator& x) const | ||||
|     { ++x; } | ||||
|  | ||||
|   template <class Iterator1, class Iterator2> | ||||
|   bool equal(Iterator1& x, Iterator2& y) const | ||||
|     { return x == y; } | ||||
|  | ||||
|   // required for a BidirectionalIterator | ||||
|   template <class Iterator> | ||||
|   void decrement(Iterator& x) const | ||||
|     { --x; } | ||||
|  | ||||
|   // required for a RandomAccessIterator | ||||
|   template <class Iterator, class DifferenceType> | ||||
|   void advance(Iterator& x, DifferenceType n) const | ||||
|     { x += n; } | ||||
|  | ||||
|   template <class Difference, class Iterator1, class Iterator2> | ||||
|   Difference distance(type<Difference>, Iterator1& x, Iterator2& y) const | ||||
|     { return y - x; } | ||||
|  | ||||
|   template <class Iterator1, class Iterator2> | ||||
|   bool less(Iterator1& x, Iterator2& y) const | ||||
|     { return x < y; } | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <p> | ||||
| The generated iterator adaptor types will have the following | ||||
| constructors. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| <i>iterator</i>(const Iterator& i, const Policies& p = Policies()) | ||||
|  | ||||
| <i>const_iterator</i>(const ConstIterator& i, const Policies& p = Policies()) | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <h3><a name="iterator_adaptor">The Iterator Adaptor Class</a></h3> | ||||
|  | ||||
| This is the class used inside of the <tt>iterator_adaptors</tt> type | ||||
| generator. Use this class directly (instead of using | ||||
| <tt>iterator_adaptors</tt>) when there is no difference between the | ||||
| const and non-const versions of the iterator type. Often this is | ||||
| because there is only a const (read-only) version of the iterator, as | ||||
| is the case for <tt>std::set</tt>'s iterators. Use the same type for | ||||
| the <tt>Iterator</tt> and <tt>NonconstIterator</tt> template | ||||
| arguments. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| template <class Iterator,  | ||||
|           class Policies = default_iterator_policies, | ||||
|           class NonconstIterator = Iterator,          | ||||
|           class Traits = std::iterator_traits<Iterator> > | ||||
| struct iterator_adaptor; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
|  | ||||
| <p> | ||||
| Next we will look at some iterator adaptors that are examples of how | ||||
| to use the iterator adaptors class, and that are useful iterator | ||||
| adaptors in their own right. | ||||
|  | ||||
| <h3><a name="transform_iterator">The Transform Iterator Class</a></h3> | ||||
|  | ||||
| It is often useful to automatically apply some function to the value | ||||
| returned by dereferencing (<tt>operator*()</tt>) an iterator. The | ||||
| <tt>transform_iterators</tt> class makes it easy to create an iterator | ||||
| adaptor that does just that. | ||||
|  | ||||
| First let us consider what the <tt>Policies</tt> class for the transform | ||||
| iterator should look like. We are only changing one of the iterator | ||||
| behaviours, so we will inherit from | ||||
| <tt>default_iterator_policies</tt>. In addition, we will need a | ||||
| function object to apply, so we will have a template parameter and a | ||||
| data member for the function object. The function will take one | ||||
| argument (the dereferenced value) and we will need to know the | ||||
| <tt>result_type</tt> of the function, so <a | ||||
| href="http://www.sgi.com/Technology/STL/AdaptableUnaryFunction.html"> | ||||
| AdaptableUnaryFunction</a> is the corrent concept to choose for the | ||||
| function object type. Now for the heart of our iterator adaptor, we | ||||
| implement the <tt>dereference</tt> method, applying the function | ||||
| object to <tt>*i</tt>. The <tt>type<Reference></tt> class is | ||||
| there to tell you what the reference type of the iterator is, which is | ||||
| handy when writing generic iterator adaptors such as this one <a | ||||
| href="#2">[2]</a>. | ||||
|  | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
|   template <class AdaptableUnaryFunction> | ||||
|   struct transform_iterator_policies : public default_iterator_policies | ||||
|   { | ||||
|     transform_iterator_policies(const AdaptableUnaryFunction& f) : m_f(f) { } | ||||
|  | ||||
|     template <class Reference, class Iterator> | ||||
|     Reference dereference(type<Reference>, const Iterator& i) const | ||||
|       { return m_f(*i); } | ||||
|  | ||||
|     AdaptableUnaryFunction m_f; | ||||
|   }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| Next we need to create the traits class for our new iterator.  In some | ||||
| situations you may need to create a separate traits class for the | ||||
| const and non-const iterator types, but here a single traits class | ||||
| will do. The <tt>value_type</tt> and <tt>reference</tt> type of our | ||||
| transform iterator will be the <tt>result_type</tt> of the function | ||||
| object.  The <tt>difference_type</tt> and <tt>iterator_category</tt> | ||||
| will be the same as the adapted iterator. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
|   template <class AdaptableUnaryFunction, class IteratorTraits> | ||||
|   struct transform_iterator_traits { | ||||
|     typedef typename AdaptableUnaryFunction::result_type value_type; | ||||
|     typedef value_type reference; | ||||
|     typedef value_type* pointer; | ||||
|     typedef typename IteratorTraits::difference_type difference_type; | ||||
|     typedef typename IteratorTraits::iterator_category iterator_category; | ||||
|   }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| The final step is to use the <tt>iterator_adaptor</tt> class to | ||||
| construct our transform iterator. We will use the single iterator | ||||
| adaptor version because we will not need to create both a mutable and | ||||
| const version of the transform iterator. The transform iterator is | ||||
| inherently a read-only iterator.  The nicest way to package up our new | ||||
| transform iterator is to create a type generator similar to | ||||
| <tt>iterator_adaptor</tt>. The first template parameter will be the | ||||
| type of the function object. The second parameter will be the adapted | ||||
| iterator type. The third parameter is the trait class for | ||||
| the adapted iterator.  Inside the <tt>transform_iterators</tt> class | ||||
| we use the <tt>transform_iterator_traits</tt> class defined above to | ||||
| create the traits class for the new transform iterator. We then use | ||||
| the <tt>iterator_adaptor</tt> class to extract the generated | ||||
| iterator adaptor type. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| template <class AdaptableUnaryFunction, | ||||
|           class Iterator, | ||||
|           class Traits = std::iterator_traits<Iterator> | ||||
|          > | ||||
| struct transform_iterator | ||||
| { | ||||
|   typedef transform_iterator_traits<AdaptableUnaryFunction,Traits> | ||||
|     TransTraits; | ||||
|   typedef iterator_adaptor<Iterator, TransTraits, | ||||
|     transform_iterator_policies<AdaptableUnaryFunction> >::type type; | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <p> | ||||
| The following is a simple example of how to use the | ||||
| <tt>transform_iterators</tt> class to iterate through a range of | ||||
| numbers, multiplying each of them by 2 when they are dereferenced. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| #include <functional> | ||||
| #include <iostream> | ||||
| #include <boost/iterator_adaptors.hpp> | ||||
|  | ||||
| int | ||||
| main(int, char*[]) | ||||
| { | ||||
|   int x[] = { 1, 2, 3, 4, 5, 6, 7, 8 }; | ||||
|  | ||||
|   typedef std::binder1st< std::multiplies<int> > Function; | ||||
|   typedef boost::transform_iterator<Function, int*,  | ||||
|     boost::iterator<std::random_access_iterator_tag, int> | ||||
|   >::type doubling_iterator; | ||||
|  | ||||
|   doubling_iterator i(x, std::bind1st(std::multiplies<int>(), 2)), | ||||
|     i_end(x + sizeof(x)/sizeof(int), std::bind1st(std::multiplies<int>(), 2)); | ||||
|  | ||||
|   std::cout << "multiplying the array by 2:" << std::endl; | ||||
|   while (i != i_end) | ||||
|     std::cout << *i++ << " "; | ||||
|   std::cout << std::endl; | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
|  | ||||
| <h3><a name="indirect_iterators">The Indirect Iterators Class</a></h3> | ||||
|  | ||||
| It is not all that uncommon to create data structures that consist of | ||||
| pointers to pointers. For such a structure it might be nice to have an | ||||
| iterator that applies a double-dereference inside the | ||||
| <tt>operator*()</tt>. The implementation of this is similar to the | ||||
| <tt>transform_iterators</tt><a href="#3">[3]</a>. We first create a | ||||
| policies class which does a double-dereference in the | ||||
| <tt>dereference()</tt> method. We then create a traits class, this | ||||
| time also including a template parameter for the traits of the second | ||||
| level iterators as well as the first. Lastly we wrap this up in the | ||||
| type generator <tt>indirect_iterators</tt>, using | ||||
| <tt>iterator_adaptors</tt> to do most of the work. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
|   struct indirect_iterator_policies : public default_iterator_policies | ||||
|   { | ||||
|     template <class Reference, class Iterator> | ||||
|     Reference dereference(type<Reference>, const Iterator& x) const | ||||
|       { return **x; } | ||||
|   }; | ||||
|  | ||||
|   template <class IndirectIterator, | ||||
| 	    class IndirectTraits = std::iterator_traits<IndirectIterator>, | ||||
| 	    class Traits =  | ||||
| 	      std::iterator_traits<typename IndirectTraits::value_type> | ||||
| 	   > | ||||
|   struct indirect_traits | ||||
|   { | ||||
|     typedef typename IndirectTraits::difference_type difference_type; | ||||
|     typedef typename Traits::value_type value_type; | ||||
|     typedef typename Traits::pointer pointer; | ||||
|     typedef typename Traits::reference reference; | ||||
|     typedef typename IndirectTraits::iterator_category iterator_category; | ||||
|   }; | ||||
|  | ||||
|   template <class IndirectIterator, class ConstIndirectIterator, | ||||
|             class IndirectTraits =  | ||||
|               std::iterator_traits<IndirectIterator>, | ||||
|             class ConstIndirectTraits =  | ||||
|               std::iterator_traits<ConstIndirectIterator>, | ||||
|             class Traits = | ||||
|               std::iterator_traits<typename IndirectTraits::value_type> | ||||
|            > | ||||
|   struct indirect_iterators | ||||
|   { | ||||
|     typedef typename IndirectTraits::value_type Iterator; | ||||
|     typedef typename Traits::value_type ValueType; | ||||
|     typedef iterator_adaptors<IndirectIterator, ConstIndirectIterator, | ||||
|       indirect_traits<IndirectIterator, IndirectTraits, Traits>, | ||||
|       indirect_traits<ConstIndirectIterator, ConstIndirectTraits, Traits>, | ||||
|       indirect_iterator_policies | ||||
|       > Adaptors; | ||||
|     typedef typename Adaptors::iterator iterator; | ||||
|     typedef typename Adaptors::const_iterator const_iterator; | ||||
|   }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <h3><a name="reverse_iterators">The Reverse Iterators Class</a></h3> | ||||
|  | ||||
| <p> | ||||
| Yes, there is already a <tt>reverse_iterator</tt> adaptor class | ||||
| defined in the C++ Standard, but using the <tt>iterator_adaptors</tt> | ||||
| class we can re-implement this classic adaptor in a more succinct and | ||||
| elegant fashion. Also, this makes for a good example of using | ||||
| <tt>iterator_adaptors</tt> that is in familiar territory. | ||||
|  | ||||
| <p> | ||||
| The first step is to create the <tt>Policies</tt> class. As in the | ||||
| <tt>std::reverse_iterator</tt> class, we need to flip all the | ||||
| operations of the iterator. Increment will become decrement, advancing | ||||
| by <tt>n</tt> will become retreating by <tt>n</tt>, etc.  | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| struct reverse_iterator_policies | ||||
| { | ||||
|   template <class Reference, class Iterator> | ||||
|   Reference dereference(type<Reference>, const Iterator& x) const | ||||
|     { return *boost::prior(x); } | ||||
|     // this is equivalent to { Iterator tmp = x; return *--tmp; } | ||||
|      | ||||
|   template <class Iterator> | ||||
|   void increment(Iterator& x) const | ||||
|     { --x; } | ||||
|      | ||||
|   template <class Iterator> | ||||
|   void decrement(Iterator& x) const | ||||
|     { ++x; } | ||||
|      | ||||
|   template <class Iterator, class DifferenceType> | ||||
|   void advance(Iterator& x, DifferenceType n) const | ||||
|     { x -= n; } | ||||
|      | ||||
|   template <class Difference, class Iterator1, class Iterator2> | ||||
|   Difference distance(type<Difference>, Iterator1& x, Iterator2& y) const | ||||
|     { return x - y; } | ||||
|      | ||||
|   template <class Iterator1, class Iterator2> | ||||
|   bool equal(Iterator1& x, Iterator2& y) const | ||||
|     { return x == y; } | ||||
|      | ||||
|   template <class Iterator1, class Iterator2> | ||||
|   bool less(Iterator1& x, Iterator2& y) const | ||||
|     { return y < x; } | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| Since the traits of the reverse iterator adaptor will be the same as | ||||
| the adapted iterator's traits, we do not need to create new traits | ||||
| classes as was the case for <tt>transform_iterator</tt>. We can skip to | ||||
| the final stage of creating a type generator class for our reverse | ||||
| iterators using the <tt>iterator_adaptor</tt> class. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| template <class Iterator, class ConstIterator, | ||||
|           class Traits = std::iterator_traits<Iterator>,  | ||||
|           class ConstTraits = std::iterator_traits<ConstIterator> | ||||
|          > | ||||
| struct reverse_iterators | ||||
| { | ||||
|   typedef iterator_adaptors<Iterator,ConstIterator,Traits,ConstTraits, | ||||
|     reverse_iterator_policies> Adaptor; | ||||
|   typedef typename Adaptor::iterator iterator; | ||||
|   typedef typename Adaptor::const_iterator const_iterator; | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| A typical use of the <tt>reverse_iterators</tt> class is in | ||||
| user-defined container types. You can use the | ||||
| <tt>reverse_iterators</tt> class to generate the reverse iterators for | ||||
| your container. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| class my_container { | ||||
|   ... | ||||
|   typedef ... iterator; | ||||
|   typedef ... const_iterator; | ||||
|  | ||||
|   typedef reverse_iterators<iterator, const_iterator> RevIters; | ||||
|   typedef typename RevIters::iterator reverse_iterator; | ||||
|   typedef typename RevIters::const_iterator const_reverse_iterator; | ||||
|   ... | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
|  | ||||
| <h3><a name="integer_range">The Integer Range Class</a></h3> | ||||
|  | ||||
| The <tt>iterator_adaptors</tt> class can not only be used for adapting | ||||
| iterators, but it can also be used to take a non-iterator type and use | ||||
| it to build an iterator. An especially simple example of this is | ||||
| turning an integer type into an iterator, a counting iterator. The | ||||
| builtin integer types of C++ are almost iterators. They have | ||||
| <tt>operator++()</tt>, <tt>operator--()</tt>, etc. The one operator | ||||
| they are lacking is the <tt>operator*()</tt>, which we will want to | ||||
| simply return the current value of the integer. The following few | ||||
| lines of code implement the policy and traits class for the counting | ||||
| iterator. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| struct counting_iterator_policies : public default_iterator_policies | ||||
| { | ||||
|   template <class IntegerType> | ||||
|   IntegerType dereference(type<IntegerType>, const IntegerType& i) const | ||||
|     { return i; } | ||||
| }; | ||||
| template <class IntegerType> | ||||
| struct counting_iterator_traits { | ||||
|   typedef IntegerType value_type; | ||||
|   typedef IntegerType reference; | ||||
|   typedef value_type* pointer; | ||||
|   typedef std::ptrdiff_t difference_type; | ||||
|   typedef std::random_access_iterator_tag iterator_category; | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| Typically we will want to count the integers in some range, so a nice | ||||
| interface would be to have a fake container that represents the range | ||||
| of integers. The following is the definition of such a class called | ||||
| <tt>integer_range</tt>. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| template <class IntegerType> | ||||
| struct integer_range { | ||||
|   typedef typename iterator_adaptor<IntegerType,  | ||||
|                            counting_iterator_traits<IntegerType>, | ||||
|                            counting_iterator_policies >::type iterator; | ||||
|   typedef iterator const_iterator; | ||||
|   typedef IntegerType value_type; | ||||
|   typedef std::ptrdiff_t difference_type; | ||||
|   typedef IntegerType reference; | ||||
|   typedef IntegerType* pointer; | ||||
|   typedef IntegerType size_type; | ||||
|  | ||||
|   integer_range(IntegerType start, IntegerType finish) | ||||
|     : m_start(start), m_finish(finish) { } | ||||
|  | ||||
|   iterator begin() const { return iterator(m_start); } | ||||
|   iterator end() const { return iterator(m_finish); } | ||||
|   size_type size() const { return m_finish - m_start; } | ||||
|   bool empty() const { return m_finish == m_start; } | ||||
|   void swap(integer_range& x) { | ||||
|     std::swap(m_start, x.m_start); | ||||
|     std::swap(m_finish, x.m_finish); | ||||
|   } | ||||
| protected: | ||||
|   IntegerType m_start, m_finish; | ||||
| }; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <p> | ||||
| The following is an example of how to use the | ||||
| <tt>integer_range</tt> class to count from 0 to 4. | ||||
|  | ||||
| <p> | ||||
| <TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2> | ||||
| <TR><TD WIDTH=30 VALIGN=TOP></TD><TD> | ||||
| <PRE> | ||||
| boost::integer_range<int> r(0,5); | ||||
|  | ||||
| cout << "counting to from 0 to 4:" << endl; | ||||
| std::copy(r.begin(), r.end(), ostream_iterator<int>(cout, " ")); | ||||
| cout << endl; | ||||
| </PRE></TD></TABLE> | ||||
|  | ||||
| <h3>Challenge</h3> | ||||
|  | ||||
| <p> | ||||
| There is an unlimited number of ways the the | ||||
| <tt>iterator_adaptors</tt> class can be used to create iterators. One | ||||
| interesting exercise would be to re-implement the iterators of | ||||
| <tt>std::list</tt> and <tt>std::slist</tt> using | ||||
| <tt>iterator_adaptors</tt>, where the adapted <tt>Iterator</tt> types | ||||
| would be node pointers. | ||||
|  | ||||
|  | ||||
| <h3>Notes</h3> | ||||
|  | ||||
| <p> | ||||
| <a name="1">[1]</a> | ||||
| If your compiler does not support partial specialization and hence | ||||
| does not have a working <tt>std::iterator_traits</tt> class, you will | ||||
| not be able to use the defaults and will need to supply your own | ||||
| <tt>Traits</tt> and <tt>ConstTraits</tt> classes. | ||||
|  | ||||
| <p> | ||||
| <a name="2">[2]</a> | ||||
| The reference type could also be obtained from | ||||
| <tt>std::iterator_traits</tt>, but that is not portable on compilers | ||||
| that do not support partial specialization. | ||||
|  | ||||
| <p> | ||||
| <a name="3">[3]</a> | ||||
| It would have been more elegant to implement <tt>indirect_iterators</tt> | ||||
| using <tt>transform_iterators</tt>, but for subtle reasons that would require | ||||
| the use of <tt>boost::remove_cv</tt> which is not portable. | ||||
|  | ||||
| <h3>Implementation Notes</h3> | ||||
|  | ||||
| The code is somewhat complicated because there are three iterator | ||||
| adaptor class: <tt>forward_iterator_adaptor</tt>, | ||||
| <tt>bidirectional_iterator_adaptor</tt>, and | ||||
| <tt>random_access_iterator_adaptor</tt>. The alternative would be to | ||||
| just have one iterator adaptor equivalent to the | ||||
| <tt>random_access_iterator_adaptor</tt>.  The reason for going with | ||||
| the three adaptors is that according to 14.5.3p5 in the C++ Standard, | ||||
| friend functions defined inside a template class body are instantiated | ||||
| when the template class is instantiated. This means that if we only | ||||
| used the one iterator adaptor, then if the adapted iterator did not | ||||
| meet all of the requirements for a | ||||
| <a href="http://www.sgi.com/Technology/STL/RandomAccessIterator.html"> | ||||
| RandomAccessIterator</a> then a compiler error should occur.  Many | ||||
| current compilers in fact do not instantiate the friend functions | ||||
| unless used, so we could get away with the one iterator adaptor in | ||||
| most cases. However, out of respect for the standard this implementation | ||||
| uses the three adaptors. | ||||
|  | ||||
|  | ||||
|  | ||||
| <hr> | ||||
| <p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %b %Y" startspan -->17 Jun 2000<!--webbot bot="Timestamp" endspan i-checksum="15055" --></p> | ||||
| <p><EFBFBD> Copyright Jeremy Siek 2000. Permission to copy, use, | ||||
| modify, sell and distribute this document is granted provided this copyright | ||||
| notice appears in all copies. This document is provided "as is" | ||||
| without express or implied warranty, and with no claim as to its suitability for | ||||
| any purpose.</p> | ||||
|  | ||||
| <body> | ||||
| This documentation moved to <a href="../iterator/doc/index.html">../iterator/doc/index.html</a>. | ||||
| </body> | ||||
|  | ||||
| </html> | ||||
|   | ||||
| @@ -1,24 +1,36 @@ | ||||
| //  Demonstrate and test boost/operators.hpp on std::iterators  --------------// | ||||
|  | ||||
| //  (C) Copyright Jeremy Siek 1999. Permission to copy, use, modify, | ||||
| //  sell and distribute this software is granted provided this | ||||
| //  copyright notice appears in all copies. This software is provided | ||||
| //  "as is" without express or implied warranty, and with no claim as | ||||
| //  to its suitability for any purpose. | ||||
| //  (C) Copyright Jeremy Siek 1999. | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
|  | ||||
| //  Revision History | ||||
| //  29 May 01 Factored implementation, added comparison tests, use Test Tools | ||||
| //            library (Daryle Walker) | ||||
| //  12 Dec 99 Initial version with iterator operators (Jeremy Siek) | ||||
|  | ||||
| #include <string> | ||||
| #include <iostream> | ||||
| using namespace std; | ||||
| #define  BOOST_INCLUDE_MAIN | ||||
| #include <boost/test/test_tools.hpp>  // for main | ||||
|  | ||||
| #include <boost/operators.hpp> | ||||
| using namespace boost; | ||||
| #include <boost/config.hpp>     // for BOOST_STATIC_CONSTANT | ||||
| #include <boost/cstdlib.hpp>    // for boost::exit_success | ||||
| #include <boost/operators.hpp>  // for boost::random_access_iterator_helper | ||||
|  | ||||
| #include <cstddef>    // for std::ptrdiff_t, std::size_t | ||||
| #include <cstring>    // for std::strcmp | ||||
| #include <iostream>   // for std::cout (std::endl, ends, and flush indirectly) | ||||
| #include <string>     // for std::string | ||||
| #include <sstream>    // for std::stringstream | ||||
|  | ||||
| # ifdef BOOST_NO_STDC_NAMESPACE | ||||
|     namespace std { using ::strcmp; } | ||||
| # endif | ||||
|  | ||||
|  | ||||
| // Iterator test class | ||||
| template <class T, class R, class P> | ||||
| struct test_iter | ||||
|   : public boost::random_access_iterator_helper< | ||||
| @@ -29,7 +41,7 @@ struct test_iter | ||||
|   typedef std::ptrdiff_t Distance; | ||||
|  | ||||
| public: | ||||
|   test_iter(T* i) : _i(i) { } | ||||
|   explicit test_iter(T* i =0) : _i(i) { } | ||||
|   test_iter(const self& x) : _i(x._i) { } | ||||
|   self& operator=(const self& x) { _i = x._i; return *this; } | ||||
|   Reference operator*() const { return *_i; } | ||||
| @@ -43,127 +55,270 @@ public: | ||||
|     return x._i - y._i;  | ||||
|   } | ||||
| protected: | ||||
|   T* _i; | ||||
|   P _i; | ||||
| }; | ||||
|  | ||||
|  | ||||
| int | ||||
| main() | ||||
| // Iterator operator testing classes | ||||
| class test_opr_base | ||||
| { | ||||
|   string array[] = { "apple", "orange", "pear", "peach", "grape", "plum"  }; | ||||
|   { | ||||
|     test_iter<string,string&,string*> i = array,  | ||||
|       ie = array + sizeof(array)/sizeof(string); | ||||
| protected: | ||||
|     // Test data and types | ||||
|     BOOST_STATIC_CONSTANT( std::size_t, fruit_length = 6u ); | ||||
|  | ||||
|     // Tests for all of the operators added by random_access_iterator_helper | ||||
|     typedef std::string  fruit_array_type[ fruit_length ]; | ||||
|  | ||||
|     // test i++ | ||||
|     while (i != ie) | ||||
|       cout << *i++ << " "; | ||||
|     cout << endl; | ||||
|     i = array; | ||||
|     static  fruit_array_type    fruit; | ||||
|  | ||||
|     // test i-- | ||||
|     while (ie != i) { | ||||
|       ie--; | ||||
|       cout << *ie << " "; | ||||
|     } | ||||
|     cout << endl; | ||||
|     ie = array + sizeof(array)/sizeof(string); | ||||
| };  // test_opr_base | ||||
|  | ||||
|     // test i->m | ||||
|     while (i != ie) { | ||||
|       cout << i->size() << " "; | ||||
|       ++i; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
| #ifndef BOOST_NO_INCLASS_MEMBER_INITIALIZATION | ||||
| //  A definition is required even for integral static constants | ||||
| const std::size_t test_opr_base::fruit_length; | ||||
| #endif | ||||
|  | ||||
|     // test i + n | ||||
|     while (i < ie) { | ||||
|       cout << *i << " "; | ||||
|       i = i + 2; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
| template <typename T, typename R = T&, typename P = T*> | ||||
| class test_opr | ||||
|     : public test_opr_base | ||||
| { | ||||
|     typedef test_opr<T, R, P>  self_type; | ||||
|  | ||||
|     // test n + i | ||||
|     while (i < ie) { | ||||
|       cout << *i << " "; | ||||
|       i = ptrdiff_t(2) + i; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
| public: | ||||
|     // Types | ||||
|     typedef T  value_type; | ||||
|     typedef R  reference; | ||||
|     typedef P  pointer; | ||||
|  | ||||
|     // test i - n | ||||
|     while (ie > i) { | ||||
|       ie = ie - 2; | ||||
|       cout << *ie << " "; | ||||
|     } | ||||
|     cout << endl; | ||||
|     ie = array + sizeof(array)/sizeof(string); | ||||
|     typedef test_iter<T, R, P>  iter_type; | ||||
|  | ||||
|     // test i[n] | ||||
|     for (std::size_t j = 0; j < sizeof(array)/sizeof(string); ++j) | ||||
|       cout << i[j] << " "; | ||||
|     cout << endl; | ||||
|   } | ||||
|   { | ||||
|     test_iter<string, const string&, const string*> i = array,  | ||||
|       ie = array + sizeof(array)/sizeof(string); | ||||
|     // Test controller | ||||
|     static  void  master_test( char const name[] ); | ||||
|  | ||||
|     // Tests for all of the operators added by random_access_iterator_helper | ||||
| private: | ||||
|     // Test data | ||||
|     static iter_type const  fruit_begin; | ||||
|     static iter_type const  fruit_end; | ||||
|  | ||||
|     // test i++ | ||||
|     while (i != ie) | ||||
|       cout << *i++ << " "; | ||||
|     cout << endl; | ||||
|     i = array; | ||||
|     // Test parts | ||||
|     static  void  post_increment_test(); | ||||
|     static  void  post_decrement_test(); | ||||
|     static  void  indirect_referral_test(); | ||||
|     static  void  offset_addition_test(); | ||||
|     static  void  reverse_offset_addition_test(); | ||||
|     static  void  offset_subtraction_test(); | ||||
|     static  void  comparison_test(); | ||||
|     static  void  indexing_test(); | ||||
|  | ||||
|     // test i-- | ||||
|     while (ie != i) { | ||||
|       ie--; | ||||
|       cout << *ie << " "; | ||||
|     } | ||||
|     cout << endl; | ||||
|     ie = array + sizeof(array)/sizeof(string); | ||||
| };  // test_opr | ||||
|  | ||||
|     // test i->m | ||||
|     while (i != ie) { | ||||
|       cout << i->size() << " "; | ||||
|       ++i; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
|  | ||||
|     // test i + n | ||||
|     while (i < ie) { | ||||
|       cout << *i << " "; | ||||
|       i = i + 2; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
| // Class-static data definitions | ||||
| test_opr_base::fruit_array_type | ||||
|  test_opr_base::fruit = { "apple", "orange", "pear", "peach", "grape", "plum" }; | ||||
|  | ||||
|     // test n + i | ||||
|     while (i < ie) { | ||||
|       cout << *i << " "; | ||||
|       i = ptrdiff_t(2) + i; | ||||
|     } | ||||
|     cout << endl; | ||||
|     i = array; | ||||
| template <typename T, typename R, typename P> | ||||
|   typename test_opr<T, R, P>::iter_type const | ||||
|  test_opr<T, R, P>::fruit_begin = test_iter<T,R,P>( fruit ); | ||||
|  | ||||
|     // test i - n | ||||
|     while (ie > i) { | ||||
|       ie = ie - 2; | ||||
|       cout << *ie << " "; | ||||
|     } | ||||
|     cout << endl; | ||||
|     ie = array + sizeof(array)/sizeof(string); | ||||
| template <typename T, typename R, typename P> | ||||
| typename test_opr<T, R, P>::iter_type const | ||||
|  test_opr<T, R, P>::fruit_end = test_iter<T,R,P>( fruit + fruit_length ); | ||||
|  | ||||
|     // test i[n] | ||||
|     for (std::size_t j = 0; j < sizeof(array)/sizeof(string); ++j) | ||||
|       cout << i[j] << " "; | ||||
|     cout << endl; | ||||
|   } | ||||
|   return 0; | ||||
|  | ||||
| // Main testing function | ||||
| int | ||||
| test_main( int , char * [] ) | ||||
| { | ||||
|     using std::string; | ||||
|  | ||||
|     typedef test_opr<string, string &, string *>              test1_type; | ||||
|     typedef test_opr<string, string const &, string const *>  test2_type; | ||||
|  | ||||
|     test1_type::master_test( "non-const string" ); | ||||
|     test2_type::master_test( "const string" ); | ||||
|  | ||||
|     return boost::exit_success; | ||||
| } | ||||
|  | ||||
| // Tests for all of the operators added by random_access_iterator_helper | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::master_test | ||||
| ( | ||||
|     char const  name[] | ||||
| ) | ||||
| { | ||||
|     std::cout << "Doing test run for " << name << '.' << std::endl; | ||||
|  | ||||
|     post_increment_test(); | ||||
|     post_decrement_test(); | ||||
|     indirect_referral_test(); | ||||
|     offset_addition_test(); | ||||
|     reverse_offset_addition_test(); | ||||
|     offset_subtraction_test(); | ||||
|     comparison_test(); | ||||
|     indexing_test(); | ||||
| } | ||||
|  | ||||
| // Test post-increment | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::post_increment_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing post-increment test." << std::endl; | ||||
|  | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_begin ; i != fruit_end ; ) | ||||
|     { | ||||
|         oss << *i++ << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "apple orange pear peach grape plum "); | ||||
| } | ||||
|  | ||||
| // Test post-decrement | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::post_decrement_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing post-decrement test." << std::endl; | ||||
|  | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_end ; i != fruit_begin ; ) | ||||
|     { | ||||
|         i--; | ||||
|         oss << *i << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "plum grape peach pear orange apple "); | ||||
| } | ||||
|  | ||||
| // Test indirect structure referral | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::indirect_referral_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing indirect reference test." << std::endl; | ||||
|  | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_begin ; i != fruit_end ; ++i ) | ||||
|     { | ||||
|         oss << i->size() << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "5 6 4 5 5 4 "); | ||||
| } | ||||
|  | ||||
| // Test offset addition | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::offset_addition_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing offset addition test." << std::endl; | ||||
|  | ||||
|     std::ptrdiff_t const  two = 2; | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_begin ; i != fruit_end ; i = i + two ) | ||||
|     { | ||||
|         oss << *i << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "apple pear grape "); | ||||
| } | ||||
|  | ||||
| // Test offset addition, in reverse order | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::reverse_offset_addition_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing reverse offset addition test." << std::endl; | ||||
|  | ||||
|     std::ptrdiff_t const  two = 2; | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_begin ; i != fruit_end ; i = two + i ) | ||||
|     { | ||||
|         oss << *i << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "apple pear grape "); | ||||
| } | ||||
|  | ||||
| // Test offset subtraction | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::offset_subtraction_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing offset subtraction test." << std::endl; | ||||
|  | ||||
|     std::ptrdiff_t const  two = 2; | ||||
|     std::stringstream oss; | ||||
|     for ( iter_type i = fruit_end ; fruit_begin < i ; ) | ||||
|     { | ||||
|         i = i - two; | ||||
|         if ( (fruit_begin < i) || (fruit_begin == i) ) | ||||
|         { | ||||
|             oss << *i << ' '; | ||||
|         } | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "grape pear apple "); | ||||
| } | ||||
|  | ||||
| // Test comparisons | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::comparison_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     using std::cout; | ||||
|     using std::ptrdiff_t; | ||||
|  | ||||
|     cout << "\tDoing comparison tests.\n\t\tPass:"; | ||||
|  | ||||
|     for ( iter_type i = fruit_begin ; i != fruit_end ; ++i ) | ||||
|     { | ||||
|         ptrdiff_t const  i_offset = i - fruit_begin; | ||||
|  | ||||
|         cout << ' ' << *i << std::flush; | ||||
|         for ( iter_type j = fruit_begin ; j != fruit_end ; ++j ) | ||||
|         { | ||||
|             ptrdiff_t const  j_offset = j - fruit_begin; | ||||
|  | ||||
|             BOOST_CHECK( (i != j) == (i_offset != j_offset) ); | ||||
|             BOOST_CHECK( (i > j) == (i_offset > j_offset) ); | ||||
|             BOOST_CHECK( (i <= j) == (i_offset <= j_offset) ); | ||||
|             BOOST_CHECK( (i >= j) == (i_offset >= j_offset) ); | ||||
|         } | ||||
|     } | ||||
|     cout << std::endl; | ||||
| } | ||||
|  | ||||
| // Test indexing | ||||
| template <typename T, typename R, typename P> | ||||
| void | ||||
| test_opr<T, R, P>::indexing_test | ||||
| ( | ||||
| ) | ||||
| { | ||||
|     std::cout << "\tDoing indexing test." << std::endl; | ||||
|  | ||||
|     std::stringstream oss; | ||||
|     for ( std::size_t k = 0u ; k < fruit_length ; ++k ) | ||||
|     { | ||||
|         oss << fruit_begin[ k ] << ' '; | ||||
|     } | ||||
|  | ||||
|     BOOST_CHECK( oss.str() == "apple orange pear peach grape plum "); | ||||
| } | ||||
|   | ||||
| @@ -1,10 +1,8 @@ | ||||
| //  boost class noncopyable test program  ------------------------------------// | ||||
|  | ||||
| //  (C) Copyright boost.org 1999. Permission to copy, use, modify, sell | ||||
| //  and distribute this software is granted provided this copyright | ||||
| //  notice appears in all copies. This software is provided "as is" without | ||||
| //  express or implied warranty, and with no claim as to its suitability for | ||||
| //  any purpose. | ||||
| //  (C) Copyright Beman Dawes 1999. Distributed under the Boost | ||||
| //  Software License, Version 1.0. (See accompanying file | ||||
| //  LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
|  | ||||
| @@ -12,7 +10,7 @@ | ||||
| //   9 Jun 99  Add unnamed namespace | ||||
| //   2 Jun 99  Initial Version | ||||
|  | ||||
| #include <boost/utility.hpp> | ||||
| #include <boost/noncopyable.hpp> | ||||
| #include <iostream> | ||||
|  | ||||
| //  This program demonstrates compiler errors resulting from trying to copy | ||||
| @@ -20,7 +18,7 @@ | ||||
|  | ||||
| namespace | ||||
| { | ||||
|     class DontTreadOnMe : boost::noncopyable | ||||
|     class DontTreadOnMe : private boost::noncopyable | ||||
|     { | ||||
|     public: | ||||
|          DontTreadOnMe() { std::cout << "defanged!" << std::endl; } | ||||
| @@ -35,4 +33,4 @@ int main() | ||||
|     object1 = object2; | ||||
|     return 0; | ||||
| }   // main | ||||
|    | ||||
|    | ||||
|   | ||||
							
								
								
									
										405
									
								
								numeric_traits_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										405
									
								
								numeric_traits_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,405 @@ | ||||
| //  (C) Copyright David Abrahams 2001. | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  See http://www.boost.org for most recent version including documentation. | ||||
|  | ||||
| //  Revision History | ||||
| //  1  Apr 2001 Fixes for ICL; use BOOST_STATIC_CONSTANT | ||||
| //  11 Feb 2001 Fixes for Borland (David Abrahams) | ||||
| //  23 Jan 2001 Added test for wchar_t (David Abrahams) | ||||
| //  23 Jan 2001 Now statically selecting a test for signed numbers to avoid | ||||
| //              warnings with fancy compilers. Added commentary and | ||||
| //              additional dumping of traits data for tested types (David | ||||
| //              Abrahams). | ||||
| //  21 Jan 2001 Initial version (David Abrahams) | ||||
|  | ||||
| #include <boost/detail/numeric_traits.hpp> | ||||
| #include <cassert> | ||||
| #include <boost/type_traits.hpp> | ||||
| #include <boost/static_assert.hpp> | ||||
| #include <boost/cstdint.hpp> | ||||
| #include <boost/utility.hpp> | ||||
| #include <boost/lexical_cast.hpp> | ||||
| #include <climits> | ||||
| #include <typeinfo> | ||||
| #include <iostream> | ||||
| #include <string> | ||||
| #ifndef BOOST_NO_LIMITS | ||||
| # include <limits> | ||||
| #endif | ||||
|  | ||||
| // ================================================================================= | ||||
| // template class complement_traits<Number> -- | ||||
| // | ||||
| //    statically computes the max and min for 1s and 2s-complement binary | ||||
| //    numbers. This helps on platforms without <limits> support. It also shows | ||||
| //    an example of a recursive template that works with MSVC! | ||||
| // | ||||
|  | ||||
| template <unsigned size> struct complement; // forward | ||||
|  | ||||
| // The template complement, below, does all the real work, using "poor man's | ||||
| // partial specialization". We need complement_traits_aux<> so that MSVC doesn't | ||||
| // complain about undefined min/max as we're trying to recursively define them.  | ||||
| template <class Number, unsigned size> | ||||
| struct complement_traits_aux | ||||
| { | ||||
|     BOOST_STATIC_CONSTANT(Number, max = complement<size>::template traits<Number>::max); | ||||
|     BOOST_STATIC_CONSTANT(Number, min = complement<size>::template traits<Number>::min); | ||||
| }; | ||||
|  | ||||
| template <unsigned size> | ||||
| struct complement | ||||
| { | ||||
|     template <class Number> | ||||
|     struct traits | ||||
|     { | ||||
|      private: | ||||
|         // indirection through complement_traits_aux necessary to keep MSVC happy | ||||
|         typedef complement_traits_aux<Number, size - 1> prev; | ||||
|      public: | ||||
| #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2 | ||||
|       // GCC 4.0.2 ICEs on these C-style casts | ||||
|         BOOST_STATIC_CONSTANT(Number, max = | ||||
|                             Number((prev::max) << CHAR_BIT) | ||||
|                             + Number(UCHAR_MAX)); | ||||
|         BOOST_STATIC_CONSTANT(Number, min = Number((prev::min) << CHAR_BIT)); | ||||
| #else | ||||
|         BOOST_STATIC_CONSTANT(Number, max = | ||||
|                             Number(Number(prev::max) << CHAR_BIT) | ||||
|                             + Number(UCHAR_MAX)); | ||||
|         BOOST_STATIC_CONSTANT(Number, min = Number(Number(prev::min) << CHAR_BIT)); | ||||
| #endif | ||||
|     | ||||
|     }; | ||||
| }; | ||||
|  | ||||
| // Template class complement_base<> -- defines values for min and max for | ||||
| // complement<1>, at the deepest level of recursion. Uses "poor man's partial | ||||
| // specialization" again. | ||||
| template <bool is_signed> struct complement_base; | ||||
|  | ||||
| template <> struct complement_base<false> | ||||
| { | ||||
|     template <class Number> | ||||
|     struct values | ||||
|     { | ||||
|         BOOST_STATIC_CONSTANT(Number, min = 0); | ||||
|         BOOST_STATIC_CONSTANT(Number, max = UCHAR_MAX); | ||||
|     }; | ||||
| }; | ||||
|  | ||||
| template <> struct complement_base<true> | ||||
| { | ||||
|     template <class Number> | ||||
|     struct values | ||||
|     { | ||||
|         BOOST_STATIC_CONSTANT(Number, min = SCHAR_MIN); | ||||
|         BOOST_STATIC_CONSTANT(Number, max = SCHAR_MAX); | ||||
|     }; | ||||
| }; | ||||
|  | ||||
| // Base specialization of complement, puts an end to the recursion. | ||||
| template <> | ||||
| struct complement<1> | ||||
| { | ||||
|     template <class Number> | ||||
|     struct traits | ||||
|     { | ||||
|         BOOST_STATIC_CONSTANT(bool, is_signed = boost::detail::is_signed<Number>::value); | ||||
|         BOOST_STATIC_CONSTANT(Number, min = | ||||
|                             complement_base<is_signed>::template values<Number>::min); | ||||
|         BOOST_STATIC_CONSTANT(Number, max = | ||||
|                             complement_base<is_signed>::template values<Number>::max); | ||||
|     }; | ||||
| }; | ||||
|  | ||||
| // Now here's the "pretty" template you're intended to actually use. | ||||
| //   complement_traits<Number>::min, complement_traits<Number>::max are the | ||||
| //   minimum and maximum values of Number if Number is a built-in integer type. | ||||
| template <class Number> | ||||
| struct complement_traits | ||||
| { | ||||
|     BOOST_STATIC_CONSTANT(Number, max = (complement_traits_aux<Number, sizeof(Number)>::max)); | ||||
|     BOOST_STATIC_CONSTANT(Number, min = (complement_traits_aux<Number, sizeof(Number)>::min)); | ||||
| }; | ||||
|  | ||||
| // ================================================================================= | ||||
|  | ||||
| // Support for streaming various numeric types in exactly the format I want. I | ||||
| // needed this in addition to all the assertions so that I could see exactly | ||||
| // what was going on. | ||||
| // | ||||
| // Numbers go through a 2-stage conversion process (by default, though, no real | ||||
| // conversion). | ||||
| // | ||||
| template <class T> struct stream_as { | ||||
|     typedef T t1; | ||||
|     typedef T t2; | ||||
| }; | ||||
|  | ||||
| // char types first get converted to unsigned char, then to unsigned. | ||||
| template <> struct stream_as<char> { | ||||
|     typedef unsigned char t1; | ||||
|     typedef unsigned t2; | ||||
| }; | ||||
| template <> struct stream_as<unsigned char> { | ||||
|     typedef unsigned char t1; typedef unsigned t2; | ||||
| }; | ||||
| template <> struct stream_as<signed char>  { | ||||
|     typedef unsigned char t1; typedef unsigned t2; | ||||
| }; | ||||
|  | ||||
| #if defined(BOOST_MSVC_STD_ITERATOR) // No intmax streaming built-in | ||||
|  | ||||
| // With this library implementation, __int64 and __uint64 get streamed as strings | ||||
| template <> struct stream_as<boost::uintmax_t> { | ||||
|     typedef std::string t1; | ||||
|     typedef std::string t2; | ||||
| }; | ||||
|  | ||||
| template <> struct stream_as<boost::intmax_t>  { | ||||
|     typedef std::string t1; | ||||
|     typedef std::string t2; | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| // Standard promotion process for streaming | ||||
| template <class T> struct promote | ||||
| { | ||||
|     static typename stream_as<T>::t1 from(T x) { | ||||
|         typedef typename stream_as<T>::t1 t1; | ||||
|         return t1(x); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| #if defined(BOOST_MSVC_STD_ITERATOR) // No intmax streaming built-in | ||||
|  | ||||
| // On this platform, stream them as long/unsigned long if they fit. | ||||
| // Otherwise, write a string. | ||||
| template <> struct promote<boost::uintmax_t> { | ||||
|     std::string static from(const boost::uintmax_t x) { | ||||
|         if (x > ULONG_MAX) | ||||
|             return std::string("large unsigned value"); | ||||
|         else | ||||
|             return boost::lexical_cast<std::string>((unsigned long)x); | ||||
|     } | ||||
| }; | ||||
| template <> struct promote<boost::intmax_t> { | ||||
|     std::string static from(const boost::intmax_t x) { | ||||
|         if (x > boost::intmax_t(ULONG_MAX)) | ||||
|             return std::string("large positive signed value"); | ||||
|         else if (x >= 0) | ||||
|             return boost::lexical_cast<std::string>((unsigned long)x); | ||||
|          | ||||
|         if (x < boost::intmax_t(LONG_MIN)) | ||||
|             return std::string("large negative signed value"); | ||||
|         else | ||||
|             return boost::lexical_cast<std::string>((long)x); | ||||
|     } | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| // This is the function which converts types to the form I want to stream them in. | ||||
| template <class T> | ||||
| typename stream_as<T>::t2 stream_number(T x) | ||||
| { | ||||
|     return promote<T>::from(x); | ||||
| } | ||||
| // ================================================================================= | ||||
|  | ||||
| // | ||||
| // Tests for built-in signed and unsigned types | ||||
| // | ||||
|  | ||||
| // Tag types for selecting tests | ||||
| struct unsigned_tag {}; | ||||
| struct signed_tag {}; | ||||
|  | ||||
| // Tests for unsigned numbers. The extra default Number parameter works around | ||||
| // an MSVC bug. | ||||
| template <class Number> | ||||
| void test_aux(unsigned_tag, Number*) | ||||
| { | ||||
|     typedef typename boost::detail::numeric_traits<Number>::difference_type difference_type; | ||||
|     BOOST_STATIC_ASSERT(!boost::detail::is_signed<Number>::value); | ||||
|     BOOST_STATIC_ASSERT( | ||||
|         (sizeof(Number) < sizeof(boost::intmax_t)) | ||||
|         | (boost::is_same<difference_type, boost::intmax_t>::value)); | ||||
|  | ||||
| #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2 | ||||
|     // GCC 4.0.2 ICEs on this C-style cases | ||||
|     BOOST_STATIC_ASSERT((complement_traits<Number>::max) > Number(0)); | ||||
|     BOOST_STATIC_ASSERT((complement_traits<Number>::min) == Number(0)); | ||||
| #else | ||||
|     // Force casting to Number here to work around the fact that it's an enum on MSVC | ||||
|     BOOST_STATIC_ASSERT(Number(complement_traits<Number>::max) > Number(0)); | ||||
|     BOOST_STATIC_ASSERT(Number(complement_traits<Number>::min) == Number(0)); | ||||
| #endif | ||||
|  | ||||
|     const Number max = complement_traits<Number>::max; | ||||
|     const Number min = complement_traits<Number>::min; | ||||
|      | ||||
|     const Number test_max = (sizeof(Number) < sizeof(boost::intmax_t)) | ||||
|         ? max | ||||
|         : max / 2 - 1; | ||||
|  | ||||
|     std::cout << std::hex << "(unsigned) min = " << stream_number(min) << ", max = " | ||||
|               << stream_number(max) << "..." << std::flush; | ||||
|     std::cout << "difference_type = " << typeid(difference_type).name() << "..." | ||||
|               << std::flush; | ||||
|      | ||||
|     difference_type d1 = boost::detail::numeric_distance(Number(0), test_max); | ||||
|     difference_type d2 = boost::detail::numeric_distance(test_max, Number(0)); | ||||
|      | ||||
|     std::cout << "0->" << stream_number(test_max) << "==" << std::dec << stream_number(d1) << "; " | ||||
|               << std::hex << stream_number(test_max) << "->0==" << std::dec << stream_number(d2) << "..." << std::flush; | ||||
|  | ||||
|     assert(d1 == difference_type(test_max)); | ||||
|     assert(d2 == -difference_type(test_max)); | ||||
| } | ||||
|  | ||||
| // Tests for signed numbers. The extra default Number parameter works around an | ||||
| // MSVC bug. | ||||
| struct out_of_range_tag {}; | ||||
| struct in_range_tag {}; | ||||
|  | ||||
| // This test morsel gets executed for numbers whose difference will always be | ||||
| // representable in intmax_t | ||||
| template <class Number> | ||||
| void signed_test(in_range_tag, Number*) | ||||
| { | ||||
|     BOOST_STATIC_ASSERT(boost::detail::is_signed<Number>::value); | ||||
|     typedef typename boost::detail::numeric_traits<Number>::difference_type difference_type; | ||||
|     const Number max = complement_traits<Number>::max; | ||||
|     const Number min = complement_traits<Number>::min; | ||||
|      | ||||
|     difference_type d1 = boost::detail::numeric_distance(min, max); | ||||
|     difference_type d2 = boost::detail::numeric_distance(max, min); | ||||
|  | ||||
|     std::cout << stream_number(min) << "->" << stream_number(max) << "=="; | ||||
|     std::cout << std::dec << stream_number(d1) << "; "; | ||||
|     std::cout << std::hex << stream_number(max) << "->" << stream_number(min) | ||||
|               << "==" << std::dec << stream_number(d2) << "..." << std::flush; | ||||
|     assert(d1 == difference_type(max) - difference_type(min)); | ||||
|     assert(d2 == difference_type(min) - difference_type(max)); | ||||
| } | ||||
|  | ||||
| // This test morsel gets executed for numbers whose difference may exceed the | ||||
| // capacity of intmax_t. | ||||
| template <class Number> | ||||
| void signed_test(out_of_range_tag, Number*) | ||||
| { | ||||
|     BOOST_STATIC_ASSERT(boost::detail::is_signed<Number>::value); | ||||
|     typedef typename boost::detail::numeric_traits<Number>::difference_type difference_type; | ||||
|     const Number max = complement_traits<Number>::max; | ||||
|     const Number min = complement_traits<Number>::min; | ||||
|  | ||||
|     difference_type min_distance = complement_traits<difference_type>::min; | ||||
|     difference_type max_distance = complement_traits<difference_type>::max; | ||||
|  | ||||
|     const Number n1 = Number(min + max_distance); | ||||
|     const Number n2 = Number(max + min_distance); | ||||
|     difference_type d1 = boost::detail::numeric_distance(min, n1); | ||||
|     difference_type d2 = boost::detail::numeric_distance(max, n2); | ||||
|  | ||||
|     std::cout << stream_number(min) << "->" << stream_number(n1) << "=="; | ||||
|     std::cout << std::dec << stream_number(d1) << "; "; | ||||
|     std::cout << std::hex << stream_number(max) << "->" << stream_number(n2) | ||||
|               << "==" << std::dec << stream_number(d2) << "..." << std::flush; | ||||
|     assert(d1 == max_distance); | ||||
|     assert(d2 == min_distance); | ||||
| } | ||||
|  | ||||
| template <class Number> | ||||
| void test_aux(signed_tag, Number*) | ||||
| { | ||||
|     typedef typename boost::detail::numeric_traits<Number>::difference_type difference_type; | ||||
|     BOOST_STATIC_ASSERT(boost::detail::is_signed<Number>::value); | ||||
|     BOOST_STATIC_ASSERT( | ||||
|         (sizeof(Number) < sizeof(boost::intmax_t)) | ||||
|         | (boost::is_same<difference_type, Number>::value)); | ||||
|  | ||||
| #if defined(__GNUC__) && __GNUC__ == 4 && __GNUC_MINOR__ == 0 && __GNUC_PATCHLEVEL__ == 2 | ||||
|     // GCC 4.0.2 ICEs on this cast | ||||
|     BOOST_STATIC_ASSERT((complement_traits<Number>::max) > Number(0)); | ||||
|     BOOST_STATIC_ASSERT((complement_traits<Number>::min) < Number(0)); | ||||
| #else | ||||
|     // Force casting to Number here to work around the fact that it's an enum on MSVC | ||||
|     BOOST_STATIC_ASSERT(Number(complement_traits<Number>::max) > Number(0)); | ||||
|     BOOST_STATIC_ASSERT(Number(complement_traits<Number>::min) < Number(0)); | ||||
| #endif     | ||||
|     const Number max = complement_traits<Number>::max; | ||||
|     const Number min = complement_traits<Number>::min; | ||||
|      | ||||
|     std::cout << std::hex << "min = " << stream_number(min) << ", max = " | ||||
|               << stream_number(max) << "..." << std::flush; | ||||
|     std::cout << "difference_type = " << typeid(difference_type).name() << "..." | ||||
|               << std::flush; | ||||
|  | ||||
|     typedef typename boost::detail::if_true< | ||||
|                           (sizeof(Number) < sizeof(boost::intmax_t))> | ||||
|                         ::template then< | ||||
|                           in_range_tag, | ||||
|                           out_of_range_tag | ||||
|                         >::type | ||||
|         range_tag; | ||||
|     signed_test<Number>(range_tag(), 0); | ||||
| } | ||||
|  | ||||
|  | ||||
| // Test for all numbers. The extra default Number parameter works around an MSVC | ||||
| // bug. | ||||
| template <class Number> | ||||
| void test(Number* = 0) | ||||
| { | ||||
|     std::cout << "testing " << typeid(Number).name() << ":\n" | ||||
| #ifndef BOOST_NO_LIMITS_COMPILE_TIME_CONSTANTS | ||||
|               << "is_signed: " << (std::numeric_limits<Number>::is_signed ? "true\n" : "false\n") | ||||
|               << "is_bounded: " << (std::numeric_limits<Number>::is_bounded ? "true\n" : "false\n") | ||||
|               << "digits: " << std::numeric_limits<Number>::digits << "\n" | ||||
| #endif | ||||
|               << "..." << std::flush; | ||||
|  | ||||
|     // factoring out difference_type for the assert below confused Borland :( | ||||
|     typedef boost::detail::is_signed< | ||||
| #if !defined(BOOST_MSVC) || BOOST_MSVC > 1300 | ||||
|         typename | ||||
| #endif | ||||
|         boost::detail::numeric_traits<Number>::difference_type | ||||
|         > is_signed; | ||||
|     BOOST_STATIC_ASSERT(is_signed::value); | ||||
|  | ||||
|     typedef typename boost::detail::if_true< | ||||
|         boost::detail::is_signed<Number>::value | ||||
|         >::template then<signed_tag, unsigned_tag>::type signedness; | ||||
|      | ||||
|     test_aux<Number>(signedness(), 0); | ||||
|     std::cout << "passed" << std::endl; | ||||
| } | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     test<char>(); | ||||
|     test<unsigned char>(); | ||||
|     test<signed char>(); | ||||
|     test<wchar_t>(); | ||||
|     test<short>(); | ||||
|     test<unsigned short>(); | ||||
|     test<int>(); | ||||
|     test<unsigned int>(); | ||||
|     test<long>(); | ||||
|     test<unsigned long>(); | ||||
| #if defined(BOOST_HAS_LONG_LONG) && !defined(BOOST_NO_INTEGRAL_INT64_T) | ||||
|     test< ::boost::long_long_type>(); | ||||
|     test< ::boost::ulong_long_type>(); | ||||
| #elif defined(BOOST_MSVC) | ||||
|     // The problem of not having compile-time static class constants other than | ||||
|     // enums prevents this from working, since values get truncated. | ||||
|     // test<boost::uintmax_t>(); | ||||
|     // test<boost::intmax_t>(); | ||||
| #endif | ||||
|     return 0; | ||||
| } | ||||
							
								
								
									
										2571
									
								
								operators.htm
									
									
									
									
									
								
							
							
						
						
									
										2571
									
								
								operators.htm
									
									
									
									
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
										
											
												File diff suppressed because it is too large
												Load Diff
											
										
									
								
							
							
								
								
									
										134
									
								
								ref_ct_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										134
									
								
								ref_ct_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,134 @@ | ||||
| // Copyright David Abrahams and Aleksey Gurtovoy | ||||
| // 2002-2004. Distributed under the Boost Software License, Version | ||||
| // 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // compile-time test for "boost/ref.hpp" header content | ||||
| // see 'ref_test.cpp' for run-time part | ||||
|  | ||||
| #include <boost/ref.hpp> | ||||
| #include <boost/type_traits/is_same.hpp> | ||||
| #include <boost/type_traits/remove_const.hpp> | ||||
| #include <boost/static_assert.hpp> | ||||
| #include <boost/detail/workaround.hpp> | ||||
|  | ||||
| #include <boost/mpl/assert.hpp> | ||||
|  | ||||
| namespace { | ||||
|  | ||||
| template< typename T, typename U > | ||||
| void ref_test(boost::reference_wrapper<U>) | ||||
| { | ||||
|     typedef typename boost::reference_wrapper<U>::type type; | ||||
|     BOOST_STATIC_ASSERT((boost::is_same<U,type>::value)); | ||||
|     BOOST_STATIC_ASSERT((boost::is_same<T,type>::value)); | ||||
| } | ||||
|  | ||||
| template< typename T > | ||||
| void assignable_test(T x) | ||||
| { | ||||
|     x = x; | ||||
| } | ||||
|  | ||||
| template< bool R, typename T > | ||||
| void is_reference_wrapper_test(T) | ||||
| { | ||||
|     BOOST_STATIC_ASSERT(boost::is_reference_wrapper<T>::value == R); | ||||
| } | ||||
|  | ||||
| template< typename R, typename Ref > | ||||
| void cxx_reference_test(Ref) | ||||
| { | ||||
| #if BOOST_WORKAROUND(__BORLANDC__, < 0x600) | ||||
|     typedef typename boost::remove_const<Ref>::type ref; | ||||
|     BOOST_STATIC_ASSERT((boost::is_same<R,ref>::value)); | ||||
| #else | ||||
|     BOOST_STATIC_ASSERT((boost::is_same<R,Ref>::value)); | ||||
| #endif | ||||
| } | ||||
|  | ||||
| template< typename R, typename Ref > | ||||
| void unwrap_reference_test(Ref) | ||||
| { | ||||
| #if BOOST_WORKAROUND(__BORLANDC__, < 0x600) | ||||
|     typedef typename boost::remove_const<Ref>::type ref; | ||||
|     typedef typename boost::unwrap_reference<ref>::type type; | ||||
| #else | ||||
|     typedef typename boost::unwrap_reference<Ref>::type type; | ||||
| #endif | ||||
|     BOOST_STATIC_ASSERT((boost::is_same<R,type>::value)); | ||||
| } | ||||
|  | ||||
| } // namespace | ||||
|  | ||||
| int main() | ||||
| { | ||||
|     int i = 0; | ||||
|     int& ri = i; | ||||
|  | ||||
|     int const ci = 0; | ||||
|     int const& rci = ci; | ||||
|  | ||||
|     // 'ref/cref' functions test | ||||
|     ref_test<int>(boost::ref(i)); | ||||
|     ref_test<int>(boost::ref(ri)); | ||||
|     ref_test<int const>(boost::ref(ci)); | ||||
|     ref_test<int const>(boost::ref(rci)); | ||||
|  | ||||
|     ref_test<int const>(boost::cref(i)); | ||||
|     ref_test<int const>(boost::cref(ri)); | ||||
|     ref_test<int const>(boost::cref(ci)); | ||||
|     ref_test<int const>(boost::cref(rci)); | ||||
|  | ||||
|     // test 'assignable' requirement | ||||
|     assignable_test(boost::ref(i)); | ||||
|     assignable_test(boost::ref(ri)); | ||||
|     assignable_test(boost::cref(i)); | ||||
|     assignable_test(boost::cref(ci)); | ||||
|     assignable_test(boost::cref(rci)); | ||||
|  | ||||
|     // 'is_reference_wrapper' test | ||||
|     is_reference_wrapper_test<true>(boost::ref(i)); | ||||
|     is_reference_wrapper_test<true>(boost::ref(ri)); | ||||
|     is_reference_wrapper_test<true>(boost::cref(i)); | ||||
|     is_reference_wrapper_test<true>(boost::cref(ci)); | ||||
|     is_reference_wrapper_test<true>(boost::cref(rci)); | ||||
|  | ||||
|     is_reference_wrapper_test<false>(i); | ||||
|     is_reference_wrapper_test<false, int&>(ri); | ||||
|     is_reference_wrapper_test<false>(ci); | ||||
|     is_reference_wrapper_test<false, int const&>(rci); | ||||
|  | ||||
|     // ordinary references/function template arguments deduction test | ||||
|     cxx_reference_test<int>(i); | ||||
|     cxx_reference_test<int>(ri); | ||||
|     cxx_reference_test<int>(ci); | ||||
|     cxx_reference_test<int>(rci); | ||||
|  | ||||
|     cxx_reference_test<int&, int&>(i); | ||||
|     cxx_reference_test<int&, int&>(ri); | ||||
|     cxx_reference_test<int const&, int const&>(i); | ||||
|     cxx_reference_test<int const&, int const&>(ri); | ||||
|     cxx_reference_test<int const&, int const&>(ci); | ||||
|     cxx_reference_test<int const&, int const&>(rci); | ||||
|  | ||||
|     // 'unwrap_reference' test | ||||
|     unwrap_reference_test<int>(boost::ref(i)); | ||||
|     unwrap_reference_test<int>(boost::ref(ri)); | ||||
|     unwrap_reference_test<int const>(boost::cref(i)); | ||||
|     unwrap_reference_test<int const>(boost::cref(ci)); | ||||
|     unwrap_reference_test<int const>(boost::cref(rci)); | ||||
|  | ||||
|     unwrap_reference_test<int>(i); | ||||
|     unwrap_reference_test<int>(ri); | ||||
|     unwrap_reference_test<int>(ci); | ||||
|     unwrap_reference_test<int>(rci); | ||||
|     unwrap_reference_test<int&, int&>(i); | ||||
|     unwrap_reference_test<int&, int&>(ri); | ||||
|     unwrap_reference_test<int const&, int const&>(i); | ||||
|     unwrap_reference_test<int const&, int const&>(ri); | ||||
|     unwrap_reference_test<int const&, int const&>(ci); | ||||
|     unwrap_reference_test<int const&, int const&>(rci); | ||||
|  | ||||
|     return 0; | ||||
| } | ||||
							
								
								
									
										78
									
								
								ref_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										78
									
								
								ref_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,78 @@ | ||||
| // Copyright David Abrahams and Aleksey Gurtovoy | ||||
| // 2002-2004. Distributed under the Boost Software License, Version | ||||
| // 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // run-time test for "boost/ref.hpp" header content | ||||
| // see 'ref_ct_test.cpp' for compile-time part | ||||
|  | ||||
| #if defined(_MSC_VER) && !defined(__ICL) | ||||
| # pragma warning(disable: 4786)  // identifier truncated in debug info | ||||
| # pragma warning(disable: 4710)  // function not inlined | ||||
| # pragma warning(disable: 4711)  // function selected for automatic inline expansion | ||||
| # pragma warning(disable: 4514)  // unreferenced inline removed | ||||
| #endif | ||||
|  | ||||
| #include <boost/ref.hpp> | ||||
|  | ||||
| #if defined(BOOST_MSVC) && (BOOST_MSVC < 1300) | ||||
| # pragma warning(push, 3) | ||||
| #endif | ||||
|  | ||||
| #include <iostream> | ||||
|  | ||||
| #if defined(BOOST_MSVC) && (BOOST_MSVC < 1300) | ||||
| # pragma warning(pop) | ||||
| #endif | ||||
|  | ||||
|  | ||||
| #define BOOST_INCLUDE_MAIN | ||||
| #include <boost/test/test_tools.hpp> | ||||
|  | ||||
| namespace { | ||||
| using namespace boost; | ||||
|  | ||||
| template <class T> | ||||
| struct ref_wrapper | ||||
| { | ||||
|     // Used to verify implicit conversion | ||||
|     static T* get_pointer(T& x) | ||||
|     { | ||||
|         return &x; | ||||
|     } | ||||
|  | ||||
|     static T const* get_const_pointer(T const& x) | ||||
|     { | ||||
|         return &x; | ||||
|     } | ||||
|  | ||||
|     template <class Arg> | ||||
|     static T* passthru(Arg x) | ||||
|     { | ||||
|         return get_pointer(x); | ||||
|     } | ||||
|  | ||||
|     template <class Arg> | ||||
|     static T const* cref_passthru(Arg x) | ||||
|     { | ||||
|         return get_const_pointer(x); | ||||
|     } | ||||
|  | ||||
|     static void test(T x) | ||||
|     { | ||||
|         BOOST_CHECK(passthru(ref(x)) == &x); | ||||
|         BOOST_CHECK(&ref(x).get() == &x); | ||||
|  | ||||
|         BOOST_CHECK(cref_passthru(cref(x)) == &x); | ||||
|         BOOST_CHECK(&cref(x).get() == &x); | ||||
|     } | ||||
| }; | ||||
|  | ||||
| } // namespace unnamed | ||||
|  | ||||
| int test_main(int, char * []) | ||||
| { | ||||
|     ref_wrapper<int>::test(1); | ||||
|     ref_wrapper<int const>::test(1); | ||||
|     return 0; | ||||
| } | ||||
							
								
								
									
										322
									
								
								shared_container_iterator.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										322
									
								
								shared_container_iterator.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,322 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> | ||||
| <meta name="ProgId" content="FrontPage.Editor.Document"> | ||||
| <title>Shared Container Iterator Documentation</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|  | ||||
| <img src="../../boost.png" alt="boost.png (6897 bytes)" | ||||
| align="center" width="277" height="86"> | ||||
|  | ||||
| <h1>Shared Container Iterator</h1> | ||||
|  | ||||
| Defined in header | ||||
| <a href="../../boost/shared_container_iterator.hpp">boost/shared_container_iterator.hpp</a> | ||||
|  | ||||
| <p> | ||||
| The purpose of the shared container iterator is to attach the lifetime | ||||
| of a container to the lifetime of its iterators. In other words, the | ||||
| container will not be deleted until after all its iterators are | ||||
| destroyed.  The shared container iterator is typically used to | ||||
| implement functions that return iterators over a range of objects that | ||||
| only need to exist for the lifetime of the iterators.  By returning a | ||||
| pair of shared iterators from a function, the callee can return a | ||||
| heap-allocated range of objects whose lifetime is automatically managed. | ||||
| <p> | ||||
| The shared container iterator augments an iterator over a shared | ||||
| container.  It maintains a reference count on the shared  | ||||
| container. If only shared container iterators hold references to | ||||
| the container, the container's lifetime will end when the last shared | ||||
| container iterator over it is destroyed.  In any case, the shared | ||||
| container is guaranteed to persist beyond the lifetime of all | ||||
| the iterators. In all other ways, the | ||||
| shared container iterator behaves the same as its base iterator. | ||||
|  | ||||
|  | ||||
| <h2>Synopsis</h2> | ||||
|  | ||||
| <pre> | ||||
| namespace boost { | ||||
|   template <typename <a href="http://www.sgi.com/tech/stl/Container.html">Container</a>> | ||||
|   class shared_container_iterator; | ||||
|  | ||||
|   template <typename <a href="http://www.sgi.com/tech/stl/Container.html">Container</a>> | ||||
|   shared_container_iterator<Container> | ||||
|   make_shared_container_iterator(typename Container::iterator base,  | ||||
|     boost::shared_ptr<Container> const& container); | ||||
|  | ||||
|   std::pair< | ||||
|     typename shared_container_iterator<Container>, | ||||
|     typename shared_container_iterator<Container> | ||||
|   > | ||||
|   make_shared_container_range(boost::shared_ptr<Container> const& container); | ||||
| } | ||||
| </pre> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <h2><a name="generator">The Shared Container Iterator Type</a></h2> | ||||
|  | ||||
| <pre> | ||||
| template <typename Container> class shared_container_iterator; | ||||
| </pre> | ||||
|  | ||||
| The class template <tt>shared_container_iterator</tt>  | ||||
| is the shared container iterator type.  The <tt>Container</tt> template | ||||
| type argument must model the | ||||
| <a href="http://www.sgi.com/tech/stl/Container.html">Container</a> | ||||
| concept. | ||||
|  | ||||
| <h3>Example</h3> | ||||
|  | ||||
| <p> | ||||
| The following example illustrates how to create an iterator that  | ||||
| regulates the lifetime of a reference counted <tt>std::vector</tt>. | ||||
| Though the original shared pointer <tt>ints</tt> ceases to exist | ||||
| after <tt>set_range()</tt> returns, the | ||||
| <tt>shared_counter_iterator</tt> objects maintain references to the | ||||
|       underlying vector and thereby extend the container's lifetime. | ||||
| <p> | ||||
| <a href="./shared_iterator_example1.cpp">shared_iterator_example1.cpp</a>: | ||||
| <PRE> | ||||
| <font color="#008040">#include "shared_container_iterator.hpp"</font> | ||||
| <font color="#008040">#include "boost/shared_ptr.hpp"</font> | ||||
| <font color="#008040">#include <algorithm></font> | ||||
| <font color="#008040">#include <iostream></font> | ||||
| <font color="#008040">#include <vector></font> | ||||
|  | ||||
| <B>typedef</B> boost::shared_container_iterator< std::vector<<B>int</B>> > iterator; | ||||
|  | ||||
|  | ||||
| <B>void</B> set_range(iterator& i, iterator& end)  { | ||||
|  | ||||
|   boost::shared_ptr< std::vector<<B>int</B>> > ints(<B>new</B> std::vector<<B>int</B>>()); | ||||
|    | ||||
|   ints->push_back(<font color="#0000A0">0</font>); | ||||
|   ints->push_back(<font color="#0000A0">1</font>); | ||||
|   ints->push_back(<font color="#0000A0">2</font>); | ||||
|   ints->push_back(<font color="#0000A0">3</font>); | ||||
|   ints->push_back(<font color="#0000A0">4</font>); | ||||
|   ints->push_back(<font color="#0000A0">5</font>); | ||||
|    | ||||
|   i = iterator(ints->begin(),ints); | ||||
|   end = iterator(ints->end(),ints); | ||||
| } | ||||
|  | ||||
|  | ||||
| <B>int</B> main() { | ||||
|  | ||||
|   iterator i,end; | ||||
|  | ||||
|   set_range(i,end); | ||||
|  | ||||
|   std::copy(i,end,std::ostream_iterator<<B>int</B>>(std::cout,<font color="#0000FF">","</font>)); | ||||
|   std::cout.put(<font color="#0000FF">'\n'</font>); | ||||
|  | ||||
|   <B>return</B> <font color="#0000A0">0</font>; | ||||
| } | ||||
| </PRE> | ||||
|  | ||||
| The output from this part is: | ||||
| <pre> | ||||
| 0,1,2,3,4,5, | ||||
| </pre> | ||||
|  | ||||
| <h3>Template Parameters</h3> | ||||
|  | ||||
| <Table border> | ||||
| <TR> | ||||
| <TH>Parameter</TH><TH>Description</TH> | ||||
| </TR> | ||||
|  | ||||
| <TR> | ||||
| <TD><a | ||||
| href="http://www.sgi.com/tech/stl/Container.html"><tt>Container</tt></a></TD> | ||||
| <TD>The type of the container that we wish to iterate over. It must be  | ||||
| a model of the  | ||||
| <a href="http://www.sgi.com/tech/stl/Container.html"><tt>Container</tt></a> | ||||
| concept. | ||||
| </TD> | ||||
| </TR> | ||||
| </Table> | ||||
|  | ||||
| <h3>Model of</h3> | ||||
|  | ||||
| The <tt>shared_container_iterator<Container></tt> type models the | ||||
| same iterator concept as the base iterator | ||||
|     (<tt>Container::iterator</tt>). | ||||
|  | ||||
| <h3>Members</h3> | ||||
|  | ||||
| The shared container iterator type implements the member functions and | ||||
| operators required of the <a | ||||
| href="http://www.sgi.com/tech/stl/RandomAccessIterator.html">Random Access Iterator</a> | ||||
| concept, though only operations defined for the base iterator will be valid. | ||||
| In addition it has the following constructor: | ||||
|  | ||||
| <pre> | ||||
| shared_container_iterator(Container::iterator const& it, | ||||
|                           boost::shared_ptr<Container> const& container) | ||||
| </pre> | ||||
|  | ||||
| <p> | ||||
| <hr> | ||||
| <p> | ||||
|  | ||||
|  | ||||
| <h2><a name="make_iterator">The Shared Container Iterator Object Generator</a></h2> | ||||
|  | ||||
| <pre> | ||||
| template <typename Container> | ||||
| shared_container_iterator<Container> | ||||
| make_shared_container_iterator(Container::iterator base, | ||||
|                                boost::shared_ptr<Container> const& container) | ||||
| </pre> | ||||
|  | ||||
| This function provides an alternative to directly constructing a | ||||
| shared container iterator.  Using the object generator, a shared | ||||
| container iterator can be created and passed to a function without | ||||
| explicitly specifying its type. | ||||
|  | ||||
| <h3>Example</h3> | ||||
|  | ||||
| This example, similar to the previous, uses  | ||||
| <tt>make_shared_container_iterator()</tt> to create the iterators. | ||||
|  | ||||
| <p> | ||||
| <a href="./shared_iterator_example2.cpp">shared_iterator_example2.cpp</a>: | ||||
|  | ||||
| <PRE> | ||||
| <font color="#008040">#include "shared_container_iterator.hpp"</font> | ||||
| <font color="#008040">#include "boost/shared_ptr.hpp"</font> | ||||
| <font color="#008040">#include <algorithm></font> | ||||
| <font color="#008040">#include <iterator></font> | ||||
| <font color="#008040">#include <iostream></font> | ||||
| <font color="#008040">#include <vector></font> | ||||
|  | ||||
|  | ||||
| <B>template</B> <<B>typename</B> Iterator> | ||||
| <B>void</B> print_range_nl (Iterator begin, Iterator end) { | ||||
|   <B>typedef</B> <B>typename</B> std::iterator_traits<Iterator>::value_type val; | ||||
|   std::copy(begin,end,std::ostream_iterator<val>(std::cout,<font color="#0000FF">","</font>)); | ||||
|   std::cout.put(<font color="#0000FF">'\n'</font>); | ||||
| } | ||||
|  | ||||
|  | ||||
| <B>int</B> main() { | ||||
|  | ||||
|   <B>typedef</B> boost::shared_ptr< std::vector<<B>int</B>> > ints_t; | ||||
|   { | ||||
|     ints_t ints(<B>new</B> std::vector<<B>int</B>>()); | ||||
|  | ||||
|     ints->push_back(<font color="#0000A0">0</font>); | ||||
|     ints->push_back(<font color="#0000A0">1</font>); | ||||
|     ints->push_back(<font color="#0000A0">2</font>); | ||||
|     ints->push_back(<font color="#0000A0">3</font>); | ||||
|     ints->push_back(<font color="#0000A0">4</font>); | ||||
|     ints->push_back(<font color="#0000A0">5</font>); | ||||
|  | ||||
|     print_range_nl(boost::make_shared_container_iterator(ints->begin(),ints), | ||||
| 		   boost::make_shared_container_iterator(ints->end(),ints)); | ||||
|   } | ||||
|    | ||||
|  | ||||
|  | ||||
|   <B>return</B> <font color="#0000A0">0</font>; | ||||
| } | ||||
| </PRE> | ||||
|  | ||||
| Observe that the <tt>shared_container_iterator</tt> type is never | ||||
| explicitly named. The output from this example is the same as the previous. | ||||
|  | ||||
| <h2><a name="make_range">The Shared Container Iterator Range Generator</a></h2> | ||||
|  | ||||
| <pre> | ||||
| template <typename Container> | ||||
| std::pair< | ||||
|   shared_container_iterator<Container>, | ||||
|   shared_container_iterator<Container> | ||||
| > | ||||
| make_shared_container_range(boost::shared_ptr<Container> const& container); | ||||
| </pre> | ||||
|  | ||||
| Class <tt>shared_container_iterator</tt> is meant primarily to return, | ||||
| using iterators, a range of values that we can guarantee will be alive as  | ||||
| long as the iterators are. This is a convenience | ||||
| function to do just that. It is equivalent to | ||||
|  | ||||
| <pre> | ||||
| std::make_pair(make_shared_container_iterator(container->begin(),container), | ||||
|                make_shared_container_iterator(container->end(),container)); | ||||
| </pre> | ||||
|  | ||||
| <h3>Example</h3> | ||||
|  | ||||
| In the following example, a range of values is returned as a pair of | ||||
| <tt>shared_container_iterator</tt> objects.   | ||||
|  | ||||
|  | ||||
| <p> | ||||
| <a href="./shared_iterator_example3.cpp">shared_iterator_example3.cpp</a>: | ||||
|  | ||||
| <PRE> | ||||
| <font color="#008040">#include "shared_container_iterator.hpp"</font> | ||||
| <font color="#008040">#include "boost/shared_ptr.hpp"</font> | ||||
| <font color="#008040">#include "boost/tuple/tuple.hpp" // for boost::tie</font> | ||||
| <font color="#008040">#include <algorithm>              // for std::copy</font> | ||||
| <font color="#008040">#include <iostream>              </font> | ||||
| <font color="#008040">#include <vector></font> | ||||
|  | ||||
|  | ||||
| <B>typedef</B> boost::shared_container_iterator< std::vector<<B>int</B>> > iterator;  | ||||
|  | ||||
| std::pair<iterator,iterator> | ||||
| return_range() { | ||||
|   boost::shared_ptr< std::vector<<B>int</B>> > range(<B>new</B> std::vector<<B>int</B>>()); | ||||
|   range->push_back(<font color="#0000A0">0</font>); | ||||
|   range->push_back(<font color="#0000A0">1</font>); | ||||
|   range->push_back(<font color="#0000A0">2</font>); | ||||
|   range->push_back(<font color="#0000A0">3</font>); | ||||
|   range->push_back(<font color="#0000A0">4</font>); | ||||
|   range->push_back(<font color="#0000A0">5</font>); | ||||
|   <B>return</B> boost::make_shared_container_range(range); | ||||
| } | ||||
|  | ||||
|  | ||||
| <B>int</B> main() { | ||||
|  | ||||
|  | ||||
|   iterator i,end; | ||||
|    | ||||
|   boost::tie(i,end) = return_range(); | ||||
|  | ||||
|   std::copy(i,end,std::ostream_iterator<<B>int</B>>(std::cout,<font color="#0000FF">","</font>)); | ||||
|   std::cout.put(<font color="#0000FF">'\n'</font>); | ||||
|  | ||||
|   <B>return</B> <font color="#0000A0">0</font>; | ||||
| } | ||||
| </PRE> | ||||
|  | ||||
| Though the <tt>range</tt> object only lives for the duration of the | ||||
| <tt>return_range</tt> call, the reference counted | ||||
| <tt>std::vector</tt> will live until <tt>i</tt> and <tt>end</tt> | ||||
| are both destroyed.  The output from this example is the same as | ||||
| the previous two. | ||||
|  | ||||
|  | ||||
| <hr> | ||||
| <!-- hhmts start --> | ||||
| Last modified: Mon Aug 11 11:27:03 EST 2003 | ||||
| <!-- hhmts end --> | ||||
| <p><EFBFBD> Copyright 2003 The Trustees of Indiana University. | ||||
|  Use, modification and distribution is subject to the Boost Software  | ||||
|  License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
|  http:www.boost.org/LICENSE_1_0.txt)</p> | ||||
|  | ||||
| </body> | ||||
|  | ||||
| </html> | ||||
							
								
								
									
										42
									
								
								shared_iterator_example1.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										42
									
								
								shared_iterator_example1.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,42 @@ | ||||
| // Copyright 2003 The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification and distribution is subject to the Boost Software  | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| #include "boost/shared_container_iterator.hpp" | ||||
| #include "boost/shared_ptr.hpp" | ||||
| #include <algorithm> | ||||
| #include <iostream> | ||||
| #include <vector> | ||||
|  | ||||
| typedef boost::shared_container_iterator< std::vector<int> > iterator; | ||||
|  | ||||
|  | ||||
| void set_range(iterator& i, iterator& end)  { | ||||
|  | ||||
|   boost::shared_ptr< std::vector<int> > ints(new std::vector<int>()); | ||||
|    | ||||
|   ints->push_back(0); | ||||
|   ints->push_back(1); | ||||
|   ints->push_back(2); | ||||
|   ints->push_back(3); | ||||
|   ints->push_back(4); | ||||
|   ints->push_back(5); | ||||
|    | ||||
|   i = iterator(ints->begin(),ints); | ||||
|   end = iterator(ints->end(),ints); | ||||
| } | ||||
|  | ||||
|  | ||||
| int main() { | ||||
|  | ||||
|   iterator i,end; | ||||
|  | ||||
|   set_range(i,end); | ||||
|  | ||||
|   std::copy(i,end,std::ostream_iterator<int>(std::cout,",")); | ||||
|   std::cout.put('\n'); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										43
									
								
								shared_iterator_example2.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										43
									
								
								shared_iterator_example2.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,43 @@ | ||||
| // Copyright 2003 The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification and distribution is subject to the Boost Software  | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| #include "boost/shared_container_iterator.hpp" | ||||
| #include "boost/shared_ptr.hpp" | ||||
| #include <algorithm> | ||||
| #include <iterator> | ||||
| #include <iostream> | ||||
| #include <vector> | ||||
|  | ||||
|  | ||||
| template <typename Iterator> | ||||
| void print_range_nl (Iterator begin, Iterator end) { | ||||
|   typedef typename std::iterator_traits<Iterator>::value_type val; | ||||
|   std::copy(begin,end,std::ostream_iterator<val>(std::cout,",")); | ||||
|   std::cout.put('\n'); | ||||
| } | ||||
|  | ||||
|  | ||||
| int main() { | ||||
|  | ||||
|   typedef boost::shared_ptr< std::vector<int> > ints_t; | ||||
|   { | ||||
|     ints_t ints(new std::vector<int>()); | ||||
|  | ||||
|     ints->push_back(0); | ||||
|     ints->push_back(1); | ||||
|     ints->push_back(2); | ||||
|     ints->push_back(3); | ||||
|     ints->push_back(4); | ||||
|     ints->push_back(5); | ||||
|  | ||||
|     print_range_nl(boost::make_shared_container_iterator(ints->begin(),ints), | ||||
|                    boost::make_shared_container_iterator(ints->end(),ints)); | ||||
|   } | ||||
|    | ||||
|  | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										41
									
								
								shared_iterator_example3.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										41
									
								
								shared_iterator_example3.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,41 @@ | ||||
| // Copyright 2003 The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification and distribution is subject to the Boost Software  | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| #include "boost/shared_container_iterator.hpp" | ||||
| #include "boost/shared_ptr.hpp" | ||||
| #include "boost/tuple/tuple.hpp" // for boost::tie | ||||
| #include <algorithm>              // for std::copy | ||||
| #include <iostream>               | ||||
| #include <vector> | ||||
|  | ||||
|  | ||||
| typedef boost::shared_container_iterator< std::vector<int> > iterator; | ||||
|  | ||||
| std::pair<iterator,iterator> | ||||
| return_range() { | ||||
|   boost::shared_ptr< std::vector<int> > range(new std::vector<int>()); | ||||
|   range->push_back(0); | ||||
|   range->push_back(1); | ||||
|   range->push_back(2); | ||||
|   range->push_back(3); | ||||
|   range->push_back(4); | ||||
|   range->push_back(5); | ||||
|   return boost::make_shared_container_range(range); | ||||
| } | ||||
|  | ||||
|  | ||||
| int main() { | ||||
|  | ||||
|  | ||||
|   iterator i,end; | ||||
|    | ||||
|   boost::tie(i,end) = return_range(); | ||||
|  | ||||
|   std::copy(i,end,std::ostream_iterator<int>(std::cout,",")); | ||||
|   std::cout.put('\n'); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										64
									
								
								shared_iterator_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										64
									
								
								shared_iterator_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,64 @@ | ||||
| // Copyright 2003 The Trustees of Indiana University. | ||||
|  | ||||
| // Use, modification and distribution is subject to the Boost Software  | ||||
| // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| //  Shared container iterator adaptor  | ||||
| //  Author: Ronald Garcia | ||||
| //  See http://boost.org/libs/utility/shared_container_iterator.html  | ||||
| //  for documentation.  | ||||
|  | ||||
| // | ||||
| // shared_iterator_test.cpp - Regression tests for shared_container_iterator. | ||||
| // | ||||
|  | ||||
|  | ||||
| #include "boost/shared_container_iterator.hpp" | ||||
| #include "boost/shared_ptr.hpp" | ||||
| #include <vector> | ||||
| #include <cassert> | ||||
|  | ||||
| struct resource { | ||||
|   static int count; | ||||
|   resource() { ++count; } | ||||
|   resource(resource const&) { ++count; } | ||||
|   ~resource() { --count; } | ||||
| }; | ||||
| int resource::count = 0; | ||||
|  | ||||
| typedef std::vector<resource> resources_t; | ||||
|  | ||||
| typedef boost::shared_container_iterator< resources_t > iterator; | ||||
|  | ||||
|  | ||||
| void set_range(iterator& i, iterator& end)  { | ||||
|  | ||||
|   boost::shared_ptr< resources_t > objs(new resources_t()); | ||||
|  | ||||
|   for (int j = 0; j != 6; ++j) | ||||
|     objs->push_back(resource()); | ||||
|    | ||||
|   i = iterator(objs->begin(),objs); | ||||
|   end = iterator(objs->end(),objs); | ||||
|   assert(resource::count == 6); | ||||
| } | ||||
|  | ||||
|  | ||||
| int main() { | ||||
|  | ||||
|   assert(resource::count == 0); | ||||
|    | ||||
|   { | ||||
|     iterator i; | ||||
|     { | ||||
|       iterator end; | ||||
|       set_range(i,end); | ||||
|       assert(resource::count == 6); | ||||
|     } | ||||
|     assert(resource::count == 6); | ||||
|   } | ||||
|   assert(resource::count == 0); | ||||
|    | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										1
									
								
								sublibs
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								sublibs
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1 @@ | ||||
| The existance of this file tells the regression reporting programs that the directory contains sub-directories which are libraries. | ||||
							
								
								
									
										36
									
								
								test/Jamfile.v2
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								test/Jamfile.v2
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| # Copyright David Abrahams 2003. Permission to copy, use, | ||||
| # modify, sell and distribute this software is granted provided this | ||||
| # copyright notice appears in all copies. This software is provided | ||||
| # "as is" without express or implied warranty, and with no claim as | ||||
| # to its suitability for any purpose. | ||||
|  | ||||
| # For more information, see http://www.boost.org/ | ||||
|  | ||||
| # bring in rules for testing | ||||
| import testing ; | ||||
|  | ||||
| # Please keep the tests ordered by filename | ||||
| test-suite utility | ||||
|     : | ||||
|         [ run ../addressof_test.cpp ] | ||||
|         [ run ../assert_test.cpp ] | ||||
|         [ run ../base_from_member_test.cpp ] | ||||
|         [ run ../binary_search_test.cpp ] | ||||
|         [ run ../call_traits_test.cpp : -u ] | ||||
|         [ compile-fail ../checked_delete_test.cpp ] | ||||
|         [ run ../compressed_pair_test.cpp ../../test/build//boost_test_exec_monitor/<link>static : -u ] | ||||
|         [ run ../current_function_test.cpp : : : <test-info>always_show_run_output ] | ||||
|         [ run ../iterators_test.cpp ../../test/build//boost_test_exec_monitor/<link>static ] | ||||
|         [ run next_prior_test.cpp ../../test/build//boost_test_exec_monitor/<link>static ] | ||||
|         [ compile-fail ../noncopyable_test.cpp ] | ||||
|         [ run ../numeric_traits_test.cpp ] | ||||
|         [ run ../operators_test.cpp ../../test/build//boost_test_exec_monitor/<link>static ] | ||||
|         [ compile ../ref_ct_test.cpp  ] | ||||
|         [ run ../ref_test.cpp ../../test/build//boost_test_exec_monitor/<link>static ] | ||||
|         [ compile result_of_test.cpp ] | ||||
|         [ run ../shared_iterator_test.cpp ] | ||||
|         [ run ../value_init_test.cpp ] | ||||
|         [ compile-fail ../value_init_test_fail1.cpp ] | ||||
|         [ compile-fail ../value_init_test_fail2.cpp ] | ||||
|         [ compile-fail ../value_init_test_fail3.cpp ] | ||||
|     ; | ||||
							
								
								
									
										79
									
								
								test/next_prior_test.cpp
									
									
									
									
									
										Executable file
									
								
							
							
						
						
									
										79
									
								
								test/next_prior_test.cpp
									
									
									
									
									
										Executable file
									
								
							| @@ -0,0 +1,79 @@ | ||||
| // Boost test program for next() and prior() utilities. | ||||
|  | ||||
| // Copyright 2003 Daniel Walker.  Use, modification, and distribution | ||||
| // are subject to the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or a copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt.) | ||||
|  | ||||
| // See http://www.boost.org/libs/utility for documentation. | ||||
|  | ||||
| // Revision History 13 Dec 2003 Initial Version (Daniel Walker) | ||||
|  | ||||
| // next() and prior() are replacements for operator+ and operator- for | ||||
| // non-random-access iterators. The semantics of these operators are | ||||
| // such that after executing j = i + n, std::distance(i, j) equals | ||||
| // n. Tests are provided to ensure next() has the same | ||||
| // result. Parallel tests are provided for prior(). The tests call | ||||
| // next() and prior() several times. next() and prior() are very | ||||
| // simple functions, though, and it would be very strange if these | ||||
| // tests were to fail. | ||||
|  | ||||
| #define BOOST_INCLUDE_MAIN | ||||
| #include <boost/test/test_tools.hpp> | ||||
|  | ||||
| #include <list> | ||||
| #include <vector> | ||||
|  | ||||
| #include <boost/next_prior.hpp> | ||||
|  | ||||
| template<class RandomAccessIterator, class ForwardIterator> | ||||
| bool plus_one_test(RandomAccessIterator first, RandomAccessIterator last, ForwardIterator first2) | ||||
| { | ||||
|     RandomAccessIterator i = first; | ||||
|     ForwardIterator j = first2; | ||||
|     while(i != last) | ||||
|         i = i + 1, j = boost::next(j); | ||||
|     return std::distance(first, i) == std::distance(first2, j); | ||||
| } | ||||
|  | ||||
| template<class RandomAccessIterator, class ForwardIterator> | ||||
| bool plus_n_test(RandomAccessIterator first, RandomAccessIterator last, ForwardIterator first2) | ||||
| { | ||||
|     RandomAccessIterator i = first; | ||||
|     ForwardIterator j = first2; | ||||
|     for(int n = 0; i != last; ++n) | ||||
|         i = first + n, j = boost::next(first2, n); | ||||
|     return std::distance(first, i) == std::distance(first2, j); | ||||
| } | ||||
|  | ||||
| template<class RandomAccessIterator, class BidirectionalIterator> | ||||
| bool minus_one_test(RandomAccessIterator first, RandomAccessIterator last, BidirectionalIterator last2) | ||||
| { | ||||
|     RandomAccessIterator i = last; | ||||
|     BidirectionalIterator j = last2; | ||||
|     while(i != first) | ||||
|         i = i - 1, j = boost::prior(j); | ||||
|     return std::distance(i, last) == std::distance(j, last2); | ||||
| } | ||||
|  | ||||
| template<class RandomAccessIterator, class BidirectionalIterator> | ||||
| bool minus_n_test(RandomAccessIterator first, RandomAccessIterator last, BidirectionalIterator last2) | ||||
| { | ||||
|     RandomAccessIterator i = last; | ||||
|     BidirectionalIterator j = last2; | ||||
|     for(int n = 0; i != first; ++n) | ||||
|         i = last - n, j = boost::prior(last2, n); | ||||
|     return std::distance(i, last) == std::distance(j, last2); | ||||
| } | ||||
|  | ||||
| int test_main(int, char*[]) | ||||
| { | ||||
|     std::vector<int> x(8); | ||||
|     std::list<int> y(x.begin(), x.end()); | ||||
|  | ||||
|     BOOST_REQUIRE(plus_one_test(x.begin(), x.end(), y.begin())); | ||||
|     BOOST_REQUIRE(plus_n_test(x.begin(), x.end(), y.begin())); | ||||
|     BOOST_REQUIRE(minus_one_test(x.begin(), x.end(), y.end())); | ||||
|     BOOST_REQUIRE(minus_n_test(x.begin(), x.end(), y.end())); | ||||
|     return 0; | ||||
| } | ||||
							
								
								
									
										85
									
								
								test/result_of_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										85
									
								
								test/result_of_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,85 @@ | ||||
| // Boost result_of library | ||||
|  | ||||
| //  Copyright Douglas Gregor 2003-2004. Use, modification and | ||||
| //  distribution is subject to the Boost Software License, Version | ||||
| //  1.0. (See accompanying file LICENSE_1_0.txt or copy at | ||||
| //  http://www.boost.org/LICENSE_1_0.txt) | ||||
|  | ||||
| // For more information, see http://www.boost.org/libs/utility | ||||
| #include <boost/utility/result_of.hpp> | ||||
| #include <utility> | ||||
| #include <boost/static_assert.hpp> | ||||
| #include <boost/type_traits/is_same.hpp> | ||||
|  | ||||
| struct int_result_type { typedef int result_type; }; | ||||
|  | ||||
| struct int_result_of | ||||
| { | ||||
|   template<typename F> struct result { typedef int type; }; | ||||
| }; | ||||
|  | ||||
| struct int_result_type_and_float_result_of | ||||
| { | ||||
|   typedef int result_type; | ||||
|   template<typename F> struct result { typedef float type; }; | ||||
| }; | ||||
|  | ||||
| template<typename T> | ||||
| struct int_result_type_template { typedef int result_type; }; | ||||
|  | ||||
| template<typename T> | ||||
| struct int_result_of_template | ||||
| { | ||||
|   template<typename F> struct result; | ||||
|   template<typename This, typename That> struct result<This(That)> { typedef int type; }; | ||||
| }; | ||||
|  | ||||
| template<typename T> | ||||
| struct int_result_type_and_float_result_of_template | ||||
| { | ||||
|   typedef int result_type; | ||||
|   template<typename F> struct result; | ||||
|   template<typename This, typename That> struct result<This(That)> { typedef float type; }; | ||||
| }; | ||||
|  | ||||
| struct X {}; | ||||
|  | ||||
| int main() | ||||
| { | ||||
|   using namespace boost; | ||||
|  | ||||
|   typedef int (*func_ptr)(float, double); | ||||
|   typedef int (&func_ref)(float, double); | ||||
|   typedef int (*func_ptr_0)(); | ||||
|   typedef int (&func_ref_0)(); | ||||
|   typedef int (X::*mem_func_ptr)(float); | ||||
|   typedef int (X::*mem_func_ptr_c)(float) const; | ||||
|   typedef int (X::*mem_func_ptr_v)(float) volatile; | ||||
|   typedef int (X::*mem_func_ptr_cv)(float) const volatile; | ||||
|   typedef int (X::*mem_func_ptr_0)(); | ||||
|  | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_type(float)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_of(double)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_of(void)>::type, void>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<const int_result_of(double)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<volatile int_result_of(void)>::type, void>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_type_and_float_result_of(char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_type_template<void>(float)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_of_template<void>(double)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_of_template<void>(void)>::type, void>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<const int_result_of_template<void>(double)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<volatile int_result_of_template<void>(void)>::type, void>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<int_result_type_and_float_result_of_template<void>(char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<func_ptr(char, float)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<func_ref(char, float)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<func_ptr_0()>::type, int>::value));  | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<func_ref_0()>::type, int>::value));  | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<mem_func_ptr(X,char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<mem_func_ptr_c(X,char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<mem_func_ptr_v(X,char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<mem_func_ptr_cv(X,char)>::type, int>::value)); | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<mem_func_ptr_0(X)>::type, int>::value));  | ||||
|   BOOST_STATIC_ASSERT((is_same<result_of<func_ptr(void)>::type, int>::value)); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										58
									
								
								throw_exception.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										58
									
								
								throw_exception.html
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,58 @@ | ||||
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | ||||
| <html> | ||||
| 	<head> | ||||
| 		<title>Boost: throw_exception.hpp documentation</title> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| 	</head> | ||||
| 	<body bgcolor="white" style="MARGIN-LEFT: 5%; MARGIN-RIGHT: 5%"> | ||||
| 		<table border="0" width="100%"> | ||||
| 			<tr> | ||||
| 				<td width="277"><A href="../../index.htm"> <img src="../../boost.png" alt="boost.png (6897 bytes)" width="277" height="86" border="0"></A> | ||||
| 				</td> | ||||
| 				<td align="center"> | ||||
| 					<h1>throw_exception.hpp</h1> | ||||
| 				</td> | ||||
| 			</tr> | ||||
| 			<tr> | ||||
| 				<td colspan="2" height="64"> </td> | ||||
| 			</tr> | ||||
| 		</table> | ||||
| 		<p> | ||||
| 			The header <STRONG><boost/throw_exception.hpp></STRONG> defines the  | ||||
| 			helper function <STRONG>boost::throw_exception</STRONG>. It is intended to be  | ||||
| 			used in Boost libraries that need to throw exceptions, but support  | ||||
| 			configurations and platforms where exceptions aren't available, as indicated by  | ||||
| 			the presence of the <STRONG>BOOST_NO_EXCEPTIONS</STRONG> <A href="../config/config.htm#macro_ref"> | ||||
| 				configuration macro</A>. | ||||
| 		</p> | ||||
| 		<P>When <STRONG>BOOST_NO_EXCEPTIONS</STRONG> is not defined, <tt>boost::throw_exception(e)</tt> | ||||
| 			is equivalent to <tt>throw e</tt>. Otherwise, the function is left undefined,  | ||||
| 			and the user is expected to supply an appropriate definition. Callers of <tt>throw_exception</tt> | ||||
| 			are allowed to assume that the function never returns; therefore, if the  | ||||
| 			user-defined <tt>throw_exception</tt> returns, the behavior is undefined.</P> | ||||
| 		<h3><a name="Synopsis">Synopsis</a></h3> | ||||
| 		<pre> | ||||
| namespace boost | ||||
| { | ||||
|  | ||||
| #ifdef BOOST_NO_EXCEPTIONS | ||||
|  | ||||
| void throw_exception(std::exception const & e); // user defined | ||||
|  | ||||
| #else | ||||
|  | ||||
| template<class E> void throw_exception(E const & e) | ||||
| { | ||||
|     throw e; | ||||
| } | ||||
|  | ||||
| #endif | ||||
|  | ||||
| } | ||||
| </pre> | ||||
| 		<p><br> | ||||
| 			<small>Copyright <20> 2002 by Peter Dimov. Distributed under the Boost Software License, Version  | ||||
| 				1.0. See accompanying file <A href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or  | ||||
| 				copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>.</small></p> | ||||
| 	</body> | ||||
| </html> | ||||
							
								
								
									
										138
									
								
								tie.html
									
									
									
									
									
								
							
							
						
						
									
										138
									
								
								tie.html
									
									
									
									
									
								
							| @@ -1,138 +0,0 @@ | ||||
| <HTML> | ||||
| <!-- | ||||
|   -- Copyright (c) Jeremy Siek, Lie-Quan Lee, and Andrew Lumsdaine  2000 | ||||
|   -- | ||||
|   -- Permission to use, copy, modify, distribute and sell this software | ||||
|   -- and its documentation for any purpose is hereby granted without fee, | ||||
|   -- provided that the above copyright notice appears in all copies and | ||||
|   -- that both that copyright notice and this permission notice appear | ||||
|   -- in supporting documentation.  We make no | ||||
|   -- representations about the suitability of this software for any | ||||
|   -- purpose.  It is provided "as is" without express or implied warranty. | ||||
|   --> | ||||
| <Head> | ||||
| <Title>Boost Tie</Title> | ||||
| <BODY BGCOLOR="#ffffff" LINK="#0000ee" TEXT="#000000" VLINK="#551a8b"  | ||||
| 	ALINK="#ff0000">  | ||||
| <IMG SRC="../../c++boost.gif"  | ||||
|      ALT="C++ Boost">  | ||||
|  | ||||
| <BR Clear> | ||||
|  | ||||
| <H1><A NAME="sec:tie"></A> | ||||
| <TT>tie</TT> | ||||
| </H1> | ||||
|  | ||||
| <P> | ||||
| <PRE> | ||||
| template <class A, class B> | ||||
| tied<A,B> tie(A& a, B& b); | ||||
| </PRE> | ||||
|  | ||||
| <P> | ||||
| This is a utility function that makes it more convenient to work with | ||||
| a function which returns a pair. The effect of the <TT>tie()</TT> | ||||
| function is to allow the assignment of the two values of the pair to | ||||
| two separate variables. The idea for this comes from Jaakko | ||||
| Järvi's Binders [<A | ||||
| HREF="bibliography.html#jaakko_tuple_assign">1</A>]. | ||||
|  | ||||
| <P> | ||||
|  | ||||
| <H3>Where Defined</H3> | ||||
|  | ||||
| <P> | ||||
| <a href="../../boost/utility.hpp"><TT>boost/utility.hpp</TT></a> | ||||
|  | ||||
| <P> | ||||
|  | ||||
| <H3>Example</H3> | ||||
|  | ||||
| <P> | ||||
| An example of using the <TT>tie()</TT> function with the | ||||
| <TT>vertices()</TT> function, which returns a pair of | ||||
| type <TT>std::pair<vertex_iterator,vertex_iterator></TT>.  The | ||||
| pair of iterators is assigned to the iterator variables <TT>i</TT> and | ||||
| <TT>end</TT>. | ||||
|  | ||||
| <P> | ||||
| <PRE> | ||||
|   graph_traits< adjacency_list<> >::vertex_iterator i, end; | ||||
|   for(tie(i,end) = vertices(G); i != end; ++i) | ||||
|     // ... | ||||
| </PRE> | ||||
|  | ||||
| <P> | ||||
| Here is another example that uses <TT>tie()</TT> for handling | ||||
| operaitons with <a | ||||
| href="http://www.sgi.com/Technology/STL/set.html"><TT>std::set</TT></a>. | ||||
|  | ||||
| <P> | ||||
| <PRE> | ||||
| #include <set> | ||||
| #include <algorithm> | ||||
| #include <iostream> | ||||
| #include <boost/utility.hpp> | ||||
|  | ||||
| int | ||||
| main(int, char*[]) | ||||
| { | ||||
|   { | ||||
|     typedef std::set<int> SetT; | ||||
|     SetT::iterator i, end; | ||||
|     bool inserted; | ||||
|      | ||||
|     int vals[5] = { 5, 2, 4, 9, 1 }; | ||||
|     SetT s(vals, vals + 5); | ||||
|      | ||||
|     // Using tie() with a return value of pair<iterator,bool> | ||||
|  | ||||
|     int new_vals[2] = { 3, 9 }; | ||||
|  | ||||
|     for (int k = 0; k < 2; ++k) { | ||||
|       boost::tie(i,inserted) = s.insert(new_vals[k]); | ||||
|       if (!inserted) | ||||
|         std::cout << *i << " was already in the set." << std::endl; | ||||
|       else | ||||
|         std::cout << *i << " successfully inserted." << std::endl;     | ||||
|     } | ||||
|   }     | ||||
|   { | ||||
|     int* i, *end; | ||||
|     int vals[6] = { 5, 2, 4, 4, 9, 1 }; | ||||
|     std::sort(vals, vals + 6); | ||||
|  | ||||
|     // Using tie() with a return value of pair<iterator,iterator> | ||||
|  | ||||
|     boost::tie(i,end) = std::equal_range(vals, vals + 6, 4); | ||||
|     std::cout << "There were " << std::distance(i,end) | ||||
|               << " occurances of " << *i << "." << std::endl; | ||||
|     // Footnote: of course one would normally just use std::count() | ||||
|     // to get this information, but that would spoil the example :) | ||||
|   } | ||||
|   return 0; | ||||
| } | ||||
| </PRE> | ||||
| The output is: | ||||
| <PRE> | ||||
|   3 successfully inserted. | ||||
|   9 was already in the set. | ||||
|   There were 2 occurances of 4. | ||||
| </PRE> | ||||
|  | ||||
| <br> | ||||
| <HR> | ||||
| <TABLE> | ||||
| <TR valign=top> | ||||
| <TD nowrap>Copyright © 2000</TD><TD> | ||||
| <A HREF=http://www.boost.org/people/jeremy_siek.htm>Jeremy Siek</A>, | ||||
| Univ.of Notre Dame (<A | ||||
| HREF="mailto:jsiek@lsc.nd.edu">jsiek@lsc.nd.edu</A>)<br> | ||||
| <A HREF=http://www.lsc.nd.edu/~llee1>Lie-Quan Lee</A>, Univ.of Notre Dame (<A HREF="mailto:llee1@lsc.nd.edu">llee1@lsc.nd.edu</A>)<br> | ||||
| <A HREF=http://www.lsc.nd.edu/~lums>Andrew Lumsdaine</A>, | ||||
| Univ.of Notre Dame (<A | ||||
| HREF="mailto:lums@lsc.nd.edu">lums@lsc.nd.edu</A>) | ||||
| </TD></TR></TABLE> | ||||
|  | ||||
| </BODY> | ||||
| </HTML>  | ||||
| @@ -1,61 +0,0 @@ | ||||
| //  (C) Copyright Jeremy Siek 2000. Permission to copy, use, modify, | ||||
| //  sell and distribute this software is granted provided this | ||||
| //  copyright notice appears in all copies. This software is provided | ||||
| //  "as is" without express or implied warranty, and with no claim as | ||||
| //  to its suitability for any purpose. | ||||
| // | ||||
| // This is an example demonstrating how to use the tie() function. | ||||
| // The purpose of tie() is to make it easiery to deal with std::pair | ||||
| // return values. | ||||
| // | ||||
| // Contributed by Jeremy Siek | ||||
| // | ||||
| // Sample output | ||||
| // | ||||
| // 3 successfully inserted. | ||||
| // 9 was already in the set. | ||||
| // There were 2 occurances of 4. | ||||
|  | ||||
| #include <set> | ||||
| #include <algorithm> | ||||
| #include <iostream> | ||||
| #include <boost/utility.hpp> | ||||
|  | ||||
| int | ||||
| main(int, char*[]) | ||||
| { | ||||
|   { | ||||
|     typedef std::set<int> SetT; | ||||
|     SetT::iterator i, end; | ||||
|     bool inserted; | ||||
|      | ||||
|     int vals[5] = { 5, 2, 4, 9, 1 }; | ||||
|     SetT s(vals, vals + 5); | ||||
|      | ||||
|     // Using tie() with a return value of pair<iterator,bool> | ||||
|  | ||||
|     int new_vals[2] = { 3, 9 }; | ||||
|  | ||||
|     for (int k = 0; k < 2; ++k) { | ||||
|       boost::tie(i,inserted) = s.insert(new_vals[k]); | ||||
|       if (!inserted) | ||||
| 	std::cout << *i << " was already in the set." << std::endl; | ||||
|       else | ||||
| 	std::cout << *i << " successfully inserted." << std::endl;     | ||||
|     } | ||||
|   }     | ||||
|   { | ||||
|     int* i, *end; | ||||
|     int vals[6] = { 5, 2, 4, 4, 9, 1 }; | ||||
|     std::sort(vals, vals + 6); | ||||
|  | ||||
|     // Using tie() with a return value of pair<iterator,iterator> | ||||
|  | ||||
|     boost::tie(i,end) = std::equal_range(vals, vals + 6, 4); | ||||
|     std::cout << "There were " << std::distance(i,end) | ||||
| 	      << " occurances of " << *i << "." << std::endl; | ||||
|     // Footnote: of course one would normally just use std::count() | ||||
|     // to get this information, but that would spoil the example :) | ||||
|   } | ||||
|   return 0; | ||||
| } | ||||
							
								
								
									
										626
									
								
								type_traits.htm
									
									
									
									
									
								
							
							
						
						
									
										626
									
								
								type_traits.htm
									
									
									
									
									
								
							| @@ -1,626 +0,0 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" | ||||
| content="text/html; charset=iso-8859-1"> | ||||
| <meta name="Template" | ||||
| content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> | ||||
| <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0"> | ||||
| <title>Type Traits</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" link="#0000FF" vlink="#800080"> | ||||
|  | ||||
| <h1><img src="../../c++boost.gif" width="276" height="86">Header | ||||
| <<a href="../../boost/detail/type_traits.hpp">boost/type_traits.hpp</a>></h1> | ||||
|  | ||||
| <p>The contents of <boost/type_traits.hpp> are declared in | ||||
| namespace boost.</p> | ||||
|  | ||||
| <p>The file <<a href="../../boost/detail/type_traits.hpp">boost/type_traits.hpp</a>> | ||||
| contains various template classes that describe the fundamental | ||||
| properties of a type; each class represents a single type | ||||
| property or a single type transformation. This documentation is | ||||
| divided up into the following sections:</p> | ||||
|  | ||||
| <pre><a href="#fop">Fundamental type operations</a> | ||||
| <a href="#fp">Fundamental type properties</a> | ||||
|    <a href="#misc">Miscellaneous</a> | ||||
| <code>   </code><a href="#cv">cv-Qualifiers</a> | ||||
| <code>   </code><a href="#ft">Fundamental Types</a> | ||||
| <code>   </code><a href="#ct">Compound Types</a> | ||||
| <code>   </code><a href="#ot">Object/Scalar Types</a> | ||||
| <a href="#cs">Compiler Support Information</a> | ||||
| <a href="#ec">Example Code</a></pre> | ||||
|  | ||||
| <h2><a name="fop"></a>Fundamental type operations</h2> | ||||
|  | ||||
| <p>Usage: "class_name<T>::type" performs | ||||
| indicated transformation on type T.</p> | ||||
|  | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><p align="center">Expression.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="45%"><p align="center">Description.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="33%"><p align="center">Compiler.</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>remove_volatile<T>::type</code></td> | ||||
|         <td valign="top" width="45%">Creates a type the same as T | ||||
|         but with any top level volatile qualifier removed. For | ||||
|         example "volatile int" would become "int".</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>remove_const<T>::type</code></td> | ||||
|         <td valign="top" width="45%">Creates a type the same as T | ||||
|         but with any top level const qualifier removed. For | ||||
|         example "const int" would become "int".</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>remove_cv<T>::type</code></td> | ||||
|         <td valign="top" width="45%">Creates a type the same as T | ||||
|         but with any top level cv-qualifiers removed. For example | ||||
|         "const int" would become "int", and | ||||
|         "volatile double" would become "double".</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>remove_reference<T>::type</code></td> | ||||
|         <td valign="top" width="45%">If T is a reference type | ||||
|         then removes the reference, otherwise leaves T unchanged. | ||||
|         For example "int&" becomes "int" | ||||
|         but "int*" remains unchanged.</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>add_reference<T>::type</code></td> | ||||
|         <td valign="top" width="45%">If T is a reference type | ||||
|         then leaves T unchanged, otherwise converts T to a | ||||
|         reference type. For example "int&" remains | ||||
|         unchanged, but "double" becomes "double&".</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>remove_bounds<T>::type</code></td> | ||||
|         <td valign="top" width="45%">If T is an array type then | ||||
|         removes the top level array qualifier from T, otherwise | ||||
|         leaves T unchanged. For example "int[2][3]" | ||||
|         becomes "int[3]".</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h2><a name="fp"></a>Fundamental type properties</h2> | ||||
|  | ||||
| <p>Usage: "class_name<T>::value" is true if | ||||
| indicated property is true, false otherwise. (Note that class_name<T>::value | ||||
| is always defined as a compile time constant).</p> | ||||
|  | ||||
| <h3><a name="misc"></a>Miscellaneous</h3> | ||||
|  | ||||
| <table border="1" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td width="37%"><p align="center">Expression</p> | ||||
|         </td> | ||||
|         <td width="36%"><p align="center">Description</p> | ||||
|         </td> | ||||
|         <td width="27%"><p align="center">Compiler</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td width="37%"><div align="center"><center><pre><code>is_same<T,U>::value</code></pre> | ||||
|         </center></div></td> | ||||
|         <td width="36%"><p align="center">True if T and U are the | ||||
|         same type.</p> | ||||
|         </td> | ||||
|         <td width="27%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td width="37%"><div align="center"><center><pre>is_convertible<T,U>::value</pre> | ||||
|         </center></div></td> | ||||
|         <td width="36%"><p align="center">True if type T is | ||||
|         convertible to type U.</p> | ||||
|         </td> | ||||
|         <td width="27%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td width="37%"><div align="center"><center><pre>alignment_of<T>::value</pre> | ||||
|         </center></div></td> | ||||
|         <td width="36%"><p align="center">An integral value | ||||
|         representing the minimum alignment requirements of type T | ||||
|         (strictly speaking defines a multiple of the type's | ||||
|         alignment requirement; for all compilers tested so far | ||||
|         however it does return the actual alignment).</p> | ||||
|         </td> | ||||
|         <td width="27%"> </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h3><a name="cv"></a>cv-Qualifiers</h3> | ||||
|  | ||||
| <p>The following classes determine what cv-qualifiers are present | ||||
| on a type (see 3.93).</p> | ||||
|  | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td valign="top" width="37%"><p align="center">Expression.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="37%"><p align="center">Description.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="27%"><p align="center">Compiler.</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="37%"><code>is_const<T>::value</code></td> | ||||
|         <td valign="top" width="37%">True if type T is top-level | ||||
|         const qualified.</td> | ||||
|         <td valign="top" width="27%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="37%"><code>is_volatile<T>::value</code></td> | ||||
|         <td valign="top" width="37%">True if type T is top-level | ||||
|         volatile qualified.</td> | ||||
|         <td valign="top" width="27%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h3><a name="ft"></a>Fundamental Types</h3> | ||||
|  | ||||
| <p>The following will only ever be true for cv-unqualified types; | ||||
| these are closely based on the section 3.9 of the C++ Standard.</p> | ||||
|  | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><p align="center">Expression.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="45%"><p align="center">Description.</p> | ||||
|         </td> | ||||
|         <td valign="top" width="33%"><p align="center">Compiler.</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_void<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True only if T is void.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_unsigned_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True only if T is one of the | ||||
|         standard unsigned integral types (3.9.1 p3) - unsigned | ||||
|         char, unsigned short, unsigned int, and unsigned long.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_signed_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True only if T is one of the | ||||
|         standard signed integral types (3.9.1 p2) - signed char, | ||||
|         short, int, and long.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a standard | ||||
|         integral type(3.9.1 p7) - T is either char, wchar_t, bool | ||||
|         or either is_standard_signed_integral<T>::value or | ||||
|         is_standard_integral<T>::value is true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_float<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is one of the | ||||
|         standard floating point types(3.9.1 p8) - float, double | ||||
|         or long double.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_arithmetic<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a standard | ||||
|         arithmetic type(3.9.1 p8) - implies is_standard_integral | ||||
|         or is_standard_float is true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_fundamental<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a standard | ||||
|         arithmetic type or if T is void.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_unsigned_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True for compiler specific | ||||
|         unsigned integral types.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_signed_integral<T>>:value</code></td> | ||||
|         <td valign="top" width="45%">True for compiler specific | ||||
|         signed integral types.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_extension_unsigned_integral<T>::value | ||||
|         or is_extension_signed_integral<T>::value is true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_float<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True for compiler specific | ||||
|         floating point types.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_arithmetic<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_extension_integral<T>::value | ||||
|         or is_extension_float<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code> is_extension_fundamental<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_extension_arithmetic<T>::value | ||||
|         or is_void<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code> is_unsigned_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_standard_unsigned_integral<T>::value | ||||
|         or is_extention_unsigned_integral<T>::value are | ||||
|         true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_signed_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_standard_signed_integral<T>::value | ||||
|         or is_extention_signed_integral<T>>::value are | ||||
|         true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_integral<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_standard_integral<T>::value | ||||
|         or is_extention_integral<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_float<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_standard_float<T>::value | ||||
|         or is_extention_float<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_arithmetic<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_integral<T>::value | ||||
|         or is_float<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_fundamental<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if either is_arithmetic<T>::value | ||||
|         or is_void<T>::value are true.</td> | ||||
|         <td valign="top" width="33%"> </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h3><a name="ct"></a>Compound Types</h3> | ||||
|  | ||||
| <p>The following will only ever be true for cv-unqualified types, | ||||
| as defined by the Standard. </p> | ||||
|  | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><p align="center">Expression</p> | ||||
|         </td> | ||||
|         <td valign="top" width="45%"><p align="center">Description</p> | ||||
|         </td> | ||||
|         <td valign="top" width="33%"><p align="center">Compiler</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_array<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is an array type.</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_pointer<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a regular | ||||
|         pointer type - including function pointers - but | ||||
|         excluding pointers to member functions (3.9.2 p1 and 8.3.1).</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_member_pointer<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a pointer to a | ||||
|         non-static class member (3.9.2 p1 and 8.3.1).</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_reference<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a reference | ||||
|         type (3.9.2 p1 and 8.3.2).</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_class<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a class or | ||||
|         struct type.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_union<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a union type.</td> | ||||
|         <td valign="top" width="33%"><p align="center">C</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_enum<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is an enumerator | ||||
|         type.</td> | ||||
|         <td valign="top" width="33%"><p align="center">C</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_compound<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is any of the | ||||
|         above compound types.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h3><a name="ot"></a>Object/Scalar Types</h3> | ||||
|  | ||||
| <p>The following ignore any top level cv-qualifiers: if <code>class_name<T>::value</code> | ||||
| is true then <code>class_name<cv-qualified-T>::value</code> | ||||
| will also be true.</p> | ||||
|  | ||||
| <table border="1" cellpadding="7" cellspacing="1" width="100%"> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><p align="center">Expression</p> | ||||
|         </td> | ||||
|         <td valign="top" width="45%"><p align="center">Description</p> | ||||
|         </td> | ||||
|         <td valign="top" width="33%"><p align="center">Compiler</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_object<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is not a reference | ||||
|         type, or a (possibly cv-qualified) void type.</td> | ||||
|         <td valign="top" width="33%"><p align="center">P</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_standard_scalar<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a standard | ||||
|         arithmetic type, an enumerated type, a pointer or a | ||||
|         member pointer.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_extension_scalar<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is an extentions | ||||
|         arithmetic type, an enumerated type, a pointer or a | ||||
|         member pointer.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_scalar<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is an arithmetic | ||||
|         type, an enumerated type, a pointer or a member pointer.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_POD<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is a "Plain | ||||
|         Old Data" type (see 3.9 p2&p3). Note that | ||||
|         although this requires compiler support to be correct in | ||||
|         all cases, if T is a scalar or an array of scalars then | ||||
|         we can correctly define T as a POD.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PC</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>is_empty<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T is an empty struct | ||||
|         or class. If the compiler implements the "zero sized | ||||
|         empty base classes" optimisation, then is_empty will | ||||
|         correctly guess whether T is empty. Relies upon is_class | ||||
|         to determine whether T is a class type. Screens out enum | ||||
|         types by using is_convertible<T,int>, this means | ||||
|         that empty classes that overload operator int(), will not | ||||
|         be classified as empty.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PCD</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>has_trivial_constructor<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T has a trivial | ||||
|         default constructor - that is T() is equivalent to memset.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PC</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>has_trivial_copy<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T has a trivial copy | ||||
|         constructor - that is T(const T&) is equivalent to | ||||
|         memcpy.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PC</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>has_trivial_assign<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T has a trivial | ||||
|         assignment operator - that is if T::operator=(const T&) | ||||
|         is equivalent to memcpy.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PC</p> | ||||
|         </td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="45%"><code>has_trivial_destructor<T>::value</code></td> | ||||
|         <td valign="top" width="45%">True if T has a trivial | ||||
|         destructor - that is if T::~T() has no effect.</td> | ||||
|         <td valign="top" width="33%"><p align="center">PC</p> | ||||
|         </td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <h2><a name="cs"></a>Compiler Support Information</h2> | ||||
|  | ||||
| <p>The legends used in the tables above have the following | ||||
| meanings:</p> | ||||
|  | ||||
| <table border="0" cellpadding="7" cellspacing="0" width="480"> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><p align="center">P</p> | ||||
|         </td> | ||||
|         <td valign="top" width="90%">Denotes that the class | ||||
|         requires support for partial specialisation of class | ||||
|         templates to work correctly.</td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><p align="center">C</p> | ||||
|         </td> | ||||
|         <td valign="top" width="90%">Denotes that direct compiler | ||||
|         support for that traits class is required.</td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><p align="center">D</p> | ||||
|         </td> | ||||
|         <td valign="top" width="90%">Denotes that the traits | ||||
|         class is dependent upon a class that requires direct | ||||
|         compiler support.</td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <p>For those classes that are marked with a D or C, if compiler | ||||
| support is not provided, this type trait may return "false" | ||||
| when the correct value is actually "true". The single | ||||
| exception to this rule is "is_class", which attempts to | ||||
| guess whether or not T is really a class, and may return "true" | ||||
| when the correct value is actually "false". This can | ||||
| happen if: T is a union, T is an enum, or T is a compiler-supplied | ||||
| scalar type that is not specialised for in these type traits.</p> | ||||
|  | ||||
| <p><i>If there is no compiler support</i>, to ensure that these | ||||
| traits <i>always</i> return the correct values, specialise 'is_enum' | ||||
| for each user-defined enumeration type, 'is_union' for each user-defined | ||||
| union type, 'is_empty' for each user-defined empty composite type, | ||||
| and 'is_POD' for each user-defined POD type. The 'has_*' traits | ||||
| should also be specialized if the user-defined type has those | ||||
| traits and is <i>not</i> a POD.</p> | ||||
|  | ||||
| <p>The following rules are automatically enforced:</p> | ||||
|  | ||||
| <p>is_enum implies is_POD</p> | ||||
|  | ||||
| <p>is_POD implies has_*</p> | ||||
|  | ||||
| <p>This means, for example, if you have an empty POD-struct, just | ||||
| specialize is_empty and is_POD, which will cause all the has_* to | ||||
| also return true.</p> | ||||
|  | ||||
| <h2><a name="ec"></a>Example code</h2> | ||||
|  | ||||
| <p>Type-traits comes with two sample programs: <a | ||||
| href="type_traits_test.cpp">type_traits_test.cpp</a> tests the | ||||
| type traits classes - mostly this is a test of your compiler's | ||||
| support for the concepts used in the type traits implementation, | ||||
| while <a href="algo_opt_examples.cpp">algo_opt_examples.cpp</a> | ||||
| uses the type traits classes to "optimise" some | ||||
| familiar standard library algorithms.</p> | ||||
|  | ||||
| <p>There are four algorithm examples in algo_opt_examples.cpp:</p> | ||||
|  | ||||
| <table border="0" cellpadding="7" cellspacing="0" width="638"> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><pre>opt::copy</pre> | ||||
|         </td> | ||||
|         <td valign="top" width="50%">If the copy operation can be | ||||
|         performed using memcpy then does so, otherwise uses a | ||||
|         regular element by element copy (<i>c.f.</i> std::copy).</td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><pre>opt::fill</pre> | ||||
|         </td> | ||||
|         <td valign="top" width="50%">If the fill operation can be | ||||
|         performed by memset, then does so, otherwise uses a | ||||
|         regular element by element assign. Also uses call_traits | ||||
|         to optimise how the parameters can be passed (<i>c.f.</i> | ||||
|         std::fill).</td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><pre>opt::destroy_array</pre> | ||||
|         </td> | ||||
|         <td valign="top" width="50%">If the type in the array has | ||||
|         a trivial destructor then does nothing, otherwise calls | ||||
|         destructors for all elements in the array - this | ||||
|         algorithm is the reverse of std::uninitialized_copy / std::uninitialized_fill.</td> | ||||
|     </tr> | ||||
|     <tr> | ||||
|         <td valign="top" width="50%"><pre>opt::iter_swap</pre> | ||||
|         </td> | ||||
|         <td valign="top" width="50%">Determines whether the | ||||
|         iterator is a proxy-iterator: if it is then does a "slow | ||||
|         and safe" swap, otherwise calls std::swap on the | ||||
|         assumption that std::swap may be specialised for the | ||||
|         iterated type.</td> | ||||
|     </tr> | ||||
| </table> | ||||
|  | ||||
| <p> </p> | ||||
|  | ||||
| <hr> | ||||
|  | ||||
| <p>Revised 08<sup>th</sup> March 2000</p> | ||||
|  | ||||
| <p><EFBFBD> Copyright boost.org 2000. Permission to copy, use, modify, | ||||
| sell and distribute this document is granted provided this | ||||
| copyright notice appears in all copies. This document is provided | ||||
| "as is" without express or implied warranty, and with | ||||
| no claim as to its suitability for any purpose.</p> | ||||
|  | ||||
| <p>Based on contributions by Steve Cleary, Beman Dawes, Howard | ||||
| Hinnant and John Maddock.</p> | ||||
|  | ||||
| <p>Maintained by <a href="mailto:John_Maddock@compuserve.com">John | ||||
| Maddock</a>, the latest version of this file can be found at <a | ||||
| href="http://www.boost.org/">www.boost.org</a>, and the boost | ||||
| discussion list at <a href="http://www.egroups.com/list/boost">www.egroups.com/list/boost</a>.</p> | ||||
| </body> | ||||
| </html> | ||||
| @@ -1,595 +0,0 @@ | ||||
| //  (C) Copyright Steve Cleary, Beman Dawes, Howard Hinnant & John Maddock 2000. | ||||
| //  Permission to copy, use, modify, sell and | ||||
| //  distribute this software is granted provided this copyright notice appears | ||||
| //  in all copies. This software is provided "as is" without express or implied | ||||
| //  warranty, and with no claim as to its suitability for any purpose. | ||||
|  | ||||
| // standalone test program for <boost/type_traits.hpp> | ||||
|  | ||||
| /* Release notes: | ||||
|    31st July 2000: | ||||
|       Added extra tests for is_empty, is_convertible, alignment_of. | ||||
|    23rd July 2000: | ||||
|       Removed all call_traits tests to call_traits_test.cpp | ||||
|       Removed all compressed_pair tests to compressed_pair_tests.cpp | ||||
|       Improved tests macros | ||||
|       Tidied up specialistions of type_types classes for test cases. | ||||
| */ | ||||
|  | ||||
| #include <iostream> | ||||
| #include <typeinfo> | ||||
|  | ||||
| #include <boost/type_traits.hpp> | ||||
| #include "type_traits_test.hpp" | ||||
|  | ||||
| using namespace boost; | ||||
|  | ||||
| // Since there is no compiler support, we should specialize: | ||||
| //  is_enum for all enumerations (is_enum implies is_POD) | ||||
| //  is_union for all unions | ||||
| //  is_empty for all empty composites | ||||
| //  is_POD for all PODs (except enums) (is_POD implies has_*) | ||||
| //  has_* for any UDT that has that trait and is not POD | ||||
|  | ||||
| enum enum_UDT{ one, two, three }; | ||||
| struct UDT | ||||
| { | ||||
|    UDT(); | ||||
|    ~UDT(); | ||||
|    UDT(const UDT&); | ||||
|    UDT& operator=(const UDT&); | ||||
|    int i; | ||||
|  | ||||
|    void f1(); | ||||
|    int f2(); | ||||
|    int f3(int); | ||||
|    int f4(int, float); | ||||
| }; | ||||
|  | ||||
| struct POD_UDT { int x; }; | ||||
| struct empty_UDT{ ~empty_UDT(){}; }; | ||||
| struct empty_POD_UDT{}; | ||||
| union union_UDT | ||||
| { | ||||
|   int x; | ||||
|   double y; | ||||
|   ~union_UDT(); | ||||
| }; | ||||
| union POD_union_UDT | ||||
| { | ||||
|   int x; | ||||
|   double y; | ||||
| }; | ||||
| union empty_union_UDT | ||||
| { | ||||
|   ~empty_union_UDT(); | ||||
| }; | ||||
| union empty_POD_union_UDT{}; | ||||
| #ifndef BOOST_NO_INCLASS_MEMBER_INITIALIZATION | ||||
| namespace boost { | ||||
| template <> struct is_enum<enum_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_POD<POD_UDT> | ||||
| { static const bool value = true; }; | ||||
| // this type is not POD, so we have to specialize the has_* individually | ||||
| template <> struct has_trivial_constructor<empty_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct has_trivial_copy<empty_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct has_trivial_assign<empty_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_POD<empty_POD_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_union<union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_union<POD_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_POD<POD_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_union<empty_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| // this type is not POD, so we have to specialize the has_* individually | ||||
| template <> struct has_trivial_constructor<empty_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct has_trivial_copy<empty_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct has_trivial_assign<empty_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_union<empty_POD_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| template <> struct is_POD<empty_POD_union_UDT> | ||||
| { static const bool value = true; }; | ||||
| } | ||||
| #else | ||||
| namespace boost { | ||||
| template <> struct is_enum<enum_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_POD<POD_UDT> | ||||
| { enum{ value = true }; }; | ||||
| // this type is not POD, so we have to specialize the has_* individually | ||||
| template <> struct has_trivial_constructor<empty_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct has_trivial_copy<empty_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct has_trivial_assign<empty_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_POD<empty_POD_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_union<union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_union<POD_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_POD<POD_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_union<empty_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| // this type is not POD, so we have to specialize the has_* individually | ||||
| template <> struct has_trivial_constructor<empty_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct has_trivial_copy<empty_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct has_trivial_assign<empty_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_union<empty_POD_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| template <> struct is_POD<empty_POD_union_UDT> | ||||
| { enum{ value = true }; }; | ||||
| } | ||||
| #endif | ||||
|  | ||||
| class Base { }; | ||||
|  | ||||
| class Deriverd : public Base { }; | ||||
|  | ||||
| class NonDerived { }; | ||||
|  | ||||
| enum enum1 | ||||
| { | ||||
|    one_,two_ | ||||
| }; | ||||
|  | ||||
| enum enum2 | ||||
| { | ||||
|    three_,four_ | ||||
| }; | ||||
|  | ||||
| struct VB | ||||
| { | ||||
|    virtual ~VB(){}; | ||||
| }; | ||||
|  | ||||
| struct VD : VB | ||||
| { | ||||
|    ~VD(){}; | ||||
| }; | ||||
|  | ||||
|  | ||||
| // Steve: All comments that I (Steve Cleary) have added below are prefixed with | ||||
| //  "Steve:"  The failures that BCB4 has on the tests are due to Borland's | ||||
| //  not considering cv-qual's as a part of the type -- they are considered | ||||
| //  compiler hints only.  These failures should be fixed before long. | ||||
|  | ||||
| int main() | ||||
| { | ||||
|    std::cout << "Checking type operations..." << std::endl << std::endl; | ||||
|  | ||||
|    // cv-qualifiers applied to reference types should have no effect | ||||
|    // declare these here for later use with is_reference and remove_reference: | ||||
|    typedef int& r_type; | ||||
|    typedef const r_type cr_type; | ||||
|  | ||||
|    type_test(int, remove_reference<int>::type) | ||||
|    type_test(const int, remove_reference<const int>::type) | ||||
|    type_test(int, remove_reference<int&>::type) | ||||
|    type_test(const int, remove_reference<const int&>::type) | ||||
|    type_test(volatile int, remove_reference<volatile int&>::type) | ||||
|    type_test(int, remove_reference<cr_type>::type) | ||||
|  | ||||
|    type_test(int, remove_const<const int>::type) | ||||
|    // Steve: fails on BCB4 | ||||
|    type_test(volatile int, remove_const<volatile int>::type) | ||||
|    // Steve: fails on BCB4 | ||||
|    type_test(volatile int, remove_const<const volatile int>::type) | ||||
|    type_test(int, remove_const<int>::type) | ||||
|    type_test(int*, remove_const<int* const>::type) | ||||
|    type_test(int, remove_volatile<volatile int>::type) | ||||
|    // Steve: fails on BCB4 | ||||
|    type_test(const int, remove_volatile<const int>::type) | ||||
|    // Steve: fails on BCB4 | ||||
|    type_test(const int, remove_volatile<const volatile int>::type) | ||||
|    type_test(int, remove_volatile<int>::type) | ||||
|    type_test(int*, remove_volatile<int* volatile>::type) | ||||
|    type_test(int, remove_cv<volatile int>::type) | ||||
|    type_test(int, remove_cv<const int>::type) | ||||
|    type_test(int, remove_cv<const volatile int>::type) | ||||
|    type_test(int, remove_cv<int>::type) | ||||
|    type_test(int*, remove_cv<int* volatile>::type) | ||||
|    type_test(int*, remove_cv<int* const>::type) | ||||
|    type_test(int*, remove_cv<int* const volatile>::type) | ||||
|    type_test(const int *, remove_cv<const int * const>::type) | ||||
|    type_test(int, remove_bounds<int>::type) | ||||
|    type_test(int*, remove_bounds<int*>::type) | ||||
|    type_test(int, remove_bounds<int[3]>::type) | ||||
|    type_test(int[3], remove_bounds<int[2][3]>::type) | ||||
|  | ||||
|    std::cout << std::endl << "Checking type properties..." << std::endl << std::endl; | ||||
|  | ||||
|    value_test(true, (is_same<int, int>::value)) | ||||
|    value_test(false, (is_same<int, const int>::value)) | ||||
|    value_test(false, (is_same<int, int&>::value)) | ||||
|    value_test(false, (is_same<int*, const int*>::value)) | ||||
|    value_test(false, (is_same<int*, int*const>::value)) | ||||
|    value_test(false, (is_same<int, int[2]>::value)) | ||||
|  | ||||
|    value_test(false, is_const<int>::value) | ||||
|    value_test(true, is_const<const int>::value) | ||||
|    value_test(false, is_const<volatile int>::value) | ||||
|    value_test(true, is_const<const volatile int>::value) | ||||
|  | ||||
|    value_test(false, is_volatile<int>::value) | ||||
|    value_test(false, is_volatile<const int>::value) | ||||
|    value_test(true, is_volatile<volatile int>::value) | ||||
|    value_test(true, is_volatile<const volatile int>::value) | ||||
|  | ||||
|    value_test(true, is_void<void>::value) | ||||
|    // Steve: fails on BCB4 | ||||
|    // JM: but looks as though it should according to [3.9.3p1]? | ||||
|    //value_test(false, is_void<const void>::value) | ||||
|    value_test(false, is_void<int>::value) | ||||
|  | ||||
|    value_test(false, is_standard_unsigned_integral<UDT>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<void>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<bool>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<char>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<signed char>::value) | ||||
|    value_test(true, is_standard_unsigned_integral<unsigned char>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<wchar_t>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<short>::value) | ||||
|    value_test(true, is_standard_unsigned_integral<unsigned short>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<int>::value) | ||||
|    value_test(true, is_standard_unsigned_integral<unsigned int>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<long>::value) | ||||
|    value_test(true, is_standard_unsigned_integral<unsigned long>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<float>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<double>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<long double>::value) | ||||
|    #ifdef ULLONG_MAX | ||||
|    value_test(false, is_standard_unsigned_integral<long long>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<unsigned long long>::value) | ||||
|    #endif | ||||
|    #if defined(__BORLANDC__) || defined(_MSC_VER) | ||||
|    value_test(false, is_standard_unsigned_integral<__int64>::value) | ||||
|    value_test(false, is_standard_unsigned_integral<unsigned __int64>::value) | ||||
|    #endif | ||||
|  | ||||
|    value_test(false, is_standard_signed_integral<UDT>::value) | ||||
|    value_test(false, is_standard_signed_integral<void>::value) | ||||
|    value_test(false, is_standard_signed_integral<bool>::value) | ||||
|    value_test(false, is_standard_signed_integral<char>::value) | ||||
|    value_test(true, is_standard_signed_integral<signed char>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned char>::value) | ||||
|    value_test(false, is_standard_signed_integral<wchar_t>::value) | ||||
|    value_test(true, is_standard_signed_integral<short>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned short>::value) | ||||
|    value_test(true, is_standard_signed_integral<int>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned int>::value) | ||||
|    value_test(true, is_standard_signed_integral<long>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned long>::value) | ||||
|    value_test(false, is_standard_signed_integral<float>::value) | ||||
|    value_test(false, is_standard_signed_integral<double>::value) | ||||
|    value_test(false, is_standard_signed_integral<long double>::value) | ||||
|    #ifdef ULLONG_MAX | ||||
|    value_test(false, is_standard_signed_integral<long long>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned long long>::value) | ||||
|    #endif | ||||
|    #if defined(__BORLANDC__) || defined(_MSC_VER) | ||||
|    value_test(false, is_standard_signed_integral<__int64>::value) | ||||
|    value_test(false, is_standard_signed_integral<unsigned __int64>::value) | ||||
|    #endif | ||||
|  | ||||
|    value_test(false, is_standard_arithmetic<UDT>::value) | ||||
|    value_test(false, is_standard_arithmetic<void>::value) | ||||
|    value_test(true, is_standard_arithmetic<bool>::value) | ||||
|    value_test(true, is_standard_arithmetic<char>::value) | ||||
|    value_test(true, is_standard_arithmetic<signed char>::value) | ||||
|    value_test(true, is_standard_arithmetic<unsigned char>::value) | ||||
|    value_test(true, is_standard_arithmetic<wchar_t>::value) | ||||
|    value_test(true, is_standard_arithmetic<short>::value) | ||||
|    value_test(true, is_standard_arithmetic<unsigned short>::value) | ||||
|    value_test(true, is_standard_arithmetic<int>::value) | ||||
|    value_test(true, is_standard_arithmetic<unsigned int>::value) | ||||
|    value_test(true, is_standard_arithmetic<long>::value) | ||||
|    value_test(true, is_standard_arithmetic<unsigned long>::value) | ||||
|    value_test(true, is_standard_arithmetic<float>::value) | ||||
|    value_test(true, is_standard_arithmetic<double>::value) | ||||
|    value_test(true, is_standard_arithmetic<long double>::value) | ||||
|    #ifdef ULLONG_MAX | ||||
|    value_test(false, is_standard_arithmetic<long long>::value) | ||||
|    value_test(false, is_standard_arithmetic<unsigned long long>::value) | ||||
|    #endif | ||||
|    #if defined(__BORLANDC__) || defined(_MSC_VER) | ||||
|    value_test(false, is_standard_arithmetic<__int64>::value) | ||||
|    value_test(false, is_standard_arithmetic<unsigned __int64>::value) | ||||
|    #endif | ||||
|  | ||||
|    value_test(false, is_standard_fundamental<UDT>::value) | ||||
|    value_test(true, is_standard_fundamental<void>::value) | ||||
|    value_test(true, is_standard_fundamental<bool>::value) | ||||
|    value_test(true, is_standard_fundamental<char>::value) | ||||
|    value_test(true, is_standard_fundamental<signed char>::value) | ||||
|    value_test(true, is_standard_fundamental<unsigned char>::value) | ||||
|    value_test(true, is_standard_fundamental<wchar_t>::value) | ||||
|    value_test(true, is_standard_fundamental<short>::value) | ||||
|    value_test(true, is_standard_fundamental<unsigned short>::value) | ||||
|    value_test(true, is_standard_fundamental<int>::value) | ||||
|    value_test(true, is_standard_fundamental<unsigned int>::value) | ||||
|    value_test(true, is_standard_fundamental<long>::value) | ||||
|    value_test(true, is_standard_fundamental<unsigned long>::value) | ||||
|    value_test(true, is_standard_fundamental<float>::value) | ||||
|    value_test(true, is_standard_fundamental<double>::value) | ||||
|    value_test(true, is_standard_fundamental<long double>::value) | ||||
|    #ifdef ULLONG_MAX | ||||
|    value_test(false, is_standard_fundamental<long long>::value) | ||||
|    value_test(false, is_standard_fundamental<unsigned long long>::value) | ||||
|    #endif | ||||
|    #if defined(__BORLANDC__) || defined(_MSC_VER) | ||||
|    value_test(false, is_standard_fundamental<__int64>::value) | ||||
|    value_test(false, is_standard_fundamental<unsigned __int64>::value) | ||||
|    #endif | ||||
|  | ||||
|    value_test(false, is_arithmetic<UDT>::value) | ||||
|    value_test(true, is_arithmetic<char>::value) | ||||
|    value_test(true, is_arithmetic<signed char>::value) | ||||
|    value_test(true, is_arithmetic<unsigned char>::value) | ||||
|    value_test(true, is_arithmetic<wchar_t>::value) | ||||
|    value_test(true, is_arithmetic<short>::value) | ||||
|    value_test(true, is_arithmetic<unsigned short>::value) | ||||
|    value_test(true, is_arithmetic<int>::value) | ||||
|    value_test(true, is_arithmetic<unsigned int>::value) | ||||
|    value_test(true, is_arithmetic<long>::value) | ||||
|    value_test(true, is_arithmetic<unsigned long>::value) | ||||
|    value_test(true, is_arithmetic<float>::value) | ||||
|    value_test(true, is_arithmetic<double>::value) | ||||
|    value_test(true, is_arithmetic<long double>::value) | ||||
|    value_test(true, is_arithmetic<bool>::value) | ||||
|    #ifdef ULLONG_MAX | ||||
|    value_test(true, is_arithmetic<long long>::value) | ||||
|    value_test(true, is_arithmetic<unsigned long long>::value) | ||||
|    #endif | ||||
|    #if defined(__BORLANDC__) || defined(_MSC_VER) | ||||
|    value_test(true, is_arithmetic<__int64>::value) | ||||
|    value_test(true, is_arithmetic<unsigned __int64>::value) | ||||
|    #endif | ||||
|  | ||||
|    value_test(false, is_array<int>::value) | ||||
|    value_test(false, is_array<int*>::value) | ||||
|    value_test(true, is_array<int[2]>::value) | ||||
|    value_test(true, is_array<int[2][3]>::value) | ||||
|    value_test(true, is_array<UDT[2]>::value) | ||||
|  | ||||
|    typedef void(*f1)(); | ||||
|    typedef int(*f2)(int); | ||||
|    typedef int(*f3)(int, bool); | ||||
|    typedef void (UDT::*mf1)(); | ||||
|    typedef int (UDT::*mf2)(); | ||||
|    typedef int (UDT::*mf3)(int); | ||||
|    typedef int (UDT::*mf4)(int, float); | ||||
|  | ||||
|    value_test(false, is_pointer<int>::value) | ||||
|    value_test(false, is_pointer<int&>::value) | ||||
|    value_test(true, is_pointer<int*>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3, 3.9.3p1 | ||||
|    value_test(false, is_pointer<int*const>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3, 3.9.3p1 | ||||
|    value_test(false, is_pointer<int*volatile>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3, 3.9.3p1 | ||||
|    value_test(false, is_pointer<int*const volatile>::value) | ||||
|    value_test(true, is_pointer<f1>::value) | ||||
|    value_test(true, is_pointer<f2>::value) | ||||
|    value_test(true, is_pointer<f3>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3 | ||||
|    value_test(false, is_pointer<mf1>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3 | ||||
|    value_test(false, is_pointer<mf2>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3 | ||||
|    value_test(false, is_pointer<mf3>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9.2p3 | ||||
|    value_test(false, is_pointer<mf4>::value) | ||||
|  | ||||
|    value_test(false, is_reference<bool>::value) | ||||
|    value_test(true, is_reference<int&>::value) | ||||
|    value_test(true, is_reference<const int&>::value) | ||||
|    value_test(true, is_reference<volatile int &>::value) | ||||
|    value_test(true, is_reference<r_type>::value) | ||||
|    value_test(true, is_reference<cr_type>::value) | ||||
|  | ||||
|    value_test(false, is_class<int>::value) | ||||
|    value_test(false, is_class<const int>::value) | ||||
|    value_test(false, is_class<volatile int>::value) | ||||
|    value_test(false, is_class<int*>::value) | ||||
|    value_test(false, is_class<int* const>::value) | ||||
|    value_test(false, is_class<int[2]>::value) | ||||
|    value_test(false, is_class<int&>::value) | ||||
|    value_test(false, is_class<mf4>::value) | ||||
|    value_test(false, is_class<f1>::value) | ||||
|    value_test(false, is_class<enum_UDT>::value) | ||||
|    value_test(true, is_class<UDT>::value) | ||||
|    value_test(true, is_class<UDT const>::value) | ||||
|    value_test(true, is_class<UDT volatile>::value) | ||||
|    value_test(true, is_class<empty_UDT>::value) | ||||
|    value_test(true, is_class<std::iostream>::value) | ||||
|    value_test(false, is_class<UDT*>::value) | ||||
|    value_test(false, is_class<UDT[2]>::value) | ||||
|    value_test(false, is_class<UDT&>::value) | ||||
|  | ||||
|    value_test(true, is_object<int>::value) | ||||
|    value_test(true, is_object<UDT>::value) | ||||
|    value_test(false, is_object<int&>::value) | ||||
|    value_test(false, is_object<void>::value) | ||||
|    value_test(true, is_standard_scalar<int>::value) | ||||
|    value_test(true, is_extension_scalar<void*>::value) | ||||
|  | ||||
|    value_test(false, is_enum<int>::value) | ||||
|    value_test(true, is_enum<enum_UDT>::value) | ||||
|  | ||||
|    value_test(false, is_member_pointer<f1>::value) | ||||
|    value_test(false, is_member_pointer<f2>::value) | ||||
|    value_test(false, is_member_pointer<f3>::value) | ||||
|    value_test(true, is_member_pointer<mf1>::value) | ||||
|    value_test(true, is_member_pointer<mf2>::value) | ||||
|    value_test(true, is_member_pointer<mf3>::value) | ||||
|    value_test(true, is_member_pointer<mf4>::value) | ||||
|  | ||||
|    value_test(false, is_empty<int>::value) | ||||
|    value_test(false, is_empty<int*>::value) | ||||
|    value_test(false, is_empty<int&>::value) | ||||
| #ifdef __MWERKS__ | ||||
|    // apparent compiler bug causes this to fail to compile: | ||||
|    value_fail(false, is_empty<int[2]>::value) | ||||
| #else | ||||
|    value_test(false, is_empty<int[2]>::value) | ||||
| #endif | ||||
|    value_test(false, is_empty<f1>::value) | ||||
|    value_test(false, is_empty<mf1>::value) | ||||
|    value_test(false, is_empty<UDT>::value) | ||||
|    value_test(true, is_empty<empty_UDT>::value) | ||||
|    value_test(true, is_empty<empty_POD_UDT>::value) | ||||
|    value_test(true, is_empty<empty_union_UDT>::value) | ||||
|    value_test(false, is_empty<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, has_trivial_constructor<int>::value) | ||||
|    value_test(true, has_trivial_constructor<int*>::value) | ||||
|    value_test(true, has_trivial_constructor<int*const>::value) | ||||
|    value_test(true, has_trivial_constructor<const int>::value) | ||||
|    value_test(true, has_trivial_constructor<volatile int>::value) | ||||
|    value_test(true, has_trivial_constructor<int[2]>::value) | ||||
|    value_test(true, has_trivial_constructor<int[3][2]>::value) | ||||
|    value_test(true, has_trivial_constructor<int[2][4][5][6][3]>::value) | ||||
|    value_test(true, has_trivial_constructor<f1>::value) | ||||
|    value_test(true, has_trivial_constructor<mf2>::value) | ||||
|    value_test(false, has_trivial_constructor<UDT>::value) | ||||
|    value_test(true, has_trivial_constructor<empty_UDT>::value) | ||||
|    value_test(true, has_trivial_constructor<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, has_trivial_copy<int>::value) | ||||
|    value_test(true, has_trivial_copy<int*>::value) | ||||
|    value_test(true, has_trivial_copy<int*const>::value) | ||||
|    value_test(true, has_trivial_copy<const int>::value) | ||||
|    // Steve: was 'false' -- should be 'true' via 3.9p3, 3.9p10 | ||||
|    value_test(true, has_trivial_copy<volatile int>::value) | ||||
|    value_test(true, has_trivial_copy<int[2]>::value) | ||||
|    value_test(true, has_trivial_copy<int[3][2]>::value) | ||||
|    value_test(true, has_trivial_copy<int[2][4][5][6][3]>::value) | ||||
|    value_test(true, has_trivial_copy<f1>::value) | ||||
|    value_test(true, has_trivial_copy<mf2>::value) | ||||
|    value_test(false, has_trivial_copy<UDT>::value) | ||||
|    value_test(true, has_trivial_copy<empty_UDT>::value) | ||||
|    value_test(true, has_trivial_copy<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, has_trivial_assign<int>::value) | ||||
|    value_test(true, has_trivial_assign<int*>::value) | ||||
|    value_test(true, has_trivial_assign<int*const>::value) | ||||
|    value_test(true, has_trivial_assign<const int>::value) | ||||
|    // Steve: was 'false' -- should be 'true' via 3.9p3, 3.9p10 | ||||
|    value_test(true, has_trivial_assign<volatile int>::value) | ||||
|    value_test(true, has_trivial_assign<int[2]>::value) | ||||
|    value_test(true, has_trivial_assign<int[3][2]>::value) | ||||
|    value_test(true, has_trivial_assign<int[2][4][5][6][3]>::value) | ||||
|    value_test(true, has_trivial_assign<f1>::value) | ||||
|    value_test(true, has_trivial_assign<mf2>::value) | ||||
|    value_test(false, has_trivial_assign<UDT>::value) | ||||
|    value_test(true, has_trivial_assign<empty_UDT>::value) | ||||
|    value_test(true, has_trivial_assign<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, has_trivial_destructor<int>::value) | ||||
|    value_test(true, has_trivial_destructor<int*>::value) | ||||
|    value_test(true, has_trivial_destructor<int*const>::value) | ||||
|    value_test(true, has_trivial_destructor<const int>::value) | ||||
|    value_test(true, has_trivial_destructor<volatile int>::value) | ||||
|    value_test(true, has_trivial_destructor<int[2]>::value) | ||||
|    value_test(true, has_trivial_destructor<int[3][2]>::value) | ||||
|    value_test(true, has_trivial_destructor<int[2][4][5][6][3]>::value) | ||||
|    value_test(true, has_trivial_destructor<f1>::value) | ||||
|    value_test(true, has_trivial_destructor<mf2>::value) | ||||
|    value_test(false, has_trivial_destructor<UDT>::value) | ||||
|    value_test(false, has_trivial_destructor<empty_UDT>::value) | ||||
|    value_test(true, has_trivial_destructor<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, is_POD<int>::value) | ||||
|    value_test(true, is_POD<int*>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9p10 | ||||
|    value_test(false, is_POD<int&>::value) | ||||
|    value_test(true, is_POD<int*const>::value) | ||||
|    value_test(true, is_POD<const int>::value) | ||||
|    // Steve: was 'false', should be 'true', via 3.9p10 | ||||
|    value_test(true, is_POD<volatile int>::value) | ||||
|    // Steve: was 'true', should be 'false', via 3.9p10 | ||||
|    value_test(false, is_POD<const int&>::value) | ||||
|    value_test(true, is_POD<int[2]>::value) | ||||
|    value_test(true, is_POD<int[3][2]>::value) | ||||
|    value_test(true, is_POD<int[2][4][5][6][3]>::value) | ||||
|    value_test(true, is_POD<f1>::value) | ||||
|    value_test(true, is_POD<mf2>::value) | ||||
|    value_test(false, is_POD<UDT>::value) | ||||
|    value_test(false, is_POD<empty_UDT>::value) | ||||
|    value_test(true, is_POD<enum_UDT>::value) | ||||
|  | ||||
|    value_test(true, (boost::is_convertible<Deriverd,Base>::value)); | ||||
|    value_test(true, (boost::is_convertible<Deriverd,Deriverd>::value)); | ||||
|    value_test(true, (boost::is_convertible<Base,Base>::value)); | ||||
|    value_test(false, (boost::is_convertible<Base,Deriverd>::value)); | ||||
|    value_test(true, (boost::is_convertible<Deriverd,Deriverd>::value)); | ||||
|    value_test(false, (boost::is_convertible<NonDerived,Base>::value)); | ||||
|    //value_test(false, (boost::is_convertible<boost::noncopyable, boost::noncopyable>::value)); | ||||
|    value_test(true, (boost::is_convertible<float,int>::value)); | ||||
| #if defined(BOOST_MSVC6_MEMBER_TEMPLATES) || !defined(BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION) | ||||
|    value_test(false, (boost::is_convertible<float,void>::value)); | ||||
|    value_test(false, (boost::is_convertible<void,float>::value)); | ||||
|    value_test(true, (boost::is_convertible<void,void>::value)); | ||||
| #endif | ||||
|    value_test(true, (boost::is_convertible<enum1, int>::value)); | ||||
|    value_test(true, (boost::is_convertible<Deriverd*, Base*>::value)); | ||||
|    value_test(false, (boost::is_convertible<Base*, Deriverd*>::value)); | ||||
|    value_test(true, (boost::is_convertible<Deriverd&, Base&>::value)); | ||||
|    value_test(false, (boost::is_convertible<Base&, Deriverd&>::value)); | ||||
|    value_test(true, (boost::is_convertible<const Deriverd*, const Base*>::value)); | ||||
|    value_test(false, (boost::is_convertible<const Base*, const Deriverd*>::value)); | ||||
|    value_test(true, (boost::is_convertible<const Deriverd&, const Base&>::value)); | ||||
|    value_test(false, (boost::is_convertible<const Base&, const Deriverd&>::value)); | ||||
|  | ||||
|    value_test(false, (boost::is_convertible<const int *, int*>::value)); | ||||
|    value_test(false, (boost::is_convertible<const int&, int&>::value)); | ||||
|    value_test(false, (boost::is_convertible<int*, int[2]>::value)); | ||||
|    value_test(false, (boost::is_convertible<const int*, int[3]>::value)); | ||||
|    value_test(true, (boost::is_convertible<const int&, int>::value)); | ||||
|    value_test(true, (boost::is_convertible<int(&)[4], const int*>::value)); | ||||
|    value_test(true, (boost::is_convertible<int(&)(int), int(*)(int)>::value)); | ||||
|    value_test(true, (boost::is_convertible<int *, const int*>::value)); | ||||
|    value_test(true, (boost::is_convertible<int&, const int&>::value)); | ||||
|    value_test(true, (boost::is_convertible<int[2], int*>::value)); | ||||
|    value_test(true, (boost::is_convertible<int[2], const int*>::value)); | ||||
|    value_test(false, (boost::is_convertible<const int[2], int*>::value)); | ||||
|  | ||||
|    align_test(int); | ||||
|    align_test(char); | ||||
|    align_test(double); | ||||
|    align_test(int[4]); | ||||
|    align_test(int(*)(int)); | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
|    align_test(char&); | ||||
|    align_test(char (&)(int)); | ||||
|    align_test(char(&)[4]); | ||||
| #endif | ||||
|    align_test(int*); | ||||
|    //align_test(const int); | ||||
|    align_test(VB); | ||||
|    align_test(VD); | ||||
|  | ||||
|    std::cout << std::endl << test_count << " tests completed (" << failures << " failures)... press any key to exit"; | ||||
|    std::cin.get(); | ||||
|    return failures; | ||||
| } | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
| @@ -1,106 +0,0 @@ | ||||
|  // boost::compressed_pair test program    | ||||
|      | ||||
|  //  (C) Copyright John Maddock 2000. Permission to copy, use, modify, sell and    | ||||
|  //  distribute this software is granted provided this copyright notice appears    | ||||
|  //  in all copies. This software is provided "as is" without express or implied    | ||||
|  //  warranty, and with no claim as to its suitability for any purpose.    | ||||
|  | ||||
| // common test code for type_traits_test.cpp/call_traits_test.cpp/compressed_pair_test.cpp | ||||
|  | ||||
|  | ||||
| #ifndef BOOST_TYPE_TRAITS_TEST_HPP | ||||
| #define BOOST_TYPE_TRAITS_TEST_HPP | ||||
|  | ||||
| // | ||||
| // this one is here just to suppress warnings: | ||||
| // | ||||
| template <class T> | ||||
| bool do_compare(T i, T j) | ||||
| { | ||||
|    return i == j; | ||||
| } | ||||
|  | ||||
| // | ||||
| // this one is to verify that a constant is indeed a | ||||
| // constant-integral-expression: | ||||
| // | ||||
| template <int> | ||||
| struct ct_checker | ||||
| { | ||||
| }; | ||||
|  | ||||
| #define BOOST_DO_JOIN( X, Y ) BOOST_DO_JOIN2(X,Y) | ||||
| #define BOOST_DO_JOIN2(X, Y) X ## Y | ||||
| #define BOOST_JOIN( X, Y ) BOOST_DO_JOIN( X, Y ) | ||||
|  | ||||
|  | ||||
| #define value_test(v, x) ++test_count;\ | ||||
|                          typedef ct_checker<(x)> BOOST_JOIN(this_is_a_compile_time_check_, __LINE__);\ | ||||
|                          if(!do_compare((int)v,(int)x)){++failures; std::cout << "checking value of " << #x << "...failed" << std::endl;} | ||||
| #define value_fail(v, x) ++test_count; ++failures; std::cout << "checking value of " << #x << "...failed" << std::endl; | ||||
|  | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| #define type_test(v, x)  ++test_count;\ | ||||
|                            if(do_compare(boost::is_same<v, x>::value, false)){\ | ||||
|                            ++failures; \ | ||||
|                            std::cout << "checking type of " << #x << "...failed" << std::endl; \ | ||||
|                            std::cout << "   expected type was " << #v << std::endl; \ | ||||
|                            std::cout << "   " << typeid(boost::is_same<v, x>).name() << "::value is false" << std::endl; } | ||||
| #else | ||||
| #define type_test(v, x)  ++test_count;\ | ||||
|                          if(typeid(v) != typeid(x)){\ | ||||
|                            ++failures; \ | ||||
|                            std::cout << "checking type of " << #x << "...failed" << std::endl; \ | ||||
|                            std::cout << "   expected type was " << #v << std::endl; \ | ||||
|                            std::cout << "   " << "typeid(" #v ") != typeid(" #x ")" << std::endl; } | ||||
| #endif | ||||
|  | ||||
| template <class T> | ||||
| struct test_align | ||||
| { | ||||
|    struct padded | ||||
|    { | ||||
|       char c; | ||||
|       T t; | ||||
|    }; | ||||
|    static void do_it() | ||||
|    { | ||||
|       padded p; | ||||
|       unsigned a = reinterpret_cast<char*>(&(p.t)) - reinterpret_cast<char*>(&p); | ||||
|       value_test(a, boost::alignment_of<T>::value); | ||||
|    } | ||||
| }; | ||||
| #ifndef BOOST_NO_TEMPLATE_PARTIAL_SPECIALIZATION | ||||
| template <class T> | ||||
| struct test_align<T&> | ||||
| { | ||||
|    static void do_it() | ||||
|    { | ||||
|       // | ||||
|       // we can't do the usual test because we can't take the address | ||||
|       // of a reference, so check that the result is the same as for a | ||||
|       // pointer type instead: | ||||
|       value_test(boost::alignment_of<T*>::value, boost::alignment_of<T&>::value); | ||||
|    } | ||||
| }; | ||||
| #endif | ||||
|  | ||||
| #define align_test(T) test_align<T>::do_it() | ||||
|  | ||||
| // | ||||
| // define tests here | ||||
| unsigned failures = 0; | ||||
| unsigned test_count = 0; | ||||
|  | ||||
| // | ||||
| // turn off some warnings: | ||||
| #ifdef __BORLANDC__ | ||||
| #pragma option -w-8004 | ||||
| #endif | ||||
|  | ||||
| #ifdef BOOST_MSVC | ||||
| #pragma warning (disable: 4018) | ||||
| #endif | ||||
|  | ||||
|  | ||||
| #endif // BOOST_TYPE_TRAITS_TEST_HPP | ||||
							
								
								
									
										275
									
								
								utility.htm
									
									
									
									
									
								
							
							
						
						
									
										275
									
								
								utility.htm
									
									
									
									
									
								
							| @@ -1,103 +1,194 @@ | ||||
| <html> | ||||
|  | ||||
| <head> | ||||
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| <title>Header boost/utility.hpp Documentation</title> | ||||
| </head> | ||||
|  | ||||
| <body bgcolor="#FFFFFF" text="#000000"> | ||||
|  | ||||
| <h1><img src="../../c++boost.gif" alt="c++boost.gif (8819 bytes)" align="center" WIDTH="277" HEIGHT="86">Header | ||||
| <a href="../../boost/utility.hpp">boost/utility.hpp</a></h1> | ||||
|  | ||||
| <p>The entire contents of the header <code><a href="../../boost/utility.hpp"><boost/utility.hpp></a></code> | ||||
|  are in <code>namespace boost</code>.</p> | ||||
|  | ||||
| <h2>Contents</h2> | ||||
|  | ||||
| <ul> | ||||
|   <li>Template functions <a href="#functions next">next() and prior()</a></li> | ||||
|   <li>Class <a href="#Class noncopyable">noncopyable</a></li> | ||||
| </ul> | ||||
| <h2>Template <a name="functions next">functions next</a>() and prior()</h2> | ||||
|  | ||||
| <p>Certain data types, such as the C++ Standard Library's forward and | ||||
| bidirectional iterators, do not provide addition and subtraction via operator+() | ||||
| or operator-().  This means that non-modifying computation of the next or | ||||
| prior value requires a temporary, even though operator++() or operator--() is | ||||
| provided.  It also means that writing code like <code>itr+1</code> inside a | ||||
| template restricts the iterator category to random access iterators.</p> | ||||
|  | ||||
| <p>The next() and prior() functions provide a simple way around these problems:</p> | ||||
|  | ||||
| <blockquote> | ||||
|  | ||||
| <pre>template <class T> | ||||
| 	<head> | ||||
| 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | ||||
| 		<title>Header boost/utility.hpp Documentation</title> | ||||
| 	</head> | ||||
| 	<body bgcolor="#FFFFFF" text="#000000"> | ||||
| 		<h1><img src="../../boost.png" alt="boost.png (6897 bytes)" align="center" WIDTH="277" HEIGHT="86">Header | ||||
| 			<a href="../../boost/utility.hpp">boost/utility.hpp</a></h1> | ||||
| 		<p>The entire contents of the header <code><a href="../../boost/utility.hpp"><boost/utility.hpp></a></code> | ||||
| 			are in <code>namespace boost</code>.</p> | ||||
| 		<h2>Contents</h2> | ||||
| 		<ul> | ||||
| 			<li> | ||||
| 				Class templates supporting the <a href="base_from_member.html">base-from-member  | ||||
| 					idiom</a></li> | ||||
| 			<li> | ||||
| 				Function templates <a href="#checked_delete">checked_delete() and  | ||||
| 					checked_array_delete()</a></li> | ||||
| 			<li> | ||||
| 				Function templates <a href="#functions_next_prior">next() and prior()</a></li> | ||||
| 			<li> | ||||
| 				Class <a href="#Class_noncopyable">noncopyable</a></li> | ||||
| 			<li> | ||||
| 				Function template <a href="#addressof">addressof()</a></li> | ||||
|                         <li>Class template <a href="#result_of">result_of</a></li> | ||||
|                         <li><a href="index.html">Other utilities not part of <code>utility.hpp</code></a></li> | ||||
| 		</ul> | ||||
| 		<h2> | ||||
| 			Function templates <a name="checked_delete">checked_delete</a>() and  | ||||
| 			checked_array_delete()</h2> | ||||
| 		<p>See <a href="checked_delete.html">separate documentation</a>.</p> | ||||
| 		<h2> | ||||
| 			<a name="functions_next_prior">Function</a> templates next() and prior()</h2> | ||||
| 		<p>Certain data types, such as the C++ Standard Library's forward and bidirectional  | ||||
| 			iterators, do not provide addition and subtraction via operator+() or  | ||||
| 			operator-().  This means that non-modifying computation of the next or  | ||||
| 			prior value requires a temporary, even though operator++() or operator--() is  | ||||
| 			provided.  It also means that writing code like <code>itr+1</code> inside  | ||||
| 			a template restricts the iterator category to random access iterators.</p> | ||||
| 		<p>The next() and prior() functions provide a simple way around these problems:</p> | ||||
| 		<blockquote> | ||||
| 			<pre>template <class T> | ||||
| T next(T x) { return ++x; } | ||||
|  | ||||
| template <class X> | ||||
| T prior(T x) { return --x; }</pre> | ||||
| template <class T, class Distance> | ||||
| T next(T x, Distance n) | ||||
| { | ||||
|     std::advance(x, n); | ||||
|     return x; | ||||
| } | ||||
|  | ||||
| </blockquote> | ||||
| template <class T> | ||||
| T prior(T x) { return --x; } | ||||
|  | ||||
| <p>Usage is simple:</p> | ||||
|  | ||||
| <blockquote> | ||||
|  | ||||
| <pre>const std::list<T>::iterator p = get_some_iterator(); | ||||
| const std::list<T>::iterator prev = boost::prior(p);</pre> | ||||
|  | ||||
| </blockquote> | ||||
|  | ||||
| <p>Contributed by <a href="../../people/dave_abrahams.htm">Dave Abrahams</a>.</p> | ||||
|  | ||||
| <h2><a name="Class noncopyable">Class noncopyable</a></h2> | ||||
|  | ||||
| <p>Class <strong>noncopyable</strong> is a base class.  Derive your own class from <strong>noncopyable</strong> | ||||
| when you want to prohibit copy construction and copy assignment.</p> | ||||
|  | ||||
| <p>Some objects, particularly those which hold complex resources like files or | ||||
| network connections, have no sensible copy semantics.  Sometimes there are | ||||
| possible copy semantics, but these would be of very limited usefulness and be | ||||
| very difficult to implement correctly.  Sometimes you're implementing a class that doesn't need to be copied | ||||
| just yet and you don't want to take the time to write the appropriate functions.  | ||||
| Deriving from <b> noncopyable</b> will prevent the otherwise implicitly-generated | ||||
| functions (which don't have the proper semantics) from becoming a trap for other programmers.</p> | ||||
|  | ||||
| <p>The traditional way to deal with these is to declare a private copy constructor and copy assignment, and then | ||||
| document why this is done.  But deriving from <b>noncopyable</b> is simpler | ||||
| and clearer, and doesn't require additional documentation.</p> | ||||
|  | ||||
| <p>The program <a href="noncopyable_test.cpp">noncopyable_test.cpp</a> can be | ||||
| used to verify class <b>noncopyable</b> works as expected. It has have been run successfully under | ||||
| GCC 2.95, Metrowerks | ||||
| CodeWarrior 5.0, and Microsoft Visual C++ 6.0 sp 3.</p> | ||||
|  | ||||
| <p>Contributed by <a href="../../people/dave_abrahams.htm">Dave Abrahams</a>.</p> | ||||
|  | ||||
| <h3>Example</h3> | ||||
| <blockquote> | ||||
|   <pre>// inside one of your own headers ... | ||||
| template <class T, class Distance> | ||||
| T prior(T x, Distance n) | ||||
| { | ||||
|     std::advance(x, -n); | ||||
|     return x; | ||||
| }</pre> | ||||
| 		</blockquote> | ||||
| 		<p>Usage is simple:</p> | ||||
| 		<blockquote> | ||||
| 			<pre>const std::list<T>::iterator p = get_some_iterator(); | ||||
| const std::list<T>::iterator prev = boost::prior(p); | ||||
| const std::list<T>::iterator next = boost::next(prev, 2);</pre> | ||||
| 		</blockquote> | ||||
|                 <p>The distance from the given iterator should be supplied as an absolute value. For | ||||
| 			example, the iterator four iterators prior to the given iterator <code>p</code> | ||||
| 			may be obtained by <code>prior(p, 4)</code>.</p> | ||||
| 		<p>Contributed by <a href="../../people/dave_abrahams.htm">Dave Abrahams</a>.  Two-argument versions by Daniel Walker.</p> | ||||
| 		<h2><a name="Class_noncopyable">Class noncopyable</a></h2> | ||||
| 		<p>Class <strong>noncopyable</strong> is a base class.  Derive your own class  | ||||
| 			from <strong>noncopyable</strong> when you want to prohibit copy construction  | ||||
| 			and copy assignment.</p> | ||||
| 		<p>Some objects, particularly those which hold complex resources like files or  | ||||
| 			network connections, have no sensible copy semantics.  Sometimes there are  | ||||
| 			possible copy semantics, but these would be of very limited usefulness and be  | ||||
| 			very difficult to implement correctly.  Sometimes you're implementing a  | ||||
| 			class that doesn't need to be copied just yet and you don't want to take the  | ||||
| 			time to write the appropriate functions.  Deriving from <b>noncopyable</b>  | ||||
| 			will prevent the otherwise implicitly-generated functions (which don't have the  | ||||
| 			proper semantics) from becoming a trap for other programmers.</p> | ||||
| 		<p>The traditional way to deal with these is to declare a private copy constructor  | ||||
| 			and copy assignment, and then document why this is done.  But deriving  | ||||
| 			from <b>noncopyable</b> is simpler and clearer, and doesn't require additional  | ||||
| 			documentation.</p> | ||||
| 		<p>The program <a href="noncopyable_test.cpp">noncopyable_test.cpp</a> can be used  | ||||
| 			to verify class <b>noncopyable</b> works as expected. It has have been run  | ||||
| 			successfully under GCC 2.95, Metrowerks CodeWarrior 5.0, and Microsoft Visual  | ||||
| 			C++ 6.0 sp 3.</p> | ||||
| 		<p>Contributed by <a href="../../people/dave_abrahams.htm">Dave Abrahams</a>.</p> | ||||
| 		<h3>Example</h3> | ||||
| 		<blockquote> | ||||
| 			<pre>// inside one of your own headers ... | ||||
| #include <boost/utility.hpp> | ||||
|  | ||||
| class ResourceLadenFileSystem : noncopyable { | ||||
| class ResourceLadenFileSystem : boost::noncopyable { | ||||
| ...</pre> | ||||
| </blockquote> | ||||
| 		</blockquote> | ||||
| 		<h3>Rationale</h3> | ||||
| 		<p>Class noncopyable has protected constructor and destructor members to emphasize  | ||||
| 			that it is to be used only as a base class.  Dave Abrahams notes concern  | ||||
| 			about the effect on compiler optimization of adding (even trivial inline)  | ||||
| 			destructor declarations. He says "Probably this concern is misplaced,  | ||||
| 			because noncopyable will be used mostly for classes which own resources and  | ||||
| 			thus have non-trivial destruction semantics."</p> | ||||
| 		<h2><a name="addressof">Function template addressof()</a></h2> | ||||
| 		<p>Function <strong>addressof()</strong> returns the address of an object.</p> | ||||
| 		<blockquote> | ||||
| 			<pre>template <typename T> inline T*                addressof(T& v); | ||||
| template <typename T> inline const T*          addressof(const T& v); | ||||
| template <typename T> inline volatile T*       addressof(volatile T& v); | ||||
| template <typename T> inline const volatile T* addressof(const volatile T& v); | ||||
| </pre> | ||||
| 		</blockquote> | ||||
| 		<p>C++ allows programmers to replace the unary <strong>operator&()</strong> class  | ||||
| 			member used to get the address of an object. Getting the real address of an  | ||||
| 			object requires ugly casting tricks to avoid invoking the overloaded <strong>operator&()</strong>.  | ||||
| 			Function <strong>addressof()</strong> provides a wrapper around the necessary  | ||||
| 			code to make it easy to get an object's real address. | ||||
| 		</p> | ||||
| 		<p>The program <a href="addressof_test.cpp">addressof_test.cpp</a> can be used to  | ||||
| 			verify that <b>addressof()</b> works as expected.</p> | ||||
| 		<p>Contributed by Brad King based on ideas from discussion with Doug Gregor.</p> | ||||
| 		<h3>Example</h3> | ||||
| 		<blockquote> | ||||
| 			<pre>#include <boost/utility.hpp> | ||||
|  | ||||
| <h3>Rationale</h3> | ||||
| <p>Class noncopyable has protected constructor and destructor members to | ||||
| emphasize that it is to be used only as a base class.  Dave Abrahams notes | ||||
| concern about the effect on compiler optimization of adding (even trivial inline) | ||||
| destructor declarations. He says "Probably this concern is misplaced, because | ||||
| noncopyable will be used mostly for classes which own resources and thus have non-trivial destruction semantics."</p> | ||||
| <hr> | ||||
| <p>Revised  <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan | ||||
| -->26 January, 2000<!--webbot bot="Timestamp" endspan i-checksum="38194" | ||||
| struct useless_type {}; | ||||
| class nonaddressable { | ||||
|   useless_type operator&() const; | ||||
| }; | ||||
|  | ||||
| void f() { | ||||
|   nonaddressable x; | ||||
|   nonaddressable* xp = boost::addressof(x); | ||||
|   // nonaddressable* xpe = &x; /* error */ | ||||
| }</pre> | ||||
| 		</blockquote> | ||||
|                 <h2><a name="result_of">Class template | ||||
|                 result_of</a></h2> <p>The class template | ||||
|                 <code>result_of</code> helps determine the type of a | ||||
|                 call expression. Given an lvalue <code>f</code> of | ||||
|                 type <code>F</code> and lvalues <code>t1</code>, | ||||
|                 <code>t2</code>, ..., <code>t<em>N</em></code> of | ||||
|                 types <code>T1</code>, <code>T2</code>, ..., | ||||
|                 <code>T<em>N</em></code>, respectively, the type | ||||
|                 <code>result_of<F(T1, T2, ..., | ||||
|                 T<em>N</em>)>::type</code> defines the result type | ||||
|                 of the expression <code>f(t1, t2, | ||||
|                 ...,t<em>N</em>)</code>. The implementation permits | ||||
|                 the type <code>F</code> to be a function pointer, | ||||
|                 function reference, member function pointer, or class | ||||
|                 type. When <code>F</code> is a class type with a | ||||
|                 member type <code>result_type</code>, | ||||
|                 <code>result_of<F(T1, T2, ..., | ||||
|                 T<em>N</em>)></code> is | ||||
|                 <code>F::result_type</code>. Otherwise, | ||||
|                 <code>result_of<F(T1, T2, ..., | ||||
|                 T<em>N</em>)></code> is <code>F::result<F(T1, | ||||
|                 T2, ..., T<em>N</em>)>::type</code> when | ||||
|                 <code><em>N</em> > 0</code> or <code>void</code> | ||||
|                 when <code><em>N</em> = 0</code>. For additional | ||||
|                 information about <code>result_of</code>, see the | ||||
|                 C++ Library Technical Report, <a | ||||
|                 href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2005/n1836.pdf">N1836</a>, | ||||
|                 or, for motivation and design rationale, the <code>result_of</code> <a | ||||
|                 href="http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2003/n1454.html">proposal</a>.</p> | ||||
|  | ||||
|                 <p>Class template <code>result_of</code> resides in | ||||
|                 the header <code><<a | ||||
|                 href="../../boost/utility/result_of.hpp">boost/utility/result_of.hpp</a>></code>. By | ||||
|                 default, <em>N</em> may be any value between 0 and | ||||
|                 10. To change the upper limit, define the macro | ||||
|                 <code>BOOST_RESULT_OF_NUM_ARGS</code> to the maximum | ||||
|                 value for <em>N</em>.</p> | ||||
|  | ||||
|                 <a name="BOOST_NO_RESULT_OF"></a> | ||||
|                 <p>This implementation of <code>result_of</code> requires class template partial specialization, the ability to parse function types properly, and support for SFINAE. If <code>result_of</code> is not supported by your compiler, including the header <code>boost/utility/result_of.hpp</code> will define the macro <code>BOOST_NO_RESULT_OF</code>. Contributed by Doug Gregor.</p> | ||||
|  | ||||
| 		<h2>Class templates for the Base-from-Member Idiom</h2> | ||||
| 		<p>See <a href="base_from_member.html">separate documentation</a>.</p> | ||||
| 		<hr> | ||||
| 		<p>Revised  <!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan | ||||
| -->02 May, 2004<!--webbot bot="Timestamp" endspan i-checksum="38582" | ||||
| --> | ||||
| </p> | ||||
| <p><EFBFBD> Copyright boost.org 1999. Permission to copy, use, modify, sell and | ||||
| distribute this document is granted provided this copyright notice appears in | ||||
| all copies. This document is provided "as is" without express or | ||||
| implied warranty, and with no claim as to its suitability for any purpose.</p> | ||||
| </body> | ||||
| 		</p> | ||||
| 		<p>© Copyright boost.org 1999-2003. Permission to copy, use, modify, sell and distribute  | ||||
| 			this document is granted provided this copyright notice appears in all copies.  | ||||
| 			This document is provided "as is" without express or implied  | ||||
| 			warranty, and with no claim as to its suitability for any purpose.</p> | ||||
| 	</body> | ||||
| </html> | ||||
|   | ||||
							
								
								
									
										219
									
								
								value_init.htm
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										219
									
								
								value_init.htm
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,219 @@ | ||||
| <html> | ||||
| <head> | ||||
|               | ||||
|   <meta http-equiv="Content-Type" | ||||
|  content="text/html; charset=iso-8859-1"> | ||||
|   <title>value_initialized</title> | ||||
|      | ||||
| </head> | ||||
|   <body vlink="#800080" link="#0000ff" text="#000000" bgcolor="#ffffff"> | ||||
|                     | ||||
| <h2><img src="../../boost.png" width="276" height="86"> | ||||
|          Header <<a href="../../boost/utility/value_init.hpp">boost/utility/value_init.hpp</a>> | ||||
|      </h2> | ||||
|                     | ||||
| <h2>Contents</h2> | ||||
|                     | ||||
| <dl> | ||||
|   <dt><a href="#rationale">Rationale</a></dt> | ||||
|   <dt><a href="#intro">Introduction</a></dt> | ||||
| </dl> | ||||
|                     | ||||
| <ul> | ||||
|           <li><a href="#valueinit">value-initialization</a></li> | ||||
|           <li><a href="#valueinitsyn">value-initialization syntax</a></li> | ||||
|                     | ||||
| </ul> | ||||
|                     | ||||
| <dl class="page-index"> | ||||
|   <dt><a href="#types">Types</a></dt> | ||||
| </dl> | ||||
|                     | ||||
| <ul> | ||||
|           <li><a href="#val_init"><code>value_initialized<></code></a></li> | ||||
|                     | ||||
| </ul> | ||||
|               <a href="#acknowledgements">Acknowledgements</a><br> | ||||
|      <br> | ||||
|           | ||||
| <hr>           | ||||
| <h2><a name="rationale"></a>Rationale</h2> | ||||
|                    | ||||
| <p>Constructing and initializing objects in a generic way is difficult in | ||||
|     C++. The problem is that there are several different rules that apply | ||||
| for    initialization. Depending on the type, the value of a newly constructed | ||||
|   object  can be zero-initialized (logically 0), default-constructed (using | ||||
|   the default constructor), or indeterminate. When writing generic code, | ||||
| this   problem must be addressed. <code>value_initialized</code> provides | ||||
| a solution   with consistent syntax for value   initialization of scalar, | ||||
| union and class   types. <br> | ||||
|   </p> | ||||
|          | ||||
| <h2><a name="intro"></a>Introduction</h2> | ||||
|       | ||||
| <p>The C++ standard [<a href="#references">1</a>] contains the definitions  | ||||
|     of <code>zero-initialization</code> and <code>default-initialization</code>. | ||||
|      Informally, zero-initialization means that the object is given the initial | ||||
|      value 0 (converted to the type) and default-initialization means that | ||||
|  POD   [<a href="#references">2</a>] types are zero-initialized, while class | ||||
|  types   are initialized with their corresponding default constructors. A | ||||
| <i>declaration</i>   can contain an <i>initializer</i>, which specifies the | ||||
| object's initial value.  The initializer can be just '()', which states that | ||||
| the object shall be default-initialized  (but see below). However, if a <i>declaration</i>  | ||||
|   has no <i>initializer</i>  and it is of a non-<code>const</code>, non-<code>static</code>  | ||||
|    POD type, the initial value is indeterminate:<cite>(see §8.5 for the | ||||
|    accurate definitions).</cite></p> | ||||
|                     | ||||
| <pre>int x ; // no initializer. x value is indeterminate.<br>std::string s ; // no initializer, s is default-constructed.<br><br>int y = int() ; <br>// y is initialized using copy-initialization<br>// but the temporary uses an empty set of parentheses as the initializer,<br>// so it is default-constructed.<br>// A default constructed POD type is zero-initialized,<br>// therefore, y == 0.<br><br>void foo ( std::string ) ;<br>foo ( std::string() ) ; <br>// the temporary string is default constructed <br>// as indicated by the initializer ()  </pre> | ||||
|                      | ||||
| <h3><a name="valueinit">value-initialization</a></h3> | ||||
|                     | ||||
| <p>The first <a | ||||
|  href="http://anubis.dkuug.dk/JTC1/SC22/WG21/docs/cwg_defects.html">Technical  | ||||
|   Corrigendum for the C++ Standard</a> (TC1), whose draft   was released to | ||||
|   the public in November 2001, introduced <a | ||||
|  href="http://anubis.dkuug.dk/JTC1/SC22/WG21/docs/cwg_defects.html#178">Core  | ||||
|   Issue 178</a> (among   many other issues, of course).</p> | ||||
|                     | ||||
| <p> That issue introduced the new concept of <code>value-initialization</code> | ||||
|      (it also fixed the wording for zero-initialization). Informally, value-initialization  | ||||
|     is similar to default-initialization with the exception that in some cases | ||||
|     non-static data members and base class sub-objects are also value-initialized.  | ||||
|     The difference is that an object that is value-initialized won't have  | ||||
| (or    at least is less likely to have) indeterminate values for data members  | ||||
|  and   base class sub-objects; unlike the case of an object default constructed.  | ||||
|     (see Core Issue 178 for a normative description).</p> | ||||
|                     | ||||
| <p>In order to specify value-initialization of an object we need to use the | ||||
|      empty-set initializer: (). </p> | ||||
|                     | ||||
| <p><i>(but recall that the current C++ Standard states that '()' invokes default-initialization, | ||||
| not value-initialization)</i></p> | ||||
|                     | ||||
| <p>As before, a declaration with no intializer specifies default-initialization,  | ||||
|     and a declaration with a non-empty initializer specifies copy (=xxx) or | ||||
|   direct  (xxx) initialization. </p> | ||||
|                     | ||||
| <pre>template<class T> void eat(T);<br>int x ; // indeterminate initial value.<br>std::string s; // default-initialized.<br>eat ( int() ) ; // value-initialized<br>eat ( std::string() ) ; // value-initialied</pre> | ||||
|                      | ||||
| <h4><a name="valueinitsyn">value-initialization</a> syntax</h4> | ||||
|                     | ||||
| <p>Value initialization is specified using (). However, the empty set of | ||||
| parentheses is not permitted by the syntax of initializers because it is | ||||
| parsed as the declaration of a function taking no arguments: </p> | ||||
|                     | ||||
| <pre>int x() ; // declares function int(*)()<br>int y ( int() ) ; // decalares function int(*)( int(*)() )</pre> | ||||
|                      | ||||
| <p>Thus, the empty () must be put in some other initialization context.</p> | ||||
|                     | ||||
| <p>One alternative is to use copy-initialization syntax:</p> | ||||
|                     | ||||
| <pre>int x = int() ;</pre> | ||||
|                      | ||||
| <p>This works perfectly fine for POD types. But for non-POD class types, | ||||
| copy-initialization searches for a suitable constructor, which could be, | ||||
| for instance, the copy-constructor (it also searches for a suitable conversion | ||||
| sequence but this doesn't apply in this context). For an arbitrary unknown | ||||
| type, using this syntax may not have the value-initialization effect intended | ||||
| because we don't know if a copy from a default constructed object is exactly | ||||
| the same as a default constructed object, and the compiler is allowed (in | ||||
| some cases), but never required to, optimize the copy away.</p> | ||||
|                     | ||||
| <p>One possible generic solution is to use value-initialization of a non static | ||||
| data member:</p> | ||||
|                     | ||||
| <pre>template<class T> <br>struct W <br>{<br>  // value-initialization of 'data' here.<br>  W() : data() {}<br>  T data ;<br>} ;<br>W<int> w ;<br>// w.data is value-initialized for any type. </pre> | ||||
|                      | ||||
| <p><code>This is the solution supplied by the value_initialized<> template | ||||
|      class.</code></p> | ||||
|                     | ||||
| <h2><a name="types"></a>Types</h2> | ||||
|                     | ||||
| <h2><a name="val_init"><code>template class value_initialized<T></code></a></h2> | ||||
|                     | ||||
| <pre>namespace boost {<br><br>template<class T><br>class value_initialized<br>{<br>  public :<br>    value_initialized() : x() {}<br>    operator T&() const { return x ; }<br>    T& data() const { return x ; }<br><br>  private :<br>    <i>unspecified</i> x ;<br>} ;<br><br>template<class T><br>T const& get ( value_initialized<T> const& x )<br>{<br>  return x.data() ;<br>}<br><br>template<class T><br>T& get ( value_initialized<T>& x )<br>{<br>  return x.data() ;<br>}<br><br>} // namespace boost<br></pre> | ||||
|                      | ||||
| <p>An object of this template class is a <code>T</code>-wrapper convertible  | ||||
|     to <code>'T&'</code> whose wrapped object (data member of type <code>T</code>)  | ||||
|     is <a href="#valueinit">value-initialized</a> upon default-initialization  | ||||
|     of this wrapper class: </p> | ||||
|                     | ||||
| <pre>int zero = 0 ;<br>value_initialized<int> x ;<br>assert ( x == zero ) ;<br><br>std::string def ;<br>value_initialized< std::string > y ;<br>assert ( y == def ) ;<br></pre> | ||||
|                      | ||||
| <p>The purpose of this wrapper is to provide a consistent syntax for value | ||||
|      initialization of scalar, union and class types (POD and non-POD) since | ||||
|    the  correct syntax for value initialization varies (see <a | ||||
|  href="#valueinitsyn">value-initialization syntax</a>)</p> | ||||
|                     | ||||
| <p>The wrapped object can be accessed either through the conversion operator | ||||
|      <code>T&</code>, the member function <code>data()</code>, or the | ||||
| non-member    function <code>get()</code>:  </p> | ||||
|                     | ||||
| <pre>void watch(int);<br>value_initialized<int> x;<br><br>watch(x) ; // operator T& used.<br>watch(x.data());<br>watch( get(x) ) // function get() used</pre> | ||||
|                      | ||||
| <p>Both <code>const</code> and non-<code>const</code> objects can be wrapped.  | ||||
|     Mutable objects can be modified directly from within the wrapper but constant | ||||
|     objects cannot:</p> | ||||
|                     | ||||
| <pre>value_initialized<int> x ; <br>static_cast<int&>(x) = 1 ; // OK<br>get(x) = 1 ; // OK<br><br>value_initialized<int const> y ; <br>static_cast<int&>(y) = 1 ; // ERROR: cannot cast to int&<br>static_cast<int const&>(y) = 1 ; // ERROR: cannot modify a const value<br>get(y) = 1 ; // ERROR: cannot modify a const value</pre> | ||||
|                      | ||||
| <h3>Warning:</h3> | ||||
|                     | ||||
| <p>Both the conversion operator and the <code>data()</code> member function  | ||||
|     are <code>const</code> in order to allow access to the wrapped object  | ||||
| from    a constant wrapper:</p> | ||||
|                     | ||||
| <pre>void foo(int);<br>value_initialized<int> const x ;<br>foo(x);<br></pre> | ||||
|                      | ||||
| <p>But notice that this conversion operator is to <code>T&</code> although  | ||||
|     it is itself <code>const</code>. As a consequence, if <code>T</code> is | ||||
|   a  non-<code>const</code> type, you can modify the wrapped object even from | ||||
|    within a constant wrapper:</p> | ||||
|                     | ||||
| <pre>value_initialized<int> const x_c ;<br>int& xr = x_c ; // OK, conversion to int& available even though x_c is itself const.<br>xr = 2 ; </pre> | ||||
|                      | ||||
| <p>The reason for this obscure behavior is that some commonly used compilers | ||||
|      just don't accept the following valid code:</p> | ||||
|                     | ||||
| <pre>struct X<br>{<br>  operator int&() ;<br>  operator int const&() const ;   <br>};<br>X x ;<br>(x == 1 ) ; // ERROR HERE!</pre> | ||||
|                      | ||||
| <p>These compilers complain about ambiguity between the conversion operators.  | ||||
|     This complaint is incorrect, but the only workaround that I know of is  | ||||
|  to   provide only one of them, which leads to the obscure behavior just explained.<br> | ||||
|           </p> | ||||
|                     | ||||
| <h3>Recommended practice: The non-member get() idiom</h3> | ||||
|                     | ||||
| <p>The obscure behavior of being able to modify a non-<code>const</code> | ||||
| wrapped object from within a constant wrapper can be avoided if access to | ||||
| the wrapped object is always performed with the <code>get()</code> idiom:</p> | ||||
|                     | ||||
| <pre>value_initialized<int> x ;<br>get(x) = 1 ; // OK<br><br>value_initialized<int const> cx ;<br>get(x) = 1 ; // ERROR: Cannot modify a const object<br><br>value_initialized<int> const x_c ;<br>get(x_c) = 1 ; // ERROR: Cannot modify a const object<br><br>value_initialized<int const> const cx_c ;<br>get(cx_c) = 1 ; // ERROR: Cannot modify a const object<br></pre> | ||||
|                      | ||||
| <h3><a name="references">References</a></h3> | ||||
|           [1] The C++ Standard, ISO/IEC 14882:98 <br> | ||||
|           [2] Plain Old Data            | ||||
| <h3><a name="acknowledgements"></a>Acknowledgements</h3> | ||||
|      value_initialized was developed by Fernando Cacciola, with help and | ||||
| suggestions from David Abrahams and Darin Adler.<br> | ||||
| Special thanks to Bj<42>rn Karlsson who carefully edited and completed this documentation. | ||||
| <pre> </pre> | ||||
|                      | ||||
| <hr>           | ||||
| <p>Revised 19 September 2002</p> | ||||
|                     | ||||
| <p>© Copyright boost.org 2002. Permission to copy, use, modify, sell  | ||||
| and distribute this document is granted provided this copyright notice  appears  | ||||
| in all copies. This document is provided "as is" without express or implied  | ||||
| warranty, and with no claim as to its suitability for any purpose.</p> | ||||
|                     | ||||
| <p>Developed by <a href="mailto:fernando_cacciola@hotmail.com">Fernando Cacciola</a>, | ||||
|      the latest version of this file can be found at <a | ||||
|  href="http://www.boost.org">www.boost.org</a>, and the boost discussion list | ||||
| at <a href="http://www.yahoogroups.com/list/boost">www.yahoogroups.com/list/boost</a>. | ||||
|      </p> | ||||
|  <br> | ||||
|  <br> | ||||
|      | ||||
| </body> | ||||
| </html> | ||||
							
								
								
									
										128
									
								
								value_init_test.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										128
									
								
								value_init_test.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,128 @@ | ||||
| // (C) 2002, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // Test program for "boost/utility/value_init.hpp" | ||||
| // | ||||
| // Initial: 21 Agu 2002 | ||||
|  | ||||
| #include <iostream> | ||||
| #include <string> | ||||
|  | ||||
| #include "boost/utility/value_init.hpp" | ||||
|  | ||||
| #ifdef __BORLANDC__ | ||||
| #pragma hdrstop | ||||
| #endif | ||||
|  | ||||
| #include "boost/test/minimal.hpp" | ||||
|  | ||||
| // | ||||
| // Sample POD type | ||||
| // | ||||
| struct POD | ||||
| { | ||||
|   POD () : c(0), i(0), f(0) {} | ||||
|  | ||||
|   POD ( char c_, int i_, float f_ ) : c(c_), i(i_), f(f_) {} | ||||
|  | ||||
|   friend std::ostream& operator << ( std::ostream& os, POD const& pod ) | ||||
|     { return os << '(' << pod.c << ',' << pod.i << ',' << pod.f << ')' ; } | ||||
|  | ||||
|   friend bool operator == ( POD const& lhs, POD const& rhs ) | ||||
|     { return lhs.f == rhs.f && lhs.c == rhs.c && lhs.i == rhs.i ; } | ||||
|  | ||||
|   float f; | ||||
|   char  c; | ||||
|   int   i; | ||||
| } ; | ||||
|  | ||||
| // | ||||
| // Sample non POD type | ||||
| // | ||||
| struct NonPODBase | ||||
| { | ||||
|   virtual ~NonPODBase() {} | ||||
| } ; | ||||
| struct NonPOD : NonPODBase | ||||
| { | ||||
|   NonPOD () : id() {} | ||||
|   NonPOD ( std::string const& id_) : id(id_) {} | ||||
|  | ||||
|   friend std::ostream& operator << ( std::ostream& os, NonPOD const& npod ) | ||||
|     { return os << '(' << npod.id << ')' ; } | ||||
|  | ||||
|   friend bool operator == ( NonPOD const& lhs, NonPOD const& rhs ) | ||||
|     { return lhs.id == rhs.id ; } | ||||
|  | ||||
|   std::string id ; | ||||
| } ; | ||||
|  | ||||
| // | ||||
| // Sample aggregate POD struct type | ||||
| // | ||||
| struct AggregatePODStruct | ||||
| { | ||||
|   float f; | ||||
|   char  c; | ||||
|   int   i; | ||||
| }; | ||||
|  | ||||
| bool operator == ( AggregatePODStruct const& lhs, AggregatePODStruct const& rhs ) | ||||
| { return lhs.f == rhs.f && lhs.c == rhs.c && lhs.i == rhs.i ; } | ||||
|  | ||||
|  | ||||
| template<class T> | ||||
| void test ( T const& y, T const& z ) | ||||
| { | ||||
|   boost::value_initialized<T> x ; | ||||
|   BOOST_CHECK ( y == x ) ; | ||||
|   BOOST_CHECK ( y == boost::get(x) ) ; | ||||
|   static_cast<T&>(x) = z ; | ||||
|   boost::get(x) = z ; | ||||
|   BOOST_CHECK ( x == z ) ; | ||||
|  | ||||
|   boost::value_initialized<T> const x_c ; | ||||
|   BOOST_CHECK ( y == x_c ) ; | ||||
|   BOOST_CHECK ( y == boost::get(x_c) ) ; | ||||
|   T& x_c_ref = x_c ; | ||||
|   x_c_ref = z ; | ||||
|   BOOST_CHECK ( x_c == z ) ; | ||||
|  | ||||
| #if !BOOST_WORKAROUND(BOOST_MSVC, < 1300) | ||||
|   boost::value_initialized<T const> cx ; | ||||
|   BOOST_CHECK ( y == cx ) ; | ||||
|   BOOST_CHECK ( y == boost::get(cx) ) ; | ||||
|  | ||||
|   boost::value_initialized<T const> const cx_c ; | ||||
|   BOOST_CHECK ( y == cx_c ) ; | ||||
|   BOOST_CHECK ( y == boost::get(cx_c) ) ; | ||||
| #endif | ||||
| } | ||||
|  | ||||
| int test_main(int, char **) | ||||
| { | ||||
|   test( 0,1234 ) ; | ||||
|   test( 0.0,12.34 ) ; | ||||
|   test( POD(0,0,0.0), POD('a',1234,56.78) ) ; | ||||
|   test( NonPOD( std::string() ), NonPOD( std::string("something") ) ) ; | ||||
|  | ||||
|   NonPOD NonPOD_object( std::string("NonPOD_object") ); | ||||
|   test<NonPOD *>( 0, &NonPOD_object ) ; | ||||
|  | ||||
|   AggregatePODStruct zeroInitializedAggregatePODStruct = { 0.0f, '\0', 0 }; | ||||
|   AggregatePODStruct nonZeroInitializedAggregatePODStruct = { 1.25f, 'a', -1 }; | ||||
|   test(zeroInitializedAggregatePODStruct, nonZeroInitializedAggregatePODStruct); | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
|  | ||||
| unsigned int expected_failures = 0; | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
							
								
								
									
										37
									
								
								value_init_test_fail1.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										37
									
								
								value_init_test_fail1.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,37 @@ | ||||
| // (C) 2002, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // Test program for "boost/utility/value_init.hpp" | ||||
| // | ||||
| // Initial: 21 Agu 2002 | ||||
|  | ||||
| #include <iostream> | ||||
| #include <string> | ||||
|  | ||||
| #include "boost/utility/value_init.hpp" | ||||
|  | ||||
| #ifdef __BORLANDC__ | ||||
| #pragma hdrstop | ||||
| #endif | ||||
|  | ||||
| #include "boost/test/minimal.hpp" | ||||
|  | ||||
| int test_main(int, char **) | ||||
| { | ||||
|   boost::value_initialized<int> const x_c ; | ||||
|  | ||||
|   get(x_c) = 1234 ; // this should produce an ERROR | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
|  | ||||
| unsigned int expected_failures = 0; | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
							
								
								
									
										36
									
								
								value_init_test_fail2.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										36
									
								
								value_init_test_fail2.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,36 @@ | ||||
| // (C) 2002, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // Test program for "boost/utility/value_init.hpp" | ||||
| // | ||||
| // Initial: 21 Agu 2002 | ||||
|  | ||||
| #include <iostream> | ||||
| #include <string> | ||||
|  | ||||
| #include "boost/utility/value_init.hpp" | ||||
|  | ||||
| #ifdef __BORLANDC__ | ||||
| #pragma hdrstop | ||||
| #endif | ||||
|  | ||||
| #include "boost/test/minimal.hpp" | ||||
|  | ||||
| int test_main(int, char **) | ||||
| { | ||||
|   boost::value_initialized<int const> cx ; | ||||
|  | ||||
|   get(cx) = 1234 ; // this should produce an ERROR | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
| unsigned int expected_failures = 0; | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
							
								
								
									
										37
									
								
								value_init_test_fail3.cpp
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										37
									
								
								value_init_test_fail3.cpp
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,37 @@ | ||||
| // (C) 2002, Fernando Luis Cacciola Carballal. | ||||
| // | ||||
| // Distributed under the Boost Software License, Version 1.0. (See | ||||
| // accompanying file LICENSE_1_0.txt or copy at | ||||
| // http://www.boost.org/LICENSE_1_0.txt) | ||||
| // | ||||
| // Test program for "boost/utility/value_init.hpp" | ||||
| // | ||||
| // Initial: 21 Agu 2002 | ||||
|  | ||||
| #include <iostream> | ||||
| #include <string> | ||||
|  | ||||
| #include "boost/utility/value_init.hpp" | ||||
|  | ||||
| #ifdef __BORLANDC__ | ||||
| #pragma hdrstop | ||||
| #endif | ||||
|  | ||||
| #include "boost/test/minimal.hpp" | ||||
|  | ||||
| int test_main(int, char **) | ||||
| { | ||||
|   boost::value_initialized<int const> const cx_c ; | ||||
|  | ||||
|   get(cx_c) = 1234 ; // this should produce an ERROR | ||||
|  | ||||
|   return 0; | ||||
| } | ||||
|  | ||||
|  | ||||
| unsigned int expected_failures = 0; | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
|  | ||||
		Reference in New Issue
	
	Block a user