CKTIS / C
memchr — generieke C23-bytezoekfunctie
De generieke C23-functie `memchr(s, c, n)` uit `<string.h>` zoekt onder de eerste `n` bytes van het object bij `s` de eerste byte die gelijk is aan `c` na omzetting naar `unsigned char`. Zij retourneert een pointer precies naar de eerste overeenkomst of null; de implementatie moet zich gedragen als sequentieel lezen dat bij de overeenkomst meteen stopt.
Versie: C23
Syntax
QVoid *memchr(QVoid *s, int c, size_t n);De generieke C23-functie memchr(s, c, n) uit <string.h> zoekt onder de eerste n bytes van het object bij s de eerste byte die gelijk is aan c na omzetting naar unsigned char. Zij retourneert een pointer precies naar de eerste overeenkomst of null; de implementatie moet zich gedragen als sequentieel lezen dat bij de overeenkomst meteen stopt.
Het voorbeeld doorzoekt een array van vier bytes met twee bytes 0x42. De echte aanroep retourneert de eerste overeenkomst, zodat pointerverschil en gelezen byte 1 42 opleveren in plaats van slechts een Boolean.
memchr zoekt geen afsluiter en kan binaire gegevens met nulbytes onderzoeken, maar n mag niet buiten het toegankelijke object lopen; zelfs bij n == 0 vereist C23 nog een geldige pointerwaarde. C23 behoudt de const-kwalificatie van de doorzochte array in het resultaattype en accepteert hier geen volatile- of restrict-elementen; onderdrukken van een mogelijk macro maakt de concrete externe functie zichtbaar, maar dat gebruik is obsolescent.
Voorbeelden
#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;}
Resultaat
1 42
Het voorbeeld doorzoekt een array van vier bytes met twee bytes `0x42`. De echte aanroep retourneert de eerste overeenkomst, zodat pointerverschil en gelezen byte `1 42` opleveren in plaats van slechts een Boolean.