@VERSION[nom de fichier[,séparateur[,début[,force][,préfixe]]]]: renvoie un remplacement sériel "versionné" pour le nom de fichier. Si le fichier n'existe pas et que force n'est pas défini, @VERSION renvoie le nom du fichier.
Si le nom de fichier est cité, le nom de fichier retourné sera également cité (si nécessaire).
Cette fonction est différente de celle de @UNIQUE[] en ce sens qu'elle conserve l'intégralité du nom de fichier et n'y ajoute qu'un caractère de séparation de version et un numéro de version croissant. @VERSION ne crée pas le fichier ; il renvoie simplement le nom de la prochaine version disponible.
@VERSION a quatre arguments :
| filename | Le nom du fichier à "versionner" (obligatoire ) |
| separator | Le caractère de séparation de la version (facultatif, la valeur par défaut est ';'). Notez que le caractère TCC est ;, donc si vous voulez utiliser ; dans un nom de fichier, vous devrez mettre le nom de fichier entre guillemets. |
| start | Le numéro de version de départ (si nécessaire pour ajouter un numéro de version ; facultatif, la valeur par défaut est '1 ') |
| force | Le drapeau pour forcer le versionnage, même si le fichier n'existe pas (optionnel, valeur par défaut 0 ou FALSE). |
| prefix | Si prefix est 0, @VERSION ajoutera le numéro de version à la fin de l'extension. Si prefix est 1, @VERSION préfixera le numéro de version à l'extension. (Facultatif, la valeur par défaut est 0). |
Exemples :
echo %@version[myfile.txt]
myfile.txt;1
echo %@version[myfile.txt]
myfile.txt;2