На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

lstrcmpi



The lstrcmpi function compares two character strings. The comparison is not case sensitive.

int lstrcmpi(

LPCTSTR lpString1, // address of first string
LPCTSTR lpString2 // address of second string
);


Parameters

lpString1

Points to the first null-terminated string to be compared.

lpString2

Points to the second null-terminated string to be compared.



Return Values

If the function succeeds and the string pointed to by lpString1 is less than the string pointed to by lpString2, the return value is negative; if the string pointed to by lpString1 is greater than the string pointed to by lpString2, it is positive. If the strings are equal, the return value is zero.

Remarks

The lstrcmpi function compares two strings by checking the first characters against each other, the second characters against each other, and so on until it finds an inequality or reaches the ends of the strings.
The function returns the difference of the values of the first unequal characters it encounters. For example, lstrcmpi determines that "abcz" is greater than "abcdefg" and returns the difference of z and d.
The language (locale) selected by the user at setup time, or by using the control panel, determines which string is greater (or whether the strings are the same). If no language (locale) is selected, Windows performs the comparison by using default values.

For some locales, the lstrcmpi function may be insufficient. If this occurs, use CompareString to ensure proper comparison. For example, in Japan call CompareString with the IGNORE_CASE, IGNORE_KANATYPE, and IGNORE_WIDTH values to achieve the most appropriate non-exact string comparison. The IGNORE_KANATYPE and IGNORE_WIDTH values are ignored in non-Asian locales, so you can set these values for all locales and be guaranteed to have a culturally correct "insensitive" sorting regardless of the locale. Note that specifying these values slows performance, so use them only when necessary.

With a double-byte character set (DBCS) version of Windows, this function can compare two DBCS strings.
The Win32 lstrcmpi function uses a word sort, rather than a string sort. A word sort treats hyphens and apostrophes differently than it treats other symbols that are not alphanumeric, in order to ensure that words such as "coop" and "co-op" stay together within a sorted list. Note that in 16-bit versions of Windows, lstrcmpi uses a string sort. For a detailed discussion of word sorts and string sorts, see the Remarks section of the reference page for the CompareString function .

See Also

CompareString, lstrcat, lstrcmp, lstrcpy, lstrlen




Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

lstrcmpi



Функция lstrcmpi сравнивает две символьных строки. Сравнение не является случаем чувствительным.

int lstrcmpi(

LPCTSTR lpString1, // АДРЕС первого адреса строки LPCTSTR lpString2 // строки секунды
);


Параметры

lpString1

Точки на первую недействительный расторгнутую строку, которые нужно сравниваться.

lpString2

Точки на вторую недействительный расторгнутую строку, которые нужно сравниваться.



Обратные Величины

Если функция добивается успеха и строка указанная, чтобы lpString1 - менее чем строка указанная, чтобы lpString2, обратная величина отрицательная; если строка указанная, чтобы lpString1 больше, чем строка указывалась, чтобы lpString2, она положительная. Если строки равные, обратная величина нулевая.

Замечания

Функция lstrcmpi сравнивает две строки проверяя первые символы против друг друга, вторые символы против друг друга, и так далее пока это не найдет неравенство или достигнет концов строк.
Функция возвращает различие величин первых неравных символов, которые она сталкивается. Например, lstrcmpi определяет, что "abcz" больше, чем "abcdefg" и возвращает различию z и d. язык (место действия) выбирался пользователем во времени установки, или используя панель управления, определяет, что какая строка большая (или независимо строки - те же). Если никакой язык (место действия) не выбран, Windows выполняет сравнение используя значение по умолчанию.

Для немного локальные, функция lstrcmpi может быть недостаточной. Если это происходит, используйте CompareString, чтобы гарантировать соответствующее сравнение. Например, в Японии вызова CompareString с IGNORE_CASE, IGNORE_KANATYPE, и величинами IGNORE_WIDTH, чтобы достигать наиболее подходящего не-точного сравнения строки. IGNORE_KANATYPE И величины IGNORE_WIDTH проигнорированы в не-Азиатский локальный, так что Вы можете установить эти величины для всех локальных и гарантированы, чтобы иметь культурно правильный "нечувствительный" сортируясь независимо от места действия. Отметьте, что определение этих величин замедляет исполнение, так что использовать их только когда необходимо.

С двойным-байтовым набором символов версии (DBCS) Windows, эта функция может сравнить две строки DBCS.
Win32 lstrcmpi Функция использует текстовую сортировку, а не сортировку строки. Текстовая сортировка обрабатывает дефисы и апострофы иначе чем она обрабатывает другие символы, которые не текстовые, для того, чтобы гарантировать эти слово как например, "курятник" и пребывание "кооператива" вместе в пределах отсортированного списка. Отметьте, что в 16- битовых версиях Windows, lstrcmpi использует сортировку строки. Для подробной дискуссии текстовых типов и типов строки, смотри секцию Замечаний страницы ссылки для функции CompareString.

Смотри Также

CompareString, lstrcat, lstrcmp, lstrcpy, lstrlen




Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz