MkBufferListC_Class_C_API

MkBufferListC - define the class … More...

Collaboration diagram for MkBufferListC_Class_C_API:

Topics
	MkBufferListC_Class_Define_C_API
	MkBufferListC - low level definition, access and cast …

Typedefs
typedef struct MkBufferListS *	libmkkernel::MK_BFL
	class-shortcut for struct MkBufferListS *, all shortcut using the XX_YYY syntax (only for public API) …
typedef const struct MkBufferListS *	libmkkernel::MK_BFLN
	class-shortcut for const struct MkBufferListS *, all const shortcut using the XX_YYYC syntax (only for public API) …
typedef struct MkBufferListS	libmkkernel::MK_BFLR
	reference-shortcut for struct MkBufferListS, all shortcut using the XX_YYYR syntax (only for public API) …
typedef struct MkBufferListS *	libmkkernel::MK_BAC
	a list of 'buffer' as last argument in function …
typedef const struct MkBufferListS *	libmkkernel::MK_BACN
	const - a list of 'buffer' as last argument in function …

MkBufferListC - Introspection - inline - access to all instances created by class starting with the last one
static MK_BFL	libmkkernel::MkBufferListInstances_RT (MK_RT mkrt)
	get head-instance from linked-list of MkBufferListS type …
static MK_BFL	libmkkernel::MkBufferListNext (MK_BFL const bfl)
	get next instance from linked-list of MkBufferListS type
static MK_BFL	libmkkernel::MkBufferListPrev (MK_BFL const bfl)
	get previous instance from linked-list of MkBufferListS type

MkBufferListC - Export - inline - interact with an external software
static MK_HDL	libmkkernel::MkBufferListHandleGet_RT (MK_RT mkrt, MK_BFL const bfl)
	Handle-Get-Slot - returns a export-hdl to the MkBufferListC useable for external storage
static MK_BFL	libmkkernel::MkBufferListHandleResolve_RT (MK_RT mkrt, MK_HDL const netHdl)
	Handle-Resolve-Slot - return a MkBufferListC from netHdl or MK_NULL if invalid…
#define	MkBufferListHandleResolve_e(netHdl)
	wrapper for MkBufferListHandleResolve with error-handline

MkBufferListC - Misc - function - unspecified functions to perform different tasks
static MK_BFL	libmkkernel::MkBufferListGetNull (void)
	Null-Slot - return a MkBufferListC typed NULL instance …

MkBufferListC - Export - overload
#define	MkBufferListHandleResolve_NULL(...)
#define	MkBufferListHandleResolve(...)
#define	MkBufferListHandleGet_NULL(...)
#define	MkBufferListHandleGet(...)

MkBufferListC - Introspection - overload
#define	MkBufferListInstances_NULL()
#define	MkBufferListInstances()

Detailed Description

MkBufferListC - define the class …

Macro Definition Documentation

MkBufferListHandleGet

#define MkBufferListHandleGet

(

...

)

Value:

MkBufferListHandleGet_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 480 of file kernel_overload_mk.h.

MkBufferListHandleGet_NULL

#define MkBufferListHandleGet_NULL

(

...

)

Value:

MkBufferListHandleGet_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 479 of file kernel_overload_mk.h.

MkBufferListHandleResolve

#define MkBufferListHandleResolve

(

...

)

Value:

MkBufferListHandleResolve_RT(MK_RT_CALL __VA_ARGS__)

Definition at line 476 of file kernel_overload_mk.h.

MkBufferListHandleResolve_e

#define MkBufferListHandleResolve_e

(

netHdl

)

Value:

  ({ \
  MK_HDL tmpHdl=netHdl; \
  MK_BFL tmp; \
  if (tmpHdl==0) { \
    tmp=NULL; \
  } else { \
    tmp=MkBufferListHandleResolve(tmpHdl); \
    if (tmp==NULL) { \
      MkErrorSetC_1_NULL("ERROR: 'MkBufferListC' handle is 'NULL'"); \
      goto error; \
    }; \
  }; \
  tmp; \
})

wrapper for MkBufferListHandleResolve with error-handline

Parameters

[in]

netHdl

The handle previously returned by MkObjectHandleGet.

Returns

Return an valid libmkkernel::MK_BFL or MK_NULL with an error set.

• If netHdl is 0 than MK_NULL is returned and the upper-code decide how to deal with it.
• MkBufferListHandleResolve return an valid libmkkernel::MK_BFL or MK_NULL if the netHdl is invalid or the underlying object has already been deleted.
  • If a MK_NULL is returned than an error-message is created and a jump to the label error is done.
  • If a libmkkernel::MK_BFL is returned than the netHdl is valid.

Definition at line 284 of file MkBufferListC_def_mk.h.

#define MkBufferListHandleResolve_e(netHdl) ({ \
  MK_HDL tmpHdl=netHdl; \
  MK_BFL tmp; \
  if (tmpHdl==0) { \
    tmp=NULL; \
  } else { \
    tmp=MkBufferListHandleResolve(tmpHdl); \
    if (tmp==NULL) { \
      MkErrorSetC_1_NULL("ERROR: 'MkBufferListC' handle is 'NULL'"); \
      goto error; \
    }; \
  }; \
  tmp; \
})

MkBufferListHandleResolve_NULL

#define MkBufferListHandleResolve_NULL

(

...

)

Value:

MkBufferListHandleResolve_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 475 of file kernel_overload_mk.h.

MkBufferListInstances

#define MkBufferListInstances

(

)

Value:

MkBufferListInstances_RT(MK_RT_CALL_ONLY)

Definition at line 491 of file kernel_overload_mk.h.

MkBufferListInstances_NULL

#define MkBufferListInstances_NULL

(

)

Value:

MkBufferListInstances_RT(MK_RT_CALL_NULL_ONLY)

Definition at line 490 of file kernel_overload_mk.h.

Typedef Documentation

MK_BAC

typedef struct MkBufferListS* libmkkernel::MK_BAC

a list of 'buffer' as last argument in function …

Definition at line 1579 of file LibMkKernel_mk.h.

MK_BACN

typedef const struct MkBufferListS* libmkkernel::MK_BACN

const - a list of 'buffer' as last argument in function …

Definition at line 1584 of file LibMkKernel_mk.h.

MK_BFL

typedef struct MkBufferListS* libmkkernel::MK_BFL

class-shortcut for struct MkBufferListS *, all shortcut using the XX_YYY syntax (only for public API) …

Definition at line 1466 of file LibMkKernel_mk.h.

MK_BFLN

typedef const struct MkBufferListS* libmkkernel::MK_BFLN

class-shortcut for const struct MkBufferListS *, all const shortcut using the XX_YYYC syntax (only for public API) …

Definition at line 1469 of file LibMkKernel_mk.h.

MK_BFLR

typedef struct MkBufferListS libmkkernel::MK_BFLR

reference-shortcut for struct MkBufferListS, all shortcut using the XX_YYYR syntax (only for public API) …

Definition at line 1472 of file LibMkKernel_mk.h.

Function Documentation

MkBufferListGetNull()

static MK_BFL libmkkernel::MkBufferListGetNull ( void )

inlinestatic

Null-Slot - return a MkBufferListC typed NULL instance …

Definition at line 309 of file MkBufferListC_def_mk.h.

                                                {
    return (MK_BFL)MK_NULL;
  }

Here is the caller graph for this function:

MkBufferListHandleGet_RT()

static MK_HDL libmkkernel::MkBufferListHandleGet_RT ( MK_RT mkrt, MK_BFL const bfl )

inlinestatic

Handle-Get-Slot - returns a export-hdl to the MkBufferListC useable for external storage

The export-hdl is a reference to an instance that can be stored in software and converted back into an instance using the MkBufferListHandleResolve.

By default, the export-hdl is initialized to "0", which is equivalent to does not exist. This function returns a non-zero and unique export-hdl that is recreated if necessary.

The export-hdl is only valid until the Programming-Language-Micro-Kernel (PLMK) ends.

example: The export-hdl is used in rpc to identify an object across the network.

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 export-hdl

Definition at line 251 of file MkBufferListC_def_mk.h.

  {
  return MkObjectHandleGet(bfl?MkOBJ(bfl):NULL);
}

Here is the caller graph for this function:

MkBufferListHandleResolve_RT()

static MK_BFL libmkkernel::MkBufferListHandleResolve_RT ( MK_RT mkrt, MK_HDL const netHdl )

inlinestatic

Handle-Resolve-Slot - return a MkBufferListC from netHdl or MK_NULL if invalid…

The MkBufferListHandleResolve undo the MkBufferListHandleGet and is intended to export a unique identifer into external code not belonging to the Programming-Language-Micro-Kernel (PLMK).

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	netHdl	handle former exported with MkBufferListHandleGet

Returns

the required handle or MK_NULL if netHdl is invalid

Definition at line 268 of file MkBufferListC_def_mk.h.

  {
  return MkBfl(MkObjectHandleResolve(netHdl));
}

MkBufferListInstances_RT()

static MK_BFL libmkkernel::MkBufferListInstances_RT ( MK_RT mkrt )

inlinestatic

get head-instance from linked-list of MkBufferListS type …

The head-instance is the last instance created.

Definition at line 12666 of file LibMkKernel_mk.h.

                                                    {
  MK_INSTANCE_HDL(bfl);
  return (MK_BFL)MkBufferListC_X2obj(bfl)->obj_protect.prev;
}

Here is the caller graph for this function:

MkBufferListNext()

static MK_BFL libmkkernel::MkBufferListNext ( MK_BFL const bfl )

inlinestatic

get next instance from linked-list of MkBufferListS type

Definition at line 12673 of file LibMkKernel_mk.h.

Here is the caller graph for this function:

MkBufferListPrev()

static MK_BFL libmkkernel::MkBufferListPrev ( MK_BFL const bfl )

inlinestatic

get previous instance from linked-list of MkBufferListS type

Definition at line 12680 of file LibMkKernel_mk.h.

Here is the caller graph for this function: