Função StrDupA (shlwapi.h)

Duplica uma cadeia de caracteres.

Sintaxe

PSTR StrDupA(
  PCSTR pszSrch
);

Parâmetros

pszSrch

Tipo: PCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo constante.

Retornar valor

Tipo: PTSTR

Retorna o endereço da cadeia de caracteres que foi copiada ou NULL se a cadeia de caracteres não puder ser copiada.

Comentários

StrDup alocará o armazenamento do tamanho da cadeia de caracteres original. Se a alocação de armazenamento for bem-sucedida, a cadeia de caracteres original será copiada para a cadeia de caracteres duplicada.

Essa função usa LocalAlloc para alocar espaço de armazenamento para a cópia da cadeia de caracteres. O aplicativo de chamada deve liberar essa memória chamando a função LocalFree no ponteiro retornado pela chamada para StrDup.

Exemplos

Este aplicativo de console simples ilustra o uso de StrDup.

#include <windows.h>
#include <shlwapi.h>
#include <stdio.h>

void main(void)
{
   char buffer[] = "This is the buffer text";
   char *newstring;

   // Note: Never use an unbounded %s format specifier in printf.
   printf("Original: %25s\n", buffer);

   newstring = StrDup(buffer);
   if (newstring != NULL)
   {
       printf("Copy:     %25s\n", newstring);
       LocalFree(newstring);
   }
}

OUTPUT:
- - - - - - 
Original: This is the buffer text
Copy:     This is the buffer text

Requisitos