strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

Articolo
03/26/2013

I caratteri della copia di una stringa a un altro.Più versioni sicure di queste funzioni sono disponibili, vedere strncpy_s, _strncpy_s_l, wcsncpy_s, _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l.

Importante
_mbsncpy e _mbsncpy_l non possono essere utilizzati nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

char *strncpy(
   char *strDest,
   const char *strSource,
   size_t count 
);
char *_strncpy_l(
   char *strDest,
   const char *strSource,
   size_t count,
   locale_t locale 
);
wchar_t *wcsncpy(
   wchar_t *strDest,
   const wchar_t *strSource,
   size_t count 
);
wchar_t *_wcsncpy_l(
   wchar_t *strDest,
   const wchar_t *strSource,
   size_t count,
   locale_t locale 
);
unsigned char *_mbsncpy(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count 
);
unsigned char *_mbsncpy_l(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
char *strncpy(
   char (&strDest)[size],
   const char *strSource,
   size_t count 
); // C++ only
template <size_t size>
char *_strncpy_l(
   char (&strDest)[size],
   const char *strSource,
   size_t count,
   locale_t locale 
); // C++ only
template <size_t size>
wchar_t *wcsncpy(
   wchar_t (&strDest)[size],
   const wchar_t *strSource,
   size_t count 
); // C++ only
template <size_t size>
wchar_t *_wcsncpy_l(
   wchar_t (&strDest)[size],
   const wchar_t *strSource,
   size_t count,
   locale_t locale 
); // C++ only
template <size_t size>
unsigned char *_mbsncpy(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsncpy_l(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
); // C++ only

Parametri

strDest
Stringa di destinazione.
strSource
Stringa di origine.
count
Numero di caratteri da copiare.
locale
Impostazioni locali da utilizzare.

Valore restituito

Restituisca il valore strDest.Nessun valore restituito è riservato per indicare un errore.

Note

La funzione di strncpy copia i caratteri iniziali di count di strSource a strDest e restituisce strDest.Se count è minore o uguale alla lunghezza di strSource, un carattere null non viene aggiunto automaticamente alla stringa copiata.Se count è maggiore della lunghezza di strSource, la stringa di destinazione viene completata con i caratteri null fino alla lunghezza count.Il comportamento di strncpy non è definito se le stringhe di origine e di destinazione si sovrappongono.

Nota sulla sicurezza
strncpy non controlla se uno spazio sufficiente in strDest; ciò rende una causa potenziale dei sovraccarichi del buffer.L'argomento di count limita il numero di caratteri copiato, non è un limite di dimensione di strDest.Vedere l'esempio che segue.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

Se strDest o strSource è un puntatore di NULL, o se count è minore o uguale a zero, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono -1 e errno impostato su EINVAL

wcsncpy e _mbsncpy sono versioni a caratteri di tipo "wide" e di caratteri multibyte di strncpy.Gli argomenti e il valore restituito di wcsncpy e _mbsncpy variano di conseguenza.Queste ultime sei funzioni si comportano in modo identico in caso contrario.

Le versioni di queste funzioni con il suffisso _l sono identiche ma utilizzano le impostazioni locali passate anziché le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali.Per ulteriori informazioni, vedere Impostazioni locali.

In C++, queste funzioni hanno modelli di overload che invocano le più recenti, controparti sicure di queste.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsncpy	strncpy	_mbsnbcpy	wcsncpy
_tcsncpy_l	_strncpy_l	_mbsnbcpy_l	_wcsncpy_l

[!NOTA]

_strncpy_l e _wcsncpy_l non dispongono di dipendenza delle impostazioni locali; vengono forniti solo per _tcsncpy_l e non possono essere chiamati direttamente.

Requisiti

Routine	Intestazione obbligatoria
strncpy	<string.h>
wcsncpy	<string.h> o <wchar.h>
_mbsncpy, _mbsncpy_l	<mbstring.h>

Per informazioni di compatibilità aggiuntive della piattaforma, vedere Compatibilità.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di strncpy e come può essere l'utilizzo improprio di per determinare i bug e i problemi di sicurezza del programma.Il compilatore genera un avviso per ogni chiamata a strncpy simile all'crt_strncpy_x86.c(15) : warning C4996: 'strncpy': This function or variable may be unsafe. Consider using strncpy_s instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details.

// crt_strncpy_x86.c
// Use this command in an x86 developer command prompt to compile: 
// cl /TC /W3 crt_strncpy_x86.c

#include <stdio.h>
#include <string.h>

int main() {
   char t[20];
   char s[20];
   char *p = 0, *q = 0;

   strcpy_s(s, sizeof(s), "AA BB CC");
   // Note: strncpy is deprecated; consider using strncpy_s instead
   strncpy(s, "aa", 2);     // "aa BB CC"         C4996
   strncpy(s + 3, "bb", 2); // "aa bb CC"         C4996
   strncpy(s, "ZZ", 3);     // "ZZ",              C4996
                            // count greater than strSource, null added
   printf("%s\n", s);

   strcpy_s(s, sizeof(s), "AA BB CC");
   p = strstr(s, "BB");
   q = strstr(s, "CC");
   strncpy(s, "aa", p - s - 1);   // "aa BB CC"   C4996
   strncpy(p, "bb", q - p - 1);   // "aa bb CC"   C4996
   strncpy(q, "cc",  q - s);      // "aa bb cc"   C4996
   strncpy(q, "dd", strlen(q));   // "aa bb dd"   C4996
   printf("%s\n", s);

   // some problems with strncpy
   strcpy_s(s, sizeof(s), "test");
   strncpy(t, "this is a very long string", 20 ); // C4996
   // Danger: at this point, t has no terminating null,
   // so the printf continues until it runs into one.
   // In this case, it will print "this is a very long test"
   printf("%s\n", t);

   strcpy_s(t, sizeof(t), "dogs like cats");
   printf("%s\n", t);

   strncpy(t + 10, "to chase cars.", 14); // C4996
   printf("%s\n", t);

   // strncpy has caused a buffer overrun and corrupted string s
   printf("Buffer overrun: s = '%s' (should be 'test')\n", s);
   // Since the stack grows from higher to lower addresses, buffer
   // overruns can corrupt function return addresses on the stack,
   // which can be exploited to run arbitrary code.
}

Output

Il layout delle variabili automatiche e di rilevamento degli errori e di protezione di codice può variare in base alle impostazioni modificate del compilatore.Questo esempio può produrre risultati diversi una volta incorporato altri ambienti di compilazione o con altre opzioni del compilatore.