TMPNAM(3)

NOME
tmpnam - cria um nome para um arquivo temporário

SINÓPSE
#include <stdio.h>

char *tmpnam(char *s);

DESCRIÇÃO
A função tmpnam() retorna um indicador para uma seqüencia que é um nome de arquivo válido, de modo que tal arquivo com este nome não exista em um mesmo ponto do tempo, para que programadores ingenuos possam considerá-lo como um nome adequado para um arquivo temporário. Se o argumento s for NULO, este será gerado em um 'buffer' estático interno e pode ser sobre-escrito na próxima chamada à tmpnam(). Se s não for NULO, o nome é copiado para a matriz de caracteres (de tamanho L_tmpnam pelo menos) indicado por s e o valor s é retornado em caso de sucesso.

O nome do caminho é criado, tem um prefixo de diretório P_tmpdir. (Ambos L_tmpnam e P_tmpdir são definidos em <stdio.h>, assim como TMP_MAX mencionada abaixo.)

VALORES RETORNADOS
A função tmpnam() retorna um indicador para um nome e arquivo temporário único, ou NULO se um nome não pode ser gerado.

ERROS
Erros não estão definidos.

NOTAS
Aplicações portáveis que utilizam 'threads' não podem usar tmpnam() com o parâmetro NULL se _POSIX_THREAD_SAFE_FUNCTIONS ou _POSIX_THREADS estiver definida.

A função tmpnam() gerá uma seqüencia diferente a cada vez que é chamada, até TMP_MAX vezes. Se for chamada mais do que TMP_MAX vezes, o comportamento é definido pela implementação.

PROBLEMAS
Nunca use esta função. Use mkstemp(3) no lugar.

DE ACORDO COM
SVID 2, POSIX, BSD 4.3, ISO 9899.

VEJA TAMBÉM
mktemp(3), mkstemp(3), tempnam(3), tmpfile(3).

TRADUZIDO POR LPD-BR em 08/06/2001.

  Tradução:
Daniel Chicayban <daniel@chicayban.com.br>

  Revisão.:
Ricardo C.O.Freitas <english.quest@best-service.com>