...pro funkce převodu textového tvaru programu na binární a naopak:

• rpnprocmkjcb_t - callback funkce pro rpnproc_makejob().
• rpnprocmkjval_t - union použitý jako argument pro callback funkci rpnprocmkjcb_t.
• rpnproclsjval_t - struktura argumentů pro rpnproc_listjob() resp. rpnproc_listone().

...pro funkce pro provádění programu:

• rpnprocexecb_t - callback funkce pro rpnproc_execute().
• rpnprocexeval_t - struktura použitá jako argument pro callback funkci rpnprocexecb_t.

Prosté datové typy:

• Kód instrukce
  typedef unsigned char           rpnproccode_t;
• Parametr instrukce
  #define  RPNPROC_PARAM_LIMIT    1000
  typedef unsigned short          rpnprocparam_t;
• Hodnota výpočtu
  typedef unsigned long           rpnprocvalue_t;
• Program (job) (pointer)
  typedef rpnproccode_t           *rpnprocjobp_t;
• Program (job) (pole pro statické vytváření programu)
  typedef rpnproccode_t           rpnprocjobt_t[];
• Handle
  typedef struct rpnprochndls     *rpnprochndp_t;

SYNOPSIS

typedef int (*rpnprocmkjcb_t)(int __mkjcb, rpnprocmkjval_t *, void *__userdata);

DESCRIPTION

Funkce je volána z funkce rpnproc_makejob() z důvodů, které rozlišuje argument __mkjcb. Jakých tento argument nabývá hodnot a co znamenají popisuje následující tabulka.

RETURN VALUE

Možností, co vrátit, tato funkce nemá mnoho:

• RPNPROC_CB_CONT - pokračovat v činnosti,
• RPNPROC_CB_BREAK - zastavit provádění.

SYNOPSIS

typedef union
{
    struct
    {
        rpnprocjobp_t   jobp;
        int             size;
    } memjob;
    char                linet[RPNPROC_LINE_SIZE];
} rpnprocmkjval_t;

DESCRIPTION

Jak bylo uvedeno v popisu callback funkce rpnprocmkjcb_t pro různé typy rozlišení žádosti vrstvy "RPNPROC" jsou použity různé členy tohoto unionu:

• Při žádosti o paměť musí callback funkce nalplnit člen .jobp pointerem na přidělenou paměť, a do členu .size vložit velikost (počet byte) této paměti.
Při žádosti o řádku programu s aktuální instrukcí pro převod callback funkce nakopíruje (obvykle použitím strcpy()) příslušný text do bufferu .linet.

SYNOPSIS

typedef int (*rpnproclsjcb_t)(char __linetxt[], void *__userdata);

DESCRIPTION

Voláním této funkce vrstva "RPNPROC" předá uživatelskému programu jednu řádku programu v textovém tvaru (viz popis funkce rpnproc_listjob()).

RETURN VALUE

Návratové hodnoty jsou popsané zde.

SYNOPSIS

typedef struct
{
    int             radix;
    unsigned long   delim;
    rpnproclsjcb_t  fncp;
    void            *userdata;
} rpnproclsjval_t;

DESCRIPTION

Struktura sdružuje argumenty společné funkcím rpnproc_listjob() a rpnproc_listone(). Argumenty mají následující významy:

• .radix učuje číselnou soustavu přímého operandu instrukcí. Možné hodnoty přináší tabulka:
  
  

  Název	Číselná soustava
  RPNPROC_LIST_RADIX_SGN	desítková se znaménkem
  RPNPROC_LIST_RADIX_UNS	desítková bez znaménka
  RPNPROC_LIST_RADIX_HEX	šestnáctková
  RPNPROC_LIST_RADIX_OCT	osmičková

  
  
• .delim specifikuje skupinu znaků/oddělovačů použitou ve výpisu. Nejčastější hodnotou tohoto argumentu bude macro RPNPROC_LIST_DELIM_DEFLT, ale je možné si určit jiné oddělovací znaky použitím macra RPNPROC_LIST_DELIM(n, a, i, p). Argumenty tohoto macra reprezentují znaky:
  
  

  Název argumentu	Význam (použití znaku)
  n	znaky pro neexisující navěští
  a	oddělovač navěští od čísla řádku
  i	oddělovač instrukce od adresy
  p	oddělovač parametru od instrukce

  
  
• .fncp je pointer na callback funkci poskytující jednu řádku "zpětného překladu". Detailní popis je zde.
• .userdata jsou uživatelská data pro callback funkci. V podstatě libovolné číslo, které má vrstva "RPNPROC" předat voláním callback funkce.

SYNOPSIS

typedef int (*rpnprocexecb_t)(int __execb, rpnprocexeval_t *, void *__userdata);

DESCRIPTION

Funkce je volána z funkce rpnproc_execute() z důvodů, které rozlišuje argument __execb. Jakých tento argument nabývá hodnot a co znamenají popisuje následující tabulka. (Kromě prvních dvou se jedná o chybová hlášení).

RETURN VALUE

Návratové hodnoty jsou popsané zde.

SYNOPSIS

typedef struct
{
    int             lblidx;
    unsigned        lineno;
} rpnproctrace_t;

typedef struct
{
    rpnproctrace_t  tracev;
    rpnprocjobp_t   curjobp;
} rpnproctrcjob_t;

typedef struct
{
    rpnprocvalue_t  stackx;
    rpnproctrcjob_t trcjobv;
} rpnprocexeval_t;

DESCRIPTION

Tyto tři do sebe vnořené struktury obsahují členy, které poskytují následující informace:

• .lblidx - Číslo návěští platící pro aktuální úsek programu. Terminologií jazyka "C" by bylo možné mluvit o identifikaci právě prováděné funkce.
• .lineno - Číslo řádky (line); číslování od nuly začíná s každým novým návěštím.
• .curjobp - Aktuální pozice v programu.
• .stackx - Hodnota X-registru RPN stacku.

Statické vytváření programu.

Na řadě míst tohoto textu je popisován vznik programu pro RPN procesor použitím funkce rpnproc_makejob(). Není to však jediná cesta. Binární kód je možno zapsat přímo do "statického pole" tasku používajícího SW vrstvu RPNPROC. Každého samozřejmě okamžitě napadne námitka "Proč bych psal RPN kód rovnou do programu? To můžu napsat požadovaný postup/výpočet do svýho programu rovnou a na celej RPN procesor se vyfláknu, ne?!" S takovou námitkou lze pouze souhlasit, jiná cesta není. Přesto je tato možnost uživateli ponechána a přostředky pro to jsou v headeru rpnproc.h obsaženy.
K čemu to tedy opravdu je?
Uspokojivá odpověď se nachází skutečně obtížně. Přesto zde je příklad, který by mohl býti typickým:

• Výpočet prováděný RPN procesorem bude vracet více hodnot (než jenom tu z X-registru) tak, že jimi obsadí i ostatní registry RPN stacku. Postup, který hodnoty z těchto registrů "dostane" je vrcholně jednoduchý. Bude obsahovat jedinou instrukci: Rdn.

Ukázka statického vytváření programu je zde.