int pthread_create(pthread_t *restrict thread, const pthread_attr_t *restrict attr, void *(*start_routine)(void*), void *restrict arg);
I would like to know what the meaning of restrict is?
In the C programming language, restrict is a keyword, introduced by the C99 standard, that can be used in pointer declarations. By adding this type qualifier, a programmer hints to the compiler that for the lifetime of the pointer, no other pointer will be used to access the object to which it points.
The restrict qualifier can be used in the declaration of a structure member. A compiler can assume, when an identifier is declared that provides a means of access to an object of that structure type, that the member provides the sole initial means of access to an object of the type specified in the member declaration.
It's something introduced in C99 which lets the compiler know that the pointer passed in there isn't pointing to the same place as any other pointers in the arguments. If you give this hint to the compiler, it can do some more aggressive optimizations without breaking code.
As an example, consider this function:
int add(int *a, int *b) { return *a + *b; }
Obviously, it adds two numbers from pointers. We can use it like this if we want:
// includes excluded for brevity int main(int argc, char **argv) { int number=4; printf("%d\n", add(&number, &number)); return 0; }
Obviously, it will output 8; it's adding 4 to itself. However, if we add restrict
to add
like so:
int add(int *restrict a, int *restrict b) { return *a + *b; }
Then the previous main
is now invalid; it's passing &number
as both arguments. You may, however, pass in two pointers pointing to different places.
int main(int argc, char **argv) { int numberA=4; int numberB=4; printf("%d\n", add(&numberA, &numberB)); return 0; }
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With