String.h

RemarksRemarks

Функция находит последнее вхождение c (преобразованное в ) в str.The function finds the last occurrence of c (converted to ) in str. Поиск включает завершающие нуль-символы.The search includes the terminating null character.

Функции и are wide-character и multibyte-character versions of для расширенных и многобайтовых символов. and are wide-character and multibyte-character versions of . Аргументы и возвращаемое значение представляют собой двухбайтовые строки; аргументы и возвращаемое значение представляют собой многобайтовые строки.The arguments and return value of are wide-character strings; those of are multibyte-character strings.

В C эти функции принимают указатель на первый аргумент.In C, these functions take a pointer for the first argument. В языке C++ доступны две перегрузки.In C++, two overloads are available. Перегрузка, принимающая указатель на, возвращает указатель на ; версия, которая принимает указатель на, не возвращает указатель на значение, отличное от .The overload taking a pointer to returns a pointer to ; the version that takes a pointer to non- returns a pointer to non-. Макрос _CRT_CONST_CORRECT_OVERLOADS определяется, если доступны и не версии этих функций.The macro _CRT_CONST_CORRECT_OVERLOADS is defined if both the and non- versions of these functions are available. Если требуется не поведение обеих перегрузок C++, определите символ _CONST_RETURN.If you require the non- behavior for both C++ overloads, define the symbol _CONST_RETURN.

проверяет свои параметры. validates its parameters. Если str имеет значение null, вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров.If str is NULL, the invalid parameter handler is invoked, as described in Parameter Validation. Если выполнение может быть продолжено, для задается значение еинвал и возвращает 0.If execution is allowed to continue, is set to EINVAL and returns 0. Функции и не проверяют свои параметры. and do not validate their parameters. В остальном эти три функции ведут себя идентично.These three functions behave identically otherwise.

На выходное значение влияет параметр категории LC_CTYPE языкового стандарта. Дополнительные сведения см. в разделе setlocale.The output value is affected by the setting of the LC_CTYPE category setting of the locale; for more information, see setlocale. Версии этих функций без суффикса _l используют текущий языковой стандарт для данного поведения, зависящего от языкового стандарта; версии с суффиксом _l идентичны, за исключением того, что они используют переданный параметр языкового стандарта.The versions of these functions without the _l suffix use the current locale for this locale-dependent behavior; the versions with the _l suffix are identical except that they use the locale parameter passed in instead. Для получения дополнительной информации см. Locale.For more information, see Locale.

По умолчанию глобальное состояние этой функции ограничивается приложением.By default, this function’s global state is scoped to the application. Чтобы изменить это, см. раздел глобальное состояние в CRT.To change this, see Global state in the CRT.

Универсальное текстовое сопоставление функцийGeneric-Text Routine Mappings

Подпрограмма TCHAR.HTCHAR.H routine _UNICODE и _MBCS не определены_UNICODE & _MBCS not defined _MBCS определено_MBCS defined _UNICODE определено_UNICODE defined
н/дn/a н/дn/a н/дn/a

стоиstoi

Преобразует последовательность символов в целое число.Converts a character sequence to an integer.

ПараметрыParameters

strstrПоследовательность символов для преобразования.The character sequence to be converted.

IDXidxЗначение индекса первого непреобразованного символа.The index value of the first unconverted character.

изbaseИспользуемое числовое основание.The number base to use.

RemarksRemarks

Функция преобразует последовательность символов в str в значение типа и возвращает значение.The function converts the sequence of characters in str to a value of type and returns the value. Например, если передать последовательность символов «10», возвращает целочисленное значение 10.For example, when passed a character sequence «10», the value returned by is the integer 10.

ведет себя аналогично функции для однобайтовых символов, когда она вызывается способом , где является объектом, внутренним по отношению к функции, или для расширенных символов, когда он вызывается подобным образом . behaves similarly to the function for single-byte characters when it’s called in the manner , where is an object internal to the function; or for wide characters, when it’s called in similar manner, . Дополнительные сведения см. в разделе strtol, wcstol, _strtol_l, _wcstol_l.For more information, see strtol, wcstol, _strtol_l, _wcstol_l.

Если значение равно, вызывается объект типа .If , throws an object of type . Если такой вызов будет установлен или если возвращаемое значение не может быть представлено как объект типа , то создается объект типа .If such a call would set , or if the returned value can’t be represented as an object of type , it throws an object of type . В противном случае, если idx не является пустым указателем, функция сохраняет в .Otherwise, if idx isn’t a null pointer, the function stores in .

RemarksRemarks

Функция возвращает указатель на первое вхождение стрсеарч в str.The function returns a pointer to the first occurrence of strSearch in str. Поиск не включает завершающие нуль-символы.The search does not include terminating null characters. является версией с расширенными символами, а  — версией с многобайтовыми символами. is the wide-character version of and is the multibyte-character version. Аргументы и возвращаемое значение представляют собой двухбайтовые строки; аргументы и возвращаемое значение представляют собой многобайтовые строки.The arguments and return value of are wide-character strings; those of are multibyte-character strings. проверяет свои параметры. validates its parameters. Если str или стрсеарч имеет значение null, вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров .If str or strSearch is NULL, the invalid parameter handler is invoked, as described in Parameter Validation . Если выполнение может быть продолжено, присваивает свойству значение еинвал и возвращает значение 0.If execution is allowed to continue, sets to EINVAL and returns 0. Функции и не проверяют свои параметры. and do not validate their parameters. В остальном эти три функции ведут себя идентично.These three functions behave identically otherwise.

Важно!

Эти функции могут создать угрозу в связи с проблемой переполнения буфера.These functions might incur a threat from a buffer overrun problem. Проблемы переполнения буфера могут использоваться для атаки на систему, поскольку они могут допустить выполнение произвольного кода, приводящего к несанкционированному повышению прав доступа.Buffer overrun problems can be used to attack a system because they can allow the execution of arbitrary code, which can cause an unwarranted elevation of privilege. Дополнительные сведения см. в разделе Как избежать переполнения буфера.For more information, see Avoiding Buffer Overruns.

В C эти функции принимают указатель на первый аргумент.In C, these functions take a pointer for the first argument. В языке C++ доступны две перегрузки.In C++, two overloads are available. Перегрузка, которая принимает указатель на, возвращает указатель на ; версия, которая принимает указатель на, не возвращает указатель на значение, отличное от .The overload that takes a pointer to returns a pointer to ; the version that takes a pointer to non- returns a pointer to non-. Макрос _CRT_CONST_CORRECT_OVERLOADS определяется, если доступны и не версии этих функций.The macro _CRT_CONST_CORRECT_OVERLOADS is defined if both the and non- versions of these functions are available. Если требуется не поведение обеих перегрузок C++, определите символ _CONST_RETURN.If you require the non- behavior for both C++ overloads, define the symbol _CONST_RETURN.

На выходное значение влияет настройка категории locale LC_CTYPE; Дополнительные сведения см. в разделе setlocale, _wsetlocale.The output value is affected by the locale-category setting of LC_CTYPE; for more information, see setlocale, _wsetlocale. Версии этих функций, не имеющие суффикса _l , используют текущий языковой стандарт для этого поведения, зависящего от языкового стандарта. версии с суффиксом _l идентичны, за исключением того, что вместо них используется переданный параметр языкового стандарта.The versions of these functions that do not have the _l suffix use the current locale for this locale-dependent behavior; the versions that have the _l suffix are identical except that they instead use the locale parameter that’s passed in. Для получения дополнительной информации см. Locale.For more information, see Locale.

По умолчанию глобальное состояние этой функции ограничивается приложением.By default, this function’s global state is scoped to the application. Чтобы изменить это, см. раздел глобальное состояние в CRT.To change this, see Global state in the CRT.

Универсальное текстовое сопоставление функцийGeneric-Text Routine Mappings

Подпрограмма TCHAR.HTCHAR.H routine _UNICODE и _MBCS не определены_UNICODE & _MBCS not defined _MBCS определено_MBCS defined _UNICODE определено_UNICODE defined
н/дn/a н/дn/a н/дn/a
Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

Adblock
detector