# history

gestionnaire d'historique.

## 📝 Syntaxe

* history()
* c = history()
* s = history('size')
* f = history('filename')
* l = history('enable\_save')
* c = history('get')
* history('display')
* history('save')
* history('load')
* history('clear')
* history('duplicated')
* history('saveafter')
* history('removeexit')
* history('size', new\_size)
* history('enable\_save', true\_false)
* history('delete', lines)
* history('append', str)
* history('filename', name)
* history('load', filename\_history)
* history('save', filename\_history)
* history('duplicated', true\_false)
* history('removeexit', true\_false)
* history('get', lines)
* history('saveafter', nb\_commands)

## 📥 Argument d'entrée

* new\_size - un entier : nouvelle taille maximale de l'historique.
* true\_false - un booléen.
* lines - un entier ou un vecteur de taille 1x2.
* str - une chaîne.
* name - une chaîne : nouveau nom de fichier par défaut pour l'historique
* filename\_history - une chaîne : nom de fichier
* nb\_commands - un entier : nombre de commandes.

## 📤 Argument de sortie

* c - un tableau (cell) de chaînes.
* l - un booléen.
* s - un entier.
* f - une chaîne.

## 📄 Description

history() affiche l'historique actuel de Nelson.

c = history() renvoie l'historique actuel de Nelson sous forme d'un tableau (cell) de chaînes.

s = history('size') renvoie la taille maximale de l'historique.

f = history('filename') renvoie le nom de fichier de l'historique.

l = history('enable\_save') renvoie l'état du gestionnaire d'historique.

c = history('get') renvoie l'historique actuel de Nelson sous forme d'un tableau (cell) de chaînes.

history('display') affiche l'historique actuel de Nelson.

history('save') enregistre le fichier d'historique courant.

history('load') charge le fichier d'historique courant.

history('clear') efface l'historique.

history('duplicated') obtient l'état concernant la sauvegarde des commandes consécutives dupliquées.

history('saveafter') obtient l'état concernant la sauvegarde de l'historique après N commandes.

history('removeexit') obtient l'état concernant la non-enregistrement des sorties dans le fichier d'historique.

history('size', new\_size) définit la taille maximale de l'historique avecnew\_size.

history('enable\_save', true\_false) définit l'état du gestionnaire d'historique : false pour 'off', true pour 'on'.

history('delete', lines) supprime des lignes par index : un scalaire ou un vecteur 1x2.

history('append', str) ajoute une commande à l'historique.

history('filename', name) définit le nom de fichier de l'historique.

history('load', filename\_history) charge un fichier d'historique.

history('save', filename\_history) enregistre un fichier d'historique.

history('duplicated', true\_false) définit l'état concernant les commandes consécutives dupliquées : true supprime les doublons.

history('removeexit', true\_false) définit l'état concernant la non-enregistrement des sorties dans le fichier d'historique.

history('get', lines) renvoie l'historique actuel de Nelson sous forme d'un tableau (cell) de chaînes par index : un scalaire ou un vecteur 1x2.

history('saveafter', nb\_commands) enregistre le fichier d'historique après quenb\_commands instructions aient été ajoutées au fichier.

Astuces : vous pouvez facilement partager votre fichier d'historique dans le cloud en ajoutant quelques lignes de code dans votre fichier de démarrage utilisateur.

Si Nelson est lancé avec l'option '--nouserstartup', le fichier d'historique ne sera pas chargé au démarrage et ne sera pas enregistré à la fermeture.

## 💡 Exemples

Example to share your history file in OneDrive cloud

```matlab
OneDrivePath = getenv('OneDrive');
if (strcmp(OneDrivePath, '') == false)
  NelsonOneDrivePath = [OneDrivePath, '/Nelson'];
  mkdir(NelsonOneDrivePath);
  NelsonOneDrivePathFilename = [NelsonOneDrivePath, '/', 'Nelson.history'];
 history('filename', NelsonOneDrivePathFilename);
  history('load', NelsonOneDrivePathFilename);
end
```

```matlab
history()
c = history()
```

## 🔗 Voir aussi

[diary](https://nelson-9.gitbook.io/Nelson/markdown/fr/stream_manager/diary).

## 🕔 Historique

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