m_warning_disable_var()

	#define m_warning_disable_var(var)		var = var

stability: Stable

Utilizzata per eliminare il warning in caso di non utilizzo di una variabile dichiarata.

Questa macro è utile nei casi in cui si voglia evitare dei warning dati dal compilatore, relativi alla dichiarazione di variabili non utilizzate.

Un utilizzo eccessivo di questa scappatoia può però rendere difficoltosa la ricerca di bug relativi a variabili non implementate.

Si consiglia di inserire questa macro, all'interno delle funzioni, dopo l'ultimo "return", in modo da evitare una inutile esecuzione di istruzioni.

exprtostrn()

    #define exprtostrn(expr)				#expr

stability: Stable

Converte una espressione in una stringa.

texttostrn()

    #define texttostrn(text)				#text

stability: Stable

Converte un testo in una stringa.

stringify()

    #define stringify(macro_or_string) texttostrn (macro_or_string)

stability: Stable

Accepts a macro or a string and converts it into a string after preprocessor argument expansion.

M_STRSIZE_FROM_TYPE()

    #define M_STRSIZE_FROM_TYPE(type) stringify(type), sizeof ( type )

stability: Unstable

Utilizzato in funzioni che richiedano come argomenti una stringa rappresentante un tipo di dato, e le dimensioni in byte del tipo.

iftrue

    #define iftrue  ?

stability: Stable

Macro di comprensione, utilizzata come sostituto del segno grafico '?' dell'operatore condizionale '? :'

see also: iffalse

iffalse

    #define iffalse :

stability: Stable

Macro di comprensione, utilizzata come sostituto del segno grafico ':' dell'operatore condizionale '? :'

see also: iftrue

iftrueexpr()

    #define iftrueexpr(expr)    (expr) iftrue

stability: Stable

Macro di comprensione, utilizzata come sostituto della prima sezione dell'operatore condizionale '? :'

see also: iftrue

ifelse()

    #define ifelse(expr,istr1,istr2)  iftrueexpr(expr)  istr1  iffalse  istr2

stability: Unstable

Macro di comprensione, utilizzata come sostituto dell'operatore condizionale '? :' Valuta una espressione e ritorna le istruzioni appropriate.

see also: iftrue

forinoffset()

#define             forinoffset(index,offset)

stability: Unstable

Macro di semplificazione. Assegna alla variabile index il valore 0, esegue un ciclo di istruzioni fino a che index non risulta maggiore di offset. index viene aumentato di una unità per ciclo. Differisce dalla macro cicloindex per la variabile di conteggio che in forinoffset è pubblica e possiede visibilità al di fuori del ciclo. La variabile index deve essere stata dichiarata prima dell'utilizzo di forinoffset. offset viene castato attraverso la macro ABS ottenendone il valore assoluto.

fortooffset()

#define             fortooffset(index,offset)

stability: Unstable

Macro di semplificazione. Assegna alla variabile index il valore 0, esegue un ciclo di istruzioni fino a che index non risulta uguale o maggiore di offset. index viene aumentato di una unità per ciclo. Differisce dalla macro cicloindex per la variabile di conteggio che in fortooffset è pubblica e possiede visibilità al di fuori del ciclo. La variabile index deve essere stata dichiarata prima dell'utilizzo di fortooffset. offset viene castato attraverso la macro ABS ottenendone il valore assoluto.

forsettooffset()

#define             forsettooffset(index,offset,set)

stability: Unstable

Macro di semplificazione. Assegna alla variabile index il valore 0, esegue un ciclo di istruzioni fino a che index non risulta uguale o maggiore di offset. index viene aumentato di set unità per ciclo. La variabile index deve essere stata dichiarata prima dell'utilizzo di forsettooffset. offset viene castato attraverso la macro ABS ottenendone il valore assoluto.

foroffsetto()

#define             foroffsetto(index,offset)

stability: Unstable

Macro di semplificazione. Assegna alla variabile index il valore offset, esegue un ciclo di istruzioni fino a che index non risulta minore di 0. index viene diminuito di una unità per ciclo. La variabile index deve essere del tipo mint o muint, in quest'ultimo caso viene comunque valutata come se fosse del tipo mint attraverso un casting. Differisce dalla macro cicloindexm per la variabile di conteggio che in foroffsetto è pubblica e possiede visibilità al di fuori del ciclo. La variabile index deve essere stata dichiarata prima dell'utilizzo di foroffsetto. offset viene castato attraverso la macro ABS ottenendone il valore assoluto.

foroffsettolong()

#define             foroffsettolong(index,offset)

stability: Unstable

Macro di semplificazione. Assegna alla variabile index il valore offset, esegue un ciclo di istruzioni fino a che index non risulta minore di 0. index viene diminuito di una unità per ciclo. La variabile index deve essere del tipo mlong o mulong, in quest'ultimo caso viene comunque valutata come se fosse del tipo mlong attraverso un casting. offset viene castato attraverso la macro ABS ottenendone il valore assoluto.

ciclo()

#define             ciclo(n,istructions)

stability: Unstable

Macro di semplificazione. Esegue le istruzioni istructions per n volte. Per effettuare il ciclo viene definita una variabile privata ___index, si sconsiglia di utilizzare tale variabile per le proprie istruzioni all'interno del ciclo per mantenere una buona portabilità del codice.

Nel caso fosse necessario utilizzare una variabile numerica contatore si consiglia l'utilizzo del comando 'for' o delle macros cicloindex, cicloindexm, fortooffset ,foroffsetto , foroffsettolong .

n viene castato attraverso la macro ABS ottenendone il valore assoluto.

    ciclo ( 5,
    {
        m_printf ( "\n Hello ... \n" );
    } );
  

Since 0.0.1

cicloindex()

#define             cicloindex(n,index,istructions)

stability: Unstable

Macro di semplificazione. Esegue le istruzioni istructions per n volte. Per effettuare il ciclo viene definita una variabile privata dichiarata index. La variabile di conteggio mantiene una visibilità interna al ciclo e una volta terminato questo, viene liberata. La variabile index viene inizializzata a 0 ed aumentata fino a ( n - 1 ).

Differisce dalla macro fortooffset per la variabile di conteggio che in cicloindex è privata e non possiede visibilità al di fuori del ciclo.

n viene castato attraverso la macro ABS ottenendone il valore assoluto.

    cicloindex ( 5,var,
    {
        m_printf ( "\n %u \n", var );
    } );
  

Since 0.0.1

cicloindexm()

#define             cicloindexm(n,index,istructions)

stability: Unstable

Macro di semplificazione. Esegue le istruzioni istructions per n volte. Per effettuare il ciclo viene definita una variabile privata dichiarata index. La variabile di conteggio mantiene una visibilità interna al ciclo e una volta terminato questo, viene liberata. La variabile index viene inizializzata a ( n - 1 ) e diminuita fino a 0.

Differisce dalla macro foroffsetto per la variabile di conteggio che in cicloindex è privata e non possiede visibilità al di fuori del ciclo.

n viene castato attraverso la macro ABS ottenendone il valore assoluto.

    cicloindexm ( 5,var,
    {
        m_printf ( "\n %u \n", var );
    } );
  

Since 0.0.1

mloop

    #define mloop    while(1)

stability: Stable

Macro di semplificazione. Esegue un ciclo infinito.

MGPID()

    #define MGPID(pointer,id)       (pointer + id)

stability: Stable

Macro di semplificazione. ritorna l'indirizzo di memoria alla posizione id.

m_return_if_reentry

#define             m_return_if_reentry()

stability: Unstable

Macro di semplificazione. Utilizzata all'interno di funzioni prive di valori di ritorno. Consente, se collocata come prima linea di codice, di evitare lo svolgersi di una funzione nel caso questa venga invocata più di una volta.

#include <mlib.h>
#include <mlib/mprintf.h>

    void
    func_test ( void )
{
    m_return_if_reentry();

    m_printf ( "inside!" );

    return;
}

    int
    m_main ( argc, argv )
{
    m_main_init ( argc, argv );

    m_printf ( "\n func: " ); func_test (); // stamp
    m_printf ( "\n func: " ); func_test (); // return
    m_printf ( "\n func: " ); func_test (); // return

    return MCORRECT;
}

  

Since 0.0.2

m_return_val_if_reentry()

#define             m_return_val_if_reentry(val)

stability: Unstable

Macro di semplificazione. Utilizzata all'interno di funzioni aventi valori di ritorno. Consente, se collocata come prima linea di codice, di evitare lo svolgersi di una funzione nel caso questa venga invocata più di una volta.

#include <mlib.h>
#include <mlib/mprintf.h>

    mchars
    func_test ( void )
{
    m_return_val_if_reentry ( NULL );

    return "inside!";

}

    int
    m_main ( argc, argv )
{
    m_main_init ( argc, argv );

    m_printf ( "\n func: %s ", func_test () ); // return text
    m_printf ( "\n func: %s ", func_test () ); // return null
    m_printf ( "\n func: %s ", func_test () ); // return null

    return MCORRECT;
}

  

Since 0.0.2