Share via


_memccpy

Copie des caractères à partir de la mémoire tampon.

Syntaxe

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

Paramètres

dest
Pointeur désignant la destination.

src
Pointeur désignant la source.

c
Dernier caractère à copier.

count
Nombre de caractères.

Valeur retournée

Si le caractère c est copié, _memccpy retourne un pointeur vers le char qui dest suit immédiatement le caractère. Si c elle n’est pas copiée, elle retourne NULL.

Notes

La _memccpy fonction copie zéro ou plus de srcdestcaractères, ce qui s’arrête lorsque le caractère c a été copié ou lorsque count des caractères ont été copiés, selon ce qui se produit en premier.

Remarque relative à la sécurité Vérifiez que la mémoire tampon de destination est d’une taille identique ou supérieure à celle de la mémoire tampon source. Pour plus d’informations, consultez Éviter les dépassements de mémoire tampon.

Spécifications

Routine En-tête requis
_memccpy <memory.h> ou <string.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

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

Sortie

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

Voir aussi

Manipulation des mémoires tampons
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset