Funzione StrDupA (shlwapi.h)

Duplica una stringa.

Sintassi

PSTR StrDupA(
  PCSTR pszSrch
);

Parametri

pszSrch

Tipo: PCTSTR

Puntatore a una costante nullstringa di caratteri con terminazione.

Valore restituito

Tipo: PTSTR

Restituisce l'indirizzo della stringa copiata oppure NULL se non è possibile copiare la stringa.

Osservazioni

StrDup allocherà le dimensioni della stringa originale. Se l'allocazione di archiviazione ha esito positivo, la stringa originale viene copiata nella stringa duplicata.

Questa funzione usa LocalAlloc per allocare spazio di archiviazione per la copia della stringa. L'applicazione chiamante deve liberare questa memoria chiamando la funzione LocalFree sul puntatore restituito dalla chiamata a StrDup.

Esempi

Questa semplice applicazione console illustra l'uso di 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

Fabbisogno