ellipsis-base64.h File Reference

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <uchar.h>
#include "utils/ellipsis-malloc.h"
#include "utils/ellipsis-str8.h"

Include dependency graph for ellipsis-base64.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	ELLIPSIS_CONTRACT(COUNT, COND, ACTION, VERB, CSTR, CTYPE, ...)
#define	ELLIPSIS_CONTRACT_CHECK_STATIC(CTYPE, COND, CSTR, ...)
#define	ELLIPSIS_CONTRACT_ICE_OR_TRUE(...)
#define	ELLIPSIS_CONTRACT_IMPL(COUNT, COND, ACTION, VERB, CSTR, CTYPE, ...)
#define	ELLIPSIS_CONTRACT_VIOLATION(COUNT, VERB, CTYPE, CSTR, ...)
#define	ELLIPSIS_TEST_ICE(...)   (false ? ELLIPSIS_TO_VOIDS(__VA_ARGS__) : (ellipsis‿contracts‿is_ice*)nullptr)
#define	ELLIPSIS_TO_VOIDS(...)   ((void*)((uintptr_t)((__VA_ARGS__)-(__VA_ARGS__))))
#define	STRINGIFY(...)   STRINGIFY_(__VA_ARGS__)
#define	STRINGIFY_(...)   #__VA_ARGS__

Typedefs
typedef struct ellipsis‿contracts‿is_ice	ellipsis‿contracts‿is_ice

Functions
ellipsis‿str8 *	ellipsis‿base64‿decode‿_Ctra (size_t len, unsigned char const buf[static restrict len])
	Decode a string that contains base64 encoded information into a binary data array.
ellipsis‿str8 *	ellipsis‿base64‿decode (size_t len, unsigned char const buf[static restrict len])
	Decode a string that contains base64 encoded information into a binary data array.
char *	ellipsis‿base64‿encode‿_Ctra (ellipsis‿str8 const source[static restrict 1])
	Encode binary data into a string that is base64 encoded.
char *	ellipsis‿base64‿encode (ellipsis‿str8 const source[static restrict 1])
	Encode binary data into a string that is base64 encoded.

Variables
thread_local bool volatile	ellipsis‿contracts‿ignore‿dynamic
thread_local bool volatile	ellipsis‿contracts‿proceed‿dynamic
thread_local bool volatile	ellipsis‿contracts‿verbose‿dynamic

Detailed Description

Warning

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

Macro Definition Documentation

ELLIPSIS_CONTRACT

#define ELLIPSIS_CONTRACT	(		COUNT,
			COND,
			ACTION,
			VERB,
			CSTR,
			CTYPE,
			...
	)

Value:

 \
 do { \
 _Generic( \
 ELLIPSIS_TEST_ICE(COND), \
 ellipsis‿contracts‿is_ice*: ELLIPSIS_CONTRACT_CHECK_STATIC(CTYPE, COND, CSTR __VA_OPT__(,) __VA_ARGS__), \
 default: ELLIPSIS_CONTRACT_IMPL(COUNT, COND, ACTION, VERB, CSTR, CTYPE __VA_OPT__(,) __VA_ARGS__));\
 } while(false)

ELLIPSIS_CONTRACT_CHECK_STATIC

#define ELLIPSIS_CONTRACT_CHECK_STATIC	(		CTYPE,
			COND,
			CSTR,
			...
	)

Value:

 ({\
 static_assert(ELLIPSIS_CONTRACT_ICE_OR_TRUE(COND), \
 "compile time violation of " CTYPE " " CSTR \
 __VA_OPT__(", ") __VA_ARGS__ );\
 })

ELLIPSIS_CONTRACT_ICE_OR_TRUE

#define ELLIPSIS_CONTRACT_ICE_OR_TRUE

(

...

)

Value:

 _Generic( \
 ELLIPSIS_TEST_ICE(__VA_ARGS__), \
 ellipsis‿contracts‿is_ice*: (__VA_ARGS__), \
 default: true)

ELLIPSIS_CONTRACT_IMPL

#define ELLIPSIS_CONTRACT_IMPL	(		COUNT,
			COND,
			ACTION,
			VERB,
			CSTR,
			CTYPE,
			...
	)

Value:

(((false) || (COND)) \
 ? (void)0 \
 : (ELLIPSIS_CONTRACT_VIOLATION(COUNT, VERB, CTYPE, CSTR __VA_OPT__(,) __VA_ARGS__) \
 , ((false) \
 ? (void)0 \
 : ACTION())))

ELLIPSIS_CONTRACT_VIOLATION

#define ELLIPSIS_CONTRACT_VIOLATION	(		COUNT,
			VERB,
			CTYPE,
			CSTR,
			...
	)

Value:

({\
 static char const contract_format_ ## COUNT[]  = \
 __FILE__ ":" STRINGIFY(__LINE__) ": violation of " CTYPE " `" CSTR "`" __VA_OPT__(", ") __VA_ARGS__ "\n";\
 (VERB \
 ? fputs(contract_format_ ## COUNT, stderr) \
 : 0);\
 })

ELLIPSIS_TEST_ICE

#define ELLIPSIS_TEST_ICE

(

...

)

(false ? ELLIPSIS_TO_VOIDS(__VA_ARGS__) : (ellipsis‿contracts‿is_ice*)nullptr)

ELLIPSIS_TO_VOIDS

#define ELLIPSIS_TO_VOIDS

(

...

)

((void*)((uintptr_t)((__VA_ARGS__)-(__VA_ARGS__))))

STRINGIFY

#define STRINGIFY

(

...

)

STRINGIFY_(__VA_ARGS__)

STRINGIFY_

#define STRINGIFY_

(

...

)

#__VA_ARGS__

Typedef Documentation

ellipsis‿contracts‿is_ice

typedef struct ellipsis‿contracts‿is_ice ellipsis‿contracts‿is_ice

Function Documentation

ellipsis‿base64‿decode‿_Ctra()

ellipsis‿str8 * ellipsis‿base64‿decode‿_Ctra ( size_t  len, unsigned char const  buf[static restrict len]  )

inline

Decode a string that contains base64 encoded information into a binary data array.

len must be a multiple of 4. In general the length of the output data is then len/4. One byte is added for a null termination.

The returned string is dynamically allocated with malloc. If the target length is not a multiple of 3, (that is if the source string has one or two = characters at the end) one or two bytes are padded with 0 at the end.

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‿base64‿decode‿_Ctra(), ellipsis‿base64‿decode‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿base64‿decode‿_Ctra(), and ellipsis‿base64‿decode‿_Insta().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿base64‿decode()

ellipsis‿str8 * ellipsis‿base64‿decode ( size_t  len, unsigned char const  buf[static restrict len]  )

inline

Decode a string that contains base64 encoded information into a binary data array.

len must be a multiple of 4. In general the length of the output data is then len/4. One byte is added for a null termination.

The returned string is dynamically allocated with malloc. If the target length is not a multiple of 3, (that is if the source string has one or two = characters at the end) one or two bytes are padded with 0 at the end.

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‿base64‿decode‿_Insta(), ellipsis‿base64‿decode(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿base64‿decode(), and ellipsis‿lex‿nonspace‿_Inner().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿base64‿encode‿_Ctra()

char * ellipsis‿base64‿encode‿_Ctra ( ellipsis‿str8 const  source[static restrict 1] )

inline

Encode binary data into a string that is base64 encoded.

The returned string is null-terminated and dynamically allocated with malloc.

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‿base64‿encode‿_Ctra(), ellipsis‿base64‿encode‿_Inner(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿base64‿encode‿_Ctra(), and ellipsis‿base64‿encode‿_Insta().

Here is the call graph for this function:

Here is the caller graph for this function:

ellipsis‿base64‿encode()

char * ellipsis‿base64‿encode ( ellipsis‿str8 const  source[static restrict 1] )

inline

Encode binary data into a string that is base64 encoded.

The returned string is null-terminated and dynamically allocated with malloc.

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‿base64‿encode‿_Insta(), ellipsis‿base64‿encode(), and ELLIPSIS_CONTRACT.

Referenced by ellipsis‿base64‿encode(), and ellipsis‿output‿base64().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

ellipsis‿contracts‿ignore‿dynamic

thread_local bool volatile ellipsis‿contracts‿ignore‿dynamic

extern

ellipsis‿contracts‿proceed‿dynamic

thread_local bool volatile ellipsis‿contracts‿proceed‿dynamic

extern

ellipsis‿contracts‿verbose‿dynamic

thread_local bool volatile ellipsis‿contracts‿verbose‿dynamic

extern