Аргументы значения шаблона

Некоторые аргументы в функциях каталога, например аргумент TableName в SQLTables, принимают шаблоны поиска. Эти аргументы принимают шаблоны поиска, если атрибут инструкции SQL_ATTR_METADATA_ID имеет значение SQL_FALSE; они являются аргументами идентификатора, которые не принимают шаблон поиска, если этот атрибут имеет значение SQL_TRUE.

Символы шаблона поиска:

• Символ подчеркивания (_), представляющий любой один символ.

• Знак процента (%) представляет любую последовательность нулевых или более символов.

• Escape-символ, который относится к драйверу и используется для включения символов подчеркивания, процентов и escape-символа в качестве литерала. Если экранный символ предшествует не специальному символу, экранный символ не имеет особого значения. Если escape-символ предшествует специальному символу, он экранирует специальный символ. Например, "\a" будет рассматриваться как два символа, "\" и "a", но "\%" будет рассматриваться как не специальный одинарный символ "%".

Экранный символ извлекается с параметром SQL_SEARCH_PATTERN_ESCAPE в SQLGetInfo. Он должен предшествовать любому символу подчеркивания, знака процента или escape-символа в аргументе, который принимает шаблоны поиска для включения этого символа в качестве литерала. Примеры показаны в следующей таблице.

Шаблон поиска	Description
%A%	Все идентификаторы, содержащие букву A
ABC_	Все четыре идентификатора символов, начиная с ABC
ABC\_	Идентификатор ABC_, предполагая, что escape-символ является обратной косой чертой (\)
\\%	Все идентификаторы, начиная с обратной косой черты (\), предполагая, что escape-символ является обратной косой чертой

Необходимо учитывать, чтобы избежать символов шаблона поиска в аргументах, которые принимают шаблоны поиска. Это особенно верно для символа подчеркивания, который обычно используется в идентификаторах. Распространенная ошибка в приложениях заключается в том, чтобы получить значение из одной функции каталога и передать это значение в аргумент шаблона поиска в другой функции каталога. Например, предположим, что приложение извлекает имя таблицы MY_TABLE из результирующего набора для SQLTables и передает это в SQLColumns, чтобы получить список столбцов в MY_TABLE. Вместо получения столбцов для MY_TABLE приложение получит столбцы для всех таблиц, соответствующих шаблону поиска MY_TABLE, например MY_TABLE, MY1TABLE, MY2TABLE и т. д.

Примечание.

ODBC 2.Драйверы x не поддерживают шаблоны поиска в аргументе CatalogName в SQLTables. Драйверы ODBC 3*.x* принимают шаблоны поиска в этом аргументе, если атрибут среды SQL_ATTR_ ODBC_VERSION имеет значение SQL_OV_ODBC3; Они не принимают шаблоны поиска в этом аргументе, если задано значение SQL_OV_ODBC2.

Передача указателя NULL в аргумент шаблона поиска не ограничивает поиск этого аргумента; То есть значение NULL и шаблон поиска % (любые символы) эквивалентны. Однако шаблон поиска нулевой длины ( то есть допустимый указатель на строку нулевой длины — соответствует только пустой строке ("").