Função StrDupA (shlwapi.h)

Artigo
11/20/2024

Duplica uma cadeia de caracteres.

Sintaxe

PSTR StrDupA(
  PCSTR pszSrch
);

Parâmetros

pszSrch

Tipo: PCTSTR

Um ponteiro para uma constante cadeia de caracteres nulaterminada.

Valor de retorno

Tipo: PTSTR

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

Observações

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

Nota

O cabeçalho shlwapi.h define StrDup como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 4.71 ou posterior)

Compartilhar via