Donc voici comment créer un fichier :

HANDLE handle;
char *ptrFILE;
SYM_ENTRY *sym ;

handle=HeapAlloc(16);
if(!handle) return;
sym=DerefSym(SymAdd(SYMSTR("tuto")));
if(!sym) {HeapFree(handle); return;}
sym->handle=handle;
ptrFILE=HeapDeref(handle);
*(short*)ptrFILE=14;
ptrFILE[10]=0;
strcpy(ptrFILE+11,"TUT");
ptrFILE[15]=OTH_TAG;

Nous allons étudier chaque ligne ensemble.

handle=HeapAlloc(16);

Ici, on attribue une taille de 16 octets au handle. Cette taille est la taille du fichier que l'on désire créer, donc ici un fichier de 16 octets.

if(!handle) return;

Ici, on teste si l'espace mémoire que l'on a attribué a l'handle a bien été alloué. Si ça n'est pas le cas (pour manque de mémoire), on quitte.

sym=DerefSym(SymAdd(SYMSTR("tuto")));

Ensuite, on crée une entrée SYM (SYM_ENTRY) en précisant le nom que l'on veut donner au fichier. (Le SYMSTR sert à créer un nom de fichier au format voulu par les routines de fichiers de AMS.) Ici, le nom sera tuto.

if(!sym) {HeapFree(handle); return;}

Ici, on teste également que l'allocation du sym s'est bien passée. S'il n'y a pas assez de place on quitte, après avoir libéré le handle alloué auparavant.

sym->handle=handle;

On copie le handle de notre handle déclaré dans la structure sym.

ptrFILE=HeapDeref(handle);

On met l'adresse du handle dans le pointeur que l'on a déclaré.

*(short*)ptrFILE=14;

Ici on attribue le premier word (les 2 premiers octets) du fichier. Il correspond a la taille du fichier moins les deux octets de fin donc ici 16-2=14.

Ensuite, selon le fichier que vous voulez créer, vous avez plus ou moins d'octets disponibles. Ici j'utilise une extension personnelle qui est TUT donc il me faut 5 octets à la fin (3 octets plus les octets nuls avant et après la chaîne de caractères) pour la mettre plus le dernier octet d'extension, ici OTH_TAG pour une extension personnel. Pour une extension personnelle on peut aller jusqu'à 4 caractères alpha.

ptrFILE[10]=0;
strcpy(ptrFILE+11,"TUT");

Donc ici je met mon extension en fin de fichier juste avant l'avant dernier octet. L'octet nul devant la chaîne doit être mis explicitement, celui après la chaîne sera mis par le strcpy.

ptrFILE[15]=OTH_TAG;

Ici, je mets l'extension TI utilisée dans le dernier octet du fichier qui est toujours la taille du fichier déclare au départ moins un. Donc ici 16-1=15.

Voilà pour la création d'un fichier, j'espère avoir été assez clair.

Nous allons maintenant voir comment lire un fichier.

SYM_ENTRY *sym = SymFindPtr(SYMSTR("tuto"),0);
if(!sym) return;
ptrFILE=HeapDeref(sym->handle);

SYM_ENTRY *sym = SymFindPtr(SYMSTR("tuto"),0);

Ici, nous créons un SYM_ENTRY comme tout à l'heure, à la différence que celui-ci pointe sur le fichier que l'on veut ouvrir, ici tuto.

if(!sym) return;

Si le fichier n'existe pas, on quitte.

ptrFILE=HeapDeref(sym->handle);

On met l'adresse du handle dans le pointeur que l'on a déclare.

Voilà, il ne reste plus qu'a lire ce que vous désirez avec un memcpy.

memcpy(&lire,ptrFILE+2,4);

Par exemple, là, on lit les 4 octets de ptrFILE de l'octet 2 à l'octet 6.

Remarquez qu'il n'est souvent pas nécessaire de copier les données. On peut souvent les lire directement du fichier, à condition de verrouiller le handle avec HeapLock. C'est le cas si le fichier contient par exemple des sprites ou des chaînes de caractères.