Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

memchr — pesquisa genérica de byte C23

A função genérica C23 `memchr(s, c, n)` de `<string.h>` localiza, nos primeiros `n` bytes do objeto em `s`, o primeiro byte igual a `c` depois da conversão para `unsigned char`. Devolve um ponteiro exatamente para a primeira ocorrência ou null; a implementação deve comportar-se como leitura sequencial que para logo ao encontrar.

Versão: C23

Sintaxe

QVoid *memchr(QVoid *s, int c, size_t n);

A função genérica C23 memchr(s, c, n) de <string.h> localiza, nos primeiros n bytes do objeto em s, o primeiro byte igual a c depois da conversão para unsigned char. Devolve um ponteiro exatamente para a primeira ocorrência ou null; a implementação deve comportar-se como leitura sequencial que para logo ao encontrar.

O exemplo pesquisa um array de quatro bytes que contém dois bytes 0x42. A chamada real devolve a primeira ocorrência, pelo que a diferença de ponteiros e o byte lido produzem 1 42, não apenas um booleano.

memchr não procura terminador e pode examinar dados binários com bytes zero, mas n não pode ultrapassar o objeto acessível; mesmo com n == 0, C23 ainda exige um valor de ponteiro válido. C23 preserva a qualificação const do array pesquisado no tipo do resultado e não aceita aqui elementos volatile ou restrict; suprimir um possível macro expõe a função externa concreta, mas esse uso é obsolescente.

Exemplos

#include <stddef.h>
#include <stdio.h>
#include <string.h>
int main(void){const unsigned char data[]={0x10,0x42,0x42,0x20};const unsigned char *hit=memchr(data,0x42,sizeof data);printf("%td %02X\n",hit-data,(unsigned)*hit);return 0;}

Resultado

1 42

O exemplo pesquisa um array de quatro bytes que contém dois bytes `0x42`. A chamada real devolve a primeira ocorrência, pelo que a diferença de ponteiros e o byte lido produzem `1 42`, não apenas um booleano.

Fontes