ellipsis‿token‿array Struct Reference

A structure with a flexible array member of base type ellipsis‿token‿array‿base. More...

#include <ellipsis-tarray.h>

Collaboration diagram for ellipsis‿token‿array:

Public Member Functions
ellipsis‿token‿array *	ellipsis‿token‿array‿alloc‿_Ctra (size_t len)
	Allocate a ellipsis‿token‿array with elements as given by the parameter.
ellipsis‿token‿array *	ellipsis‿token‿array‿alloc‿_Insta (size_t len)
	Allocate a ellipsis‿token‿array with elements as given by the parameter.
ellipsis‿token‿array *	ellipsis‿token‿array‿alloc (size_t len)
	Allocate a ellipsis‿token‿array with elements as given by the parameter.
ellipsis‿token‿array *	ellipsis‿token‿array‿append‿_Ctra (ellipsis‿token‿array *restrict s, ellipsis‿token‿array‿base c)
	Append a new element to a ellipsis‿token‿array and return a new object.
ellipsis‿token‿array *	ellipsis‿token‿array‿append‿_Insta (ellipsis‿token‿array *restrict s, ellipsis‿token‿array‿base c)
	Append a new element to a ellipsis‿token‿array and return a new object.
ellipsis‿token‿array *	ellipsis‿token‿array‿append (ellipsis‿token‿array *restrict s, ellipsis‿token‿array‿base c)
	Append a new element to a ellipsis‿token‿array and return a new object.
int	ellipsis‿token‿array‿base‿compare (ellipsis‿token‿array‿base const *__LOC_ID_0_1, ellipsis‿token‿array‿base const *__LOC_ID_0_2)
	compare the pointed-to tokens
void	ellipsis‿token‿array‿base‿destroy (size_t _n, ellipsis‿token‿array‿base _ar[static _n])
	Destroy an element of type ellipsis‿token‿array‿base.
void	ellipsis‿token‿array‿cmove (ellipsis‿token‿array const *__LOC_ID_0_5[restrict static 1], ellipsis‿token‿array const **restrict __LOC_ID_0_6)
	Move a ellipsis‿token‿array const pointed to by the second parameter to the one pointed to by the first.
int	ellipsis‿token‿array‿compare (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Compare two arrays lexicographically.
int	ellipsis‿token‿array‿compareInternal (void const *A, void const *B)
ellipsis‿token‿array *	ellipsis‿token‿array‿concat‿_Ctra (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one.
ellipsis‿token‿array *	ellipsis‿token‿array‿concat‿_Insta (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one.
ellipsis‿token‿array *	ellipsis‿token‿array‿concat (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one.
ellipsis‿token‿array *	ellipsis‿token‿array‿concat_inplace‿_Ctra (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one and delete s.
ellipsis‿token‿array *	ellipsis‿token‿array‿concat_inplace‿_Insta (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one and delete s.
ellipsis‿token‿array *	ellipsis‿token‿array‿concat_inplace (ellipsis‿token‿array const *s, ellipsis‿token‿array const *t)
	Concatenate two ellipsis‿token‿array into a new one and delete s.
ellipsis‿token‿array *	ellipsis‿token‿array‿cpy (ellipsis‿token‿array const *restrict __LOC_ID_0_7)
	Allocate a ellipsis‿token‿array and copy the data to which the parameter points into it.
ellipsis‿token‿array const *	ellipsis‿token‿array‿cpy_const‿_Ctra (ellipsis‿token‿array const *restrict s)
	Copy or link to a const-qualified ellipsis‿token‿array.
ellipsis‿token‿array const *	ellipsis‿token‿array‿cpy_const‿_Insta (ellipsis‿token‿array const *restrict s)
	Copy or link to a const-qualified ellipsis‿token‿array.
ellipsis‿token‿array const *	ellipsis‿token‿array‿cpy_const (ellipsis‿token‿array const *restrict s)
	Copy or link to a const-qualified ellipsis‿token‿array.
void	ellipsis‿token‿array‿delete (ellipsis‿token‿array const *)
	Delete a ellipsis‿token‿array pointed to by the parameter.
ellipsis‿token‿array *	ellipsis‿token‿array‿grow‿_Ctra (ellipsis‿token‿array *restrict s, size_t length)
	Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.
ellipsis‿token‿array *	ellipsis‿token‿array‿grow‿_Insta (ellipsis‿token‿array *restrict s, size_t length)
	Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.
ellipsis‿token‿array *	ellipsis‿token‿array‿grow (ellipsis‿token‿array *restrict s, size_t length)
	Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.
void	ellipsis‿token‿array‿move (ellipsis‿token‿array *__LOC_ID_0_3[restrict static 1], ellipsis‿token‿array **restrict __LOC_ID_0_4)
	Move a ellipsis‿token‿array pointed to by the second parameter to the one pointed to by the first.
ellipsis‿token‿array *	ellipsis‿token‿array‿remove (ellipsis‿token‿array s[restrict static 1], size_t)
	Remove (at most) the indicated amount of elements from the ellipsis‿token‿array return a new one and delete s.
ellipsis‿token‿array‿base const *	ellipsis‿token‿array‿search (ellipsis‿token‿array‿base const el[static 1], ellipsis‿token‿array const *p, size_t offs, size_t len)
	search for an element in a ellipsis‿token‿array
ellipsis‿token‿array *	ellipsis‿token‿array‿shrink‿_Ctra (ellipsis‿token‿array s[restrict static 1], size_t length)
	Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.
ellipsis‿token‿array *	ellipsis‿token‿array‿shrink‿_Insta (ellipsis‿token‿array s[restrict static 1], size_t length)
	Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.
ellipsis‿token‿array *	ellipsis‿token‿array‿shrink (ellipsis‿token‿array s[restrict static 1], size_t length)
	Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.
void	ellipsis‿token‿array‿sort (ellipsis‿token‿array *p, size_t offs, size_t len)
	sort a ellipsis‿token‿array in place.
ellipsis‿token‿array *	ellipsis‿token‿array‿sub‿_Ctra (ellipsis‿token‿array const *restrict s, size_t pos, size_t len)
	Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.
ellipsis‿token‿array *	ellipsis‿token‿array‿sub‿_Insta (ellipsis‿token‿array const *restrict s, size_t pos, size_t len)
	Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.
ellipsis‿token‿array *	ellipsis‿token‿array‿sub (ellipsis‿token‿array const *restrict s, size_t pos, size_t len)
	Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.

Data Fields
ellipsis‿token‿array‿base	array []
	The current data array.
size_t const	length
	Current length of this instance.

Private Attributes
size_t const	capacity
	Maximal length of this instance.
size_t	length_mod
	Modifiable length of this instance.

Related Symbols
(Note that these are not member symbols.)
#define	ELLIPSIS_TARRAY_LITERAL_LOCAL(N, ...)
	Create a literal of type ellipsis‿token‿array, where the array component is initialized with the arguments.

Detailed Description

A structure with a flexible array member of base type ellipsis‿token‿array‿base.

The ellipsis‿token‿array type by itself only works if allocated, you should never declare a variable of it; but see below for creating literals of this type. Functions and macros are provided to allocate, delete, copy etc.

ellipsis‿token‿array keeps track of two different lengths

• length, an actual length that holds the number of elements that are currently stored
• capacity, a maximal length to which the current fa structure may be expanded without reallocation. The special value 0 indicates that this instance is a literal and may not be reallocated at all.

The purpose is to handle additions and removal of elements relatively efficient, without having to reallocated and copy the whole structure each time.

Use the member length to query the current length and array to access the members. Do not touch the other members.

See also

ELLIPSIS_TARRAY_LITERAL for the creation of a literal of this type.

Source definitions for this type

The contents of this file here is automatically expanded from the meta-source file "generate/xfiles/ellipsis-fa-xcode.eLh". That source has to be included by eĿlipsis with a unit name (here ellipsis‿token‿array) set to the name that the new array structure should have. Before that, the type ¤::base (here ellipsis‿token‿array‿base) has to be defined to the base type of the array. The include should then be done by using include_source; when doing so the macro ELLIPSIS_FA_NAME (here ellipsis_tarray) has to be set to a non-composed name that will be used as a prefix for the macros that are defined.

# include_source "generate/xfiles/ellipsis-fa-xcode.eLh"__prefix__(bind ELLIPSIS_FA_NAME ellipsis_tarray)

There are two other features that can be used to fine-tune the type. They depend on the macros ELLIPSIS_HAS_DESTROY and ELLIPSIS_HAS_COMPARE that can be added with similar __prefix__(bind ...) arguments as above. If these are defined, ellipsis‿token‿array‿base‿destroy and ellipsis‿token‿array‿base‿compare are supposed to pre-exist, respectively; if they are not defined, the corresponding function is synthesized to a default.

See also

ellipsis‿token‿array‿base‿destroy for the policy when elements are removed

ellipsis‿token‿array‿base‿compare for the policy when two elements are compared

A similar mechanism is in place for the .c file.

Warning

This is a file generated by eĿlipsis version 20250309, do not modify

Member Function Documentation

ellipsis‿token‿array‿alloc‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿alloc‿_Ctra ( size_t  len )

inline

Allocate a ellipsis‿token‿array with elements as given by the parameter.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿alloc‿_Ctra(), ellipsis‿token‿array‿alloc‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿alloc‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿alloc‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿alloc‿_Insta ( size_t  len )

inline

Allocate a ellipsis‿token‿array with elements as given by the parameter.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿alloc().

Here is the caller graph for this function:

ellipsis‿token‿array‿alloc()

ellipsis‿token‿array * ellipsis‿token‿array‿alloc ( size_t  len )

inline

Allocate a ellipsis‿token‿array with elements as given by the parameter.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿alloc‿_Insta(), ellipsis‿token‿array‿alloc(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿alloc().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿append‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿append‿_Ctra ( ellipsis‿token‿array *restrict  s, ellipsis‿token‿array‿base  c  )

inline

Append a new element to a ellipsis‿token‿array and return a new object.

If the array is statically allocated an allocated copy of it is made first.

A pointer to a new or the old array may be returned, and so you should update all pointer variables that previous held the pointer accordingly.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned and the old array is maintained.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿append‿_Ctra(), ellipsis‿token‿array‿append‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿append‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿append‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿append‿_Insta ( ellipsis‿token‿array *restrict  s, ellipsis‿token‿array‿base  c  )

inline

Append a new element to a ellipsis‿token‿array and return a new object.

If the array is statically allocated an allocated copy of it is made first.

A pointer to a new or the old array may be returned, and so you should update all pointer variables that previous held the pointer accordingly.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned and the old array is maintained.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿append().

Here is the caller graph for this function:

ellipsis‿token‿array‿append()

ellipsis‿token‿array * ellipsis‿token‿array‿append ( ellipsis‿token‿array *restrict  s, ellipsis‿token‿array‿base  c  )

inline

Append a new element to a ellipsis‿token‿array and return a new object.

If the array is statically allocated an allocated copy of it is made first.

A pointer to a new or the old array may be returned, and so you should update all pointer variables that previous held the pointer accordingly.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned and the old array is maintained.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿append‿_Insta(), ellipsis‿token‿array‿append(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿append().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿base‿compare()

int ellipsis‿token‿array‿base‿compare ( ellipsis‿token‿array‿base const *  __LOC_ID_0_1, ellipsis‿token‿array‿base const *  __LOC_ID_0_2  )

inline

compare the pointed-to tokens

This is robust against null pointers. Two null pointers compare equal, otherwise a null pointer is considered below all valid pointers.

References ellipsis‿str32‿compare().

Referenced by ellipsis‿token‿array‿compareInternal().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿base‿destroy()

void ellipsis‿token‿array‿base‿destroy ( size_t  _n, ellipsis‿token‿array‿base  _ar[static _n]  )

inline

Destroy an element of type ellipsis‿token‿array‿base.

This is a synthesized function that sets all bytes of the array to 0.

See also

ellipsis‿token‿array‿remove

ellipsis‿token‿array‿delete

ellipsis‿token‿array‿cmove()

void ellipsis‿token‿array‿cmove ( ellipsis‿token‿array const *  __LOC_ID_0_5[restrict static 1], ellipsis‿token‿array const **restrict  __LOC_ID_0_6  )

inline

Move a ellipsis‿token‿array const pointed to by the second parameter to the one pointed to by the first.

If target is not null before, the old pointed-to object is deleted.

References ellipsis‿token‿array‿delete().

Here is the call graph for this function:

ellipsis‿token‿array‿compare()

int ellipsis‿token‿array‿compare	(	ellipsis‿token‿array const *	s,
		ellipsis‿token‿array const *	t
	)

Compare two arrays lexicographically.

This uses the function ellipsis‿token‿array‿base‿compare to compare the elements.

References array, and length.

ellipsis‿token‿array‿compareInternal()

int ellipsis‿token‿array‿compareInternal ( void const *  A, void const *  B  )

inline

References ellipsis‿token‿array‿base‿compare().

Referenced by ellipsis‿token‿array‿search(), and ellipsis‿token‿array‿sort().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿concat‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿concat‿_Ctra ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿concat‿_Ctra(), ellipsis‿token‿array‿concat‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿concat‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿concat‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿concat‿_Insta ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿concat().

Here is the caller graph for this function:

ellipsis‿token‿array‿concat()

ellipsis‿token‿array * ellipsis‿token‿array‿concat ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿concat‿_Insta(), ellipsis‿token‿array‿concat(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿concat().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿concat_inplace‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿concat_inplace‿_Ctra ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one and delete s.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

The effect is mostly as if in the following

ellipsis‿token‿array* tmp = ellipsis‿token‿array‿cpy(s);
ellipsis‿token‿array‿delete(s);
return ellipsis‿token‿array‿concat(tmp, t);

only that the storage of s may be reused more efficiently.

If s is a literal, a copy of it is made and then it is concatenated.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Note that in particular, as for ellipsis‿token‿array‿delete(), *s may be deleted although it is const-qualified.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿concat_inplace‿_Ctra(), ellipsis‿token‿array‿concat_inplace‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿concat_inplace‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿concat_inplace‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿concat_inplace‿_Insta ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one and delete s.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

The effect is mostly as if in the following

ellipsis‿token‿array* tmp = ellipsis‿token‿array‿cpy(s);
ellipsis‿token‿array‿delete(s);
return ellipsis‿token‿array‿concat(tmp, t);

only that the storage of s may be reused more efficiently.

If s is a literal, a copy of it is made and then it is concatenated.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Note that in particular, as for ellipsis‿token‿array‿delete(), *s may be deleted although it is const-qualified.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿concat_inplace().

Here is the caller graph for this function:

ellipsis‿token‿array‿concat_inplace()

ellipsis‿token‿array * ellipsis‿token‿array‿concat_inplace ( ellipsis‿token‿array const *  s, ellipsis‿token‿array const *  t  )

inline

Concatenate two ellipsis‿token‿array into a new one and delete s.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

The effect is mostly as if in the following

ellipsis‿token‿array* tmp = ellipsis‿token‿array‿cpy(s);
ellipsis‿token‿array‿delete(s);
return ellipsis‿token‿array‿concat(tmp, t);

only that the storage of s may be reused more efficiently.

If s is a literal, a copy of it is made and then it is concatenated.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Note that in particular, as for ellipsis‿token‿array‿delete(), *s may be deleted although it is const-qualified.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿concat_inplace‿_Insta(), ellipsis‿token‿array‿concat_inplace(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿concat_inplace().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿cpy()

ellipsis‿token‿array * ellipsis‿token‿array‿cpy ( ellipsis‿token‿array const *restrict  __LOC_ID_0_7 )

inline

Allocate a ellipsis‿token‿array and copy the data to which the parameter points into it.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿sub(), and ELLIPSIS_CONTRACT.

Here is the call graph for this function:

ellipsis‿token‿array‿cpy_const‿_Ctra()

ellipsis‿token‿array const * ellipsis‿token‿array‿cpy_const‿_Ctra ( ellipsis‿token‿array const *restrict  s )

inline

Copy or link to a const-qualified ellipsis‿token‿array.

If the pointed to object has been allocated statically, only a pointer to that object is returned. If the object has been allocated dynamically, a copy as by ellipsis‿token‿array‿cpy is produced.

See also

ELLIPSIS_TARRAY_LITERAL

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿cpy_const‿_Ctra(), ellipsis‿token‿array‿cpy_const‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿cpy_const‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿cpy_const‿_Insta()

ellipsis‿token‿array const * ellipsis‿token‿array‿cpy_const‿_Insta ( ellipsis‿token‿array const *restrict  s )

inline

Copy or link to a const-qualified ellipsis‿token‿array.

If the pointed to object has been allocated statically, only a pointer to that object is returned. If the object has been allocated dynamically, a copy as by ellipsis‿token‿array‿cpy is produced.

See also

ELLIPSIS_TARRAY_LITERAL

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿cpy_const().

Here is the caller graph for this function:

ellipsis‿token‿array‿cpy_const()

ellipsis‿token‿array const * ellipsis‿token‿array‿cpy_const ( ellipsis‿token‿array const *restrict  s )

inline

Copy or link to a const-qualified ellipsis‿token‿array.

If the pointed to object has been allocated statically, only a pointer to that object is returned. If the object has been allocated dynamically, a copy as by ellipsis‿token‿array‿cpy is produced.

See also

ELLIPSIS_TARRAY_LITERAL

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿cpy_const‿_Insta(), ellipsis‿token‿array‿cpy_const(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿token‿array‿cpy_const().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿delete()

void ellipsis‿token‿array‿delete

(

ellipsis‿token‿array const *

)

Delete a ellipsis‿token‿array pointed to by the parameter.

Remarks

This function may be presented with a literal as produced by ELLIPSIS_TARRAY_LITERAL and will just do nothing, then.

This uses the function ellipsis‿token‿array‿base‿destroy on deleted elements.

References array, and length.

Referenced by ellipsis‿token‿array‿cmove(), and ellipsis‿token‿array‿move().

Here is the caller graph for this function:

ellipsis‿token‿array‿grow‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿grow‿_Ctra ( ellipsis‿token‿array *restrict  s, size_t  length  )

inline

Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

If s is non-null and cannot be grown, s is returned unchanged.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References capacity, ellipsis‿token‿array‿grow‿_Ctra(), ellipsis‿token‿array‿grow‿_Inner(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿grow‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿grow‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿grow‿_Insta ( ellipsis‿token‿array *restrict  s, size_t  length  )

inline

Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

If s is non-null and cannot be grown, s is returned unchanged.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿grow().

Here is the caller graph for this function:

ellipsis‿token‿array‿grow()

ellipsis‿token‿array * ellipsis‿token‿array‿grow ( ellipsis‿token‿array *restrict  s, size_t  length  )

inline

Grow the ellipsis‿token‿array to (at least) the indicated amount of elements return a new one and delete the old one, if any.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

If s is null on entry a new array is returned, if possible, otherwise a null pointer is returned.

If s is non-null and cannot be grown, s is returned unchanged.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References capacity, ellipsis‿token‿array‿grow‿_Insta(), ellipsis‿token‿array‿grow(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿grow().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿move()

void ellipsis‿token‿array‿move ( ellipsis‿token‿array *  __LOC_ID_0_3[restrict static 1], ellipsis‿token‿array **restrict  __LOC_ID_0_4  )

inline

Move a ellipsis‿token‿array pointed to by the second parameter to the one pointed to by the first.

If target is not null before, the old pointed-to object is deleted.

References ellipsis‿token‿array‿delete().

Here is the call graph for this function:

ellipsis‿token‿array‿remove()

ellipsis‿token‿array * ellipsis‿token‿array‿remove	(	ellipsis‿token‿array	s[restrict static 1],
		size_t
	)

Remove (at most) the indicated amount of elements from the ellipsis‿token‿array return a new one and delete s.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

This uses the function ellipsis‿token‿array‿base‿destroy on removed elements.

References ELLIPSIS_CONTRACT.

ellipsis‿token‿array‿search()

ellipsis‿token‿array‿base const * ellipsis‿token‿array‿search ( ellipsis‿token‿array‿base const  el[static 1], ellipsis‿token‿array const *  p, size_t  offs, size_t  len  )

inline

search for an element in a ellipsis‿token‿array

The same restrictions for offs and len hold as for ellipsis‿token‿array‿sort.

The return is the same as for the bsearch C library feature.

References array, ellipsis‿token‿array‿compareInternal(), and length.

Here is the call graph for this function:

ellipsis‿token‿array‿shrink‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿shrink‿_Ctra ( ellipsis‿token‿array  s[restrict static 1], size_t  length  )

inline

Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.

If the requested length is larger than the current, s is unchanged and is returned.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Use this function to reduce the memory footprint if you find that necessary once you know that the used length of your array will remain stable.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References capacity, ellipsis‿token‿array‿shrink‿_Ctra(), ellipsis‿token‿array‿shrink‿_Inner(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿shrink‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿shrink‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿shrink‿_Insta ( ellipsis‿token‿array  s[restrict static 1], size_t  length  )

inline

Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.

If the requested length is larger than the current, s is unchanged and is returned.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Use this function to reduce the memory footprint if you find that necessary once you know that the used length of your array will remain stable.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿shrink().

Here is the caller graph for this function:

ellipsis‿token‿array‿shrink()

ellipsis‿token‿array * ellipsis‿token‿array‿shrink ( ellipsis‿token‿array  s[restrict static 1], size_t  length  )

inline

Shrink the ellipsis‿token‿array to exactly the indicated amount of elements return a new one and delete the old one, if any.

If the requested length is larger than the current, s is unchanged and is returned.

*s may or not be replaced to an new object for internal maintenance reasons. Do not expect it to remain the same and update the pointers you are holding to it.

Use this function to reduce the memory footprint if you find that necessary once you know that the used length of your array will remain stable.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References capacity, ellipsis‿token‿array‿shrink‿_Insta(), ellipsis‿token‿array‿shrink(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿shrink().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿sort()

void ellipsis‿token‿array‿sort ( ellipsis‿token‿array *  p, size_t  offs, size_t  len  )

inline

sort a ellipsis‿token‿array in place.

Sort array of length len starting from offs according to comparison function ellipsis‿token‿array‿base‿compare.

• If offs is outside the range, nothing is done.
• len is adjusted to the minimum of len and ellipsis‿token‿array‿length-pos.
• If len is zero, nothing is done.

References array, ellipsis‿token‿array‿compareInternal(), and length.

Here is the call graph for this function:

ellipsis‿token‿array‿sub‿_Ctra()

ellipsis‿token‿array * ellipsis‿token‿array‿sub‿_Ctra ( ellipsis‿token‿array const *restrict  s, size_t  pos, size_t  len  )

inline

Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿sub‿_Ctra(), ellipsis‿token‿array‿sub‿_Inner(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿sub‿_Ctra().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿token‿array‿sub‿_Insta()

ellipsis‿token‿array * ellipsis‿token‿array‿sub‿_Insta ( ellipsis‿token‿array const *restrict  s, size_t  pos, size_t  len  )

inline

Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

end inner defer anchor, level 1

Referenced by ellipsis‿token‿array‿sub().

Here is the caller graph for this function:

ellipsis‿token‿array‿sub()

ellipsis‿token‿array * ellipsis‿token‿array‿sub ( ellipsis‿token‿array const *restrict  s, size_t  pos, size_t  len  )

inline

Allocate a ellipsis‿token‿array with len elements and copy the data from *s at position pos onward.

If such a ellipsis‿token‿array cannot be allocated, a null pointer is returned.

start inner defer anchor at level 1

DEFER_TYPE needs a semicolon

defer needs braces and a semicolon

end inner defer anchor, level 1

References ellipsis‿token‿array‿sub‿_Insta(), ellipsis‿token‿array‿sub(), ELLIPSIS_CONTRACT, and length.

Referenced by ellipsis‿token‿array‿cpy(), and ellipsis‿token‿array‿sub().

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Symbol Documentation

ELLIPSIS_TARRAY_LITERAL_LOCAL

#define ELLIPSIS_TARRAY_LITERAL_LOCAL (   N,   ...  )

related

Value:

 ((static const ELLIPSIS_TARRAY_OVERLAY( \
 sizeof((ellipsis‿token‿array‿base[]){__VA_ARGS__ }) \
 /sizeof(ellipsis‿token‿array‿base))) \
 {\
 .length  = (N), \
 .array = {__VA_ARGS__ }, \
 }.fa)

Create a literal of type ellipsis‿token‿array, where the array component is initialized with the arguments.

This results in an lvalue of type ellipsis‿token‿array for an object that has static storage duration and that is const-qualified.

Most functions that are provided for ellipsis‿token‿array need to be able to reallocate the structure, so they will produce an error on a literal that is created with this macro. A notable exception of this is ellipsis‿token‿array‿delete which will just do nothing on such an object.

Remarks

Because of current restrictions in C23 that constexpr compound literals may not be of union type, this is not yet provided as constexpr.

Field Documentation

array

ellipsis‿token‿array‿base array[]

The current data array.

Referenced by ellipsis‿token‿array‿alloc‿_Inner(), ellipsis‿token‿array‿compare(), ellipsis‿token‿array‿concat‿_Inner(), ellipsis‿token‿array‿concat_inplace‿_Inner(), ellipsis‿token‿array‿delete(), ellipsis‿token‿array‿search(), ellipsis‿token‿array‿sort(), ellipsis‿token‿array‿sub‿_Inner(), ellipsis‿token‿dictionary‿catch(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿destroy(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿find(), ellipsis‿token‿dictionary‿find_pos(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿fputs(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿insert(), and ellipsis‿token‿dictionary‿resize().

capacity

size_t const capacity

private

Maximal length of this instance.

Also serves to encode the fact that a ellipsis‿token‿array is statically allocated. Do not mess with it.

Referenced by ellipsis‿token‿array‿concat_inplace‿_Inner(), ellipsis‿token‿array‿grow‿_Ctra(), ellipsis‿token‿array‿grow(), ellipsis‿token‿array‿shrink‿_Ctra(), and ellipsis‿token‿array‿shrink().

length

size_t const length

Current length of this instance.

Referenced by ellipsis‿token‿array‿alloc‿_Inner(), ellipsis‿token‿array‿compare(), ellipsis‿token‿array‿concat‿_Inner(), ellipsis‿token‿array‿concat_inplace‿_Inner(), ellipsis‿token‿array‿delete(), ellipsis‿token‿array‿grow‿_Ctra(), ellipsis‿token‿array‿grow‿_Inner(), ellipsis‿token‿array‿grow(), ellipsis‿token‿array‿search(), ellipsis‿token‿array‿shrink‿_Ctra(), ellipsis‿token‿array‿shrink(), ellipsis‿token‿array‿sort(), ellipsis‿token‿array‿sub‿_Ctra(), ellipsis‿token‿array‿sub‿_Inner(), ellipsis‿token‿array‿sub(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿destroy(), ellipsis‿token‿dictionary‿find_pos(), ellipsis‿token‿dictionary::ellipsis‿token‿dictionary‿fputs(), ellipsis‿token‿dictionary‿maintain(), and ellipsis‿token‿dictionary‿resize().

length_mod

size_t length_mod

private

Modifiable length of this instance.

Referenced by ellipsis‿token‿array‿alloc‿_Inner(), ellipsis‿token‿array‿concat_inplace‿_Inner(), and ellipsis‿token‿array‿sub‿_Inner().

---

The documentation for this struct was generated from the following files:

• sources/token/ellipsis-tarray.h
• sources/token/ellipsis-tarray.c