Flexible array member

Flexible array member[1] is a feature introduced in the C99 standard of the C programming language (in particular, in section ยง6.7.2.1, item 16, page 103).[2] It is a member of a struct, which is an array without a given dimension, and it should be the last member of such a struct, as in the following example:

struct double_vector_st {
    unsigned length;
    double array[]; // the flexible array member should be last
};

The sizeof operator on such a struct is required to give the offset of the flexible array member. When allocating such structures on the heap, it is generally required to reserve some space for the flexible array member, as in the following example:

struct double_vector_st *allocate_double_vector(unsigned len) {
   struct double_vector_st *vec = malloc(sizeof *vec + len * sizeof vec->array[0]);

   if (!vec) {
       perror("malloc double_vector_st failed");
       exit(EXIT_FAILURE);
   }

   vec->length = len;

   for (unsigned ix = 0; ix < len; ix++)
       vec->array[ix] = 0.0;

   return vec;
}

When using structures with a flexible array member, some convention regarding the actual size of that member should be defined. In the example above, the convention is that the member array has length double-precision numbers.

In previous standards of the C language, it was common to declare a zero-sized array member instead of a flexible array member. The GCC compiler explicitly accepts zero-sized arrays for such purposes.[3]

C++ does not have flexible array members.

References

This article is issued from Wikipedia - version of the Monday, September 07, 2015. The text is available under the Creative Commons Attribution/Share Alike but additional terms may apply for the media files.