# fgets

Lire une chaîne depuis un fichier, s'arrêtant après un saut de ligne, la fin du fichier ou après n caractères lus.

## 📝 Syntaxe

* res = fgets(f)
* res = fgets(f, n)

## 📥 Argument d'entrée

* f - un descripteur de fichier
* n - un scalaire : nombre de caractères

## 📤 Argument de sortie

* res - une chaîne ou -1

## 📄 Description

Lit une chaîne depuis un fichier, s'arrêtant après un saut de ligne, la fin du fichier (EOF) ou après la lecture de n caractères.

S'il n'y a plus de caractère à lire, fgets renverra -1.

Si n est omis, fgets lit jusqu'au saut de ligne suivant.

L'encodage des caractères utilise le paramètre fopen.

## 💡 Exemples

```matlab
  fid = fopen([nelsonroot(), '/etc/startup.m']);
  tline = fgets(fid);
  while ischar(tline)
  disp(tline)
  tline = fgets(fid);
  end

  fclose(fid);
```

```matlab
fid = fopen([nelsonroot(), '/etc/startup.m']);

  tline = fgets(fid, 5);
  while ischar(tline)
  disp(tline)
  tline = fgets(fid, 5);
  end

  fclose(fid);
```

## 🔗 Voir aussi

[fclose](https://nelson-9.gitbook.io/Nelson/markdown/fr/stream_manager/fclose), [fopen](https://nelson-9.gitbook.io/Nelson/markdown/fr/stream_manager/fopen), [fgetl](https://nelson-9.gitbook.io/Nelson/markdown/fr/stream_manager/fgetl).

## 🕔 Historique

| Version | 📄 Description   |
| ------- | ---------------- |
| 1.0.0   | version initiale |
