Commande save

La commande save permet de sauvegarder le document en cours.

Syntaxe

save [ prompt
     | visible
     | trim
     | noTrim
     | textLimit n
     | encoding codageCar
     | lineSeparator { CRLF | CR | LF }
     ] [...]
     [ "nomfichier" ] 

Paramètres

prompt Le paramètre facultatif prompt permet d'inviter l'utilisateur à indiquer le nom du fichier dans lequel doit être sauvegardé ce document.
visible Le paramètre facultatif visible permet d'indiquer que seuls les éléments visibles doivent être sauvegardés.
trim Le paramètre facultatif trim permet de préciser que les espaces de début et de fin de toutes les lignes du document doivent être supprimés. Si vous ne spécifiez pas le paramètre trim ou noTrim, l'option considère que le paramètre current.save.trim fait foi.
noTrim Le paramètre facultatif noTrim permet de s'assurer que les espaces de début et de fin des lignes du document n'ont pas été supprimés. Si vous ne spécifiez pas trim ou noTrim, l'option considère que le paramètre current.save.trim fait foi.
textLimit n Le paramètre facultatif textLimit permet d'indiquer la longueur maximale de la ligne. n doit être un entier supérieur ou égal à zéro. Si n est égal à zéro, aucune longueur maximale de ligne n'est appliquée. Les lignes sont tronquées si leur longueur excède celle de la valeur n. Si vous ne spécifiez pas le paramètre textLimit, la valeur est extraite du paramètre current.save.textLimit.
encoding codageCar Le paramètre facultatif encoding permet de spécifier le codage appliqué aux caractères du fichier sauvegardé. Si vous ne spécifiez pas le paramètre encoding, le codage utilisé pour charger le fichier d'origine est utilisé.
lineSeparator Le paramètre facultatif lineSeparator permet de spécifier les caractères délimiteur de ligne à utiliser pour la sauvegarde. Vous pouvez spécifier l'une des valeurs suivantes :
  • CRLF - "\r\n" (0x0D, 0x0A)
  • LF - "\n" (0x0A)
  • CR - "\r" (0x0D).
Si vous ne spécifiez pas lineSeparator, le séparateur de ligne par défaut de la plateforme est utilisé.
nomfichier Le paramètre nomfichier permet de spécifier le nom du fichier sous lequel ce document doit être sauvegardé. Si vous ne le spécifiez pas, le document est sauvegardé sous le nom du paramètre name.

Etat

Le paramètre status peut prendre l'une des valeurs suivantes :
null Indique que la sauvegarde a abouti.
save.failed Indique que la sauvegarde n'a pas abouti.
save.cancelled Indique que la sauvegarde a été annulée par l'utilisateur.

Description

Lors d'une sauvegarde sous un nom de fichier différent, les paramètres trim et textLimit ne sont pas utilisés.

Remarque : L'implémentation des opérations de sauvegarde dans un éditeur peut différer du comportement de l'éditeur de base, comme décrit ici.

Exemples

save
save "test.java" 
Concepts connexes
Commandes, actions et paramètres de l'éditeur

Références
Paramètre length
Paramètre name
Paramètre save.lineSeparator
Paramètre save.textLimit
Paramètre save.trim
Paramètre visible
Action save
Action saveAs
Action saveToWriter
Commandes de l'éditeur par défaut