_CrtSetDebugFillThreshold

Mengambil atau memodifikasi ambang batas yang mengontrol perilaku pengisian buffer dalam fungsi debug.

Sintaks

size_t _CrtSetDebugFillThreshold( size_t newThreshold );

Parameter

newThreshold
Ukuran ambang batas baru dalam byte.

Nilai hasil

Nilai ambang sebelumnya.

Keterangan

Versi debug dari beberapa fungsi CRT yang ditingkatkan keamanan mengisi buffer yang diteruskan kepada mereka dengan karakter khusus (0xFE). Karakter isian ini membantu menemukan kasus di mana ukuran yang salah diteruskan ke fungsi. Sayangnya, itu juga mengurangi performa. Untuk meningkatkan performa, gunakan _CrtSetDebugFillThreshold untuk menonaktifkan pengisian buffer untuk buffer yang lebih besar dari newThreshold ambang batas. Nilai newThreshold 0 menonaktifkannya untuk semua buffer.

Ambang defaultnya adalah SIZE_T_MAX.

Berikut adalah daftar fungsi yang terpengaruh:

• asctime_s, _wasctime_s

• _cgets_s, _cgetws_s

• ctime_s, _ctime32_s, _ctime64_s, _wctime_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, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l

• strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l

• strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l

• _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l, _mbsnset_s, _mbsnset_s_l

• _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l

• _strtime_s, _wstrtime_s

• _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Persyaratan

Rutin	Header yang diperlukan
_CrtSetDebugFillThreshold	<crtdbg.h>

Fungsi ini khusus Microsoft. Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Debug versi pustaka run-time C saja.

Contoh

// 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

Baca juga

Rutinitas debug