_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停止，無論哪一個字元都先傳回。

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

需求

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

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

程式庫

所有版本的 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