Aplikasi Unicode

Anda dapat mengkompilasi ulang aplikasi sebagai aplikasi Unicode dengan salah satu dari dua cara:

• Sertakan #define Unicode yang terkandung dalam file header Sqlucode.h dalam aplikasi.

• Kompilasi aplikasi dengan opsi Unicode kompilator. (Opsi ini akan berbeda untuk pengkompilasi yang berbeda.)

Untuk mengonversi aplikasi ANSI ke aplikasi Unicode, tulis aplikasi untuk menyimpan dan meneruskan data Unicode. Selain itu, panggilan ke fungsi yang mendukung argumen SQLPOINTER harus dikonversi untuk menggunakan jumlah byte.

Setelah aplikasi dikompilasi sebagai aplikasi Unicode, jika aplikasi memanggil fungsi ODBC API (tanpa akhiran), Driver Manager mengenali aplikasi sebagai aplikasi Unicode dan mengonversi panggilan fungsi ke fungsi Unicode (dengan akhiran W ) jika driver yang mendasarinya mendukung Unicode. Ketika aplikasi ANSI melakukan panggilan fungsi tanpa akhiran, Driver Manager mengonversinya ke ANSI jika driver yang mendasar mendukung ANSI. Jika aplikasi dan driver mendukung pengodean karakter yang sama, manajer driver meneruskan panggilan ke driver (dengan pengecualian tertentu untuk aplikasi ANSI).

Aplikasi dapat memanggil fungsi Unicode (dengan akhiran W ) dan fungsi ANSI (dengan atau tanpa akhiran A ). Panggilan fungsi Unicode dan ANSI dapat dicampur. Namun, jika pustaka kursor akan digunakan, panggilan fungsi Unicode dan ANSI tidak dapat dicampur. Pustaka kursor adalah Unicode atau ANSI, bukan campuran.

Aplikasi dapat ditulis seragam sehingga dapat dikompilasi sebagai aplikasi Unicode atau aplikasi ANSI. Dalam hal ini, jenis data karakter dapat dinyatakan sebagai SQL_C_TCHAR. Ini adalah makro yang menyisipkan SQL_C_WCHAR jika aplikasi dikompilasi sebagai aplikasi Unicode atau menyisipkan SQL_C_CHAR jika dikompilasi sebagai aplikasi ANSI. Programmer aplikasi harus berhati-hati terhadap fungsi yang mengambil SQLPOINTER sebagai argumennya, karena ukuran argumen panjang akan berubah (untuk jenis data string) tergantung pada apakah aplikasi adalah ANSI atau Unicode.

Fungsi dapat dipanggil dengan salah satu dari tiga cara: sebagai panggilan fungsi khusus Unicode (dengan akhiran W ), sebagai panggilan fungsi khusus ANSI (dengan akhiran A ), atau sebagai panggilan fungsi ODBC tanpa akhiran. Argumen untuk tiga bentuk fungsi identik. Hanya fungsi tersebut dengan argumen SQLCHAR * atau argumen SQLPOINTER yang menunjuk ke string yang memerlukan formulir Unicode dan ANSI. Untuk fungsi yang memiliki argumen yang dapat dideklarasikan sebagai jenis karakter, seperti SQLBindCol atau SQLGetData (yang tidak memiliki formulir Unicode dan ANSI), argumen dapat dideklarasikan sebagai jenis Unicode, jenis ANSI, atau dalam kasus argumen jenis C, makro SQL_C_TCHAR. Untuk informasi selengkapnya, lihat Data Unicode.

Aplikasi dapat ditulis sebagai aplikasi Unicode meskipun tidak ada driver Unicode yang tersedia untuk dikerjakan. Driver Manager akan memetakan fungsi Unicode dan jenis data ke ANSI. Ada beberapa batasan untuk pemetaan Unicode ke ANSI yang dapat dilakukan. Keberadaan driver Unicode untuk bekerja dengan aplikasi Unicode akan menghasilkan performa yang lebih baik dan akan menghapus batasan yang melekat dalam pemetaan Unicode ke ANSI.