`_set_new_mode`

Artikel
10/12/2023

new Mengatur mode handler untuk malloc.

Sintaks

int _set_new_mode( int newhandlermode );

Parameter

newhandlermode
new mode handler untuk malloc; nilai yang valid adalah 0 atau 1.

Nilai hasil

Mengembalikan set mode handler sebelumnya untuk malloc. Nilai pengembalian 1 menunjukkan bahwa, pada kegagalan mengalokasikan memori, malloc sebelumnya disebut new rutinitas handler; nilai pengembalian 0 menunjukkan bahwa itu tidak. newhandlermode Jika argumen tidak sama dengan 0 atau 1, mengembalikan -1.

Keterangan

Fungsi C++ _set_new_mode mengatur new mode handler untuk malloc. Mode new handler menunjukkan apakah, jika gagal, malloc adalah memanggil new rutinitas handler seperti yang ditetapkan oleh _set_new_handler. Secara default, malloc tidak memanggil new rutinitas handler saat gagal mengalokasikan memori. Anda dapat mengambil alih perilaku default ini sehingga, ketika malloc gagal mengalokasikan memori, malloc memanggil new rutinitas handler dengan cara yang sama seperti yang new dilakukan operator ketika gagal karena alasan yang sama. Untuk informasi selengkapnya, lihat new operator dan delete di Referensi Bahasa C++. Untuk mengambil alih default, panggil:

_set_new_mode(1);

di awal program Anda atau tautan dengan Newmode.obj (lihat Opsi tautan).

Fungsi ini memvalidasi parameternya. Jika newhandlermode ada selain 0 atau 1, fungsi memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, _set_new_mode mengembalikan -1 dan mengatur errno ke EINVAL.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan
`_set_new_mode`	<new.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.