_memccpy

Copia los caracteres de un búfer.

Sintaxis

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

Parámetros

dest
Puntero al destino.

src
Puntero al origen.

c
Último carácter que se va a copiar.

count
Número de caracteres.

Valor devuelto

Si se copia el carácter c , _memccpy devuelve un puntero al carácter de dest que sigue inmediatamente al carácter. Si c no se copia, devuelve NULL.

Comentarios

La _memccpy función copia cero o más caracteres de src en dest, que se detiene cuando se ha copiado el carácter c o cuando count se han copiado los caracteres, lo que ocurra primero.

Nota de seguridad Asegúrese de que el búfer de destino sea del mismo tamaño o mayor que el búfer de origen. Para obtener más información, consulte Evitar saturaciones del búfer.

Requisitos

Routine	Encabezado necesario
_memccpy	<memory.h> o <string.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Ejemplo

// 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 ) );
}

Output

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

Consulte también

Manipulación del búfer
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset