0000: 44 20 32 30 31 39 2d 31 32 2d 30 33 54 31 33 3a D 2019-12-03T13:
0010: 31 32 3a 33 35 2e 34 39 34 0a 4c 20 46 41 51 0a 12:35.494.L FAQ.
0020: 4e 20 74 65 78 74 2f 78 2d 6d 61 72 6b 64 6f 77 N text/x-markdow
0030: 6e 0a 50 20 62 33 39 36 33 65 30 34 36 37 65 61 n.P b3963e0467ea
0040: 38 63 31 62 36 31 38 33 30 33 64 39 65 38 64 37 8c1b618303d9e8d7
0050: 31 65 30 32 34 38 36 65 62 33 66 63 37 38 36 37 1e02486eb3fc7867
0060: 62 30 34 66 39 30 64 32 34 32 31 35 30 31 38 64 b04f90d24215018d
0070: 31 63 39 34 0a 55 20 74 61 6e 67 65 6e 74 0a 57 1c94.U tangent.W
0080: 20 32 30 35 37 39 0a 23 20 46 72 65 71 75 65 6e 20579.# Frequen
0090: 74 6c 79 2d 41 73 6b 65 64 20 51 75 65 73 74 69 tly-Asked Questi
00a0: 6f 6e 73 20 41 62 6f 75 74 20 4d 79 53 51 4c 2b ons About MySQL+
00b0: 2b 0d 0a 0d 0a 23 23 20 57 68 61 74 20 76 65 72 +....## What ver
00c0: 73 69 6f 6e 20 6f 66 20 4d 79 53 51 4c 2b 2b 20 sion of MySQL++
00d0: 73 68 6f 75 6c 64 20 49 20 75 73 65 3f 0d 0a 0d should I use?...
00e0: 0a 49 66 20 79 6f 75 e2 80 99 72 65 20 77 72 69 .If you’re wri
00f0: 74 69 6e 67 20 6e 65 77 20 63 6f 64 65 2c 20 79 ting new code, y
0100: 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 74 68 ou should use th
0110: 65 20 5b 6c 61 74 65 73 74 20 73 74 61 62 6c 65 e [latest stable
0120: 20 76 65 72 73 69 6f 6e 5d 28 2f 23 73 74 61 62 version](/#stab
0130: 6c 65 29 2e 0d 0a 0d 0a 49 66 20 79 6f 75 20 68 le).....If you h
0140: 61 76 65 20 65 78 69 73 74 69 6e 67 20 63 6f 64 ave existing cod
0150: 65 20 63 75 72 72 65 6e 74 6c 79 20 75 73 69 6e e currently usin
0160: 67 20 61 6e 20 6f 6c 64 65 72 20 76 65 72 73 69 g an older versi
0170: 6f 6e 20 6f 66 20 4d 79 53 51 4c 2b 2b 2c 20 79 on of MySQL++, y
0180: 6f 75 20 6d 61 79 20 6e 6f 74 20 77 61 6e 74 20 ou may not want
0190: 74 6f 20 75 70 67 72 61 64 65 20 61 6c 6c 20 74 to upgrade all t
01a0: 68 65 20 77 61 79 20 74 6f 20 74 68 65 20 63 75 he way to the cu
01b0: 72 72 65 6e 74 20 76 65 72 73 69 6f 6e 2c 20 61 rrent version, a
01c0: 74 20 6c 65 61 73 74 20 6e 6f 74 20 69 6e 20 61 t least not in a
01d0: 20 73 69 6e 67 6c 65 20 73 74 65 70 2e 20 59 6f single step. Yo
01e0: 75 20 6d 69 67 68 74 20 77 61 6e 74 20 74 6f 20 u might want to
01f0: 75 70 67 72 61 64 65 20 74 6f 20 61 6e 20 5b 69 upgrade to an [i
0200: 6e 74 65 72 6d 65 64 69 61 74 65 20 76 65 72 73 ntermediate vers
0210: 69 6f 6e 5d 28 2f 23 6f 6c 64 76 65 72 29 20 66 ion](/#oldver) f
0220: 69 72 73 74 2c 20 6a 75 73 74 20 74 6f 20 67 65 irst, just to ge
0230: 74 20 62 75 67 20 66 69 78 65 73 20 61 6e 64 20 t bug fixes and
0240: 6d 61 79 62 65 20 73 6f 6d 65 20 6d 69 6e 6f 72 maybe some minor
0250: 20 66 65 61 74 75 72 65 73 2e 20 54 68 65 6e 20 features. Then
0260: 6f 6e 63 65 20 74 68 61 74 20 73 74 65 70 20 69 once that step i
0270: 73 20 77 6f 72 6b 69 6e 67 20 61 6e 64 20 74 65 s working and te
0280: 73 74 65 64 2c 20 79 6f 75 20 63 61 6e 20 74 68 sted, you can th
0290: 69 6e 6b 20 61 62 6f 75 74 20 6a 75 6d 70 69 6e ink about jumpin
02a0: 67 20 74 6f 20 74 68 65 20 6c 61 74 65 73 74 20 g to the latest
02b0: 73 74 61 62 6c 65 20 76 65 72 73 69 6f 6e 2e 0d stable version..
02c0: 0a 0d 0a 4d 79 53 51 4c 2b 2b 20 75 73 65 73 20 ...MySQL++ uses
02d0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 6d 61 6a the standard maj
02e0: 6f 72 2e 6d 69 6e 6f 72 2e 62 75 67 2d 66 69 78 or.minor.bug-fix
02f0: 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 version number
0300: 73 63 68 65 6d 65 2e 20 41 20 63 68 61 6e 67 65 scheme. A change
0310: 20 69 6e 20 74 68 65 20 6c 69 62 72 61 72 79 e2 in the library
0320: 80 99 73 20 6d 61 6a 6f 72 20 76 65 72 73 69 6f s major versio
0330: 6e 20 6e 75 6d 62 65 72 20 64 65 6e 6f 74 65 73 n number denotes
0340: 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 77 69 changes that wi
0350: 6c 6c 20 61 6c 6d 6f 73 74 20 63 65 72 74 61 69 ll almost certai
0360: 6e 6c 79 20 72 65 71 75 69 72 65 20 73 6f 75 72 nly require sour
0370: 63 65 20 63 6f 64 65 20 63 68 61 6e 67 65 73 20 ce code changes
0380: 69 6e 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 2e in your program.
0390: 20 53 65 65 20 74 68 65 20 e2 80 9c 5b 49 6e 63 See the “[Inc
03a0: 6f 6d 70 61 74 69 62 6c 65 20 4c 69 62 72 61 72 ompatible Librar
03b0: 79 20 43 68 61 6e 67 65 73 5d 28 64 6f 63 2f 68 y Changes](doc/h
03c0: 74 6d 6c 2f 75 73 65 72 6d 61 6e 2f 62 72 65 61 tml/userman/brea
03d0: 6b 61 67 65 73 2e 68 74 6d 6c 29 e2 80 9d 20 63 kages.html)” c
03e0: 68 61 70 74 65 72 20 6f 66 20 74 68 65 20 75 73 hapter of the us
03f0: 65 72 20 6d 61 6e 75 61 6c 20 66 6f 72 20 64 65 er manual for de
0400: 74 61 69 6c 73 2e 20 41 20 63 68 61 6e 67 65 20 tails. A change
0410: 69 6e 20 74 68 65 20 6d 69 6e 6f 72 20 76 65 72 in the minor ver
0420: 73 69 6f 6e 20 6e 75 6d 62 65 72 20 69 6e 64 69 sion number indi
0430: 63 61 74 65 73 20 61 64 64 65 64 20 66 65 61 74 cates added feat
0440: 75 72 65 73 20 74 68 61 74 20 64 6f 6e e2 80 99 ures that don’
0450: 74 20 63 68 61 6e 67 65 20 65 78 69 73 74 69 6e t change existin
0460: 67 20 6c 69 62 72 61 72 79 20 69 6e 74 65 72 66 g library interf
0470: 61 63 65 73 2e 20 49 66 20 79 6f 75 20 64 6f 6e aces. If you don
0480: e2 80 99 74 20 77 61 6e 74 20 74 6f 20 75 73 65 ’t want to use
0490: 20 74 68 6f 73 65 20 66 65 61 74 75 72 65 73 2c those features,
04a0: 20 79 6f 75 20 73 68 6f 75 6c 64 20 62 65 20 61 you should be a
04b0: 62 6c 65 0d 0a 74 6f 20 69 6e 73 74 61 6c 6c 20 ble..to install
04c0: 74 68 65 20 6e 65 77 20 6c 69 62 72 61 72 79 20 the new library
04d0: 77 69 74 68 6f 75 74 20 72 65 62 75 69 6c 64 69 without rebuildi
04e0: 6e 67 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 2e ng your program.
04f0: 20 41 20 63 68 61 6e 67 65 20 69 6e 20 74 68 65 A change in the
0500: 20 62 75 67 2d 66 69 78 20 6e 75 6d 62 65 72 20 bug-fix number
0510: 69 6e 64 69 63 61 74 65 73 20 69 6e 74 65 72 6e indicates intern
0520: 61 6c 20 62 75 67 20 66 69 78 65 73 2c 20 77 68 al bug fixes, wh
0530: 69 63 68 20 64 6f 6e e2 80 99 74 20 61 66 66 65 ich don’t affe
0540: 63 74 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 ct the library i
0550: 6e 74 65 72 66 61 63 65 20 61 74 20 61 6c 6c 2c nterface at all,
0560: 20 73 6f 20 73 75 63 68 20 76 65 72 73 69 6f 6e so such version
0570: 73 20 61 72 65 20 61 6c 77 61 79 73 20 73 61 66 s are always saf
0580: 65 20 74 6f 20 69 6e 73 74 61 6c 6c 2e 0d 0a 0d e to install....
0590: 0a 57 65 20 68 61 76 65 6e e2 80 99 74 20 66 6f .We haven’t fo
05a0: 6c 6c 6f 77 65 64 20 74 68 69 73 20 64 69 73 63 llowed this disc
05b0: 69 70 6c 69 6e 65 20 70 65 72 66 65 63 74 6c 79 ipline perfectly
05c0: 2e 20 54 68 65 20 6c 69 62 72 61 72 79 e2 80 99 . The library’
05d0: 73 20 62 69 6e 61 72 79 20 69 6e 74 65 72 66 61 s binary interfa
05e0: 63 65 20 5b 63 68 61 6e 67 65 64 20 61 20 66 65 ce [changed a fe
05f0: 77 20 74 69 6d 65 73 5d 28 64 6f 63 2f 68 74 6d w times](doc/htm
0600: 6c 2f 75 73 65 72 6d 61 6e 2f 62 72 65 61 6b 61 l/userman/breaka
0610: 67 65 73 2e 68 74 6d 6c 23 61 62 69 2d 31 2e 37 ges.html#abi-1.7
0620: 2e 31 38 29 20 62 65 74 77 65 65 6e 20 74 68 65 .18) between the
0630: 20 65 70 6f 63 68 61 6c 20 31 2e 37 2e 39 20 72 epochal 1.7.9 r
0640: 65 6c 65 61 73 65 20 61 6e 64 20 74 68 65 20 66 elease and the f
0650: 69 6e 61 6c 20 31 2e 2a 78 2a 20 72 65 6c 65 61 inal 1.*x* relea
0660: 73 65 2c 20 31 2e 37 2e 34 30 2e 20 49 66 20 79 se, 1.7.40. If y
0670: 6f 75 72 20 70 72 6f 67 72 61 6d 20 75 73 65 73 our program uses
0680: 20 61 20 76 65 72 73 69 6f 6e 20 69 6e 20 62 65 a version in be
0690: 74 77 65 65 6e 2c 20 62 65 20 70 72 65 70 61 72 tween, be prepar
06a0: 65 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 ed to change the
06b0: 20 63 6f 64 65 20 77 68 65 6e 20 75 70 67 72 61 code when upgra
06c0: 64 69 6e 67 2e 20 54 68 65 20 6c 69 62 72 61 72 ding. The librar
06d0: 79 20 69 6e 74 65 72 66 61 63 65 20 61 6c 73 6f y interface also
06e0: 20 5b 63 68 61 6e 67 65 64 20 61 20 66 65 77 20 [changed a few
06f0: 74 69 6d 65 73 5d 28 64 6f 63 2f 68 74 6d 6c 2f times](doc/html/
0700: 75 73 65 72 6d 61 6e 2f 62 72 65 61 6b 61 67 65 userman/breakage
0710: 73 2e 68 74 6d 6c 23 61 62 69 2d 33 2e 30 2e 30 s.html#abi-3.0.0
0720: 29 20 65 61 72 6c 79 20 69 6e 20 74 68 65 20 33 ) early in the 3
0730: 2e 2a 78 2a 20 73 65 72 69 65 73 20 62 65 66 6f .*x* series befo
0740: 72 65 20 73 65 74 74 6c 69 6e 67 20 64 6f 77 6e re settling down
0750: 2e 0d 0a 0d 0a 0d 0a 23 23 20 57 68 61 74 20 70 .......## What p
0760: 6c 61 74 66 6f 72 6d 73 20 64 6f 65 73 20 69 74 latforms does it
0770: 20 77 6f 72 6b 20 6f 6e 3f 0d 0a 0d 0a 4d 79 53 work on?....MyS
0780: 51 4c 2b 2b 20 73 68 6f 75 6c 64 20 77 6f 72 6b QL++ should work
0790: 20 6f 6e 20 61 6e 79 20 70 6c 61 74 66 6f 72 6d on any platform
07a0: 20 74 68 61 74 20 68 61 73 20 61 20 43 2b 2b 39 that has a C++9
07b0: 38 20 6f 72 20 6e 65 77 65 72 20 63 6f 6d 70 69 8 or newer compi
07c0: 6c 65 72 20 61 6e 64 20 74 68 65 20 4d 79 53 51 ler and the MySQ
07d0: 4c 20 43 20 41 50 49 20 64 65 76 65 6c 6f 70 6d L C API developm
07e0: 65 6e 74 20 66 69 6c 65 73 2e 20 4d 79 53 51 4c ent files. MySQL
07f0: 2b 2b 20 64 6f 65 73 20 75 73 65 20 73 6f 6d 65 ++ does use some
0800: 20 43 39 39 2f 54 52 31 20 66 65 61 74 75 72 65 C99/TR1 feature
0810: 73 20 74 68 61 74 20 64 69 64 6e e2 80 99 74 20 s that didn’t
0820: 6d 61 6b 65 20 69 74 20 69 6e 74 6f 20 43 2b 2b make it into C++
0830: 20 75 6e 74 69 6c 20 43 2b 2b 31 31 20 6f 72 20 until C++11 or
0840: 43 2b 2b 31 34 2c 20 62 75 74 20 74 68 65 73 65 C++14, but these
0850: 20 61 72 65 20 6f 70 74 69 6f 6e 61 6c 2c 20 73 are optional, s
0860: 6f 20 69 74 20 73 74 69 6c 6c 20 77 6f 72 6b 73 o it still works
0870: 20 77 69 74 68 20 43 2b 2b 39 38 20 63 6f 6d 70 with C++98 comp
0880: 69 6c 65 72 73 2e 0d 0a 0d 0a 49 6e 20 70 72 61 ilers.....In pra
0890: 63 74 69 63 65 2c 20 4d 79 53 51 4c 2b 2b 20 77 ctice, MySQL++ w
08a0: 6f 72 6b 73 20 62 65 73 74 20 6f 6e 20 74 68 65 orks best on the
08b0: 20 70 6c 61 74 66 6f 72 6d 73 20 74 68 61 74 20 platforms that
08c0: 67 65 74 20 74 68 65 20 6d 6f 73 74 20 61 74 74 get the most att
08d0: 65 6e 74 69 6f 6e 2e 20 54 68 69 73 20 6d 65 61 ention. This mea
08e0: 6e 73 20 6d 61 73 73 2d 6d 61 72 6b 65 74 20 6f ns mass-market o
08f0: 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 73 perating systems
0900: 20 6f 6e 20 63 6f 6d 6d 6f 6e 20 68 61 72 64 77 on common hardw
0910: 61 72 65 2c 20 61 6e 64 20 74 68 65 20 64 65 66 are, and the def
0920: 61 75 6c 74 20 74 6f 6f 6c 20 63 68 61 69 6e 20 ault tool chain
0930: 66 6f 72 20 74 68 65 20 70 6c 61 74 66 6f 72 6d for the platform
0940: 2e 20 54 68 65 72 65 20 61 72 65 20 46 41 51 20 . There are FAQ
0950: 69 74 65 6d 73 20 66 6f 72 20 6d 6f 73 74 20 63 items for most c
0960: 6f 6d 6d 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 ommon platforms
0970: 62 65 6c 6f 77 3b 20 69 66 20 79 6f 75 72 20 70 below; if your p
0980: 6c 61 74 66 6f 72 6d 20 69 73 6e e2 80 99 74 20 latform isn’t
0990: 61 64 64 72 65 73 73 65 64 20 61 6e 64 20 69 74 addressed and it
09a0: e2 80 99 73 20 6f 75 74 73 69 64 65 20 74 68 65 ’s outside the
09b0: 20 6d 61 69 6e 73 74 72 65 61 6d 20 6f 72 20 69 mainstream or i
09c0: 73 20 6f 6c 64 65 72 20 74 68 61 6e 20 61 62 6f s older than abo
09d0: 75 74 20 32 30 30 33 2c 20 74 68 65 20 63 68 61 ut 2003, the cha
09e0: 6e 63 65 20 6f 66 20 69 74 20 77 6f 72 6b 69 6e nce of it workin
09f0: 67 20 6f 75 74 20 6f 66 20 74 68 65 20 62 6f 78 g out of the box
0a00: 20 61 72 65 20 6c 6f 77 2e 20 57 65 e2 80 99 72 are low. We’r
0a10: 65 20 68 61 70 70 79 20 74 6f 20 64 69 73 63 75 e happy to discu
0a20: 73 73 20 70 6f 72 74 69 6e 67 20 6f 6e 20 74 68 ss porting on th
0a30: 65 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 2c 20 e mailing list,
0a40: 62 75 74 20 62 65 20 70 72 65 70 61 72 65 64 20 but be prepared
0a50: 74 6f 20 64 6f 20 6d 6f 73 74 20 6f 66 20 74 68 to do most of th
0a60: 65 20 77 6f 72 6b 20 79 6f 75 72 73 65 6c 66 3b e work yourself;
0a70: 20 69 66 20 4d 79 53 51 4c 2b 2b 20 68 61 73 6e if MySQL++ hasn
0a80: e2 80 99 74 20 62 65 65 6e 20 70 6f 72 74 65 64 ’t been ported
0a90: 20 74 6f 20 79 6f 75 72 20 73 79 73 74 65 6d 20 to your system
0aa0: 61 6c 72 65 61 64 79 2c 20 74 68 65 72 65 e2 80 already, there
0ab0: 99 73 20 75 73 75 61 6c 6c 79 20 61 20 70 72 65 s usually a pre
0ac0: 74 74 79 20 67 6f 6f 64 20 72 65 61 73 6f 6e 20 tty good reason
0ad0: 77 68 79 20 6e 6f 74 2e 0d 0a 0d 0a 49 66 20 79 why not.....If y
0ae0: 6f 75 20 75 73 65 20 61 20 64 69 66 66 65 72 65 ou use a differe
0af0: 6e 74 20 70 6c 61 74 66 6f 72 6d 20 61 6e 64 20 nt platform and
0b00: 69 74 20 69 73 6e e2 80 99 74 20 6d 65 6e 74 69 it isn’t menti
0b10: 6f 6e 65 64 20 69 6e 20 74 68 65 20 73 75 62 73 oned in the subs
0b20: 65 71 75 65 6e 74 20 46 41 51 20 69 74 65 6d 73 equent FAQ items
0b30: 2c 20 70 72 6f 62 61 62 6c 79 20 6c 69 74 74 6c , probably littl
0b40: 65 20 69 73 20 6b 6e 6f 77 6e 20 61 62 6f 75 74 e is known about
0b50: 20 69 74 2e 20 49 66 20 69 74 20 62 75 69 6c 64 it. If it build
0b60: 73 20 6f 75 74 20 6f 66 20 74 68 65 20 62 6f 78 s out of the box
0b70: 2c 20 77 65 e2 80 99 64 20 61 70 70 72 65 63 69 , we’d appreci
0b80: 61 74 65 20 69 74 20 69 66 20 79 6f 75 e2 80 99 ate it if you’
0b90: 64 20 73 65 6e 64 20 61 20 72 65 70 6f 72 74 20 d send a report
0ba0: 74 6f 20 74 68 65 20 6d 61 69 6c 69 6e 67 20 6c to the mailing l
0bb0: 69 73 74 2e 20 49 66 20 6e 6f 74 2c 20 70 6c 65 ist. If not, ple
0bc0: 61 73 65 20 73 65 6e 64 20 70 61 74 63 68 65 73 ase send patches
0bd0: 20 74 6f 20 66 69 78 20 74 68 69 73 20 74 6f 20 to fix this to
0be0: 74 68 65 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 the mailing list
0bf0: 2e 20 57 65 20 77 69 6c 6c 20 73 75 70 70 6f 72 . We will suppor
0c00: 74 20 61 6e 79 20 70 6c 61 74 66 6f 72 6d 20 74 t any platform t
0c10: 68 61 74 20 67 65 74 73 20 65 6e 6f 75 67 68 20 hat gets enough
0c20: 69 6e 74 65 72 65 73 74 20 66 72 6f 6d 20 74 68 interest from th
0c30: 65 20 75 73 65 72 73 2e 0d 0a 0d 0a 0d 0a 23 23 e users.......##
0c40: 20 57 68 61 74 20 76 65 72 73 69 6f 6e 73 20 6f What versions o
0c50: 66 20 4d 79 53 51 4c 20 64 6f 65 73 20 69 74 20 f MySQL does it
0c60: 77 6f 72 6b 20 77 69 74 68 3f 0d 0a 0d 0a 4d 79 work with?....My
0c70: 53 51 4c 2b 2b 20 77 6f 72 6b 73 20 62 65 73 74 SQL++ works best
0c80: 20 77 69 74 68 20 4d 79 53 51 4c 20 76 65 72 73 with MySQL vers
0c90: 69 6f 6e 20 34 2e 31 20 6f 72 20 68 69 67 68 65 ion 4.1 or highe
0ca0: 72 2c 20 73 69 6d 70 6c 79 20 62 65 63 61 75 73 r, simply becaus
0cb0: 65 20 74 68 69 73 20 69 73 20 74 68 65 20 6f 6c e this is the ol
0cc0: 64 65 73 74 20 76 65 72 73 69 6f 6e 20 74 68 61 dest version tha
0cd0: 74 20 69 74 e2 80 99 73 20 72 65 67 75 6c 61 72 t it’s regular
0ce0: 6c 79 20 74 65 73 74 65 64 20 61 67 61 69 6e 73 ly tested agains
0cf0: 74 20 64 75 72 69 6e 67 20 64 65 76 65 6c 6f 70 t during develop
0d00: 6d 65 6e 74 2e 0d 0a 0d 0a 57 65 20 64 6f 20 6d ment.....We do m
0d10: 6f 73 74 20 6f 66 20 74 68 65 20 64 65 76 65 6c ost of the devel
0d20: 6f 70 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 4d opment against M
0d30: 79 53 51 4c 20 35 2e 31 20 6f 72 20 6e 65 77 65 ySQL 5.1 or newe
0d40: 72 2c 20 73 69 6e 63 65 20 77 65 20 64 6f 6e e2 r, since we don
0d50: 80 99 74 20 75 73 65 20 6f 6c 64 65 72 20 76 65 t use older ve
0d60: 72 73 69 6f 6e 73 20 6f 6e 20 6f 75 72 20 70 72 rsions on our pr
0d70: 6f 64 75 63 74 69 6f 6e 20 6d 61 63 68 69 6e 65 oduction machine
0d80: 73 2e 20 42 65 63 61 75 73 65 20 4d 79 53 51 4c s. Because MySQL
0d90: 2b 2b 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 ++ is intended f
0da0: 6f 72 20 75 73 65 20 69 6e 20 70 72 6f 64 75 63 or use in produc
0db0: 74 69 6f 6e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 tion environment
0dc0: 73 2c 20 77 65 20 61 6c 73 6f 20 64 6f 6e e2 80 s, we also don
0dd0: 99 74 20 74 65 73 74 20 69 74 20 61 67 61 69 6e t test it again
0de0: 73 74 20 62 6c 65 65 64 69 6e 67 2d 65 64 67 65 st bleeding-edge
0df0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 4d 79 53 versions of MyS
0e00: 51 4c 3b 20 74 68 65 20 6e 65 77 65 73 74 20 76 QL; the newest v
0e10: 65 72 73 69 6f 6e 20 77 65 20 74 79 70 69 63 61 ersion we typica
0e20: 6c 6c 79 20 74 65 73 74 20 69 74 20 77 69 74 68 lly test it with
0e30: 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 is the current
0e40: 47 41 20 72 65 6c 65 61 73 65 20 61 74 20 74 68 GA release at th
0e50: 65 20 74 69 6d 65 20 4d 79 53 51 4c 2b 2b 20 77 e time MySQL++ w
0e60: 61 73 20 72 65 6c 65 61 73 65 64 2e 20 57 65 e2 as released. We
0e70: 80 99 72 65 20 6e 6f 74 20 6f 70 70 6f 73 65 64 re not opposed
0e80: 20 74 6f 20 73 75 70 70 6f 72 74 69 6e 67 20 6e to supporting n
0e90: 65 77 65 72 20 76 65 72 73 69 6f 6e 73 2c 20 77 ewer versions, w
0ea0: 65 20 6a 75 73 74 20 64 6f 6e e2 80 99 74 20 62 e just don’t b
0eb0: 75 69 6c 64 20 74 65 73 74 20 65 6e 76 69 72 6f uild test enviro
0ec0: 6e 6d 65 6e 74 73 20 66 6f 72 20 74 68 65 73 65 nments for these
0ed0: 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20 newer versions
0ee0: 69 6e 20 61 64 76 61 6e 63 65 20 6f 66 20 6e 65 in advance of ne
0ef0: 65 64 2e 20 49 66 20 79 6f 75 20 66 69 6e 64 0d ed. If you find.
0f00: 0a 74 68 61 74 20 4d 79 53 51 4c 2b 2b 20 69 73 .that MySQL++ is
0f10: 6e e2 80 99 74 20 62 75 69 6c 64 69 6e 67 20 61 n’t building a
0f20: 67 61 69 6e 73 74 20 61 20 6e 65 77 65 72 20 72 gainst a newer r
0f30: 65 6c 65 61 73 65 20 6f 66 20 4d 79 53 51 4c 2c elease of MySQL,
0f40: 20 61 20 73 68 6f 72 74 20 5b 62 75 67 20 72 65 a short [bug re
0f50: 70 6f 72 74 5d 28 2f 23 62 75 67 72 65 70 6f 72 port](/#bugrepor
0f60: 74 29 20 69 73 20 75 73 75 61 6c 6c 79 20 73 75 t) is usually su
0f70: 66 66 69 63 69 65 6e 74 20 74 6f 20 67 65 74 20 fficient to get
0f80: 69 74 20 66 69 78 65 64 2e 0d 0a 0d 0a 57 69 74 it fixed.....Wit
0f90: 68 20 73 6f 6d 65 20 77 6f 72 6b 2c 20 4d 79 53 h some work, MyS
0fa0: 51 4c 2b 2b 20 6d 61 79 20 62 65 20 6d 6f 64 69 QL++ may be modi
0fb0: 66 69 65 64 20 74 6f 20 77 6f 72 6b 20 6f 6e 20 fied to work on
0fc0: 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f older versions o
0fd0: 66 20 4d 79 53 51 4c 2e 0d 0a 0d 0a 0d 0a 23 23 f MySQL.......##
0fe0: 20 3c 61 20 6e 61 6d 65 3d 22 6d 61 72 69 61 64 <a name="mariad
0ff0: 62 22 3e 3c 2f 61 3e 44 6f 65 73 20 69 74 20 62 b"></a>Does it b
1000: 75 69 6c 64 20 61 67 61 69 6e 73 74 20 5b 4d 61 uild against [Ma
1010: 72 69 61 44 42 5d 28 68 74 74 70 73 3a 2f 2f 6d riaDB](https://m
1020: 61 72 69 61 64 62 2e 6f 72 67 29 3f 0d 0a 0d 0a ariadb.org)?....
1030: 59 65 73 2e 20 54 68 65 20 6c 69 62 72 61 72 79 Yes. The library
1040: 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 is only called
1050: e2 80 9c 4d 79 53 51 4c 2b 2b e2 80 9d 20 62 65 “MySQL++” be
1060: 63 61 75 73 65 20 69 74 20 70 72 65 64 61 74 65 cause it predate
1070: 73 20 4d 61 72 69 61 44 42 2e 0d 0a 0d 0a 0d 0a s MariaDB.......
1080: 23 23 20 3c 61 20 6e 61 6d 65 3d 22 6c 69 63 65 ## <a name="lice
1090: 6e 73 65 22 3e 3c 2f 61 3e 57 68 61 74 20 73 6f nse"></a>What so
10a0: 66 74 77 61 72 65 20 6c 69 63 65 6e 73 65 20 64 ftware license d
10b0: 6f 65 73 20 4d 79 53 51 4c 2b 2b 20 75 73 65 3f oes MySQL++ use?
10c0: 20 49 73 20 69 74 20 66 72 65 65 3f 0d 0a 0d 0a Is it free?....
10d0: 4d 79 53 51 4c 2b 2b 20 69 73 20 66 72 65 65 20 MySQL++ is free
10e0: 73 6f 66 74 77 61 72 65 2c 20 6c 69 63 65 6e 73 software, licens
10f0: 65 64 20 75 6e 64 65 72 20 74 68 65 20 5b 47 4e ed under the [GN
1100: 55 20 4c 47 50 4c 5d 28 68 74 74 70 3a 2f 2f 77 U LGPL](http://w
1110: 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 63 65 6e ww.gnu.org/licen
1120: 73 65 73 2f 6c 67 70 6c 2e 68 74 6d 6c 29 2e 0d ses/lgpl.html)..
1130: 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 3d .....## <a name=
1140: 22 77 68 79 6c 67 70 6c 22 3e 3c 2f 61 3e 57 68 "whylgpl"></a>Wh
1150: 61 74 20 64 6f 65 73 20 74 68 65 20 4c 47 50 4c at does the LGPL
1160: 20 6c 69 63 65 6e 73 65 20 6d 65 61 6e 20 74 6f license mean to
1170: 20 6d 65 2c 20 61 73 20 66 61 72 20 61 73 20 4d me, as far as M
1180: 79 53 51 4c 2b 2b 20 67 6f 65 73 3f 0d 0a 0d 0a ySQL++ goes?....
1190: 54 68 65 20 63 6f 6d 6d 6f 6e 20 77 69 73 64 6f The common wisdo
11a0: 6d 20 72 65 67 61 72 64 69 6e 67 20 4c 47 50 4c m regarding LGPL
11b0: e2 80 99 64 20 6c 69 62 72 61 72 69 65 73 20 69 ’d libraries i
11c0: 73 20 74 68 61 74 20 79 6f 75 20 63 61 6e 20 75 s that you can u
11d0: 73 65 20 74 68 65 6d 20 77 69 74 68 20 61 20 70 se them with a p
11e0: 72 6f 67 72 61 6d 20 75 73 69 6e 67 20 61 6c 6d rogram using alm
11f0: 6f 73 74 20 61 6e 79 20 73 6f 66 74 77 61 72 65 ost any software
1200: 20 6c 69 63 65 6e 73 65 20 61 73 20 6c 6f 6e 67 license as long
1210: 20 61 73 20 79 6f 75 e2 80 99 72 65 20 77 69 6c as you’re wil
1220: 6c 69 6e 67 20 74 6f 20 6c 69 6e 6b 20 64 79 6e ling to link dyn
1230: 61 6d 69 63 61 6c 6c 79 2e 20 54 68 69 6e 6b 20 amically. Think
1240: 6f 66 20 74 68 65 20 47 4e 55 20 43 20 6c 69 62 of the GNU C lib
1250: 72 61 72 79 20 28 67 6c 69 62 63 29 20 6f 6e 20 rary (glibc) on
1260: 4c 69 6e 75 78 3a 20 69 74 e2 80 99 73 20 4c 47 Linux: it’s LG
1270: 50 4c e2 80 99 64 20 61 6e 64 20 6c 69 6e 6b 65 PL’d and linke
1280: 64 20 74 6f 20 61 6c 6d 6f 73 74 20 65 76 65 72 d to almost ever
1290: 79 74 68 69 6e 67 20 6f 6e 20 61 20 4c 69 6e 75 ything on a Linu
12a0: 78 20 73 79 73 74 65 6d 2c 20 61 74 20 6c 65 61 x system, at lea
12b0: 73 74 20 69 6e 64 69 72 65 63 74 6c 79 2e 20 49 st indirectly. I
12c0: 66 20 79 6f 75 72 20 70 72 6f 67 72 61 6d e2 80 f your program
12d0: 99 73 20 73 6f 66 74 77 61 72 65 20 6c 69 63 65 s software lice
12e0: 6e 73 65 20 61 6c 6c 6f 77 73 20 64 79 6e 61 6d nse allows dynam
12f0: 69 63 20 6c 69 6e 6b 69 6e 67 20 74 6f 20 67 6c ic linking to gl
1300: 69 62 63 2c 20 69 74 20 73 68 6f 75 6c 64 20 61 ibc, it should a
1310: 6c 6c 6f 77 20 79 6f 75 20 74 6f 20 75 73 65 20 llow you to use
1320: 4d 79 53 51 4c 2b 2b 20 64 79 6e 61 6d 69 63 61 MySQL++ dynamica
1330: 6c 6c 79 2c 20 74 6f 6f 2e 0d 0a 0d 0a 49 66 20 lly, too.....If
1340: 79 6f 75 20 6c 69 6e 6b 20 74 6f 20 4d 79 53 51 you link to MySQ
1350: 4c 2b 2b 20 73 74 61 74 69 63 61 6c 6c 79 2c 20 L++ statically,
1360: 79 6f 75 20 74 72 69 67 67 65 72 20 74 68 65 20 you trigger the
1370: e2 80 9c 76 69 72 61 6c e2 80 9d 20 70 72 6f 76 “viral” prov
1380: 69 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 4c 47 isions of the LG
1390: 50 4c 2e 20 50 72 61 63 74 69 63 61 6c 6c 79 20 PL. Practically
13a0: 73 70 65 61 6b 69 6e 67 2c 20 69 74 20 6d 65 61 speaking, it mea
13b0: 6e 73 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 20 ns your program
13c0: 6d 75 73 74 20 62 65 20 6c 69 63 65 6e 73 65 64 must be licensed
13d0: 20 75 6e 64 65 72 20 74 68 65 20 4c 47 50 4c 20 under the LGPL
13e0: 6f 72 20 73 6f 6d 65 74 68 69 6e 67 20 63 6f 6d or something com
13f0: 70 61 74 69 62 6c 65 20 77 69 74 68 20 69 74 2c patible with it,
1400: 20 73 75 63 68 20 61 73 20 74 68 65 20 47 50 4c such as the GPL
1410: 2e 20 54 68 69 73 20 72 75 6c 65 73 20 6f 75 74 . This rules out
1420: 20 73 74 61 74 69 63 20 6c 69 6e 6b 69 6e 67 20 static linking
1430: 77 68 65 6e 20 79 6f 75 20 77 61 6e 74 20 74 6f when you want to
1440: 20 6b 65 65 70 20 79 6f 75 72 20 73 6f 75 72 63 keep your sourc
1450: 65 20 63 6f 64 65 20 63 6c 6f 73 65 64 2c 20 61 e code closed, a
1460: 6e 64 20 65 76 65 6e 20 72 75 6c 65 73 20 6f 75 nd even rules ou
1470: 74 20 73 74 61 74 69 63 20 6c 69 6e 6b 69 6e 67 t static linking
1480: 20 77 69 74 68 20 73 6f 6d 65 20 6f 70 65 6e 20 with some open
1490: 73 6f 75 72 63 65 20 6c 69 63 65 6e 73 65 73 2c source licenses,
14a0: 20 73 69 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 6f since not all o
14b0: 66 20 74 68 65 6d 20 61 72 65 20 63 6f 6d 70 61 f them are compa
14c0: 74 69 62 6c 65 20 77 69 74 68 20 4c 47 50 4c 20 tible with LGPL
14d0: 61 74 20 74 68 61 74 20 6c 65 76 65 6c 2e 0d 0a at that level...
14e0: 0d 0a 4d 79 53 51 4c 2b 2b e2 80 99 73 20 6c 69 ..MySQL++’s li
14f0: 63 65 6e 73 69 6e 67 20 68 69 73 74 6f 72 79 20 censing history
1500: 69 73 20 74 61 6e 67 6c 65 64 2c 20 77 68 61 74 is tangled, what
1510: 20 77 69 74 68 20 74 68 65 20 6e 75 6d 65 72 6f with the numero
1520: 75 73 20 63 68 61 6e 67 65 73 20 6f 66 20 6d 61 us changes of ma
1530: 69 6e 74 61 69 6e 65 72 73 68 69 70 20 61 6e 64 intainership and
1540: 20 74 68 65 20 6c 61 63 6b 20 6f 66 20 61 20 63 the lack of a c
1550: 6f 70 79 72 69 67 68 74 20 61 73 73 69 67 6e 6d opyright assignm
1560: 65 6e 74 20 73 79 73 74 65 6d 20 66 6f 72 20 74 ent system for t
1570: 68 69 72 64 2d 70 61 72 74 79 20 63 6f 6e 74 72 hird-party contr
1580: 69 62 75 74 69 6f 6e 73 2e 20 54 68 61 74 20 6d ibutions. That m
1590: 65 61 6e 73 20 74 68 65 20 6c 69 63 65 6e 73 65 eans the license
15a0: 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 63 68 61 will not be cha
15b0: 6e 67 69 6e 67 2c 20 65 76 65 72 2e 20 49 74 20 nging, ever. It
15c0: 77 6f 75 6c 64 20 73 69 6d 70 6c 79 20 62 65 20 would simply be
15d0: 69 6d 70 72 61 63 74 69 63 61 6c 20 74 6f 20 63 impractical to c
15e0: 6f 6e 74 61 63 74 20 61 6c 6c 20 6f 66 20 74 68 ontact all of th
15f0: 65 20 70 61 73 74 20 63 6f 6e 74 72 69 62 75 74 e past contribut
1600: 6f 72 73 20 61 6e 64 20 67 65 74 20 74 68 65 6d ors and get them
1610: 20 74 6f 20 61 67 72 65 65 20 6f 6e 20 74 68 65 to agree on the
1620: 20 6c 69 63 65 6e 73 69 6e 67 20 63 68 61 6e 67 licensing chang
1630: 65 73 20 6e 65 65 64 65 64 20 74 6f 20 6d 61 6b es needed to mak
1640: 65 20 74 68 69 73 20 68 61 70 70 65 6e 2e 0d 0a e this happen...
1650: 0d 0a 49 66 20 79 6f 75 20 6e 65 65 64 20 74 6f ..If you need to
1660: 20 6c 69 6e 6b 20 74 6f 20 79 6f 75 72 20 43 2b link to your C+
1670: 2b 20 64 61 74 61 62 61 73 65 20 6c 69 62 72 61 + database libra
1680: 72 79 20 73 74 61 74 69 63 61 6c 6c 79 20 61 6e ry statically an
1690: 64 20 63 61 6e e2 80 99 74 20 75 73 65 20 74 68 d can’t use th
16a0: 65 20 4c 47 50 4c 20 6f 72 20 73 6f 6d 65 74 68 e LGPL or someth
16b0: 69 6e 67 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 ing compatible w
16c0: 69 74 68 20 69 74 20 66 6f 72 20 79 6f 75 72 20 ith it for your
16d0: 70 72 6f 67 72 61 6d 2c 20 79 6f 75 20 6d 69 67 program, you mig
16e0: 68 74 20 63 6f 6e 73 69 64 65 72 20 75 73 69 6e ht consider usin
16f0: 67 20 4d 79 53 51 4c e2 80 99 73 20 43 6f 6e 6e g MySQL’s Conn
1700: 65 63 74 6f 72 2f 43 2b 2b 20 69 6e 73 74 65 61 ector/C++ instea
1710: 64 2e 20 54 68 65 20 66 72 65 65 20 76 65 72 73 d. The free vers
1720: 69 6f 6e 20 69 73 20 47 50 4c e2 80 99 64 2c 20 ion is GPL’d,
1730: 62 75 74 20 74 68 65 79 20 77 69 6c 6c 20 73 65 but they will se
1740: 6c 6c 20 79 6f 75 20 61 20 63 6f 6d 6d 65 72 63 ll you a commerc
1750: 69 61 6c 20 6c 69 63 65 6e 73 65 20 77 68 69 63 ial license whic
1760: 68 20 61 6c 6c 6f 77 73 20 73 74 61 74 69 63 20 h allows static
1770: 6c 69 6e 6b 69 6e 67 2e 0d 0a 0d 0a 0d 0a 23 23 linking.......##
1780: 20 3c 61 20 6e 61 6d 65 3d 22 6d 79 73 71 6c 63 <a name="mysqlc
1790: 6c 69 65 6e 74 67 70 6c 22 3e 3c 2f 61 3e 44 6f lientgpl"></a>Do
17a0: 65 73 6e e2 80 99 74 20 74 68 65 20 4d 79 53 51 esn’t the MySQ
17b0: 4c 20 43 20 41 50 49 20 6c 69 62 72 61 72 79 e2 L C API library
17c0: 80 99 73 20 47 50 4c 20 6c 69 63 65 6e 73 65 20 s GPL license
17d0: 6f 76 65 72 72 69 64 65 20 4d 79 53 51 4c 2b 2b override MySQL++
17e0: e2 80 99 73 20 4c 47 50 4c 20 6c 69 63 65 6e 73 ’s LGPL licens
17f0: 65 3f 0d 0a 0d 0a 54 68 65 20 4d 79 53 51 4c 20 e?....The MySQL
1800: 43 20 41 50 49 20 6c 69 62 72 61 72 79 20 69 73 C API library is
1810: 20 61 76 61 69 6c 61 62 6c 65 20 75 6e 64 65 72 available under
1820: 20 2a 74 77 6f 2a 20 64 69 66 66 65 72 65 6e 74 *two* different
1830: 20 6c 69 63 65 6e 73 65 73 2c 20 6e 6f 74 20 6f licenses, not o
1840: 6e 65 2e 0d 0a 0d 0a 54 68 65 20 64 65 66 61 75 ne.....The defau
1850: 6c 74 20 6c 69 63 65 6e 73 65 20 66 6f 72 20 4d lt license for M
1860: 79 53 51 4c 20 28 69 6e 63 6c 75 64 69 6e 67 20 ySQL (including
1870: 69 74 73 20 43 20 41 50 49 20 6c 69 62 72 61 72 its C API librar
1880: 79 29 20 69 73 20 47 50 4c 20 77 69 74 68 20 74 y) is GPL with t
1890: 68 65 20 46 4f 53 53 20 6c 69 63 65 6e 73 65 20 he FOSS license
18a0: 65 78 63 65 70 74 69 6f 6e 2e 20 54 68 69 73 20 exception. This
18b0: 69 73 20 77 68 61 74 20 79 6f 75 20 67 65 74 20 is what you get
18c0: 69 66 20 79 6f 75 20 67 6f 74 20 4d 79 53 51 4c if you got MySQL
18d0: 20 66 6f 72 20 66 72 65 65 2c 20 73 75 63 68 20 for free, such
18e0: 61 73 20 62 79 20 64 6f 77 6e 6c 6f 61 64 69 6e as by downloadin
18f0: 67 20 69 74 20 66 72 6f 6d 20 60 6d 79 73 71 6c g it from `mysql
1900: 2e 63 6f 6d 60 20 6f 72 20 61 73 20 70 61 72 74 .com` or as part
1910: 20 6f 66 20 79 6f 75 72 20 4c 69 6e 75 78 20 64 of your Linux d
1920: 69 73 74 72 6f 2e 20 54 68 65 20 6c 65 73 73 20 istro. The less
1930: 6c 69 62 65 72 61 6c 20 64 69 73 74 72 69 62 75 liberal distribu
1940: 74 69 6f 6e 20 74 65 72 6d 73 20 6f 66 20 74 68 tion terms of th
1950: 65 20 43 20 41 50 49 20 6c 69 62 72 61 72 79 e2 e C API library
1960: 80 99 73 20 47 50 4c 20 64 6f 20 6f 76 65 72 72 s GPL do overr
1970: 69 64 65 20 74 68 65 20 6c 65 73 73 20 72 65 73 ide the less res
1980: 74 72 69 63 74 69 76 65 20 6f 6e 65 73 20 6f 66 trictive ones of
1990: 20 4d 79 53 51 4c 2b 2b e2 80 99 73 20 4c 47 50 MySQL++’s LGP
19a0: 4c 20 6c 69 63 65 6e 73 65 2e 20 54 68 69 73 20 L license. This
19b0: 6d 61 74 74 65 72 73 20 69 66 20 79 6f 75 20 77 matters if you w
19c0: 61 6e 74 20 74 6f 20 64 69 73 74 72 69 62 75 74 ant to distribut
19d0: 65 20 79 6f 75 72 20 70 72 6f 67 72 61 6d 20 61 e your program a
19e0: 73 20 61 20 62 69 6e 61 72 79 20 6f 6e 6c 79 2c s a binary only,
19f0: 20 6b 65 65 70 69 6e 67 20 74 68 65 20 73 6f 75 keeping the sou
1a00: 72 63 65 20 74 6f 20 79 6f 75 72 73 65 6c 66 2e rce to yourself.
1a10: 0d 0a 0d 0a 49 66 20 79 6f 75 20 6e 65 65 64 20 ....If you need
1a20: 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 64 69 to be able to di
1a30: 73 74 72 69 62 75 74 65 20 63 6c 6f 73 65 64 2d stribute closed-
1a40: 73 6f 75 72 63 65 20 70 72 6f 67 72 61 6d 73 2c source programs,
1a50: 20 4f 72 61 63 6c 65 20 77 69 6c 6c 20 68 61 70 Oracle will hap
1a60: 70 69 6c 79 20 73 65 6c 6c 20 79 6f 75 20 61 20 pily sell you a
1a70: 5b 63 6f 6d 6d 65 72 63 69 61 6c 20 64 69 73 74 [commercial dist
1a80: 72 69 62 75 74 69 6f 6e 0d 0a 6c 69 63 65 6e 73 ribution..licens
1a90: 65 5d 28 68 74 74 70 3a 2f 2f 77 77 77 2e 6d 79 e](http://www.my
1aa0: 73 71 6c 2e 63 6f 6d 2f 61 62 6f 75 74 2f 6c 65 sql.com/about/le
1ab0: 67 61 6c 2f 6c 69 63 65 6e 73 69 6e 67 2f 6f 65 gal/licensing/oe
1ac0: 6d 2f 29 20 66 6f 72 20 74 68 65 69 72 20 43 20 m/) for their C
1ad0: 41 50 49 20 6c 69 62 72 61 72 79 2e 0d 0a 0d 0a API library.....
1ae0: 54 68 69 73 20 69 73 73 75 65 20 72 65 61 6c 6c This issue reall
1af0: 79 20 68 61 73 20 6e 6f 74 68 69 6e 67 20 74 6f y has nothing to
1b00: 20 64 6f 20 77 69 74 68 20 4d 79 53 51 4c 2b 2b do with MySQL++
1b10: 2e 20 54 68 65 20 73 61 6d 65 20 72 65 73 74 72 . The same restr
1b20: 69 63 74 69 6f 6e 20 61 70 70 6c 69 65 73 20 69 iction applies i
1b30: 66 20 79 6f 75 20 77 72 69 74 65 20 79 6f 75 72 f you write your
1b40: 20 70 72 6f 67 72 61 6d 20 64 69 72 65 63 74 6c program directl
1b50: 79 20 61 67 61 69 6e 73 74 20 74 68 65 20 43 20 y against the C
1b60: 41 50 49 20 6c 69 62 72 61 72 79 2e 20 54 68 65 API library. The
1b70: 20 6f 6e 6c 79 20 72 65 61 73 6f 6e 20 49 20 65 only reason I e
1b80: 76 65 6e 20 70 75 74 20 74 68 69 73 20 68 65 72 ven put this her
1b90: 65 20 69 73 20 62 65 63 61 75 73 65 20 70 65 6f e is because peo
1ba0: 70 6c 65 20 6b 65 65 70 20 61 73 6b 69 6e 67 20 ple keep asking
1bb0: 74 68 65 20 71 75 65 73 74 69 6f 6e 2e 20 50 6c the question. Pl
1bc0: 65 61 73 65 20 77 6f 72 6b 20 6f 75 74 20 74 68 ease work out th
1bd0: 65 20 6c 69 63 65 6e 73 69 6e 67 20 77 69 74 68 e licensing with
1be0: 20 4f 72 61 63 6c 65 2e 20 48 61 76 69 6e 67 20 Oracle. Having
1bf0: 73 65 74 74 6c 65 64 20 74 68 61 74 2c 20 74 68 settled that, th
1c00: 65 20 70 72 65 76 69 6f 75 73 20 46 41 51 20 69 e previous FAQ i
1c10: 74 65 6d 20 61 70 70 6c 69 65 73 2e 0d 0a 0d 0a tem applies.....
1c20: 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 3d 22 63 6f ..## <a name="co
1c30: 6e 6e 63 70 70 22 3e 3c 2f 61 3e 48 6f 77 20 64 nncpp"></a>How d
1c40: 6f 65 73 20 4d 79 53 51 4c 2b 2b 20 63 6f 6d 70 oes MySQL++ comp
1c50: 61 72 65 20 74 6f 20 4d 79 53 51 4c e2 80 99 73 are to MySQL’s
1c60: 20 43 6f 6e 6e 65 63 74 6f 72 2f 43 2b 2b 3f 0d Connector/C++?.
1c70: 0a 0d 0a 5b 43 6f 6e 6e 65 63 74 6f 72 2f 43 2b ...[Connector/C+
1c80: 2b 5d 28 68 74 74 70 73 3a 2f 2f 64 65 76 2e 6d +](https://dev.m
1c90: 79 73 71 6c 2e 63 6f 6d 2f 64 6f 77 6e 6c 6f 61 ysql.com/downloa
1ca0: 64 73 2f 63 6f 6e 6e 65 63 74 6f 72 2f 63 70 70 ds/connector/cpp
1cb0: 2f 29 20 69 73 20 61 20 6d 75 63 68 20 79 6f 75 /) is a much you
1cc0: 6e 67 65 72 20 43 2b 2b 20 77 72 61 70 70 65 72 nger C++ wrapper
1cd0: 20 66 6f 72 20 74 68 65 20 4d 79 53 51 4c 20 43 for the MySQL C
1ce0: 20 41 50 49 20 6c 69 62 72 61 72 79 2c 20 66 75 API library, fu
1cf0: 6c 6c 79 20 64 65 76 65 6c 6f 70 65 64 20 75 6e lly developed un
1d00: 64 65 72 20 74 68 65 20 4d 79 53 51 4c 20 63 6f der the MySQL co
1d10: 72 70 6f 72 61 74 65 20 61 65 67 69 73 2e 20 42 rporate aegis. B
1d20: 79 20 63 6f 6e 74 72 61 73 74 2c 20 4d 79 53 51 y contrast, MySQ
1d30: 4c 2b 2b 20 68 61 73 20 61 20 6c 6f 6e 67 2c 20 L++ has a long,
1d40: 63 6f 6d 70 6c 65 78 20 5b 64 65 76 65 6c 6f 70 complex [develop
1d50: 6d 65 6e 74 20 68 69 73 74 6f 72 79 5d 28 64 6f ment history](do
1d60: 63 2f 68 74 6d 6c 2f 75 73 65 72 6d 61 6e 2f 69 c/html/userman/i
1d70: 6e 64 65 78 2e 68 74 6d 6c 23 68 69 73 74 6f 72 ndex.html#histor
1d80: 79 29 2e 20 4d 79 53 51 4c 2b 2b 20 73 74 61 72 y). MySQL++ star
1d90: 74 65 64 20 6f 75 74 20 61 73 20 61 20 74 68 69 ted out as a thi
1da0: 72 64 2d 70 61 72 74 79 20 6c 69 62 72 61 72 79 rd-party library
1db0: 2c 20 77 61 73 20 6d 61 69 6e 74 61 69 6e 65 64 , was maintained
1dc0: 20 61 6e 64 20 65 6e 68 61 6e 63 65 64 20 62 79 and enhanced by
1dd0: 0d 0a 4d 79 53 51 4c 20 66 6f 72 20 73 65 76 65 ..MySQL for seve
1de0: 72 61 6c 20 79 65 61 72 73 2c 20 74 68 65 6e 20 ral years, then
1df0: 67 6f 74 20 73 70 75 6e 20 62 61 63 6b 20 6f 75 got spun back ou
1e00: 74 20 61 67 61 69 6e 2c 20 74 68 69 73 20 74 69 t again, this ti
1e10: 6d 65 20 70 72 6f 62 61 62 6c 79 20 66 6f 72 20 me probably for
1e20: 67 6f 6f 64 2e 20 4d 79 53 51 4c 20 64 6f 65 73 good. MySQL does
1e30: 20 73 74 69 6c 6c 20 68 6f 73 74 20 6f 75 72 20 still host our
1e40: 5b 6d 61 69 6c 69 6e 67 0d 0a 6c 69 73 74 5d 28 [mailing..list](
1e50: 68 74 74 70 3a 2f 2f 6c 69 73 74 73 2e 6d 79 73 http://lists.mys
1e60: 71 6c 2e 63 6f 6d 2f 70 6c 75 73 70 6c 75 73 2f ql.com/plusplus/
1e70: 29 2c 20 66 6f 72 20 77 68 69 63 68 20 77 65 20 ), for which we
1e80: 74 68 61 6e 6b 20 74 68 65 6d 2c 20 62 75 74 20 thank them, but
1e90: 74 68 65 79 20 64 6f 6e e2 80 99 74 20 63 6f 6e they don’t con
1ea0: 74 72 6f 6c 20 74 68 65 20 68 6f 73 74 69 6e 67 trol the hosting
1eb0: 20 6f 72 20 64 65 76 65 6c 6f 70 6d 65 6e 74 20 or development
1ec0: 6f 66 20 4d 79 53 51 4c 2b 2b 20 61 6e 79 20 6d of MySQL++ any m
1ed0: 6f 72 65 2e 0d 0a 0d 0a 4d 79 53 51 4c 20 64 65 ore.....MySQL de
1ee0: 63 69 64 65 64 20 74 6f 20 63 72 65 61 74 65 20 cided to create
1ef0: 61 20 63 6f 6d 70 65 74 69 6e 67 20 6c 69 62 72 a competing libr
1f00: 61 72 79 20 66 6f 72 20 74 77 6f 20 72 65 61 73 ary for two reas
1f10: 6f 6e 73 2e 20 46 69 72 73 74 2c 20 68 61 76 69 ons. First, havi
1f20: 6e 67 20 74 68 65 20 65 6e 74 69 72 65 20 74 68 ng the entire th
1f30: 69 6e 67 20 74 6f 20 74 68 65 6d 73 65 6c 76 65 ing to themselve
1f40: 73 20 6d 65 61 6e 20 74 68 65 79 20 63 61 6e 20 s mean they can
1f50: 64 6f 20 74 68 65 20 73 61 6d 65 20 64 75 61 6c do the same dual
1f60: 2d 6c 69 63 65 6e 73 69 6e 67 20 74 68 69 6e 67 -licensing thing
1f70: 20 74 68 65 79 20 64 6f 20 77 69 74 68 20 74 68 they do with th
1f80: 65 20 43 20 41 50 49 20 6c 69 62 72 61 72 79 2e e C API library.
1f90: 20 53 65 63 6f 6e 64 2c 20 61 66 74 65 72 20 53 Second, after S
1fa0: 75 6e 20 62 6f 75 67 68 74 20 4d 79 53 51 4c 2c un bought MySQL,
1fb0: 20 74 68 65 79 20 77 61 6e 74 65 64 20 74 6f 20 they wanted to
1fc0: 70 75 74 20 4d 79 53 51 4c 20 73 75 70 70 6f 72 put MySQL suppor
1fd0: 74 20 69 6e 74 6f 20 4f 70 65 6e 4f 66 66 69 63 t into OpenOffic
1fe0: 65 2c 20 61 6e 64 20 77 61 6e 74 65 64 20 61 20 e, and wanted a
1ff0: 5b 4a 44 42 43 5d 28 68 74 74 70 3a 2f 2f 65 6e [JDBC](http://en
2000: 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 .wikipedia.org/w
2010: 69 6b 69 2f 4a 64 62 63 29 20 73 74 79 6c 65 20 iki/Jdbc) style
2020: 41 50 49 20 66 6f 72 20 74 68 61 74 20 73 75 70 API for that sup
2030: 70 6f 72 74 2e 0d 0a 0d 0a 42 79 20 63 6f 6e 74 port.....By cont
2040: 72 61 73 74 20 77 69 74 68 20 43 6f 6e 6e 65 63 rast with Connec
2050: 74 6f 72 2f 43 2b 2b e2 80 99 73 20 4a 61 76 61 tor/C++’s Java
2060: 2d 73 74 79 6c 65 20 64 61 74 61 62 61 73 65 20 -style database
2070: 41 50 49 2c 20 4d 79 53 51 4c 2b 2b 20 69 73 20 API, MySQL++ is
2080: 76 65 72 79 20 6d 75 63 68 20 61 20 6e 61 74 69 very much a nati
2090: 76 65 20 43 2b 2b 20 6c 69 62 72 61 72 79 3a 20 ve C++ library:
20a0: 77 65 20 75 73 65 20 53 54 4c 20 61 6e 64 20 6f we use STL and o
20b0: 74 68 65 72 20 53 74 61 6e 64 61 72 64 20 43 2b ther Standard C+
20c0: 2b 20 66 65 61 74 75 72 65 73 20 68 65 61 76 69 + features heavi
20d0: 6c 79 2e 20 49 66 20 79 6f 75 20 61 72 65 20 61 ly. If you are a
20e0: 20 4a 61 76 61 20 64 65 76 65 6c 6f 70 65 72 20 Java developer
20f0: 6f 72 20 73 69 6d 70 6c 79 20 61 64 6d 69 72 65 or simply admire
2100: 20 69 74 73 20 64 61 74 61 62 61 73 65 20 69 6e its database in
2110: 74 65 72 66 61 63 65 20 64 65 73 69 67 6e 2c 20 terface design,
2120: 79 6f 75 20 6d 61 79 20 70 72 65 66 65 72 20 43 you may prefer C
2130: 6f 6e 6e 65 63 74 6f 72 2f 43 2b 2b 2e 0d 0a 0d onnector/C++....
2140: 0a 41 6e 6f 74 68 65 72 20 77 61 79 20 74 6f 20 .Another way to
2150: 6c 6f 6f 6b 20 61 74 20 69 74 20 69 73 20 74 68 look at it is th
2160: 61 74 20 43 6f 6e 6e 65 63 74 6f 72 2f 43 2b 2b at Connector/C++
2170: 20 69 73 20 6e 65 77 20 61 6e 64 20 74 68 65 72 is new and ther
2180: 65 66 6f 72 65 20 70 65 72 68 61 70 73 20 6c 65 efore perhaps le
2190: 73 73 20 63 72 75 66 74 79 2c 20 77 68 69 6c 65 ss crufty, while
21a0: 20 4d 79 53 51 4c 2b 2b 20 69 73 20 6d 61 74 75 MySQL++ is matu
21b0: 72 65 20 61 6e 64 20 66 65 61 74 75 72 65 66 75 re and featurefu
21c0: 6c 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 l.......## <a na
21d0: 6d 65 3d 22 67 63 63 22 3e 3c 61 20 6e 61 6d 65 me="gcc"><a name
21e0: 3d 22 67 63 63 32 22 3e 3c 2f 61 3e 3c 2f 61 3e ="gcc2"></a></a>
21f0: 57 69 6c 6c 20 69 74 20 62 75 69 6c 64 20 75 6e Will it build un
2200: 64 65 72 20 47 43 43 3f 0d 0a 0d 0a 59 65 73 2c der GCC?....Yes,
2210: 20 77 69 74 68 20 47 43 43 20 76 65 72 73 69 6f with GCC versio
2220: 6e 20 33 2e 30 20 61 6e 64 20 75 70 2c 20 65 78 n 3.0 and up, ex
2230: 63 65 70 74 20 6f 6e 20 5b 4d 69 6e 47 57 5d 28 cept on [MinGW](
2240: 23 6d 69 6e 67 77 29 2c 20 77 68 69 63 68 20 72 #mingw), which r
2250: 65 71 75 69 72 65 73 20 33 2e 34 2e 35 20 61 74 equires 3.4.5 at
2260: 20 6d 69 6e 69 6d 75 6d 2e 0d 0a 0d 0a 54 68 65 minimum.....The
2270: 20 6c 61 73 74 20 76 65 72 73 69 6f 6e 20 6f 66 last version of
2280: 20 4d 79 53 51 4c 2b 2b 20 74 68 61 74 20 77 6f MySQL++ that wo
2290: 72 6b 73 20 77 69 74 68 20 47 43 43 20 32 2e 39 rks with GCC 2.9
22a0: 35 2e 2a 78 2a 20 69 73 20 31 2e 37 2e 39 2e 20 5.*x* is 1.7.9.
22b0: 49 74 20 6d 61 79 20 62 65 20 6c 65 73 73 20 70 It may be less p
22c0: 61 69 6e 66 75 6c 20 74 6f 20 70 6f 72 74 20 74 ainful to port t
22d0: 68 65 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 he current versi
22e0: 6f 6e 20 62 61 63 6b 20 74 6f 20 47 43 43 20 32 on back to GCC 2
22f0: 2e 39 35 20 74 68 61 6e 20 74 6f 20 6c 69 76 65 .95 than to live
2300: 20 77 69 74 68 20 74 68 65 20 6c 69 6d 69 74 61 with the limita
2310: 74 69 6f 6e 73 20 61 6e 64 20 62 75 67 73 20 6f tions and bugs o
2320: 66 20 74 68 69 73 20 6f 6c 64 20 76 65 72 73 69 f this old versi
2330: 6f 6e 20 6f 66 20 4d 79 53 51 4c 2b 2b 2e 20 54 on of MySQL++. T
2340: 68 65 20 6d 61 69 6e 20 74 68 69 6e 67 20 62 72 he main thing br
2350: 65 61 6b 69 6e 67 20 74 68 69 73 20 62 61 63 6b eaking this back
2360: 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 6c wards compatibil
2370: 69 74 79 20 61 72 65 20 74 68 65 20 73 74 65 70 ity are the step
2380: 73 20 66 6f 72 77 61 72 64 20 77 65 e2 80 99 76 s forward we’v
2390: 65 20 74 61 6b 65 6e 20 66 6f 72 20 53 74 61 6e e taken for Stan
23a0: 64 61 72 64 20 43 2b 2b 20 63 6f 6d 70 6c 69 61 dard C++ complia
23b0: 6e 63 65 2e 20 49 66 20 79 6f 75 20 77 6f 72 6b nce. If you work
23c0: 20 61 72 6f 75 6e 64 20 6f 72 20 72 65 76 65 72 around or rever
23d0: 74 20 74 68 65 73 65 2c 20 4d 79 53 51 4c 2b 2b t these, MySQL++
23e0: 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 6f 6e 20 should work on
23f0: 47 43 43 20 32 2e 39 35 20 61 67 61 69 6e 2e 0d GCC 2.95 again..
2400: 0a 0d 0a 49 66 20 79 6f 75 e2 80 99 72 65 20 73 ...If you’re s
2410: 74 75 63 6b 20 6f 6e 20 61 6e 79 74 68 69 6e 67 tuck on anything
2420: 20 6f 6c 64 65 72 20 74 68 61 6e 20 47 43 43 20 older than GCC
2430: 32 2e 39 35 2c 20 77 65 20 72 65 63 6f 6d 6d 65 2.95, we recomme
2440: 6e 64 20 74 68 61 74 20 79 6f 75 20 75 73 65 20 nd that you use
2450: 74 68 65 20 4d 79 53 51 4c 20 43 20 41 50 49 20 the MySQL C API
2460: 69 6e 73 74 65 61 64 20 6f 66 20 74 72 79 69 6e instead of tryin
2470: 67 20 74 6f 20 61 72 6d 2d 74 77 69 73 74 20 4d g to arm-twist M
2480: 79 53 51 4c 2b 2b 20 69 6e 74 6f 20 62 75 69 6c ySQL++ into buil
2490: 64 69 6e 67 20 75 6e 64 65 72 20 69 74 2e 0d 0a ding under it...
24a0: 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 3d 22 ....## <a name="
24b0: 6c 69 6e 75 78 22 3e 3c 2f 61 3e 57 69 6c 6c 20 linux"></a>Will
24c0: 69 74 20 62 75 69 6c 64 20 6f 6e 20 4c 69 6e 75 it build on Linu
24d0: 78 3f 0d 0a 0d 0a 59 65 73 3b 20 74 68 69 73 20 x?....Yes; this
24e0: 69 73 20 4d 79 53 51 4c 2b 2b e2 80 99 73 20 70 is MySQL++’s p
24f0: 72 69 6d 61 72 79 20 70 6c 61 74 66 6f 72 6d 2e rimary platform.
2500: 20 53 65 65 20 5b 74 68 65 20 60 52 45 41 44 4d See [the `READM
2510: 45 2d 4c 69 6e 75 78 2e 74 78 74 60 20 66 69 6c E-Linux.txt` fil
2520: 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 e](/doc/trunk/RE
2530: 41 44 4d 45 2d 4c 69 6e 75 78 2e 74 78 74 29 2e ADME-Linux.txt).
2540: 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 ......## <a name
2550: 3d 22 62 73 64 22 20 69 64 3d 22 75 6e 69 78 22 ="bsd" id="unix"
2560: 3e 3c 2f 61 3e 57 69 6c 6c 20 69 74 20 62 75 69 ></a>Will it bui
2570: 6c 64 20 6f 6e 20 74 68 65 20 42 53 44 73 20 6f ld on the BSDs o
2580: 72 20 6f 74 68 65 72 20 e2 80 9c 72 65 61 6c e2 r other “real
2590: 80 9d 20 55 6e 69 63 65 73 3f 0d 0a 0d 0a 59 65 Unices?....Ye
25a0: 73 2e 20 53 65 65 20 5b 74 68 65 20 60 52 45 41 s. See [the `REA
25b0: 44 4d 45 2d 55 6e 69 78 2e 74 78 74 60 20 66 69 DME-Unix.txt` fi
25c0: 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 le](/doc/trunk/R
25d0: 45 41 44 4d 45 2d 55 6e 69 78 2e 74 78 74 29 2e EADME-Unix.txt).
25e0: 0d 0a 0d 0a 54 68 65 20 42 53 44 73 20 62 65 68 ....The BSDs beh
25f0: 61 76 65 20 6d 6f 73 74 6c 79 20 74 68 65 20 73 ave mostly the s
2600: 61 6d 65 20 61 73 20 4c 69 6e 75 78 20 66 6f 72 ame as Linux for
2610: 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 the purposes of
2620: 20 62 75 69 6c 64 69 6e 67 20 4d 79 53 51 4c 2b building MySQL+
2630: 2b 2e 0d 0a 0d 0a 49 66 20 79 6f 75 27 72 65 20 +.....If you're
2640: 62 75 69 6c 64 69 6e 67 20 6f 6e 20 53 6f 6c 61 building on Sola
2650: 72 69 73 2c 20 73 65 65 20 5b 74 68 65 20 60 52 ris, see [the `R
2660: 45 41 44 4d 45 2d 53 6f 6c 61 72 69 73 2e 74 78 EADME-Solaris.tx
2670: 74 60 20 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 t` file](/doc/tr
2680: 75 6e 6b 2f 52 45 41 44 4d 45 2d 53 6f 6c 61 72 unk/README-Solar
2690: 69 73 2e 74 78 74 29 20 66 6f 72 20 73 6f 6d 65 is.txt) for some
26a0: 20 70 6c 61 74 66 6f 72 6d 2d 73 70 65 63 69 66 platform-specif
26b0: 69 63 20 64 65 74 61 69 6c 73 2e 20 57 65 20 68 ic details. We h
26c0: 61 76 65 20 72 65 70 6f 72 74 73 20 6f 66 20 70 ave reports of p
26d0: 65 6f 70 6c 65 20 62 75 69 6c 64 69 6e 67 20 69 eople building i
26e0: 74 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f t successfully o
26f0: 6e 20 76 65 72 73 69 6f 6e 73 20 61 73 20 6f 6c n versions as ol
2700: 64 20 61 73 20 53 6f 6c 61 72 69 73 20 38 2e 20 d as Solaris 8.
2710: 49 74 20 67 65 74 73 20 74 68 65 20 6d 6f 73 74 It gets the most
2720: 20 74 65 73 74 69 6e 67 20 77 69 74 68 20 47 43 testing with GC
2730: 43 2c 20 62 75 74 20 77 65 20 68 61 76 65 20 68 C, but we have h
2740: 65 61 72 64 20 6f 63 63 61 73 69 6f 6e 61 6c 20 eard occasional
2750: 73 75 63 63 65 73 73 20 72 65 70 6f 72 74 73 20 success reports
2760: 66 72 6f 6d 20 70 65 6f 70 6c 65 20 75 73 69 6e from people usin
2770: 67 20 53 75 6e 20 43 43 2e 20 42 65 77 61 72 65 g Sun CC. Beware
2780: 20 74 68 61 74 20 69 6e 20 73 6f 6d 65 20 76 65 that in some ve
2790: 72 73 69 6f 6e 73 20 6f 66 20 53 6f 6c 61 72 69 rsions of Solari
27a0: 73 2c 20 74 68 65 20 e2 80 9c 6d 79 73 71 6c e2 s, the “mysql
27b0: 80 9d 20 70 61 63 6b 61 67 65 20 69 73 20 4d 79 package is My
27c0: 53 51 4c 20 34 2e 30 2c 20 77 68 69 63 68 20 4d SQL 4.0, which M
27d0: 79 53 51 4c 2b 2b 20 6e 6f 20 6c 6f 6e 67 65 72 ySQL++ no longer
27e0: 20 77 6f 72 6b 73 20 31 30 30 25 20 77 69 74 68 works 100% with
27f0: 20 6f 75 74 20 6f 66 20 74 68 65 20 62 6f 78 2e out of the box.
2800: 20 28 53 65 65 20 61 62 6f 76 65 2e 29 20 59 6f (See above.) Yo
2810: 75 20 77 61 6e 74 20 74 68 65 20 e2 80 9c 6d 79 u want the “my
2820: 73 71 6c 35 e2 80 9d 20 70 61 63 6b 61 67 65 20 sql5” package
2830: 69 6e 73 74 65 61 64 2e 0d 0a 0d 0a 0d 0a 23 23 instead.......##
2840: 20 3c 61 20 6e 61 6d 65 3d 22 76 73 74 75 64 69 <a name="vstudi
2850: 6f 22 3e 3c 2f 61 3e 57 69 6c 6c 20 69 74 20 62 o"></a>Will it b
2860: 75 69 6c 64 20 75 6e 64 65 72 20 56 69 73 75 61 uild under Visua
2870: 6c 20 43 2b 2b 3f 0d 0a 0d 0a 59 65 73 2e 20 53 l C++?....Yes. S
2880: 65 65 20 5b 74 68 65 20 60 52 45 41 44 4d 45 2d ee [the `README-
2890: 56 69 73 75 61 6c 2d 43 2b 2b 2e 74 78 74 60 20 Visual-C++.txt`
28a0: 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b file](/doc/trunk
28b0: 2f 52 45 41 44 4d 45 2d 56 69 73 75 61 6c 2d 43 /README-Visual-C
28c0: 25 32 42 25 32 42 2e 74 78 74 29 2e 0d 0a 0d 0a %2B%2B.txt).....
28d0: 4d 79 53 51 4c 2b 2b 20 73 68 69 70 73 20 77 69 MySQL++ ships wi
28e0: 74 68 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 73 th project files
28f0: 20 66 6f 72 20 56 69 73 75 61 6c 20 43 2b 2b 20 for Visual C++
2900: 32 30 30 35 20 61 6e 64 20 32 30 30 38 2e 20 54 2005 and 2008. T
2910: 68 65 20 6c 61 74 74 65 72 20 63 61 6e 20 62 65 he latter can be
2920: 20 63 6f 6e 76 65 72 74 65 64 20 75 73 69 6e 67 converted using
2930: 20 56 69 73 75 61 6c 20 43 2b 2b 20 32 30 31 30 Visual C++ 2010
2940: 20 6f 72 20 6c 61 74 65 72 2c 20 62 75 74 20 6d or later, but m
2950: 61 79 20 72 65 71 75 69 72 65 20 73 6f 6d 65 20 ay require some
2960: 6d 61 6e 75 61 6c 20 61 64 6a 75 73 74 6d 65 6e manual adjustmen
2970: 74 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 t. For example,
2980: 77 68 65 6e 20 56 69 73 75 61 6c 20 43 2b 2b 20 when Visual C++
2990: 32 30 31 33 20 63 6f 6e 76 65 72 74 73 20 74 68 2013 converts th
29a0: 65 20 56 53 32 30 30 38 20 70 72 6f 6a 65 63 74 e VS2008 project
29b0: 20 66 69 6c 65 73 2c 20 69 74 20 63 68 61 6e 67 files, it chang
29c0: 65 73 20 74 68 65 20 64 65 62 75 67 20 62 75 69 es the debug bui
29d0: 6c 64 20 6f 75 74 70 75 74 20 64 69 72 65 63 74 ld output direct
29e0: 6f 72 79 20 66 72 6f 6d 20 60 64 65 62 75 67 60 ory from `debug`
29f0: 20 74 6f 20 60 64 65 62 75 67 5c 78 36 34 60 20 to `debug\x64`
2a00: 62 75 74 20 66 61 69 6c 73 20 74 6f 20 75 70 64 but fails to upd
2a10: 61 74 65 20 74 68 65 20 6c 69 6e 6b 65 72 20 73 ate the linker s
2a20: 65 74 74 69 6e 67 73 20 66 6f 72 20 74 68 65 20 ettings for the
2a30: 65 78 65 63 75 74 61 62 6c 65 73 2e 0d 0a 0d 0a executables.....
2a40: 57 65 e2 80 99 64 20 6c 69 6b 65 20 74 6f 20 73 We’d like to s
2a50: 68 69 70 20 6e 65 77 65 72 20 70 72 6f 6a 65 63 hip newer projec
2a60: 74 20 66 69 6c 65 73 2c 20 62 75 74 20 74 68 65 t files, but the
2a70: 20 5b 74 6f 6f 6c 20 74 68 61 74 20 67 65 6e 65 [tool that gene
2a80: 72 61 74 65 73 20 74 68 65 6d 5d 28 68 74 74 70 rates them](http
2a90: 3a 2f 2f 62 61 6b 65 66 69 6c 65 2e 6f 72 67 2f ://bakefile.org/
2aa0: 29 20 63 61 6e e2 80 99 74 20 64 6f 20 74 68 61 ) can’t do tha
2ab0: 74 20 79 65 74 2e 0d 0a 0d 0a 49 66 20 79 6f 75 t yet.....If you
2ac0: 27 72 65 20 73 74 69 6c 6c 20 6f 6e 20 61 6e 20 're still on an
2ad0: 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 20 6f 66 older version of
2ae0: 20 56 69 73 75 61 6c 20 43 2b 2b 20 74 68 61 6e Visual C++ than
2af0: 20 32 30 30 35 2c 20 77 65 20 73 74 72 6f 6e 67 2005, we strong
2b00: 6c 79 20 75 72 67 65 20 79 6f 75 20 74 6f 20 75 ly urge you to u
2b10: 70 67 72 61 64 65 2e 20 54 68 6f 73 65 20 6f 6c pgrade. Those ol
2b20: 64 20 76 65 72 73 69 6f 6e 73 20 61 72 65 20 73 d versions are s
2b30: 65 72 69 6f 75 73 6c 79 20 64 65 66 69 63 69 65 eriously deficie
2b40: 6e 74 20 69 6e 20 74 65 72 6d 73 20 6f 66 20 53 nt in terms of S
2b50: 74 61 6e 64 61 72 64 20 43 2b 2b 20 73 75 70 70 tandard C++ supp
2b60: 6f 72 74 2c 20 65 76 65 6e 20 61 74 20 74 68 65 ort, even at the
2b70: 20 72 61 74 68 65 72 20 6d 6f 64 65 73 74 20 6c rather modest l
2b80: 65 76 65 6c 20 72 65 71 75 69 72 65 64 20 62 79 evel required by
2b90: 20 4d 79 53 51 4c 2b 2b 2e 0d 0a 0d 0a 55 6e 64 MySQL++.....Und
2ba0: 65 72 20 53 61 74 79 61 20 4e 61 64 65 6c 6c 61 er Satya Nadella
2bb0: 2c 20 4d 69 63 72 6f 73 6f 66 74 20 68 61 73 20 , Microsoft has
2bc0: 61 70 70 61 72 65 6e 74 6c 79 20 66 69 6e 61 6c apparently final
2bd0: 6c 79 20 67 69 76 65 6e 20 75 70 20 6f 6e 20 74 ly given up on t
2be0: 72 79 69 6e 67 20 74 6f 20 61 72 6d 2d 74 77 69 rying to arm-twi
2bf0: 73 74 20 64 65 76 65 6c 6f 70 65 72 73 20 69 6e st developers in
2c00: 74 6f 20 62 75 79 69 6e 67 20 70 72 65 6d 69 75 to buying premiu
2c10: 6d 20 74 6f 6f 6c 73 20 74 6f 20 73 75 70 70 6f m tools to suppo
2c20: 72 74 20 74 68 65 69 72 20 70 6c 61 74 66 6f 72 rt their platfor
2c30: 6d 2c 20 65 76 69 64 65 6e 63 65 64 20 62 79 20 m, evidenced by
2c40: 74 68 65 20 66 61 63 74 20 74 68 61 74 20 5b 56 the fact that [V
2c50: 69 73 75 61 6c 20 53 74 75 64 69 6f 0d 0a 43 6f isual Studio..Co
2c60: 6d 6d 75 6e 69 74 79 5d 28 68 74 74 70 73 3a 2f mmunity](https:/
2c70: 2f 77 77 77 2e 76 69 73 75 61 6c 73 74 75 64 69 /www.visualstudi
2c80: 6f 2e 63 6f 6d 2f 76 73 2f 63 6f 6d 6d 75 6e 69 o.com/vs/communi
2c90: 74 79 2f 29 20 6e 6f 77 20 63 6f 6e 74 61 69 6e ty/) now contain
2ca0: 73 20 61 6c 6c 20 74 68 65 20 66 65 61 74 75 72 s all the featur
2cb0: 65 73 20 79 6f 75 20 75 73 65 64 20 74 6f 20 68 es you used to h
2cc0: 61 76 65 20 74 6f 20 70 61 79 20 74 6f 20 67 65 ave to pay to ge
2cd0: 74 20 69 6e 20 56 69 73 75 61 6c 20 43 2b 2b 20 t in Visual C++
2ce0: 50 72 6f 66 65 73 73 69 6f 6e 61 6c 2e 20 54 68 Professional. Th
2cf0: 69 73 20 43 6f 6d 6d 75 6e 69 74 79 20 65 64 69 is Community edi
2d00: 74 69 6f 6e 20 69 73 20 70 65 72 66 65 63 74 6c tion is perfectl
2d10: 79 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20 75 y suitable for u
2d20: 73 65 20 69 6e 20 62 75 69 6c 64 69 6e 67 20 4d se in building M
2d30: 79 53 51 4c 2b 2b 20 61 6e 64 20 70 72 6f 67 72 ySQL++ and progr
2d40: 61 6d 73 20 6c 69 6e 6b 65 64 20 74 6f 20 69 74 ams linked to it
2d50: 2e 20 49 6e 64 65 65 64 2c 20 74 68 69 73 20 69 . Indeed, this i
2d60: 73 20 74 68 65 20 6f 6e 6c 79 20 76 65 72 73 69 s the only versi
2d70: 6f 6e 20 74 68 65 20 4d 79 53 51 4c 2b 2b 20 6d on the MySQL++ m
2d80: 61 69 6e 74 61 69 6e 65 72 20 74 65 73 74 73 20 aintainer tests
2d90: 74 68 65 20 6c 69 62 72 61 72 79 20 61 67 61 69 the library agai
2da0: 6e 73 74 20 72 65 67 75 6c 61 72 6c 79 20 6e 6f nst regularly no
2db0: 77 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 w.......## <a na
2dc0: 6d 65 3d 22 6f 73 78 22 3e 3c 61 20 6e 61 6d 65 me="osx"><a name
2dd0: 3d 22 78 63 6f 64 65 22 3e 3c 2f 61 3e 3c 2f 61 ="xcode"></a></a
2de0: 3e 57 69 6c 6c 20 69 74 20 62 75 69 6c 64 20 6f >Will it build o
2df0: 6e 20 4d 61 63 20 4f 53 20 58 2f 6d 61 63 4f 53 n Mac OS X/macOS
2e00: 3f 0d 0a 0d 0a 59 65 73 2e 20 53 65 65 20 5b 74 ?....Yes. See [t
2e10: 68 65 20 60 52 45 41 44 4d 45 2d 4d 61 63 2d 4f he `README-Mac-O
2e20: 53 2d 58 2e 74 78 74 60 20 66 69 6c 65 5d 28 2f S-X.txt` file](/
2e30: 64 6f 63 2f 74 72 75 6e 6b 2f 52 45 41 44 4d 45 doc/trunk/README
2e40: 2d 4d 61 63 2d 4f 53 2d 58 2e 74 78 74 29 2e 0d -Mac-OS-X.txt)..
2e50: 0a 0d 0a 59 6f 75 20 63 61 6e 20 62 75 69 6c 64 ...You can build
2e60: 20 69 74 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 it on the comma
2e70: 6e 64 20 6c 69 6e 65 20 75 73 69 6e 67 20 74 68 nd line using th
2e80: 65 20 74 79 70 69 63 61 6c 20 55 6e 69 78 20 62 e typical Unix b
2e90: 75 69 6c 64 20 6d 65 74 68 6f 64 73 20 28 73 65 uild methods (se
2ea0: 65 20 5b 52 45 41 44 4d 45 2d 55 6e 69 78 2e 74 e [README-Unix.t
2eb0: 78 74 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b 2f 52 xt](/doc/trunk/R
2ec0: 45 41 44 4d 45 2d 55 6e 69 78 2e 74 78 74 29 29 EADME-Unix.txt))
2ed0: 20 6f 72 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 or from within
2ee0: 58 63 6f 64 65 20 75 73 69 6e 67 20 74 68 65 20 Xcode using the
2ef0: 69 6e 63 6c 75 64 65 64 20 58 63 6f 64 65 20 70 included Xcode p
2f00: 72 6f 6a 65 63 74 20 66 69 6c 65 73 2e 0d 0a 0d roject files....
2f10: 0a 43 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 62 75 .Command line bu
2f20: 69 6c 64 73 20 61 72 65 20 74 65 73 74 65 64 20 ilds are tested
2f30: 6d 6f 72 65 20 6f 66 74 65 6e 20 74 68 61 6e 20 more often than
2f40: 58 63 6f 64 65 20 62 75 69 6c 64 73 2e 20 57 65 Xcode builds. We
2f50: 27 76 65 20 73 75 63 63 65 73 73 66 75 6c 6c 79 've successfully
2f60: 20 62 75 69 6c 74 20 69 74 20 6f 6e 20 65 76 65 built it on eve
2f70: 72 79 20 6d 61 6a 6f 72 20 72 65 6c 65 61 73 65 ry major release
2f80: 20 6f 66 20 4d 61 63 20 4f 53 20 58 20 67 6f 69 of Mac OS X goi
2f90: 6e 67 20 62 61 63 6b 20 74 6f 20 31 30 2e 33 2c ng back to 10.3,
2fa0: 20 61 6e 64 20 73 74 69 6c 6c 20 6f 63 63 61 73 and still occas
2fb0: 69 6f 6e 61 6c 6c 79 20 74 65 73 74 20 69 74 20 ionally test it
2fc0: 6f 6e 20 74 68 65 20 6c 61 74 65 73 74 20 72 65 on the latest re
2fd0: 6c 65 61 73 65 20 6f 66 20 6d 61 63 4f 53 20 74 lease of macOS t
2fe0: 68 69 73 20 77 61 79 2e 0d 0a 0d 0a 59 6f 75 20 his way.....You
2ff0: 63 61 6e 20 62 75 69 6c 64 20 4d 79 53 51 4c 2b can build MySQL+
3000: 2b 20 6f 6e 20 6d 61 63 4f 53 20 61 67 61 69 6e + on macOS again
3010: 73 74 20 65 69 74 68 65 72 20 5b 43 6f 6e 6e 65 st either [Conne
3020: 63 74 6f 72 2f 43 5d 28 68 74 74 70 73 3a 2f 2f ctor/C](https://
3030: 64 65 76 2e 6d 79 73 71 6c 2e 63 6f 6d 2f 64 6f dev.mysql.com/do
3040: 77 6e 6c 6f 61 64 73 2f 63 6f 6e 6e 65 63 74 6f wnloads/connecto
3050: 72 2f 63 2f 29 20 6f 72 20 61 67 61 69 6e 73 74 r/c/) or against
3060: 20 72 65 6c 61 74 65 64 20 6c 69 62 72 61 72 69 related librari
3070: 65 73 20 6c 69 6b 65 20 74 68 65 20 60 6c 69 62 es like the `lib
3080: 6d 79 73 71 6c 63 6c 69 65 6e 74 60 20 79 6f 75 mysqlclient` you
3090: 20 63 61 6e 20 67 65 74 20 77 69 74 68 20 74 68 can get with th
30a0: 65 20 5b 48 6f 6d 65 62 72 65 77 5d 28 68 74 74 e [Homebrew](htt
30b0: 70 73 3a 2f 2f 62 72 65 77 2e 73 68 2f 29 20 60 ps://brew.sh/) `
30c0: 6d 61 72 69 61 64 62 60 20 70 61 63 6b 61 67 65 mariadb` package
30d0: 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d .......## <a nam
30e0: 65 3d 22 63 79 67 77 69 6e 22 3e 3c 2f 61 3e 57 e="cygwin"></a>W
30f0: 69 6c 6c 20 69 74 20 62 75 69 6c 64 20 75 6e 64 ill it build und
3100: 65 72 20 43 79 67 77 69 6e 3f 0d 0a 0d 0a 59 65 er Cygwin?....Ye
3110: 73 2e 20 53 65 65 20 5b 74 68 65 20 60 52 45 41 s. See [the `REA
3120: 44 4d 45 2d 43 79 67 77 69 6e 2e 74 78 74 60 20 DME-Cygwin.txt`
3130: 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b file](/doc/trunk
3140: 2f 52 45 41 44 4d 45 2d 43 79 67 77 69 6e 2e 74 /README-Cygwin.t
3150: 78 74 29 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 xt).......## <a
3160: 6e 61 6d 65 3d 22 6d 69 6e 67 77 22 3e 3c 2f 61 name="mingw"></a
3170: 3e 57 69 6c 6c 20 69 74 20 62 75 69 6c 64 20 75 >Will it build u
3180: 6e 64 65 72 20 4d 69 6e 47 57 3f 0d 0a 0d 0a 59 nder MinGW?....Y
3190: 65 73 2e 20 53 65 65 20 5b 74 68 65 20 60 52 45 es. See [the `RE
31a0: 41 44 4d 45 2d 4d 69 6e 47 57 2e 74 78 74 60 20 ADME-MinGW.txt`
31b0: 66 69 6c 65 5d 28 2f 64 6f 63 2f 74 72 75 6e 6b file](/doc/trunk
31c0: 2f 52 45 41 44 4d 45 2d 4d 69 6e 47 57 2e 74 78 /README-MinGW.tx
31d0: 74 29 2e 0d 0a 0d 0a 4f 63 63 61 73 69 6f 6e 61 t).....Occasiona
31e0: 6c 6c 79 20 61 20 76 65 72 73 69 6f 6e 20 6f 66 lly a version of
31f0: 20 4d 69 6e 47 57 20 63 6f 6d 65 73 20 6f 75 74 MinGW comes out
3200: 20 74 68 61 74 20 62 72 65 61 6b 73 20 4d 79 53 that breaks MyS
3210: 51 4c 2b 2b 2c 20 62 75 74 20 74 68 65 72 65 20 QL++, but there
3220: 68 61 73 20 61 6c 77 61 79 73 20 62 65 65 6e 20 has always been
3230: 61 20 75 73 61 62 6c 65 20 77 6f 72 6b 61 72 6f a usable workaro
3240: 75 6e 64 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 und.......## <a
3250: 6e 61 6d 65 3d 22 62 6f 72 6c 61 6e 64 22 3e 3c name="borland"><
3260: 2f 61 3e 57 69 6c 6c 20 69 74 20 62 75 69 6c 64 /a>Will it build
3270: 20 75 6e 64 65 72 20 43 2b 2b 42 75 69 6c 64 65 under C++Builde
3280: 72 3f 0d 0a 0d 0a 49 74 20 63 61 6e 20 62 65 20 r?....It can be
3290: 6d 61 64 65 20 74 6f 20 77 6f 72 6b 2c 20 6d 6f made to work, mo
32a0: 73 74 6c 79 2e 0d 0a 0d 0a 54 68 65 20 6c 61 73 stly.....The las
32b0: 74 20 74 69 6d 65 20 69 74 20 77 61 73 20 74 72 t time it was tr
32c0: 69 65 64 2c 20 74 68 65 20 5b 53 70 65 63 69 61 ied, the [Specia
32d0: 6c 69 7a 65 64 20 53 51 4c 20 53 74 72 75 63 74 lized SQL Struct
32e0: 75 72 65 73 5d 28 64 6f 63 2f 68 74 6d 6c 2f 75 ures](doc/html/u
32f0: 73 65 72 6d 61 6e 2f 73 73 71 6c 73 2e 68 74 6d serman/ssqls.htm
3300: 6c 29 20 66 65 61 74 75 72 65 20 64 69 64 6e e2 l) feature didn
3310: 80 99 74 20 77 6f 72 6b 20 72 69 67 68 74 20 6f t work right o
3320: 75 74 20 6f 66 20 74 68 65 20 62 6f 78 20 64 75 ut of the box du
3330: 65 20 74 6f 20 61 20 63 6f 6d 70 69 6c 65 72 20 e to a compiler
3340: 6c 69 6d 69 74 61 74 69 6f 6e 2e 20 41 20 66 75 limitation. A fu
3350: 6c 6c 20 64 69 73 63 75 73 73 69 6f 6e 20 6f 66 ll discussion of
3360: 20 74 68 65 20 70 72 6f 62 6c 65 6d 20 61 6e 64 the problem and
3370: 20 70 6f 73 73 69 62 6c 65 20 77 6f 72 6b 61 72 possible workar
3380: 6f 75 6e 64 73 20 69 73 20 69 6e 20 5b 74 68 69 ounds is in [thi
3390: 73 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 20 6d s mailing list m
33a0: 65 73 73 61 67 65 5d 28 68 74 74 70 3a 2f 2f 6c essage](http://l
33b0: 69 73 74 73 2e 6d 79 73 71 6c 2e 63 6f 6d 2f 70 ists.mysql.com/p
33c0: 6c 75 73 70 6c 75 73 2f 34 33 30 37 29 2e 0d 0a lusplus/4307)...
33d0: 0d 0a 54 68 61 74 20 77 61 73 20 62 61 63 6b 20 ..That was back
33e0: 69 6e 20 74 68 65 20 42 6f 72 6c 61 6e 64 20 64 in the Borland d
33f0: 61 79 73 2c 20 73 6f 20 69 66 20 79 6f 75 e2 80 ays, so if you
3400: 99 76 65 20 76 65 72 69 66 69 65 64 20 66 75 6e ve verified fun
3410: 63 74 69 6f 6e 61 6c 69 74 79 20 75 6e 64 65 72 ctionality under
3420: 20 6f 6e 65 20 6f 66 20 74 68 65 20 6e 65 77 65 one of the newe
3430: 72 20 45 6d 62 61 72 63 61 64 65 72 6f 20 72 65 r Embarcadero re
3440: 6c 65 61 73 65 73 2c 20 77 65 e2 80 99 64 20 61 leases, we’d a
3450: 70 70 72 65 63 69 61 74 65 20 61 20 72 65 70 6f ppreciate a repo
3460: 72 74 20 6f 6e 20 74 68 65 20 6d 61 69 6c 69 6e rt on the mailin
3470: 67 20 6c 69 73 74 2e 0d 0a 0d 0a 0d 0a 23 23 20 g list.......##
3480: 3c 61 20 6e 61 6d 65 3d 22 68 6f 77 6e 6f 74 74 <a name="hownott
3490: 6f 62 75 69 6c 64 22 3e 3c 2f 61 3e 60 67 2b 2b obuild"></a>`g++
34a0: 20 73 69 6d 70 6c 65 31 2e 63 70 70 20 2d 6f 20 simple1.cpp -o
34b0: 73 69 6d 70 6c 65 31 60 3f 0d 0a 0d 0a 4e 6f 21 simple1`?....No!
34c0: 0d 0a 0d 0a 59 6f 75 e2 80 99 72 65 20 70 72 6f ....You’re pro
34d0: 62 61 62 6c 79 20 6d 69 73 73 69 6e 67 20 61 20 bably missing a
34e0: 60 2d 49 60 20 66 6c 61 67 20 66 6f 72 20 74 68 `-I` flag for th
34f0: 65 20 4d 79 53 51 4c 2b 2b 20 68 65 61 64 65 72 e MySQL++ header
3500: 73 2c 20 61 6e 64 20 79 6f 75 e2 80 99 72 65 20 s, and you’re
3510: 63 65 72 74 61 69 6e 6c 79 20 6d 69 73 73 69 6e certainly missin
3520: 67 20 5b 63 6f 72 72 65 63 74 20 6c 69 6e 6b 20 g [correct link
3530: 66 6c 61 67 73 5d 28 23 6c 69 6e 6b 65 72 72 6f flags](#linkerro
3540: 72 73 29 2e 0d 0a 0d 0a 54 68 65 20 75 73 65 72 rs).....The user
3550: 20 6d 61 6e 75 61 6c 20 68 61 73 20 61 20 5b 73 manual has a [s
3560: 65 63 74 69 6f 6e 5d 28 64 6f 63 2f 68 74 6d 6c ection](doc/html
3570: 2f 75 73 65 72 6d 61 6e 2f 69 6e 63 6f 72 70 6f /userman/incorpo
3580: 72 61 74 69 6e 67 2e 68 74 6d 6c 23 69 6e 63 2d rating.html#inc-
3590: 75 6e 69 78 29 20 74 68 61 74 20 64 65 73 63 72 unix) that descr
35a0: 69 62 65 73 20 68 6f 77 20 74 6f 20 62 75 69 6c ibes how to buil
35b0: 64 20 61 20 70 72 6f 67 72 61 6d 20 62 61 73 65 d a program base
35c0: 64 20 6f 6e 20 4d 79 53 51 4c 2b 2b 2e 0d 0a 0d d on MySQL++....
35d0: 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 3d 22 6c ...## <a name="l
35e0: 69 6e 6b 65 72 72 6f 72 73 22 3e 3c 2f 61 3e 49 inkerrors"></a>I
35f0: 74 20 63 6f 6d 70 69 6c 65 73 2c 20 62 75 74 20 t compiles, but
3600: 69 74 20 77 6f 6e e2 80 99 74 20 6c 69 6e 6b 21 it won’t link!
3610: 20 57 68 79 3f 0d 0a 0d 0a 54 6f 20 62 75 69 6c Why?....To buil
3620: 64 20 61 6e 79 20 70 72 6f 67 72 61 6d 20 75 73 d any program us
3630: 69 6e 67 20 4d 79 53 51 4c 2b 2b 2c 20 61 74 20 ing MySQL++, at
3640: 6d 69 6e 69 6d 75 6d 20 79 6f 75 20 6d 75 73 74 minimum you must
3650: 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 4d 79 53 link to the MyS
3660: 51 4c 2b 2b 20 6c 69 62 72 61 72 79 20 61 6e 64 QL++ library and
3670: 20 61 6c 73 6f 20 74 6f 20 74 68 65 20 4d 79 53 also to the MyS
3680: 51 4c 20 43 20 41 50 49 20 6c 69 62 72 61 72 79 QL C API library
3690: 20 74 68 61 74 20 4d 79 53 51 4c 2b 2b 20 69 73 that MySQL++ is
36a0: 20 62 75 69 6c 74 20 75 70 6f 6e 2e 20 54 68 65 built upon. The
36b0: 20 4d 79 53 51 4c 2b 2b 20 6c 69 62 72 61 72 79 MySQL++ library
36c0: 20 69 73 20 60 6c 69 62 6d 79 73 71 6c 70 70 2e is `libmysqlpp.
36d0: 73 6f 60 20 6f 6e 20 55 6e 69 78 79 20 73 79 73 so` on Unixy sys
36e0: 74 65 6d 73 2c 20 61 6e 64 20 60 6d 79 73 71 6c tems, and `mysql
36f0: 70 70 2e 6c 69 62 60 20 6f 6e 20 57 69 6e 64 6f pp.lib` on Windo
3700: 77 73 2e 20 54 68 65 20 4d 79 53 51 4c 20 43 20 ws. The MySQL C
3710: 41 50 49 20 6c 69 62 72 61 72 79 20 69 73 20 65 API library is e
3720: 69 74 68 65 72 20 60 6c 69 62 6d 79 73 71 6c 63 ither `libmysqlc
3730: 6c 69 65 6e 74 7b 5f 72 7d 2e 7b 61 2c 73 6f 7d lient{_r}.{a,so}
3740: 60 20 6f 6e 20 55 6e 69 78 79 20 73 79 73 74 65 ` on Unixy syste
3750: 6d 73 20 61 6e 64 20 60 6c 69 62 6d 79 73 71 6c ms and `libmysql
3760: 2e 6c 69 62 60 20 6f 6e 0d 0a 57 69 6e 64 6f 77 .lib` on..Window
3770: 73 2e 0d 0a 0d 0a 2a 2a 56 69 73 75 61 6c 20 43 s.....**Visual C
3780: 2b 2b 2a 2a 3a 20 41 6e 20 61 64 64 69 74 69 6f ++**: An additio
3790: 6e 61 6c 20 72 65 71 75 69 72 65 6d 65 6e 74 20 nal requirement
37a0: 77 69 74 68 20 56 69 73 75 61 6c 20 43 2b 2b 20 with Visual C++
37b0: 69 73 20 74 68 61 74 20 79 6f 75 20 6d 75 73 74 is that you must
37c0: 20 6c 69 6e 6b 20 74 6f 20 74 68 65 20 73 61 6d link to the sam
37d0: 65 20 43 20 52 75 6e 2d 54 69 6d 65 20 4c 69 62 e C Run-Time Lib
37e0: 72 61 72 79 20 28 52 54 4c 29 20 66 6f 72 20 61 rary (RTL) for a
37f0: 6c 6c 20 6d 6f 64 75 6c 65 73 20 74 68 72 6f 75 ll modules throu
3800: 67 68 6f 75 74 20 79 6f 75 72 20 70 72 6f 6a 65 ghout your proje
3810: 63 74 2e 20 54 68 65 20 56 69 73 75 61 6c 20 43 ct. The Visual C
3820: 2b 2b 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 73 ++ project files
3830: 20 74 68 61 74 20 63 6f 6d 65 20 77 69 74 68 20 that come with
3840: 4d 79 53 51 4c 2b 2b 20 75 73 65 20 74 68 65 20 MySQL++ use the
3850: 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 44 4c multithreaded DL
3860: 4c 20 76 65 72 73 69 6f 6e 20 28 60 2f 4d 44 60 L version (`/MD`
3870: 20 6f 72 20 60 2f 4d 44 64 60 29 20 6f 66 20 74 or `/MDd`) of t
3880: 68 65 20 43 20 52 54 4c 2e 20 49 66 20 79 6f 75 he C RTL. If you
3890: 20 6c 69 6e 6b 20 4d 79 53 51 4c 2b 2b 20 74 6f link MySQL++ to
38a0: 20 61 20 70 72 6f 67 72 61 6d 20 6f 72 20 61 64 a program or ad
38b0: 64 69 74 69 6f 6e 61 6c 20 74 68 69 72 64 20 70 ditional third p
38c0: 61 72 74 79 20 6c 69 62 72 61 72 79 0d 0a 74 68 arty library..th
38d0: 61 74 20 75 73 65 73 20 61 20 64 69 66 66 65 72 at uses a differ
38e0: 65 6e 74 20 52 54 4c 2c 20 79 6f 75 20 77 69 6c ent RTL, you wil
38f0: 6c 20 67 65 74 20 6c 69 6e 6b 20 65 72 72 6f 72 l get link error
3900: 73 2e 20 53 74 75 64 79 20 74 68 65 20 65 78 61 s. Study the exa
3910: 6d 70 6c 65 20 70 72 6f 6a 65 63 74 73 e2 80 99 mple projects’
3920: 20 73 65 74 74 69 6e 67 73 20 74 6f 20 73 65 65 settings to see
3930: 20 68 6f 77 20 74 68 69 73 20 69 73 20 64 6f 6e how this is don
3940: 65 2e 20 54 68 65 20 69 6e 73 74 72 75 63 74 69 e. The instructi
3950: 6f 6e 73 20 69 6e 20 74 68 65 20 60 52 45 41 44 ons in the `READ
3960: 4d 45 2d 56 69 73 75 61 6c 2d 43 2b 2b 2e 74 78 ME-Visual-C++.tx
3970: 74 60 20 66 69 6c 65 20 6d 61 79 20 61 6c 73 6f t` file may also
3980: 20 62 65 20 68 65 6c 70 66 75 6c 2e 0d 0a 0d 0a be helpful.....
3990: 53 65 65 20 5b 43 68 61 70 74 65 72 20 39 2c 20 See [Chapter 9,
39a0: 55 73 69 6e 67 20 4d 79 53 51 4c 2b 2b 20 69 6e Using MySQL++ in
39b0: 20 59 6f 75 72 20 4f 77 6e 20 50 72 6f 6a 65 63 Your Own Projec
39c0: 74 5d 28 64 6f 63 2f 68 74 6d 6c 2f 75 73 65 72 t](doc/html/user
39d0: 6d 61 6e 2f 69 6e 63 6f 72 70 6f 72 61 74 69 6e man/incorporatin
39e0: 67 2e 68 74 6d 6c 29 20 69 6e 20 74 68 65 20 5b g.html) in the [
39f0: 4d 79 53 51 4c 2b 2b 20 55 73 65 72 20 4d 61 6e MySQL++ User Man
3a00: 75 61 6c 5d 28 64 6f 63 2f 68 74 6d 6c 2f 75 73 ual](doc/html/us
3a10: 65 72 6d 61 6e 2f 29 20 66 6f 72 20 6d 6f 72 65 erman/) for more
3a20: 20 6f 6e 20 74 68 69 73 2e 0d 0a 0d 0a 0d 0a 23 on this.......#
3a30: 23 20 3c 61 20 6e 61 6d 65 3d 22 6d 65 6d 6c 65 # <a name="memle
3a40: 61 6b 22 3e 3c 2f 61 3e 57 68 79 20 69 73 20 6d ak"></a>Why is m
3a50: 79 20 70 72 6f 67 72 61 6d 20 6c 65 61 6b 69 6e y program leakin
3a60: 67 20 6d 65 6d 6f 72 79 3f 0d 0a 0d 0a 54 68 65 g memory?....The
3a70: 20 63 75 72 72 65 6e 74 20 76 65 72 73 69 6f 6e current version
3a80: 20 6f 66 20 4d 79 53 51 4c 2b 2b 20 68 61 73 20 of MySQL++ has
3a90: 6e 6f 20 6b 6e 6f 77 6e 20 6d 65 6d 6f 72 79 20 no known memory
3aa0: 6c 65 61 6b 73 2e 20 49 66 20 79 6f 75 20 66 72 leaks. If you fr
3ab0: 65 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 4d 79 ee all of the My
3ac0: 53 51 4c 2b 2b 20 6f 62 6a 65 63 74 73 20 79 6f SQL++ objects yo
3ad0: 75 20 61 6c 6c 6f 63 61 74 65 2c 20 69 74 20 73 u allocate, it s
3ae0: 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 6c 65 61 hould not be lea
3af0: 6b 69 6e 67 20 6d 65 6d 6f 72 79 2e 0d 0a 0d 0a king memory.....
3b00: 49 66 20 79 6f 75 e2 80 99 72 65 20 67 65 74 74 If you’re gett
3b10: 69 6e 67 20 61 20 72 65 70 6f 72 74 20 66 72 6f ing a report fro
3b20: 6d 20 61 20 6d 65 6d 6f 72 79 20 64 65 62 75 67 m a memory debug
3b30: 67 65 72 20 61 62 6f 75 74 20 61 20 6c 65 61 6b ger about a leak
3b40: 2c 20 6d 6f 73 74 20 6c 69 6b 65 6c 79 20 79 6f , most likely yo
3b50: 75 e2 80 99 72 65 20 73 65 65 69 6e 67 20 6d 65 u’re seeing me
3b60: 6d 6f 72 79 20 74 68 61 74 20 74 68 65 20 4d 79 mory that the My
3b70: 53 51 4c 20 43 20 41 50 49 20 6c 69 62 72 61 72 SQL C API librar
3b80: 79 20 61 6c 6c 6f 63 61 74 65 73 20 66 6f 72 20 y allocates for
3b90: 69 74 73 20 6f 77 6e 20 69 6e 74 65 72 6e 61 6c its own internal
3ba0: 20 70 75 72 70 6f 73 65 73 2e 20 4d 79 53 51 4c purposes. MySQL
3bb0: 2b 2b 20 69 73 20 62 75 69 6c 74 20 61 74 6f 70 ++ is built atop
3bc0: 20 74 68 69 73 20 6c 69 62 72 61 72 79 2c 20 73 this library, s
3bd0: 6f 20 69 74 20 63 61 6e 20 6c 6f 6f 6b 20 6c 69 o it can look li
3be0: 6b 65 20 69 74 e2 80 99 73 20 4d 79 53 51 4c 2b ke it’s MySQL+
3bf0: 2b 20 6c 65 61 6b 69 6e 67 20 74 68 65 20 6d 65 + leaking the me
3c00: 6d 6f 72 79 2e 20 54 68 69 73 20 75 6e 64 65 72 mory. This under
3c10: 6c 79 69 6e 67 20 43 20 6c 69 62 72 61 72 79 20 lying C library
3c20: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 6c automatically al
3c30: 6c 6f 63 61 74 65 73 20 6d 75 6c 74 69 70 6c 65 locates multiple
3c40: 20 62 6c 6f 63 6b 73 20 6f 66 20 6d 65 6d 6f 72 blocks of memor
3c50: 79 20 69 6e 20 77 61 79 73 20 74 68 61 74 20 61 y in ways that a
3c60: 72 65 20 6d 6f 72 65 20 6f 72 20 6c 65 73 73 20 re more or less
3c70: 6f 75 74 73 69 64 65 20 4d 79 53 51 4c 2b 2b e2 outside MySQL++
3c80: 80 99 73 20 63 6f 6e 74 72 6f 6c 2e 20 49 66 20 s control. If
3c90: 79 6f 75 20 66 65 65 6c 20 79 6f 75 20 6d 75 73 you feel you mus
3ca0: 74 20 70 6c 75 67 20 74 68 65 73 65 20 6c 65 61 t plug these lea
3cb0: 6b 73 2c 20 69 74 20 69 73 20 75 70 20 74 6f 20 ks, it is up to
3cc0: 79 6f 75 72 20 63 6f 64 65 20 74 6f 20 63 61 6c your code to cal
3cd0: 6c 20 74 68 65 20 72 65 6c 65 76 61 6e 74 20 43 l the relevant C
3ce0: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 73 2e 0d API functions..
3cf0: 0a 0d 0a 54 68 65 73 65 20 e2 80 9c 6c 65 61 6b ...These “leak
3d00: 73 e2 80 9d 20 61 72 65 20 61 6c 6c 20 68 61 72 s” are all har
3d10: 6d 6c 65 73 73 20 69 6e 20 70 72 61 63 74 69 63 mless in practic
3d20: 65 20 66 6f 72 20 6d 6f 73 74 20 70 72 6f 67 72 e for most progr
3d30: 61 6d 73 2e 20 41 20 74 79 70 69 63 61 6c 20 70 ams. A typical p
3d40: 72 6f 67 72 61 6d 20 75 73 69 6e 67 20 4d 79 53 rogram using MyS
3d50: 51 4c 2b 2b 20 6e 65 65 64 73 20 64 61 74 61 62 QL++ needs datab
3d60: 61 73 65 20 61 63 63 65 73 73 20 66 6f 72 20 69 ase access for i
3d70: 74 73 20 65 6e 74 69 72 65 20 65 66 66 65 63 74 ts entire effect
3d80: 69 76 65 20 72 75 6e 20 74 69 6d 65 2c 20 61 6e ive run time, an
3d90: 64 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 d the size of th
3da0: 65 20 6c 65 61 6b 20 64 6f 65 73 6e e2 80 99 74 e leak doesn’t
3db0: 20 69 6e 63 72 65 61 73 65 20 6f 76 65 72 20 72 increase over r
3dc0: 75 6e 20 74 69 6d 65 20 69 66 20 79 6f 75 20 66 un time if you f
3dd0: 6f 6c 6c 6f 77 20 74 68 65 20 69 6e 73 74 72 75 ollow the instru
3de0: 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 5b 74 ctions in the [t
3df0: 68 72 65 61 64 73 0d 0a 63 68 61 70 74 65 72 5d hreads..chapter]
3e00: 28 64 6f 63 2f 68 74 6d 6c 2f 75 73 65 72 6d 61 (doc/html/userma
3e10: 6e 2f 74 68 72 65 61 64 73 2e 68 74 6d 6c 29 20 n/threads.html)
3e20: 6f 66 20 74 68 65 20 5b 55 73 65 72 20 4d 61 6e of the [User Man
3e30: 75 61 6c 5d 28 64 6f 63 2f 68 74 6d 6c 2f 75 73 ual](doc/html/us
3e40: 65 72 6d 61 6e 2f 29 2e 20 54 68 65 20 4f 53 20 erman/). The OS
3e50: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 66 72 automatically fr
3e60: 65 65 73 20 74 68 69 73 20 6d 65 6d 6f 72 79 20 ees this memory
3e70: 77 68 65 6e 0d 0a 79 6f 75 72 20 70 72 6f 67 72 when..your progr
3e80: 61 6d 20 65 78 69 74 73 2e 0d 0a 0d 0a 54 68 61 am exits.....Tha
3e90: 74 20 73 61 69 64 2c 20 69 74 e2 80 99 73 20 61 t said, it’s a
3ea0: 6e 6e 6f 79 69 6e 67 20 74 6f 20 73 65 65 20 6c nnoying to see l
3eb0: 65 61 6b 20 72 65 70 6f 72 74 73 20 69 6e 20 61 eak reports in a
3ec0: 20 6d 65 6d 6f 72 79 20 64 65 62 75 67 67 65 72 memory debugger
3ed0: 2c 20 70 61 72 74 69 63 75 6c 61 72 6c 79 20 69 , particularly i
3ee0: 66 20 6c 65 61 6b 20 63 68 65 63 6b 69 6e 67 20 f leak checking
3ef0: 69 73 20 61 20 72 65 67 75 6c 61 72 20 70 61 72 is a regular par
3f00: 74 20 6f 66 20 79 6f 75 72 20 62 75 69 6c 64 20 t of your build
3f10: 61 6e 64 20 74 65 73 74 20 70 72 6f 63 65 73 73 and test process
3f20: 2e 20 59 6f 75 20 63 61 6e 20 70 6c 61 63 61 74 . You can placat
3f30: 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 64 65 62 e the memory deb
3f40: 75 67 67 65 72 20 62 79 20 63 61 6c 6c 69 6e 67 ugger by calling
3f50: 20 60 43 6f 6e 6e 65 63 74 69 6f 6e 3a 3a 74 68 `Connection::th
3f60: 72 65 61 64 5f 65 6e 64 28 29 60 20 66 72 6f 6d read_end()` from
3f70: 20 65 61 63 68 20 74 68 72 65 61 64 20 74 68 61 each thread tha
3f80: 74 20 75 73 65 73 20 61 20 64 61 74 61 62 61 73 t uses a databas
3f90: 65 0d 0a 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 68 e..connection wh
3fa0: 65 6e 20 74 68 61 74 20 74 68 72 65 61 64 20 66 en that thread f
3fb0: 69 6e 69 73 68 65 73 20 75 73 69 6e 67 20 74 68 inishes using th
3fc0: 65 20 64 61 74 61 62 61 73 65 2e 20 49 6e 20 61 e database. In a
3fd0: 64 64 69 74 69 6f 6e 2c 20 61 66 74 65 72 20 74 ddition, after t
3fe0: 68 65 20 6c 61 73 74 20 62 69 74 20 6f 66 20 63 he last bit of c
3ff0: 6f 64 65 20 74 68 61 74 20 75 73 65 73 20 4d 79 ode that uses My
4000: 53 51 4c 2b 2b 20 73 74 6f 70 73 2c 20 79 6f 75 SQL++ stops, you
4010: 20 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 74 68 need to call th
4020: 65 20 4d 79 53 51 4c 20 43 20 41 50 49 20 66 75 e MySQL C API fu
4030: 6e 63 74 69 6f 6e 20 60 6d 79 73 71 6c 5f 6c 69 nction `mysql_li
4040: 62 72 61 72 79 5f 65 6e 64 28 29 60 2e 20 49 66 brary_end()`. If
4050: 20 79 6f 75 e2 80 99 72 65 20 75 73 69 6e 67 20 you’re using
4060: 61 20 60 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f a `ConnectionPoo
4070: 6c 60 2c 20 79 6f 75 20 6d 69 67 68 74 20 70 75 l`, you might pu
4080: 74 20 74 68 69 73 20 6c 61 73 74 20 63 61 6c 6c t this last call
4090: 20 69 6e 20 74 68 65 20 64 65 73 74 72 75 63 74 in the destruct
40a0: 6f 72 2c 20 73 69 6e 63 65 20 74 68 65 20 70 6f or, since the po
40b0: 6f 6c 20 6f 62 6a 65 63 74 20 69 73 20 74 79 70 ol object is typ
40c0: 69 63 61 6c 6c 79 20 74 68 65 20 6c 61 73 74 20 ically the last
40d0: 4d 79 53 51 4c 2b 2b 20 6f 62 6a 65 63 74 20 74 MySQL++ object t
40e0: 6f 20 62 65 20 64 65 73 74 72 6f 79 65 64 2e 0d o be destroyed..
40f0: 0a 0d 0a 49 66 20 79 6f 75 e2 80 99 76 65 20 64 ...If you’ve d
4100: 6f 6e 65 20 74 68 61 74 20 61 6e 64 20 73 74 69 one that and sti
4110: 6c 6c 20 74 68 69 6e 6b 20 79 6f 75 20 72 65 61 ll think you rea
4120: 6c 6c 79 20 68 61 76 65 20 61 20 73 65 72 69 6f lly have a serio
4130: 75 73 20 6d 65 6d 6f 72 79 20 6c 65 61 6b 20 e2 us memory leak
4140: 80 94 20 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 one of those
4150: e2 80 9c 74 68 65 20 6c 6f 6e 67 65 72 20 69 74 “the longer it
4160: 20 72 75 6e 73 2c 20 74 68 65 20 6d 6f 72 65 20 runs, the more
4170: 6d 65 6d 6f 72 79 20 69 74 20 75 73 65 73 e2 80 memory it uses
4180: 9d 20 73 6f 72 74 73 20 6f 66 20 6c 65 61 6b 20 sorts of leak
4190: e2 80 94 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 — you need to
41a0: 74 69 65 20 69 74 20 74 6f 20 73 6f 6d 65 20 75 tie it to some u
41b0: 6e 69 74 20 6f 66 20 77 6f 72 6b 2e 20 44 6f 65 nit of work. Doe
41c0: 73 20 6d 65 6d 6f 72 79 20 67 6f 20 75 70 20 61 s memory go up a
41d0: 73 20 61 20 66 75 6e 63 74 69 6f 6e 20 6f 66 20 s a function of
41e0: 74 69 6d 65 3f 20 6e 75 6d 62 65 72 20 6f 66 20 time? number of
41f0: 71 75 65 72 69 65 73 20 69 73 73 75 65 64 3f 20 queries issued?
4200: 63 6f 75 6e 74 20 6f 66 20 72 6f 77 73 20 72 65 count of rows re
4210: 74 72 65 69 76 65 64 3f 20 55 6e 74 69 6c 20 79 treived? Until y
4220: 6f 75 20 63 61 6e 20 65 73 74 61 62 6c 69 73 68 ou can establish
4230: 20 74 68 69 73 20 6c 69 6e 6b 2c 20 69 74 e2 80 this link, it
4240: 99 73 20 70 72 65 6d 61 74 75 72 65 20 74 6f 20 s premature to
4250: 70 6f 73 74 20 74 6f 20 74 68 65 20 4d 79 53 51 post to the MySQ
4260: 4c 2b 2b 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 L++ mailing list
4270: 20 63 6c 61 69 6d 69 6e 67 20 74 68 65 72 65 e2 claiming there
4280: 80 99 73 20 61 20 6c 65 61 6b 20 69 6e 20 4d 79 s a leak in My
4290: 53 51 4c 2b 2b 2e 20 45 76 65 6e 20 69 66 20 79 SQL++. Even if y
42a0: 6f 75 20 63 61 6e 20 65 73 74 61 62 6c 69 73 68 ou can establish
42b0: 20 73 75 63 68 20 61 20 6c 69 6e 6b 2c 20 69 74 such a link, it
42c0: e2 80 99 73 20 66 61 72 20 6d 6f 72 65 20 6c 69 ’s far more li
42d0: 6b 65 6c 79 20 74 68 61 74 20 79 6f 75 e2 80 99 kely that you’
42e0: 72 65 20 6e 6f 74 20 72 65 6c 65 61 73 69 6e 67 re not releasing
42f0: 20 74 68 65 20 4d 79 53 51 4c 2b 2b 20 6f 62 6a the MySQL++ obj
4300: 65 63 74 73 20 79 6f 75 20 61 6c 6c 6f 63 61 74 ects you allocat
4310: 65 20 74 68 61 6e 20 4d 79 53 51 4c 2b 2b 20 69 e than MySQL++ i
4320: 74 73 65 6c 66 20 66 61 69 6c 69 6e 67 20 74 6f tself failing to
4330: 20 72 65 6c 65 61 73 65 20 6d 65 6d 6f 72 79 2e release memory.
4340: 0d 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 ......## <a name
4350: 3d 22 73 65 67 66 61 75 6c 74 73 22 3e 3c 2f 61 ="segfaults"></a
4360: 3e 4d 79 20 70 72 6f 67 72 61 6d 20 69 73 20 63 >My program is c
4370: 72 61 73 68 69 6e 67 2e 20 48 65 6c 70 21 0d 0a rashing. Help!..
4380: 0d 0a 54 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f ..The most commo
4390: 6e 20 63 61 75 73 65 20 6f 66 20 63 72 61 73 68 n cause of crash
43a0: 65 73 20 69 6e 20 4d 79 53 51 4c 2b 2b 20 69 73 es in MySQL++ is
43b0: 20 75 6e 63 61 75 67 68 74 20 65 78 63 65 70 74 uncaught except
43c0: 69 6f 6e 73 2e 20 54 68 65 20 6c 69 62 72 61 72 ions. The librar
43d0: 79 20 74 68 72 6f 77 73 20 65 78 63 65 70 74 69 y throws excepti
43e0: 6f 6e 73 20 77 68 65 6e 20 69 74 20 64 65 74 65 ons when it dete
43f0: 63 74 73 20 65 72 72 6f 72 73 2c 20 73 75 63 68 cts errors, such
4400: 20 61 73 20 69 6e 76 61 6c 69 64 20 53 51 4c 20 as invalid SQL
4410: 73 79 6e 74 61 78 2c 20 69 6e 76 61 6c 69 64 20 syntax, invalid
4420: 6c 6f 67 69 6e 20 70 61 72 61 6d 65 74 65 72 73 login parameters
4430: 2c 20 65 74 63 2e 20 54 72 79 20 72 75 6e 6e 69 , etc. Try runni
4440: 6e 67 20 74 68 65 20 65 78 61 6d 70 6c 65 20 70 ng the example p
4450: 72 6f 67 72 61 6d 73 2c 20 73 69 6e 63 65 20 74 rograms, since t
4460: 68 65 79 20 61 6c 6c 20 63 61 74 63 68 20 65 78 hey all catch ex
4470: 63 65 70 74 69 6f 6e 73 20 70 72 6f 70 65 72 6c ceptions properl
4480: 79 2e 0d 0a 0d 0a 49 66 20 74 68 65 20 65 78 61 y.....If the exa
4490: 6d 70 6c 65 73 20 61 6c 73 6f 20 63 72 61 73 68 mples also crash
44a0: 20 61 6e 64 20 79 6f 75 e2 80 99 72 65 20 75 73 and you’re us
44b0: 69 6e 67 20 61 20 70 61 63 6b 61 67 65 20 62 75 ing a package bu
44c0: 69 6c 74 20 66 6f 72 20 61 20 64 69 66 66 65 72 ilt for a differ
44d0: 65 6e 74 20 4c 69 6e 75 78 20 64 69 73 74 72 69 ent Linux distri
44e0: 62 75 74 69 6f 6e 20 74 68 61 6e 20 74 68 65 20 bution than the
44f0: 6f 6e 65 20 79 6f 75 e2 80 99 72 65 20 61 63 74 one you’re act
4500: 75 61 6c 6c 79 20 72 75 6e 6e 69 6e 67 2c 20 74 ually running, t
4510: 72 79 20 72 65 62 75 69 6c 64 69 6e 67 20 74 68 ry rebuilding th
4520: 65 20 70 61 63 6b 61 67 65 20 66 72 6f 6d 20 5b e package from [
4530: 73 6f 75 72 63 65 5d 28 2f 23 73 6f 75 72 63 65 source](/#source
4540: 29 20 6f 6e 20 74 68 65 20 74 61 72 67 65 74 20 ) on the target
4550: 4f 53 2e 20 41 20 62 69 6e 61 72 79 20 70 61 63 OS. A binary pac
4560: 6b 61 67 65 20 69 73 20 66 61 69 72 6c 79 20 63 kage is fairly c
4570: 6c 6f 73 65 6c 79 20 74 69 65 64 20 74 6f 20 74 losely tied to t
4580: 68 65 20 73 79 73 74 65 6d 20 69 74 20 69 73 20 he system it is
4590: 62 75 69 6c 74 20 75 6e 64 65 72 2c 20 73 6f 20 built under, so
45a0: 69 74 e2 80 99 73 20 70 6f 73 73 69 62 6c 65 20 it’s possible
45b0: 74 68 61 74 20 52 50 4d 73 20 79 6f 75 20 62 75 that RPMs you bu
45c0: 69 6c 64 20 6f 6e 20 79 6f 75 72 20 73 79 73 74 ild on your syst
45d0: 65 6d 20 77 69 6c 6c 20 77 6f 72 6b 20 62 65 74 em will work bet
45e0: 74 65 72 20 74 68 61 6e 20 74 68 6f 73 65 20 62 ter than those b
45f0: 75 69 6c 74 20 65 6c 73 65 77 68 65 72 65 2e 0d uilt elsewhere..
4600: 0a 0d 0a 0d 0a 23 23 20 3c 61 20 6e 61 6d 65 3d .....## <a name=
4610: 22 62 72 6f 6b 65 6e 22 3e 3c 2f 61 3e 4e 6f 74 "broken"></a>Not
4620: 68 69 6e 67 e2 80 99 73 20 77 6f 72 6b 69 6e 67 hing’s working
4630: 20 61 74 20 61 6c 6c 21 20 49 73 20 69 74 20 62 at all! Is it b
4640: 72 6f 6b 65 6e 3f 0d 0a 0d 0a 4d 61 79 62 65 2c roken?....Maybe,
4650: 20 62 75 74 20 68 61 76 65 20 79 6f 75 20 74 72 but have you tr
4660: 69 65 64 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 ied running the
4670: 65 78 61 6d 70 6c 65 73 3f 20 46 6f 6c 6c 6f 77 examples? Follow
4680: 20 74 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e the instruction
4690: 73 20 69 6e 20 74 68 65 20 60 52 45 41 44 4d 45 s in the `README
46a0: 2d 65 78 61 6d 70 6c 65 73 2e 74 78 74 60 20 66 -examples.txt` f
46b0: 69 6c 65 2e 20 49 66 20 74 68 65 20 65 78 61 6d ile. If the exam
46c0: 70 6c 65 73 20 77 6f 72 6b 20 62 75 74 20 79 6f ples work but yo
46d0: 75 72 20 70 72 6f 67 72 61 6d 20 64 6f 65 73 6e ur program doesn
46e0: e2 80 99 74 2c 20 63 68 61 6e 63 65 73 20 61 72 ’t, chances ar
46f0: 65 20 67 6f 6f 64 20 74 68 61 74 20 74 68 65 20 e good that the
4700: 65 72 72 6f 72 20 69 73 20 69 6e 20 79 6f 75 72 error is in your
4710: 20 70 72 6f 67 72 61 6d 3b 20 73 74 75 64 79 20 program; study
4720: 74 68 65 20 65 78 61 6d 70 6c 65 73 2c 20 61 6e the examples, an
4730: 64 20 5b 72 65 61 64 20 74 68 65 20 6d 61 6e 75 d [read the manu
4740: 61 6c 73 5d 28 2f 77 69 6b 69 3f 6e 61 6d 65 3d als](/wiki?name=
4750: 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 29 2e 20 Documentation).
4760: 49 66 20 74 68 65 20 65 78 61 6d 70 6c 65 73 20 If the examples
4770: 61 6c 73 6f 20 66 61 69 6c 20 74 6f 20 77 6f 72 also fail to wor
4780: 6b 2c 20 70 6f 73 74 20 74 6f 20 74 68 65 20 6d k, post to the m
4790: 61 69 6c 69 6e 67 20 6c 69 73 74 20 77 69 74 68 ailing list with
47a0: 20 61 20 64 65 74 61 69 6c 65 64 20 66 61 69 6c a detailed fail
47b0: 75 72 65 20 72 65 70 6f 72 74 2e 0d 0a 0d 0a 0d ure report......
47c0: 0a 23 23 20 3c 61 20 6e 61 6d 65 3d 22 62 75 67 .## <a name="bug
47d0: 72 65 70 6f 72 74 22 3e 3c 2f 61 3e 49 e2 80 99 report"></a>I’
47e0: 6d 20 73 75 72 65 20 49 e2 80 99 76 65 20 66 6f m sure I’ve fo
47f0: 75 6e 64 20 61 20 62 75 67 2e 20 48 6f 77 20 64 und a bug. How d
4800: 6f 20 49 20 73 75 62 6d 69 74 20 61 20 72 65 70 o I submit a rep
4810: 6f 72 74 3f 0d 0a 0d 0a 57 65 e2 80 99 6c 6c 20 ort?....We’ll
4820: 77 61 6e 74 20 73 6f 6d 65 20 63 6f 64 65 20 74 want some code t
4830: 68 61 74 20 64 65 6d 6f 6e 73 74 72 61 74 65 73 hat demonstrates
4840: 20 74 68 65 20 62 75 67 2e 20 4e 6f 20 64 6f 75 the bug. No dou
4850: 62 74 20 79 6f 75 e2 80 99 64 20 72 61 74 68 65 bt you’d rathe
4860: 72 20 6e 6f 74 20 73 65 6e 64 20 75 73 20 61 20 r not send us a
4870: 63 6f 70 79 20 6f 66 20 79 6f 75 72 20 64 61 74 copy of your dat
4880: 61 62 61 73 65 20 74 6f 20 64 65 6d 6f 6e 73 74 abase to demonst
4890: 72 61 74 65 20 74 68 65 20 70 72 6f 62 6c 65 6d rate the problem
48a0: 2c 20 61 6e 64 20 74 6f 20 62 65 20 66 72 61 6e , and to be fran
48b0: 6b 2c 20 77 65 20 64 6f 6e e2 80 99 74 20 77 61 k, we don’t wa
48c0: 6e 74 20 79 6f 75 72 20 64 61 74 61 62 61 73 65 nt your database
48d0: 2c 20 65 69 74 68 65 72 2e 20 54 68 65 20 62 65 , either. The be
48e0: 73 74 20 74 68 69 6e 67 20 69 73 20 74 6f 20 6d st thing is to m
48f0: 6f 64 69 66 79 20 6f 6e 65 20 6f 66 20 74 68 65 odify one of the
4900: 20 4d 79 53 51 4c 2b 2b 20 65 78 61 6d 70 6c 65 MySQL++ example
4910: 73 20 73 6f 20 74 68 61 74 20 69 74 20 72 65 70 s so that it rep
4920: 72 6f 64 75 63 65 73 20 74 68 65 20 70 72 6f 62 roduces the prob
4930: 6c 65 6d 20 79 6f 75 e2 80 99 72 65 20 73 65 65 lem you’re see
4940: 69 6e 67 2e 20 54 68 69 73 20 6c 65 74 73 20 74 ing. This lets t
4950: 68 65 20 70 65 6f 70 6c 65 20 74 68 61 74 20 63 he people that c
4960: 61 6e 20 68 65 6c 70 20 79 6f 75 20 72 65 70 72 an help you repr
4970: 6f 64 75 63 65 20 74 68 65 20 70 72 6f 62 6c 65 oduce the proble
4980: 6d 20 6f 6e 20 74 68 65 69 72 20 6d 61 63 68 69 m on their machi
4990: 6e 65 73 2c 20 77 69 74 68 6f 75 74 20 6e 65 65 nes, without nee
49a0: 64 69 6e 67 20 79 6f 75 72 20 64 61 74 61 62 61 ding your databa
49b0: 73 65 2e 0d 0a 0d 0a 4f 6e 63 65 20 79 6f 75 20 se.....Once you
49c0: 68 61 76 65 20 79 6f 75 72 20 70 72 6f 62 6c 65 have your proble
49d0: 6d 20 62 6f 69 6c 65 64 20 64 6f 77 6e 20 74 6f m boiled down to
49e0: 20 61 20 73 69 6d 70 6c 65 20 65 78 61 6d 70 6c a simple exampl
49f0: 65 2c 20 73 65 6e 64 20 74 68 65 20 73 6f 75 72 e, send the sour
4a00: 63 65 20 63 6f 64 65 20 74 6f 20 74 68 65 20 6d ce code to the m
4a10: 61 69 6c 69 6e 67 20 6c 69 73 74 20 61 6c 6f 6e ailing list alon
4a20: 67 20 77 69 74 68 20 61 20 64 65 74 61 69 6c 65 g with a detaile
4a30: 64 20 72 65 70 6f 72 74 2e 20 57 65 20 77 61 6e d report. We wan
4a40: 74 20 74 6f 20 6b 6e 6f 77 20 77 68 61 74 20 79 t to know what y
4a50: 6f 75 20 65 78 70 65 63 74 20 74 68 65 20 70 72 ou expect the pr
4a60: 6f 67 72 61 6d 20 74 6f 20 64 6f 2c 20 61 6e 64 ogram to do, and
4a70: 20 77 68 61 74 20 69 74 20 61 63 74 75 61 6c 6c what it actuall
4a80: 79 20 64 6f 65 73 20 6f 6e 20 79 6f 75 72 20 6d y does on your m
4a90: 61 63 68 69 6e 65 2e 20 4b 65 65 70 20 69 6e 20 achine. Keep in
4aa0: 6d 69 6e 64 2c 20 70 72 6f 67 72 61 6d 73 20 6f mind, programs o
4ab0: 66 74 65 6e 20 62 65 68 61 76 65 20 64 69 66 66 ften behave diff
4ac0: 65 72 65 6e 74 6c 79 20 6f 6e 20 64 69 66 66 65 erently on diffe
4ad0: 72 65 6e 74 20 73 79 73 74 65 6d 73 2e 20 41 73 rent systems. As
4ae0: 20 61 20 70 72 6f 67 72 61 6d 6d 65 72 20 79 6f a programmer yo
4af0: 75 72 73 65 6c 66 2c 20 79 6f 75 20 6b 6e 6f 77 urself, you know
4b00: 20 77 68 61 74 20 69 74 20 69 73 20 6c 69 6b 65 what it is like
4b10: 20 74 6f 0d 0a 64 65 61 6c 20 77 69 74 68 20 76 to..deal with v
4b20: 61 67 75 65 20 75 73 65 72 20 62 75 67 20 72 65 ague user bug re
4b30: 70 6f 72 74 73 2e 20 47 69 76 65 20 75 73 20 74 ports. Give us t
4b40: 68 65 20 73 6f 72 74 20 6f 66 20 65 72 72 6f 72 he sort of error
4b50: 20 72 65 70 6f 72 74 20 79 6f 75 e2 80 99 64 20 report you’d
4b60: 6c 69 6b 65 20 74 6f 20 72 65 63 65 69 76 65 20 like to receive
4b70: 66 6f 72 20 79 6f 75 72 20 6f 77 6e 20 70 72 6f for your own pro
4b80: 67 72 61 6d 73 2e 0d 0a 0d 0a 54 68 65 72 65 27 grams.....There'
4b90: 73 20 61 6c 73 6f 20 74 68 65 20 5b 74 69 63 6b s also the [tick
4ba0: 65 74 20 74 72 61 63 6b 65 72 5d 28 2f 74 69 63 et tracker](/tic
4bb0: 6b 65 74 29 2c 20 62 75 74 20 77 65 20 70 72 65 ket), but we pre
4bc0: 66 65 72 20 74 68 61 74 20 79 6f 75 20 73 65 6e fer that you sen
4bd0: 64 20 74 68 65 20 72 65 70 6f 72 74 20 74 6f 20 d the report to
4be0: 74 68 65 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 the mailing list
4bf0: 20 66 6f 72 20 64 69 73 63 75 73 73 69 6f 6e 20 for discussion
4c00: 66 69 72 73 74 2e 20 45 73 70 65 63 69 61 6c 6c first. Especiall
4c10: 79 20 64 6f 20 6e 6f 74 20 75 73 65 20 74 68 65 y do not use the
4c20: 20 74 69 63 6b 65 74 20 74 72 61 63 6b 65 72 20 ticket tracker
4c30: 69 66 20 79 6f 75 20 6a 75 73 74 20 6e 65 65 64 if you just need
4c40: 20 68 65 6c 70 20 2a 75 73 69 6e 67 2a 20 4d 79 help *using* My
4c50: 53 51 4c 2b 2b 2e 0d 0a 0d 0a 0d 0a 23 23 20 3c SQL++.......## <
4c60: 61 20 6e 61 6d 65 3d 22 70 61 74 63 68 65 73 22 a name="patches"
4c70: 3e 3c 2f 61 3e 48 6f 77 20 64 6f 20 49 20 73 75 ></a>How do I su
4c80: 62 6d 69 74 20 61 20 63 68 61 6e 67 65 20 74 6f bmit a change to
4c90: 20 4d 79 53 51 4c 2b 2b 3f 0d 0a 0d 0a 54 68 69 MySQL++?....Thi
4ca0: 73 20 69 73 20 63 6f 76 65 72 65 64 20 69 6e 20 s is covered in
4cb0: 64 65 74 61 69 6c 20 69 6e 20 74 68 65 20 6c 69 detail in the li
4cc0: 62 72 61 72 79 27 73 20 5b 68 61 63 6b 65 72 27 brary's [hacker'
4cd0: 73 20 67 75 69 64 65 5d 28 2f 64 6f 63 2f 74 72 s guide](/doc/tr
4ce0: 75 6e 6b 2f 48 41 43 4b 45 52 53 2e 6d 64 29 2e unk/HACKERS.md).
4cf0: 0d 0a 0d 0a 42 75 74 20 69 6e 20 62 72 69 65 66 ....But in brief
4d00: 3a 20 77 65 20 77 61 6e 74 20 74 68 65 20 70 61 : we want the pa
4d10: 74 63 68 20 69 6e 20 75 6e 69 66 69 65 64 20 64 tch in unified d
4d20: 69 66 66 20 66 6f 72 6d 61 74 2c 20 6d 61 64 65 iff format, made
4d30: 20 61 67 61 69 6e 73 74 20 65 69 74 68 65 72 20 against either
4d40: 74 68 65 20 6c 61 74 65 73 74 20 72 65 6c 65 61 the latest relea
4d50: 73 65 20 6f 66 20 4d 79 53 51 4c 2b 2b 20 6f 72 se of MySQL++ or
4d60: 20 28 70 72 65 66 65 72 61 62 6c 79 29 20 61 67 (preferably) ag
4d70: 61 69 6e 73 74 20 5b 74 68 65 20 74 72 75 6e 6b ainst [the trunk
4d80: 20 6f 66 20 74 68 65 20 46 6f 73 73 69 6c 20 72 of the Fossil r
4d90: 65 70 6f 73 69 74 6f 72 79 5d 28 2f 74 69 6d 65 epository](/time
4da0: 6c 69 6e 65 3f 72 3d 74 72 75 6e 6b 29 2e 20 59 line?r=trunk). Y
4db0: 6f 75 20 63 61 6e 20 73 65 6e 64 20 69 74 20 65 ou can send it e
4dc0: 69 74 68 65 72 20 74 6f 20 74 68 65 20 5b 6d 61 ither to the [ma
4dd0: 69 6c 69 6e 67 20 6c 69 73 74 5d 28 68 74 74 70 iling list](http
4de0: 3a 2f 2f 6c 69 73 74 73 2e 6d 79 73 71 6c 2e 63 ://lists.mysql.c
4df0: 6f 6d 2f 70 6c 75 73 70 6c 75 73 2f 29 2c 20 6f om/plusplus/), o
4e00: 72 20 74 6f 20 5b 74 68 65 20 74 69 63 6b 65 74 r to [the ticket
4e10: 20 74 72 61 63 6b 65 72 5d 28 2f 74 69 63 6b 65 tracker](/ticke
4e20: 74 29 2e 20 57 65 20 70 72 65 66 65 72 20 74 68 t). We prefer th
4e30: 61 74 20 79 6f 75 20 6f 6e 6c 79 20 75 73 65 20 at you only use
4e40: 74 68 65 20 74 69 63 6b 65 74 20 74 72 61 63 6b the ticket track
4e50: 65 72 20 66 6f 72 20 70 61 74 63 68 65 73 20 74 er for patches t
4e60: 68 61 74 20 61 72 65 20 73 6f 20 74 72 69 76 69 hat are so trivi
4e70: 61 6c 20 6f 72 20 6f 62 76 69 6f 75 73 20 74 68 al or obvious th
4e80: 61 74 20 74 68 65 79 20 77 6f 6e e2 80 99 74 20 at they won’t
4e90: 6e 65 65 64 20 64 69 73 63 75 73 73 69 6f 6e 2e need discussion.
4ea0: 0d 0a 0d 0a 57 68 65 6e 20 61 20 70 61 74 63 68 ....When a patch
4eb0: 20 69 73 20 72 65 6a 65 63 74 65 64 2c 20 74 68 is rejected, th
4ec0: 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20 72 65 e most common re
4ed0: 61 73 6f 6e 20 69 73 20 74 68 61 74 20 69 74 20 ason is that it
4ee0: 62 72 65 61 6b 73 20 74 68 65 20 6c 69 62 72 61 breaks the libra
4ef0: 72 79 e2 80 99 73 20 62 69 6e 61 72 79 20 69 6e ry’s binary in
4f00: 74 65 72 66 61 63 65 20 28 41 42 49 29 2c 20 73 terface (ABI), s
4f10: 6f 20 74 68 61 74 20 61 6e 20 6f 6c 64 20 70 72 o that an old pr
4f20: 6f 67 72 61 6d 20 63 61 6e e2 80 99 74 20 6c 69 ogram can’t li
4f30: 6e 6b 20 74 6f 20 74 68 65 20 63 68 61 6e 67 65 nk to the change
4f40: 64 20 6c 69 62 72 61 72 79 20 77 69 74 68 6f 75 d library withou
4f50: 74 20 72 65 63 6f 6d 70 69 6c 69 6e 67 2e 20 57 t recompiling. W
4f60: 65 20 6f 6e 6c 79 20 6d 61 6b 65 20 73 75 63 68 e only make such
4f70: 20 63 68 61 6e 67 65 73 20 61 74 20 6d 61 6a 6f changes at majo
4f80: 72 20 76 65 72 73 69 6f 6e 20 74 72 61 6e 73 69 r version transi
4f90: 74 69 6f 6e 73 2e 20 54 68 65 73 65 20 74 72 61 tions. These tra
4fa0: 6e 73 69 74 69 6f 6e 73 20 61 72 65 20 72 61 72 nsitions are rar
4fb0: 65 2c 20 61 6e 64 20 77 65 20 63 61 6e e2 80 99 e, and we can’
4fc0: 74 20 65 76 65 6e 20 70 72 6f 6d 69 73 65 20 74 t even promise t
4fd0: 68 61 74 20 74 68 65 72 65 20 77 69 6c 6c 20 65 hat there will e
4fe0: 76 65 72 20 62 65 20 61 6e 6f 74 68 65 72 20 6f ver be another o
4ff0: 6e 65 2c 20 6d 75 63 68 20 6c 65 73 73 20 77 68 ne, much less wh
5000: 65 6e 20 69 74 20 77 69 6c 6c 20 6f 63 63 75 72 en it will occur
5010: 2e 20 49 66 20 79 6f 75 20 68 61 76 65 20 61 20 . If you have a
5020: 63 68 6f 69 63 65 20 6f 66 20 74 77 6f 20 77 61 choice of two wa
5030: 79 73 20 74 6f 20 67 65 74 20 79 6f 75 72 20 64 ys to get your d
5040: 65 73 69 72 65 64 20 65 66 66 65 63 74 20 61 6e esired effect an
5050: 64 20 6f 6e 65 20 6f 66 20 74 68 65 6d 20 64 6f d one of them do
5060: 65 73 6e e2 80 99 74 20 62 72 65 61 6b 20 74 68 esn’t break th
5070: 65 20 41 42 49 2c 20 69 74 20 77 69 6c 6c 20 69 e ABI, it will i
5080: 6e 63 72 65 61 73 65 20 74 68 65 20 63 68 61 6e ncrease the chan
5090: 63 65 73 20 74 68 61 74 20 77 65 20 61 63 63 65 ces that we acce
50a0: 70 74 20 79 6f 75 72 20 70 61 74 63 68 20 69 66 pt your patch if
50b0: 20 79 6f 75 20 64 6f 20 69 74 20 74 68 61 74 20 you do it that
50c0: 77 61 79 2e 0d 0a 0d 0a 3c 70 20 73 74 79 6c 65 way.....<p style
50d0: 3d 22 68 65 69 67 68 74 3a 20 35 30 65 6d 22 3e ="height: 50em">
50e0: 26 6e 62 73 70 3b 3c 2f 70 3e 0a 5a 20 66 37 34 </p>.Z f74
50f0: 37 38 37 62 63 36 37 39 30 35 34 35 36 37 37 63 787bc6790545677c
5100: 38 36 33 63 35 61 63 66 32 63 64 66 62 0a 863c5acf2cdfb.