strncpy, _strncpy_l, wcsncpy, , _wcsncpy_l, _mbsncpy, _mbsncpy_l

Bir dizenin karakterlerini başka bir dizeye kopyalayın. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. strncpy_s, _strncpy_s_l, wcsncpy_s_wcsncpy_s_l, , _mbsncpy_s, _mbsncpy_s_l.

Sözdizimi

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

Parametreler

strDest
Hedef dize.

strSource
Kaynak dize.

count
Kopyalanacak karakter sayısı.

locale
Kullanılacak yerel ayar.

Dönüş değeri

strDest döndürür. Hata belirtmek için hiçbir dönüş değeri ayrılmaz.

Açıklamalar

İşlev, öğesinin ilk count karakterlerini strSource öğesine strDest kopyalar ve döndürürstrDest.strncpy değerinden strSourceküçük veya uzunluğuna eşitsecount, kopyalanan dizeye otomatik olarak bir null karakter eklenmez. değerinden strSourcebüyüksecount, hedef dize uzunluğuna countkadar null karakterlerle doldurulur. Kaynak ve hedef dizeler çakışıyorsa, öğesinin davranışı strncpy tanımlanmamıştır.

veya strSource bir işaretçiyse strDest veya sıfırdan küçükse veya sıfıra eşitsecount, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi NULL çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler -1 döndürür ve olarak EINVALayarlanırerrno.

wcsncpy ve _mbsncpy geniş karakterli ve çok baytlı sürümleridir strncpy. bağımsız değişkenleri ve dönüş değeri wcsncpy ve _mbsncpy buna göre değişir. Bu altı işlev aynı şekilde davranır.

Bu işlevlerin sonekli _l sürümleri aynıdır, ancak yerel ayara bağımlı davranışları için geçerli yerel ayar yerine geçirilen yerel ayarı kullanırlar. Daha fazla bilgi için bkz . Yerel Ayar.

C++ dilinde, bu işlevlerin daha yeni ve güvenli karşılıklarını çağıran şablon aşırı yüklemeleri vardır. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

Gereksinimler

Daha fazla platform uyumluluğu bilgisi için bkz . Uyumluluk.

Örnek

Aşağıdaki örnekte, program hatalarına strncpy ve güvenlik sorunlarına neden olmak için kullanımı ve nasıl kötüye kullanılıp kullanılamayabileceği gösterilmektedir. Derleyici her çağrı strncpy için şuna benzer crt_strncpy_x86.c(15) bir uyarı oluşturur: uyarı C4996: 'strncpy': Bu işlev veya değişken güvenli olmayabilir. Bunun yerine kullanmayı strncpy_s göz önünde bulundurun. Kullanımdan kaldırmayı devre dışı bırakmak için kullanın _CRT_SECURE_NO_WARNINGS. Ayrıntılar için çevrimiçi yardıma bakın.

// 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.
}

Çıktı

ZZ
aa bb dd
this is a very long test
dogs like cats
dogs like to chase cars.
Buffer overrun: s = 'ars.' (should be 'test')

Otomatik değişkenlerin düzeni ve hata algılama ve kod koruması düzeyi, değiştirilen derleyici ayarlarına göre farklılık gösterebilir. Bu örnek, diğer derleme ortamlarında veya diğer derleyici seçeneklerinde yerleşik olarak kullanıldığında farklı sonuçlara sahip olabilir.

Ayrıca bkz.

Dize işleme
Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması
_mbsnbcpy, _mbsnbcpy_l
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strcpy, wcscpy, _mbscpy
strncat, _strncat_l, wcsncat, , _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, , _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
_strset, _strset_l, _wcsset, , _wcsset_l, _mbsset, _mbsset_l
strspn, wcsspn, _mbsspn, _mbsspn_l
strncpy_s, _strncpy_s_l, wcsncpy_s, , _wcsncpy_s_l, _mbsncpy_s, _mbsncpy_s_l
strcpy_s, wcscpy_s, _mbscpy_s