Differenze tra le versioni di "L'oggetto File secondo i sorgenti di Gambas"

Da Gambas-it.org - Wikipedia.
(Creata pagina con "Un ''Oggetto'' in Gambas è costituito e vive grazie ad una complessa serie di aree di memoria riservate, rappresentate solitamente da diverse ''Strutture'' e relative sub-str...")
 
 
(14 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
Un ''Oggetto'' in Gambas è costituito e vive grazie ad una complessa serie di aree di memoria riservate, rappresentate solitamente da diverse ''Strutture'' e relative sub-strutture, dichiarate in uno o più file ''header'' dei sorgenti Gambas. Anche l'Oggetto di tipo ''File'' in Gambas risponde a tale caratteristica.
+
Un ''[[Oggetti, Classi e Moduli|Oggetto]]'' in Gambas è costituito e vive grazie ad una complessa serie di aree di memoria riservate, rappresentate solitamente da diverse ''Strutture'' e relative sub-strutture, dichiarate in uno o più file ''header'' dei sorgenti Gambas, scritti in linguaggio C.
 +
<BR>Anche l'Oggetto di tipo ''File'' in Gambas risponde a tale caratteristica, ossia di impiegare diverse risorse di memoria allocata sotto forma di ''Strutture'' e di sub-''Strutture''.
  
L'Oggetto ''File'' in Gambas ha come primo riferimento la Struttura, denominata "''CFILE''" e presente nel file header "''.../main/gbx/gbx_c_file.h''" dei sorgenti di Gambas, ove è così dichiarata:
+
Come sappiamo un file può essere aperto in lettura e/o scrittura con la funzione ''Open'', la quale restituisce una variabile appunto di tipo "File", che rappresenta l'<I>handle</i> per gestire il file.
 +
 
 +
L'Oggetto ''File'' in Gambas ha come primo riferimento la Struttura, denominata "''CFILE''" e presente nel file header "''.../main/gbx/gbx_c_file.h'' " dei sorgenti, scritti in C, di Gambas, ove è così dichiarata:
 
  typedef
 
  typedef
 
         struct {
 
         struct {
 
                 CSTREAM ob;
 
                 CSTREAM ob;
                int watch_fd;
 
 
                 }
 
                 }
 
         CFILE;
 
         CFILE;
Come si può notare, tale Struttura è formata da soli due membri:
+
Il membro "''CSTREAM ob''" rappresenta a sua volta un'altra Struttura presente nel citato file header "''.../main/gbx/gbx_c_file.h''" dei sorgenti di Gambas, ove è così dichiarata:
* ''CSTREAM ob;''
 
* ''int watch_fd;''
 
<BR>Il secondo membro ''watch_fd'' è un intero che rappresenta il ''descrittore'' del file aperto.
 
<BR>Il primo membro, ''CSTREAM ob'', invece rappresenta a sua volta un'altra Struttura presente nel citato file header "''.../main/gbx/gbx_c_file.h''" dei sorgenti di Gambas, ove è così dichiarata:
 
 
  typedef
 
  typedef
 
         struct {
 
         struct {
Riga 20: Riga 18:
 
                 }
 
                 }
 
         CSTREAM;
 
         CSTREAM;
Il primo membro di quest'altra sub-Struttura è un ''Puntatore'' ad un'ulteriore Struttura di tipo ''OBJECT'', dichiarata nel file header "''.../main/gbx/gbx_class.h''" dei sorgenti di Gambas, e dalla quale potremo ottenere qualche informazione sulla variabile di tipo ''File'' utilizzata nel codice.
+
Il primo membro di quest'altra sub-Struttura è un ''Puntatore'' ad un'ulteriore Struttura di tipo ''OBJECT'', dichiarata nel file header "''.../main/gbx/gbx_object.h''" come segue:
 +
typedef
 +
        struct {
 +
                CLASS *class;
 +
                intptr_t ref;
 +
                }
 +
        OBJECT;
 +
Il primo membro di questa Struttura è a sua volta un ''Puntatore'' ad un'altra Struttura, denominata "''CLASS''" e dichiarata nel file header "''.../main/gbx/gbx_class.h''" dei sorgenti di Gambas, e dalla quale potremo ottenere qualche informazione sulla variabile di tipo ''File'' utilizzata nel codice.
  
  
Per penetrare nelle suddette ''Strutture'' e leggerne alcuni valori, in esse contenuti, dovremo sevirci del Metodo ''.Address( )'' dea Classe ''Object'', come nell'esempio seguente:
+
Per accedere alle suddette ''Strutture'' e leggerne alcuni valori, in esse contenuti, dovremo servirci del Metodo ".Address()" della Classe ''Object'', come nell'esempio seguente:
  '''Public''' Sub Main()
+
  Public Sub Main()
 
    
 
    
  Dim fl As File
+
  Dim fl As File
  Dim p1, p2 As Pointer
+
  Dim p1, p2 As Pointer
 
+
 
   fl = Open "<FONT Color=gray>''/percorso/del/file''</font>" For Read
+
   fl = Open "<FONT Color=darkgreen>''/percorso/del/file''</font>" For Read
   If IsNUll(fl) Then Error.Raise("Impossibile aprire il file !")
+
   If IsNull(fl) Then Error.Raise("Impossibile aprire il file !")
 
    
 
    
  <FONT Color=gray>' ''p1 rappresenta: "struct CFILE.CSTREAM ob;" in "User.Home &/ trunk/main/gbx/gbx_c_file.h"''</font>
+
  <FONT Color=gray>' ''p1 rappresenta la Struttura: "struct CFILE" in ".../main/gbx/gbx_c_file.h"''</font>
 
   p1 = Object.Address(fl)
 
   p1 = Object.Address(fl)
 
+
 
 
+
<FONT Color=gray>' ''p2 rappresenta: "struct CLASS" in ".../main/gbx/gbx_class.h"''</font>
 
+
  p2 = Pointer@(p1)
 
+
<FONT Color=gray>' ''Accediamo al membro "int count;" della Struttura "struct CLASS", posto al byte di indice 12 e ne dereferenziamo il Puntatore, per ottenere il numero di "istanze" della Classe "File" esistenti nel codice:''</font>
<FONT Color=red size=4><B>Pagina in costruzione !</b></font>
+
  Print Int@(p2 + (SizeOf(gb.Integer) * 3))
 +
<FONT Color=gray>' ''Accediamo al membro "char *name;" della Struttura "struct CLASS", posto al byte di indice 24 e ne dereferenziamo il Puntatore, per ottenere la denominazione del tipo della variabile "fl":''</font>
 +
  Print String@(Pointer@(p2 + (SizeOf(gb.Pointer) * 3)))
 +
 
 +
  fl.Close
 +
 
 +
End

Versione attuale delle 16:41, 23 nov 2024

Un Oggetto in Gambas è costituito e vive grazie ad una complessa serie di aree di memoria riservate, rappresentate solitamente da diverse Strutture e relative sub-strutture, dichiarate in uno o più file header dei sorgenti Gambas, scritti in linguaggio C.
Anche l'Oggetto di tipo File in Gambas risponde a tale caratteristica, ossia di impiegare diverse risorse di memoria allocata sotto forma di Strutture e di sub-Strutture.

Come sappiamo un file può essere aperto in lettura e/o scrittura con la funzione Open, la quale restituisce una variabile appunto di tipo "File", che rappresenta l'handle per gestire il file.

L'Oggetto File in Gambas ha come primo riferimento la Struttura, denominata "CFILE" e presente nel file header ".../main/gbx/gbx_c_file.h " dei sorgenti, scritti in C, di Gambas, ove è così dichiarata:

typedef
       struct {
               CSTREAM ob;
               }
       CFILE;

Il membro "CSTREAM ob" rappresenta a sua volta un'altra Struttura presente nel citato file header ".../main/gbx/gbx_c_file.h" dei sorgenti di Gambas, ove è così dichiarata:

typedef
       struct {
               OBJECT ob;
               STREAM stream;
               GB_VARIANT_VALUE tag;
               }
       CSTREAM;

Il primo membro di quest'altra sub-Struttura è un Puntatore ad un'ulteriore Struttura di tipo OBJECT, dichiarata nel file header ".../main/gbx/gbx_object.h" come segue:

typedef
       struct {
               CLASS *class;
               intptr_t ref;
               }
       OBJECT;

Il primo membro di questa Struttura è a sua volta un Puntatore ad un'altra Struttura, denominata "CLASS" e dichiarata nel file header ".../main/gbx/gbx_class.h" dei sorgenti di Gambas, e dalla quale potremo ottenere qualche informazione sulla variabile di tipo File utilizzata nel codice.


Per accedere alle suddette Strutture e leggerne alcuni valori, in esse contenuti, dovremo servirci del Metodo ".Address()" della Classe Object, come nell'esempio seguente:

Public Sub Main()
 
  Dim fl As File
  Dim p1, p2 As Pointer
  
  fl = Open "/percorso/del/file" For Read
  If IsNull(fl) Then Error.Raise("Impossibile aprire il file !")
  
' p1 rappresenta la Struttura: "struct CFILE" in ".../main/gbx/gbx_c_file.h"
  p1 = Object.Address(fl)
  
' p2 rappresenta: "struct CLASS" in ".../main/gbx/gbx_class.h"
  p2 = Pointer@(p1)
' Accediamo al membro "int count;" della Struttura "struct CLASS", posto al byte di indice 12 e ne dereferenziamo il Puntatore, per ottenere il numero di "istanze" della Classe "File" esistenti nel codice:
  Print Int@(p2 + (SizeOf(gb.Integer) * 3))
' Accediamo al membro "char *name;" della Struttura "struct CLASS", posto al byte di indice 24 e ne dereferenziamo il Puntatore, per ottenere la denominazione del tipo della variabile "fl":
  Print String@(Pointer@(p2 + (SizeOf(gb.Pointer) * 3)))
  
  fl.Close
  
End