_CrtSetDebugFillThreshold

Извлекает или изменяет поведение, управляющее порогом заполнения буфера в функциях отладки.

Синтаксис

size_t _CrtSetDebugFillThreshold( size_t newThreshold );

Параметры

newThreshold
Новый размер порогового значения в байтах.

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

Предыдущее пороговое значение.

Замечания

Отладочные версии некоторых функций CRT, улучшенных с безопасностью, заполняют буфер, переданный им специальным символом (0xFE). Этот символ заливки помогает найти случаи, когда неверный размер был передан функции. К сожалению, это также снижает производительность. Чтобы повысить производительность, используйте _CrtSetDebugFillThreshold для отключения заполнения буфера для буферов, превышающих пороговое newThreshold значение. Значение newThreshold 0 отключает его для всех буферов.

Пороговое значение по умолчанию — SIZE_T_MAX.

Ниже приведен список затронутых функций:

• asctime_s, _wasctime_s

• _cgets_s, _cgetws_s

• ctime_s, , _ctime32_s_wctime_s_ctime64_s_wctime32_s,_wctime64_s

• _ecvt_s

• _fcvt_s

• _gcvt_s

• _itoa_s, _ltoa_s, _ultoa_s_i64toa_s_ui64toa_s_itow_s_ltow_s_ultow_s_i64tow_s_ui64tow_s

• _makepath_s, _wmakepath_s

• _mbsnbcat_s, _mbsnbcat_s_l

• _mbsnbcpy_s, _mbsnbcpy_s_l

• _mbsnbset_s, _mbsnbset_s_l

• _mktemp_s, _wmktemp_s

• _splitpath_s, _wsplitpath_s

• strcat_s, , wcscat_s_mbscat_s

• strcpy_s, , wcscpy_s_mbscpy_s

• _strdate_s, _wstrdate_s

• strerror_s, , _strerror_s_wcserror_s__wcserror_s

• _strlwr_s, , _strlwr_s_l_mbslwr_s_l_mbslwr_s_wcslwr_s,_wcslwr_s_l

• strncat_s, , _strncat_s_l_wcsncat_s_lwcsncat_s_mbsncat_s,_mbsncat_s_l

• strncpy_s, , _strncpy_s_l_wcsncpy_s_lwcsncpy_s_mbsncpy_s,_mbsncpy_s_l

• _strnset_s, , _strnset_s_l_wcsnset_s_l_wcsnset_s_mbsnset_s,_mbsnset_s_l

• _strset_s, , _strset_s_l_wcsset_s_l_wcsset_s_mbsset_s,_mbsset_s_l

• _strtime_s, _wstrtime_s

• _strupr_s, , _strupr_s_l_mbsupr_s_l_mbsupr_s_wcsupr_s,_wcsupr_s_l

Требования

Маршрут	Обязательный заголовок
_CrtSetDebugFillThreshold	<crtdbg.h>

Эта функция связана с корпорацией Майкрософт. Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Отладка версий только библиотек времени выполнения C.

Пример

// crt_crtsetdebugfillthreshold.c
// compile with: cl /MTd crt_crtsetdebugfillthreshold.c
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <crtdbg.h>

void Clear( char buff[], size_t size )
{
   for( int i=0; i<size; ++i )
      buff[i] = 0;
}

void Print( char buff[], size_t size )
{
   for( int i=0; i<size; ++i )
      printf( "%02x  %c\n", (unsigned char)buff[i], buff[i] );
}

int main( void )
{
   char buff[10];

   printf( "With buffer-filling on:\n" );
   strcpy_s( buff, _countof(buff), "howdy" );
   Print( buff, _countof(buff) );

   _CrtSetDebugFillThreshold( 0 );

   printf( "With buffer-filling off:\n" );
   Clear( buff, _countof(buff) );
   strcpy_s( buff, _countof(buff), "howdy" );
   Print( buff, _countof(buff) );
}

With buffer-filling on:
68  h
6f  o
77  w
64  d
79  y
00
fe  ■
fe  ■
fe  ■
fe  ■
With buffer-filling off:
68  h
6f  o
77  w
64  d
79  y
00
00
00
00
00

См. также

Отладка подпрограмм