_memccpy

從緩衝區複製字元。

語法

void *_memccpy(
   void *dest,
   const void *src,
   int c,
   size_t count
);

參數

dest
目的地的指標。

src
來源的指標。

c
要複製的最後一個字元。

count
字元數。

傳回值

如果複製字元 c ， _memccpy 則會傳回字元緊接在 dest 字元後面的字元指標。 如果未 c 複製，則會傳 NULL 回 。

備註

函 _memccpy 式會將 的零或多個字元 srcdest 複製到 ，在複製字元 c 時或複製字元時 count 停止，以第一個字元為准。

安全性提示：確定目的緩衝區與來源緩衝區是相同大小，或大於來源緩衝區。 如需詳細資訊，請參閱 避免緩衝區溢位。

規格需求

常式傳回的值	必要的標頭
_memccpy	<memory.h > 或 < string.h>

如需詳細的相容性資訊，請參閱 Compatibility。

程式庫

所有版本的 C 執行階段程式庫。

範例

// crt_memccpy.c

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

char string1[60] = "The quick brown dog jumps over the lazy fox";

int main( void )
{
   char buffer[61];
   char *pdest;

   printf( "Function: _memccpy 60 characters or to character 's'\n" );
   printf( "Source: %s\n", string1 );
   pdest = _memccpy( buffer, string1, 's', 60 );
   *pdest = '\0';
   printf( "Result: %s\n", buffer );
   printf( "Length: %d characters\n", strlen( buffer ) );
}

輸出

Function: _memccpy 60 characters or to character 's'
Source: The quick brown dog jumps over the lazy fox
Result: The quick brown dog jumps
Length: 25 characters

另請參閱

緩衝區操作
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset