Desen Değeri Argümanları

SQLTable'lardaki TableName bağımsız değişkeni gibi katalog işlevlerindeki bazı bağımsız değişkenler arama desenlerini kabul eder. SQL_ATTR_METADATA_ID deyimi özniteliği SQL_FALSE olarak ayarlandıysa bu bağımsız değişkenler arama desenlerini kabul eder; bunlar, bu öznitelik SQL_TRUE olarak ayarlanırsa arama desenini kabul etmeyen tanımlayıcı bağımsız değişkenleridir.

Arama deseni karakterleri şunlardır:

• Herhangi bir karakteri temsil eden alt çizgi (_).

• Sıfır veya daha fazla karakterden oluşan herhangi bir sırayı temsil eden yüzde işareti (%).

• Sürücüye özgü olan ve alt çizgi, yüzde işareti ve kaçış karakterini sabit değer olarak içermek için kullanılan bir kaçış karakteri. Kaçış karakteri özel olmayan bir karakterden önce gelirse, kaçış karakterinin özel bir anlamı yoktur. Kaçış karakteri özel bir karakterden önce gelirse, özel karakterden kaçar. Örneğin, "\a" "\" ve "a" olmak üzere iki karakter olarak değerlendirilir, ancak "\%" özel olmayan tek karakter "%" olarak değerlendirilir.

Kaçış karakteri SQLGetInfo içindeki SQL_SEARCH_PATTERN_ESCAPE seçeneğiyle alınır. Bu karakteri değişmez değer olarak eklemek için arama desenlerini kabul eden bir bağımsız değişkende alt çizgi, yüzde işareti veya kaçış karakterinden önce olmalıdır. Örnekler aşağıdaki tabloda gösterilmiştir.

Arama düzeni	Description
%A%	A harfini içeren tüm tanımlayıcılar
ABC_	ABC ile başlayan dört karakterli tanımlayıcılar
ABC\_	Kaçış karakterinin ters eğik çizgi (\) olduğu varsayılarak tanımlayıcı ABC_
\\%	Kaçış karakterinin bir ters eğik çizgi (\) olduğu varsayılarak, ters eğik çizgi (\) ile başlayan tüm tanımlayıcılar

Arama desenlerini kabul eden bağımsız değişkenlerdeki arama deseni karakterlerinden kurtulmak için özel özen gösterilmelidir. Tanımlayıcılarda yaygın olarak kullanılan alt çizgi karakteri için bu özellikle geçerlidir. Uygulamalarda yaygın bir hata, bir katalog işlevinden bir değer almak ve bu değeri başka bir katalog işlevindeki bir arama düzeni bağımsız değişkenine geçirmektir. Örneğin, bir uygulamanın SQLTable'lar için sonuç kümesinden MY_TABLE tablo adını aldığı ve bunu SQLColumns'a geçirerek MY_TABLE sütun listesini aldığı varsayılır. Uygulama, yalnızca MY_TABLE sütunlarını almak yerine, MY_TABLE, MY1TABLE, MY2TABLE gibi MY_TABLE arama desenine uyan tüm tabloların sütunlarını alacaktır.

Uyarı

ODBC 2.x sürücüleri, SQLTables'taki CatalogName bağımsız değişkeninde arama kalıplarını desteklemez. SQL_ATTR_ ODBC_VERSION ortam özniteliği SQL_OV_ODBC3 olarak ayarlandıysa ODBC 3*.x* sürücüleri bu bağımsız değişkendeki arama desenlerini kabul eder; SQL_OV_ODBC2 olarak ayarlandıysa, bu bağımsız değişkende arama desenlerini kabul etmedikleridir.

Arama deseni bağımsız değişkenine null işaretçi geçirilmesi, bu bağımsız değişkenin aramasını kısıtlamaz; diğer bir ifadeyle null işaretçi ve arama deseni % (herhangi bir karakter) eşdeğerdir. Ancak, sıfır uzunluklu arama deseni (yani, sıfır uzunluklu bir dizeye ilişkin geçerli bir işaretçi) yalnızca boş dizeyle ("") eşleşir.