BC10PushBuf
B = Buffer
C = Funzioni di Calcolo
La funzione BC10PushBuf inserisce un valore in un buffer circolare. La funzione richiede un valore in ingresso nella variabile 'NewElement' e lo inserisce nel buffer in una posizione che è sconosciuta all'utilizzatore e che viene gestita solamente dalle funzioni di push e dalla complementare funzione di pop.
IMPLEMENTAZIONE
BC10PushBuf (Buffer, NewElement, ErrorCode)
Parametri:
| IN/OUT | TIPO VARIABILE | NOME DI ESEMPIO | DIM | |
|---|---|---|---|---|
| IN | ARRSYS | Buffer | B/W/L/S | Array contenente il Buffer |
| IN | GLOBAL | NewElement | L/S | Variabile contenente il valore da introdurre nel buffer |
| OUT | GLOBAL | ErrorCode | F | Variabile contenente l'errore eventualmente occorso in fase di inserimento del valore |
Errore
Una volta richiamata la funzione se ci sono degli errori la variabile di errore (ErrorCode) assume i seguenti valori:
0 - Nessun errore
1 - Buffer pieno
Esempio
Inserisce il valore del conteggio di un device nel buffer circolare ad ogni fronte del flag “gfInsVal”
MAIN:
IF gfInsVal
gfInsVal = 0
NewElement = count:posit
BC10PushBuf (Buffer, NewElement, ErrorCode)**
ENDIF
Note
-
L'utilizzo di questa funzione è legato alla funzione BC10InitBuf che inizializza il buffer in questione e che deve essere richiamata almeno una volta prima della funzione BC10PushBuf.
-
La funzione complementare a questa è la funzione BC10PopBuf che estrae un dato dalla coda del buffer circolare.