Strfind — различия между версиями

Материал из Pro-Pawn Wiki
Перейти к: навигация, поиск
(Опечатка в описании)
м (уточнения в описании и в параметрах)
 
Строка 1: Строка 1:
 
{{DISPLAYTITLE:strfind}}
 
{{DISPLAYTITLE:strfind}}
 
{{Description
 
{{Description
| Находит первую подстроку в строке.
+
| Находит первое вхождение подстроки в строке.
 
}}
 
}}
 
{{Params|const string[], const sub[], bool:ignorecase{{=}}false, pos{{=}}0}}
 
{{Params|const string[], const sub[], bool:ignorecase{{=}}false, pos{{=}}0}}
Строка 10: Строка 10:
 
{{Param
 
{{Param
 
| const sub[]
 
| const sub[]
| Подстрока, вхождения которой функция будет искать в строке <code>string</code>.
+
| Подстрока, вхождение которой функция будет искать в строке <code>string</code>.
 
}}
 
}}
 
{{Param
 
{{Param
 
| bool:ignorecase
 
| bool:ignorecase
| Указывает, следует ли функции игнорировать регистр символов (<code>true</code>/<code>false</code>; необязательный параметр).
+
| Указывает, следует ли функции игнорировать регистр символов (<code>true</code>/<code>false</code>; необязательный параметр; по умолчанию функция чувствительна к регистру).
 
}}
 
}}
 
{{Param
 
{{Param
 
| pos
 
| pos
| Позиция в строке <code>string</code>, с которой следует начинать поиск (необязательный параметр).
+
| Позиция в строке <code>string</code>, с которой следует начинать поиск (необязательный параметр; по умолчанию поиск начинается с самого начала строки).
 
}}
 
}}
 
{{Returns
 
{{Returns

Текущая версия на 09:09, 24 июля 2018

Описание:

Находит первое вхождение подстроки в строке.

Параметры:

(const string[], const sub[], bool:ignorecase=false, pos=0)
const string[] Строка, в которой будет проведён поиск.
const sub[] Подстрока, вхождение которой функция будет искать в строке string.
bool:ignorecase Указывает, следует ли функции игнорировать регистр символов (true/false; необязательный параметр; по умолчанию функция чувствительна к регистру).
pos Позиция в строке string, с которой следует начинать поиск (необязательный параметр; по умолчанию поиск начинается с самого начала строки).


Возвращаемое значение:

Позиция вхождения подстроки sub в строку string, либо -1, если ни одного вхождения не найдено.

Bug.png
Баг Pawn
Если указать отрицательную стартовую позицию (параметр pos), функция не посчитает такую позицию неправильной и начнёт поиск с неё, т.е. будет читать данные за пределами массива string.


Пример использования:

main()
{
    new result;
    static const string[] = "abcd1234";

    result = strfind(string, "cd");
    printf("result: %d", result); // "result: 2"

    result = strfind(string, "123");
    printf("result: %d", result); // "result: 4"

    result = strfind(string, "z");
    printf("result: %d", result); // "result: -1" (в строке "abcd1234" нет "z")
}


См. также: