RU/kb/00000643 - Revision history

Sancho at 10:00, 13 March 2012

2012-03-13T10:00:17Z

Sancho at 16:48, 8 November 2011

2011-11-08T16:48:34Z

Sancho at 16:48, 8 November 2011

2011-11-08T16:48:20Z

Sancho: Основной текст

2011-11-08T16:46:22Z

Основной текст

New page

<section begin=title /><noinclude>{{DISPLAYTITLE:База Знаний: Функции {{OOoC|1}}. </noinclude>HLOOKUP<noinclude>}}</noinclude><section end=title />
{{BreadCrumbL10n|RU/kb/module/calc/function/spreadsheet_functions}}
__NOTOC__

<section begin=toc />
=== HLOOKUP ===
Функция возвращает значение из строки таблицы, в столбце которого в первой строке найдено требуемое значение.

==== Синтаксис функции: ====
{| class="prettytable" style="width:100%"
!=HLOOKUP(lookupvalue; datatable; rowindex; mode)
|}
[[File:Function_HLOOKUP_ru.png|360px|thumb|right|Рис. 1. Пример функции.]]где:

* ''lookupvalue'' — значение (число, текст или логическое значение), разыскиваемое в первой строке диапазона / массива. Когда значение найдено в первой строке, '''HLOOKUP''' возвращает соответствующее значение (в том же самом столбце) в строке ''rowindex'' диапазона ''datatable'', где для первой строки ''rowindex = 1'';
* ''datatable'' — ссылка, которая должна включать по крайней мере две строки;
* ''rowindex'' — номер строки в массиве, содержащей значения, которые должны быть возвращены. Первая строка имеет номер 1;
* ''mode'' — необязательный параметр, который указывает, отсортирована ли первая строка в массиве в порядке возрастания. Если ''mode'' '''0''' или '''FALSE''', первая строка не отсортирована в порядке возрастания, и ищется первое точное совпадение (поиск выполняется слева направо). В неотсортированных списках, значение поиска должно быть подобрано точно. Иначе функция возвратит сообщение об ошибке: ''#N/A''. Если ''mode = 1'', ''TRUE'' или опущен, первая строка ''datatable'' должна быть отсортирована, с числами, в порядке возрастания располагающимися перед текстовыми значениями в алфавитном порядке. Поиск по отсортированным строкам может выполняться намного быстрее, и функция всегда возвращает значение, даже если значение поиска не было точно подобрано, если оно находится между наименьшим и наибольшим значением отсортированного списка. '''HLOOKUP''' решает, где в первом ряду появляется ''lookupvalue''. Если есть точное совпадение, оно соответствует найденному столбцу; если есть более чем одно точное совпадение, найденный столбец — не обязательно крайний левый.

Если регулярные выражения разрешены в диалоговом окне {{Menu|Сервис|Параметры|{{IopC}}|Вычисления}}, '''HLOOKUP''' находит точное соответствие, рассматривая ''lookupvalue'' как регулярное выражение. Это имеет смысл и должно использоваться только если ''mode'' имеет значение '''0''' или '''FALSE'''.

Если параметр {{Menu|Условия поиска <nowiki>=</nowiki> и <>}} должны распространяться на всю ячейку в диалоговом окне {{Menu|Сервис|Параметры|{{IopC}}|Вычисления}} — установлен, ''lookupvalue'' должен соответствовать всему тексту в ячейке; в противном случае он может соответствовать только части текста.

[[File:Function_HLOOKUP_1_ru.png|360px|thumb|right|Рис. 2. HLOOKUP.]]Соответствие всегда не зависит от регистра — значение параметра {{Menu|Учитывать регистр}} в диалоговом окне {{Menu|Сервис|Параметры|{{IopC}}|Вычисления}}, не употребляется.

На рис. 1:
* в ячейке '''B4''' возвращается ''A''. Ячейка ''A1'' в первой строке соответствует ''3''. Содержимое соответствующей ячейки во 2-ой строке (то есть, A2) возвращается. Первый ряд может быть отсортирован, но это не является необходимым в режиме '''0''';
* в ячейке '''B6''' возвращается значение ошибки '''#N/A'''. Нет никакого соответствия для 4;
* в ячейке '''B8''' возвращается ''C''. Различие между нижним и верхним регистрами игнорируется, таким образом ''CAT'' соответствует ''cat'';
* в ячейке '''B10''' возвращается ''C'', если регулярные выражения разрешены (и '''#N/A''' если не разрешены). Точка “.” соответствует «любому одиночному символу» в регулярных выражениях, таким образом ''c.t'' соответствует ''cat'';
* в ячейке '''B12''' возвращается ''C'', если регулярные выражения разрешены. Заданному условию поиска соответствует ''cat'', а так же ''mat'', но всегда находится крайнее левое совпадение в режиме '''0''';
* в ячейке '''B14''' возвращается значение ошибки '''#N/A''', если параметр {{Menu|Условия поиска <nowiki>=</nowiki> и <>}} должны распространяться на всю ячейку — установлен и ''C'' в противном случае. Строка ''at'' не соответствует никакому целому содержимому ячеек, но оно соответствует части ''cat'';
* в ячейке '''B4''' возвращается ''A''. Ячейка A1 в первой строке соответствует ''3''. Верхняя строка должна быть отсортирована в режиме '''1''', с текстовыми данными, располагающимися после чисел. Текстовая строка ''matter'' следует за ''mat'', потому что, хотя первые буквы — одинаковые, ''matter'' имеет больше букв;
* в ячейке '''B6''' возвращается ''A''. 4 располагалось бы между ''3'' и ''5'' в верхней строке, таким образом находится левая позиция;
* в ячейке '''B8''' возвращается значение ошибки '''#N/A''', ''1'' располагалось бы перед ''3'' в верхнем ряду, но позиции слева от неё нет в таблице;
* в ячейке '''B10''' возвращается ''B''. ''7'' располагалось бы между ''5'' и ''cat'' в верхнем ряду, таким образом находится левая позиция;
* в ячейке '''B12''' возвращается ''B''. Текстовая строка ''apple'' располагалась бы между ''5'' и ''cat'' в верхнем ряду, таким образом находится левая позиция;
* в ячейке '''B14''' возвращается ''D''. Текстовая строка ''mate'' располагалась бы между ''mat'' и ''matter'' в верхнем ряду, таким образом находится левая позиция;
* в ячейке '''B16''' возвращается ''E''. Текстовая строка ''rat'' располагалась бы после ''matter'' в верхнем ряду, таким образом находится левая позиция;
* в ячейке '''B18''' возвращается ''B'', даже если параметр {{Menu|Условия поиска <nowiki>=</nowiki> и <>}} должны распространяться на всю ячейку — не установлен. В этом случае соответствие между ''at'' и ''cat'' игнорируется в пользу рассмотрения ''at'' как слова, которое располагается между ''5'' и ''cat''.
<section end=toc />

<section begin=signature/>
{{Sign|Sancho}}
{{IopVersion|3.1.x}}
<section end=signature/>

{{RUkbCalcBottom}}

@@ Line 38: / Line 38: @@
-[[File:Function_HLOOKUP_1_ru.png|360px|thumb|right|Рис. 2. HLOOKUP.]]На рис. 1:
+[[File:Function_HLOOKUP_1_ru.png|360px|thumb|right|Рис. 2. HLOOKUP.]]На рис. 2:
 * в ячейке '''B4''' возвращается ''A''. Ячейка A1 в первой строке соответствует ''3''. Верхняя строка должна быть отсортирована в режиме '''1''', с текстовыми данными, располагающимися после чисел. Текстовая строка ''matter'' следует за ''mat'', потому что, хотя первые буквы — одинаковые, ''matter'' имеет больше букв;
 * в ячейке '''B6''' возвращается ''A''. 4 располагалось бы между ''3'' и ''5'' в верхней строке, таким образом находится левая позиция;

@@ Line 6: / Line 6: @@
 <section begin=toc />
 === HLOOKUP ===
-Функция возвращает значение из строки таблицы, в столбце которого в первой строке найдено требуемое значение.
+<section begin=description />Функция возвращает значение из строки таблицы, в столбце которого в первой строке найдено требуемое значение.<section end=description />
 ==== Синтаксис функции: ====

@@ Line 26: / Line 26: @@
-[[File:Function_HLOOKUP_1_ru.png|360px|thumb|right|Рис. 2. HLOOKUP.]]Соответствие всегда не зависит от регистра — значение параметра {{Menu|Учитывать регистр}} в диалоговом окне {{Menu|Сервис|Параметры|{{IopC}}|Вычисления}}, не употребляется.
+Соответствие всегда не зависит от регистра — значение параметра {{Menu|Учитывать регистр}} в диалоговом окне {{Menu|Сервис|Параметры|{{IopC}}|Вычисления}}, не употребляется.
@@ Line 36: / Line 36: @@
 * в ячейке '''B12''' возвращается ''C'', если регулярные выражения разрешены. Заданному условию поиска соответствует ''cat'', а так же ''mat'', но всегда находится крайнее левое совпадение в режиме '''0''';
 * в ячейке '''B14''' возвращается значение ошибки '''#N/A''', если параметр {{Menu|Условия поиска&nbsp;<nowiki>=</nowiki>&nbsp;и&nbsp;<>}} должны распространяться на всю ячейку — установлен и ''C'' в противном случае. Строка ''at'' не соответствует никакому целому содержимому ячеек, но оно соответствует части ''cat'';
 * в ячейке '''B4''' возвращается ''A''. Ячейка A1 в первой строке соответствует ''3''. Верхняя строка должна быть отсортирована в режиме '''1''', с текстовыми данными, располагающимися после чисел. Текстовая строка ''matter'' следует за ''mat'', потому что, хотя первые буквы — одинаковые, ''matter'' имеет больше букв;
 * в ячейке '''B6''' возвращается ''A''. 4 располагалось бы между ''3'' и ''5'' в верхней строке, таким образом находится левая позиция;