Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- software:qview:qview_6:qcl_library:bc10popbuf [2019/08/29 17:01] – creata - modifica esterna 127.0.0.1
+++ software:qview:qview_6:qcl_library:bc10popbuf [2024/09/02 14:33] (versione attuale) – [Errore] qem214
@@ Linea 1: / Linea 1: @@
+====== BC10PopBuf ======
+**B = **//Buffer//
+**C = **//Funzioni di Calcolo//
+La funzione BC10PopBuf estrae__ un valore da un buffer circolare__. Ad ogni chiamata della funzione quest'ultima fa in modo di estrarre dalla coda del buffer circolare il primo dato immesso e di porlo in una variabile.
+===== IMPLEMENTAZIONE =====
+**BC10PopBuf (Buffer, Element, ErrorCode)**
+Parametri:
+^IN/OUT^TIPO VARIABILE^NOME DI ESEMPIO^DIM^^
+|  IN  |  ARRSYS  |  Buffer  |  B/W/L/S  |Array contenente il Buffer|
+|  OUT  |  GLOBAL  |  Element  |  L/S  |Variabile nella quale viene posto il valore estratto dal 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:\\
+- Nessun errore\\
+- Buffer vuoto
+=== Esempio ===
+Estrae un dato dalla coda del buffer e lo pone nella variabile "glDato" ad ogni fronte della variabile "gfEstrai"
+<code QCL>
+;...
+MAIN:
+     IF gfEstrai
+           gfEstrai = 0
+           BC10PopBuf (Buffer, Element, ErrorCode)
+           IF NOT ErrorCode
+              glDato = Element
+           ENDIF
+     ENDIF
+</code>
+=== 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 **BC10PushBuf** che immette un dato nella coda del buffer circolare.