_tempnam_dbg
, _wtempnam_dbg
Versões de função de , , , que usam a versão de depuração de malloc
_tempnam
, . _malloc_dbg
_wtempnam
tmpnam
_wtmpnam
Sintaxe
char *_tempnam_dbg(
const char *dir,
const char *prefix,
int blockType,
const char *filename,
int linenumber
);
wchar_t *_wtempnam_dbg(
const wchar_t *dir,
const wchar_t *prefix,
int blockType,
const char *filename,
int linenumber
);
Parâmetros
dir
O caminho usado no nome do arquivo se não houver nenhuma variável de ambiente TMP ou se TMP não for um diretório válido.
prefix
A cadeia de caracteres que será pré-anexada a nomes retornados pelo _tempnam
.
blockType
Tipo solicitado de bloco de memória: _CLIENT_BLOCK
ou _NORMAL_BLOCK
.
filename
Nome do ponteiro do arquivo de origem que solicitou a operação de alocação ou NULL
.
linenumber
Número da linha no arquivo de origem em que a operação de alocação foi solicitada ou NULL
.
Retornar valor
Cada função retorna um ponteiro para o nome gerado ou NULL
se houver uma falha. A falha pode ocorrer se houver um nome de diretório inválido especificado na variável de ambiente TMP e no dir
parâmetro.
Observação
free
(ou free_dbg
) não precisa ser chamado para ponteiros alocados por _tempnam_dbg
e _wtempnam_dbg
.
Comentários
As _tempnam_dbg
funções e são idênticas a e exceto que, quando _DEBUG
é definido, essas funções usam a _tempnam
versão de depuração de malloc
e _malloc_dbg
_wtempnam_dbg
_wtempnam
, para alocar memória se NULL
for passada como o primeiro parâmetro. Para obter mais informações, consulte _malloc_dbg
.
Você não precisa chamar essas funções explicitamente na maioria dos casos. Em vez disso, você pode definir o sinalizador _CRTDBG_MAP_ALLOC
. Quando _CRTDBG_MAP_ALLOC
é definido, as chamadas a _tempnam
e _wtempnam
são remapeadas para _tempnam_dbg
e _wtempnam_dbg
, respectivamente, com o blockType
definido como _NORMAL_BLOCK
. Assim, você não precisa chamar essas funções explicitamente, a menos que queira marcar os blocos de heap como _CLIENT_BLOCK
. Para obter mais informações, consulte Tipos de blocos no heap de depuração.
Mapeamentos de rotina de texto genérico
Rotina TCHAR.H | _UNICODE e _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_ttempnam_dbg |
_tempnam_dbg |
_tempnam_dbg |
_wtempnam_dbg |
Requisitos
Rotina | Cabeçalho necessário |
---|---|
_tempnam_dbg , _wtempnam_dbg |
<crtdbg.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Confira também
_tempnam
, _wtempnam
, tmpnam
, _wtmpnam
E/S de fluxo
Versões de depuração das funções de alocação de heap
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de