org.vishia.bridgeC

Class Va_list

java.lang.Object

org.vishia.bridgeC.Va_list

public class Va_list
extends java.lang.Object

Represents a Java-complement to a C-struct which contains va_list reference from stdarg.h. The struct in C has the form:

 typedef struct Va_listFW_t
 { 
   char const* typeArgs;    //types of arguments.
   va_list args;            //pointer to the last known variable in stack
 } Va_listFW;
 

In Java the instance contains a reference to VaArgBuffer only. For compatibility with C-translated Java one can only initialize the Va_list with a variable which is the variable argument of a methods argument list. In Java semantic you can initalize with any variable, but that is not able to translate from Java to C (Java2C).

Field Summary

Fields

Modifier and Type	Field and Description
(package private) VaArgBuffer	buffer
static int	version Version, history and license.

Constructor Summary

Constructors

Constructor and Description
Va_list(java.lang.Object... args) Constructs a Va_list object which is the conterpart to a C-language Va_listFW.
Va_list(VaArgBuffer buffer)

Method Summary

Modifier and Type	Method and Description
java.lang.Object[]	get() Returns the stored arguments.
int	size() Returns the number of arguments in the variable argument list.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

version

public static int version

Version, history and license.

• 2013-03-24 Hartmut new: size() If size()=0 it has no data. Then the list should not be used to invoke String.format(String, Object...).
• 2007-00-00 Hartmut created

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL ist not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

buffer

final VaArgBuffer buffer

Constructor Detail

Va_list

public Va_list(VaArgBuffer buffer)

Va_list

public Va_list(java.lang.Object... args)

Constructs a Va_list object which is the conterpart to a C-language Va_listFW. The argument args in C-language is a pointer to variable arguments in the stack, more exact to the last known variable before a variable argument list follows. This last known variable should be a String Literal with contains the type characters like "FIB" by convention. That is a pointer of type char const*. In C-language the both values are gotten with

 myVA_list.typeArgs = args;
 va_start(myVA_list.args, args);
 

In Java a variable argument list is a Object[].

Parameters:

args - refers a variable argument list.

Method Detail

get

public java.lang.Object[] get()

Returns the stored arguments. In Java it is a Object[]. In C the va_list is used immediate.

size

public int size()

Returns the number of arguments in the variable argument list. In the C implementation it is the sizeof(typeArgs).

Returns:

especially 0 if no variable arguments are given.