MkBufferListC - various functions to work on a MkBufferListS … More...

Collaboration diagram for MkBufferListC_Misc_C_API:

Macros
#define	MkBufferListSizeI(bfl)

Functions
void	libmkkernel::MkBufferListMove_RT (MK_RT mkrt, MK_BFL const to, MK_BFL const from)
	move all internal data from from to the end of to …

void	libmkkernel::MkBufferListCopy_RT (MK_RT mkrt, MK_BFL const bfl, MK_BFLN const src)
	copy all internal data from src to tgt …

MK_BFL	libmkkernel::MkBufferListPositionMerge_RT (MK_RT mkrt, MK_BFL const bfl, MK_BFL const source, MK_NUM position)
	merge a MkBufferListS list into an MkBufferListS object on position …

MK_NUM	libmkkernel::MkBufferListSearchC_RT (MK_RT mkrt, MK_BFLN const bfl, MK_STRN const str, MK_NUM const len, MK_NUM const startindex)
	search libmkkernel::MK_STR item from a MkBufferListS object starting at startindex …

MK_BFL	libmkkernel::MkBufferListReset_RT (MK_RT mkrt, MK_BFL bfl)
	reset a MkBufferListC object …

MK_STRN	libmkkernel::MkBufferListToString_RT (MK_RT mkrt, MK_BFLN const bfl)
	get a string representation of the bfl

MK_NAT_LIST	libmkkernel::MkBufferListToList_RT (MK_RT mkrt, MK_BFLN const bfl)
	get a target-language list representation of the bfl …

MK_STRN_A	libmkkernel::MkBufferListToStringList_RT (MK_RT mkrt, MK_BFLN const bfl, bool const unique)
	get a string-list representation of the bfl

MK_BUF	libmkkernel::MkBufferListToBuffer_RT (MK_RT mkrt, MK_BFLN const bfl)
	Export a bfl into an MkBufferC using an MkBufferStreamC …

MK_I32	libmkkernel::MkBufferListCmp_RT (MK_RT mkrt, MK_BFLN const bfl, MK_BFLN const bfl2)
	compare two buffer-list …

MK_BFL	libmkkernel::MkBufferListSort_RT (MK_RT mkrt, MK_BFL const bfl)
	sort a MkBufferListC …

void	libmkkernel::MkBufferListReserve_RT (MK_RT mkrt, MK_BFL const bfl, MK_NUM const num)
	reserve num items in a MkBufferListC object …

MK_NUM	libmkkernel::MkBufferListSize_RT (MK_RT mkrt, MK_BFLN const bfl)
	get the number-of-items in the bfl …

MK_BFL	libmkkernel::MkBufferListFileGlob_RT (MK_RT mkrt, MK_STRN const pattern_match)
	create a new MkBufferListC using the result from a filesystem glob operation …

MkBufferListC - MkBufferListC_Misc_C_API - overload
#define	MkBufferListFileGlob_NULL(...)

#define	MkBufferListFileGlob(...)

#define	MkBufferListPositionMerge_NULL(...)

#define	MkBufferListPositionMerge(...)

#define	MkBufferListReset_NULL(...)

#define	MkBufferListReset(...)

#define	MkBufferListSort_NULL(...)

#define	MkBufferListSort(...)

#define	MkBufferListToBuffer_NULL(...)

#define	MkBufferListToBuffer(...)

#define	MkBufferListCmp_NULL(...)

#define	MkBufferListCmp(...)

#define	MkBufferListCopy_NULL(...)

#define	MkBufferListCopy(...)

#define	MkBufferListMove_NULL(...)

#define	MkBufferListMove(...)

#define	MkBufferListReserve_NULL(...)

#define	MkBufferListReserve(...)

#define	MkBufferListSearchC_NULL(...)

#define	MkBufferListSearchC(...)

#define	MkBufferListSearchC_3(bfl, str, len)

#define	MkBufferListSearchC_2(bfl, str)

#define	MkBufferListSize_NULL(...)

#define	MkBufferListSize(...)

#define	MkBufferListToList_NULL(...)

#define	MkBufferListToList(...)

#define	MkBufferListToString_NULL(...)

#define	MkBufferListToString(...)

#define	MkBufferListToStringList_NULL(...)

#define	MkBufferListToStringList(...)

Detailed Description

MkBufferListC - various functions to work on a MkBufferListS …

Macro Definition Documentation

◆ MkBufferListCmp

#define MkBufferListCmp ( ... )

Value:

MkBufferListCmp_RT(MK_RT_CALL __VA_ARGS__)

MK_RT_CALL

#define MK_RT_CALL

Definition LibMkKernel_mk.h:895

Definition at line 585 of file kernel_overload_mk.h.

◆ MkBufferListCmp_NULL

#define MkBufferListCmp_NULL ( ... )

Value:

MkBufferListCmp_RT(MK_RT_CALL_NULL __VA_ARGS__)

MK_RT_CALL_NULL

#define MK_RT_CALL_NULL

Definition LibMkKernel_mk.h:899

Definition at line 584 of file kernel_overload_mk.h.

◆ MkBufferListCopy

#define MkBufferListCopy ( ... )

Value:

MkBufferListCopy_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 587 of file kernel_overload_mk.h.

◆ MkBufferListCopy_NULL

#define MkBufferListCopy_NULL ( ... )

Value:

MkBufferListCopy_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 586 of file kernel_overload_mk.h.

◆ MkBufferListFileGlob

#define MkBufferListFileGlob ( ... )

Value:

MkBufferListFileGlob_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 571 of file kernel_overload_mk.h.

◆ MkBufferListFileGlob_NULL

#define MkBufferListFileGlob_NULL ( ... )

Value:

MkBufferListFileGlob_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 570 of file kernel_overload_mk.h.

◆ MkBufferListMove

#define MkBufferListMove ( ... )

Value:

MkBufferListMove_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 589 of file kernel_overload_mk.h.

◆ MkBufferListMove_NULL

#define MkBufferListMove_NULL ( ... )

Value:

MkBufferListMove_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 588 of file kernel_overload_mk.h.

◆ MkBufferListPositionMerge

#define MkBufferListPositionMerge ( ... )

Value:

MkBufferListPositionMerge_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 575 of file kernel_overload_mk.h.

◆ MkBufferListPositionMerge_NULL

#define MkBufferListPositionMerge_NULL ( ... )

Value:

MkBufferListPositionMerge_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 574 of file kernel_overload_mk.h.

◆ MkBufferListReserve

#define MkBufferListReserve ( ... )

Value:

MkBufferListReserve_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 591 of file kernel_overload_mk.h.

◆ MkBufferListReserve_NULL

#define MkBufferListReserve_NULL ( ... )

Value:

MkBufferListReserve_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 590 of file kernel_overload_mk.h.

◆ MkBufferListReset

#define MkBufferListReset ( ... )

Value:

MkBufferListReset_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 577 of file kernel_overload_mk.h.

◆ MkBufferListReset_NULL

#define MkBufferListReset_NULL ( ... )

Value:

MkBufferListReset_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 576 of file kernel_overload_mk.h.

◆ MkBufferListSearchC

#define MkBufferListSearchC ( ... )

Value:

MkBufferListSearchC_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 593 of file kernel_overload_mk.h.

◆ MkBufferListSearchC_2

#define MkBufferListSearchC_2	(		bfl,
			str )

Value:

MkBufferListSearchC(bfl,str,-1,0)

MkBufferListSearchC

#define MkBufferListSearchC(...)

Definition kernel_overload_mk.h:593

Definition at line 595 of file kernel_overload_mk.h.

◆ MkBufferListSearchC_3

#define MkBufferListSearchC_3	(	bfl,
		str,
		len )

Value:

MkBufferListSearchC(bfl,str,len,0)

Definition at line 594 of file kernel_overload_mk.h.

◆ MkBufferListSearchC_NULL

#define MkBufferListSearchC_NULL ( ... )

Value:

MkBufferListSearchC_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 592 of file kernel_overload_mk.h.

◆ MkBufferListSize

#define MkBufferListSize ( ... )

Value:

MkBufferListSize_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 597 of file kernel_overload_mk.h.

◆ MkBufferListSize_NULL

#define MkBufferListSize_NULL ( ... )

Value:

MkBufferListSize_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 596 of file kernel_overload_mk.h.

◆ MkBufferListSizeI

#define MkBufferListSizeI ( bfl )

Value:

(bfl)->cursize

Definition at line 817 of file MkBufferListC_def_mk.h.

◆ MkBufferListSort

#define MkBufferListSort ( ... )

Value:

MkBufferListSort_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 579 of file kernel_overload_mk.h.

◆ MkBufferListSort_NULL

#define MkBufferListSort_NULL ( ... )

Value:

MkBufferListSort_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 578 of file kernel_overload_mk.h.

◆ MkBufferListToBuffer

#define MkBufferListToBuffer ( ... )

Value:

MkBufferListToBuffer_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 581 of file kernel_overload_mk.h.

◆ MkBufferListToBuffer_NULL

#define MkBufferListToBuffer_NULL ( ... )

Value:

MkBufferListToBuffer_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 580 of file kernel_overload_mk.h.

◆ MkBufferListToList

#define MkBufferListToList ( ... )

Value:

MkBufferListToList_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 599 of file kernel_overload_mk.h.

◆ MkBufferListToList_NULL

#define MkBufferListToList_NULL ( ... )

Value:

MkBufferListToList_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 598 of file kernel_overload_mk.h.

◆ MkBufferListToString

#define MkBufferListToString ( ... )

Value:

MkBufferListToString_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 601 of file kernel_overload_mk.h.

◆ MkBufferListToString_NULL

#define MkBufferListToString_NULL ( ... )

Value:

MkBufferListToString_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 600 of file kernel_overload_mk.h.

◆ MkBufferListToStringList

#define MkBufferListToStringList ( ... )

Value:

MkBufferListToStringList_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 603 of file kernel_overload_mk.h.

◆ MkBufferListToStringList_NULL

#define MkBufferListToStringList_NULL ( ... )

Value:

MkBufferListToStringList_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 602 of file kernel_overload_mk.h.

Function Documentation

◆ MkBufferListCmp_RT()

MK_I32 libmkkernel::MkBufferListCmp_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl,
		MK_BFLN const	bfl2 )

compare two buffer-list …

First the size is compared and if the size is equal every argument starting from 0 is compared with BufferCmp. The first BufferCmp with a result != 0 finish the comparison and this result is returned.

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on
[in]	bfl2	buffer-list to compare

Returns: Returns < 0 if bfl is less than bfl2; > 0 if bfl is greater than bfl2, and 0 if they are equal

◆ MkBufferListCopy_RT()

void libmkkernel::MkBufferListCopy_RT	(	MK_RT	mkrt,
		MK_BFL const	bfl,
		MK_BFLN const	src )

copy all internal data from src to tgt …

existing data will be overwritten
the cursize of src will be the cursize of tgt

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on
[in]	src	the source of the copy

◆ MkBufferListFileGlob_RT()

MK_BFL libmkkernel::MkBufferListFileGlob_RT	(	MK_RT	mkrt,
		MK_STRN const	pattern_match )

create a new MkBufferListC using the result from a filesystem glob operation …

◆ MkBufferListMove_RT()

void libmkkernel::MkBufferListMove_RT	(	MK_RT	mkrt,
		MK_BFL const	to,
		MK_BFL const	from )

move all internal data from from to the end of to …

after the move… the from is empty and only the shell exists

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	to	the target of the move
[in]	from	the source of the move

◆ MkBufferListPositionMerge_RT()

MK_BFL libmkkernel::MkBufferListPositionMerge_RT	(	MK_RT	mkrt,
		MK_BFL const	bfl,
		MK_BFL const	source,
		MK_NUM	position )

merge a MkBufferListS list into an MkBufferListS object on position …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on
[in]	source	the object to be merged into bfl, afterwords the source is empty and can be deleted
[in]	position	insert in at position, shift all following arguments one up. Set position to `0` to append to the beginning or set position to `-1` to append to the end

◆ MkBufferListReserve_RT()

void libmkkernel::MkBufferListReserve_RT	(	MK_RT	mkrt,
		MK_BFL const	bfl,
		MK_NUM const	num )

reserve num items in a MkBufferListC object …

cursize will be num
size will b >= num
free: num <= X < cursize
init: cursize <= X < num

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
	bfl	the MkBufferListC object to reserve memory
	num	reserve the number of items for later use.

◆ MkBufferListReset_RT()

MK_BFL libmkkernel::MkBufferListReset_RT	(	MK_RT	mkrt,
		MK_BFL	bfl )

reset a MkBufferListC object …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Attention: all MkBufferC objects will be freed

◆ MkBufferListSearchC_RT()

MK_NUM libmkkernel::MkBufferListSearchC_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl,
		MK_STRN const	str,
		MK_NUM const	len,
		MK_NUM const	startindex )

search libmkkernel::MK_STR item from a MkBufferListS object starting at startindex …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on
	str	the string to search for
	len	the length of str or `-1` to calulate the length with strlen
	startindex	start searching in buf from index startindex

Returns: The index of the str found or -1 if not found. The return value can be used as startindex of following calls to BufferListSearchC

a typical usage for this code is parsing an MkBufferListS object for multiple occurrences of a string

while ((startindex = MkBufferListSearchC (buf, str, strlen(str), startindex)) != -1) {
  ...
}

Attention: The size of str have to be at least 4 bytes

◆ MkBufferListSize_RT()

MK_NUM libmkkernel::MkBufferListSize_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl )

get the number-of-items in the bfl …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Returns: the number-of-items in the bfl

◆ MkBufferListSort_RT()

MK_BFL libmkkernel::MkBufferListSort_RT	(	MK_RT	mkrt,
		MK_BFL const	bfl )

sort a MkBufferListC …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Returns: Return the input bfl as sorted list

◆ MkBufferListToBuffer_RT()

MK_BUF libmkkernel::MkBufferListToBuffer_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl )

Export a bfl into an MkBufferC using an MkBufferStreamC …

An buffer is able to hold all primitive types and LIST of primitive types. An buffer-list is an Indexed-LIST representation of a LIST of buffer.

To add a buffer-list into an buffer the buffer-list have to be converted into a buffer-stream and the buffer-stream have to be exported as buffer. The buffer is finally apended to the buffer-list.

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Returns: the required buffer or a MK_NULL on error

Attention: (do not free) The memory of the out/return value belongs to the called ccmkkernel function and therefore never becomes MK_NULL for a non-error result.
For details on the out/return value, see: MkKernel_Storage_C_API.

◆ MkBufferListToList_RT()

MK_NAT_LIST libmkkernel::MkBufferListToList_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl )

get a target-language list representation of the bfl …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Returns: the required list

Attention: this is only implemented by the Target-Programming-Language (TPL)

◆ MkBufferListToString_RT()

MK_STRN libmkkernel::MkBufferListToString_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl )

get a string representation of the bfl

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on

Returns: the required string

Attention

The returned string is owned by self… do not free.
On error an empty string is returned.

◆ MkBufferListToStringList_RT()

MK_STRN_A libmkkernel::MkBufferListToStringList_RT	(	MK_RT	mkrt,
		MK_BFLN const	bfl,
		bool const	unique )

get a string-list representation of the bfl

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	bfl	the MkBufferListS instance to work on
[out]	unique	if true the return belongs to the caller and have to be freed, if false the return belongs to the function and must NOT be freed.

Returns: the required list

Attention: the string-list is terminated with MK_NULL

Macros

Functions

MkBufferListC - MkBufferListC_Misc_C_API - overload

Detailed Description

Macro Definition Documentation

◆ MkBufferListCmp

◆ MkBufferListCmp_NULL

◆ MkBufferListCopy

◆ MkBufferListCopy_NULL

◆ MkBufferListFileGlob

◆ MkBufferListFileGlob_NULL

◆ MkBufferListMove

◆ MkBufferListMove_NULL

◆ MkBufferListPositionMerge

◆ MkBufferListPositionMerge_NULL

◆ MkBufferListReserve

◆ MkBufferListReserve_NULL

◆ MkBufferListReset

◆ MkBufferListReset_NULL

◆ MkBufferListSearchC

◆ MkBufferListSearchC_2

◆ MkBufferListSearchC_3

◆ MkBufferListSearchC_NULL

◆ MkBufferListSize

◆ MkBufferListSize_NULL

◆ MkBufferListSizeI

◆ MkBufferListSort

◆ MkBufferListSort_NULL

◆ MkBufferListToBuffer

◆ MkBufferListToBuffer_NULL

◆ MkBufferListToList

◆ MkBufferListToList_NULL

◆ MkBufferListToString

◆ MkBufferListToString_NULL

◆ MkBufferListToStringList

◆ MkBufferListToStringList_NULL

Function Documentation

◆ MkBufferListCmp_RT()

◆ MkBufferListCopy_RT()

◆ MkBufferListFileGlob_RT()

◆ MkBufferListMove_RT()

◆ MkBufferListPositionMerge_RT()

◆ MkBufferListReserve_RT()

◆ MkBufferListReset_RT()

◆ MkBufferListSearchC_RT()

◆ MkBufferListSize_RT()

◆ MkBufferListSort_RT()

◆ MkBufferListToBuffer_RT()

◆ MkBufferListToList_RT()

◆ MkBufferListToString_RT()

◆ MkBufferListToStringList_RT()