Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.0 - Français

Change language to:
English - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Aide de Scilab >> Interface graphique > uiputfile


Open standard dialog box for selecting and saving file.


PathFileName = uiputfile()
PathFileName = uiputfile(file_mask)
PathFileName = uiputfile(file_mask, dir)
PathFileName = uiputfile(file_mask, dir, boxTitle)
[PathFileName, Path] = uiputfile(..)
[PathFileName, Path, FilterIndex] = uiputfile(..)


Input parameters

Matrix of strings providing the file masks to use for file selection. file_mask is written with Unix conventions. The default value is '*'.

A description of each mask may be provided in column#2 and displayed, for example ["*.xcos|*.zcos*","Xcos files"; "*.scg", "Scilab graphics"].


a character string which gives the initial directory used for file search. By default uiputfile uses the previously selected directory.


a character string which gives the title of the uiputfile window. By default uiputfile's title is 'uiputfile'.

Output parameters

String which gives the user selected file (path + file name) if the user quits with "OK", or " " if the user quits with "Cancel".


is the user selected file path if user answers "Ok" or the " " string if user answers "Cancel".


is the user selected filter index on the list box if the user quits with "OK", or "0" if the user quits with "Cancel".


Creates a dialog window for file saving.


uiputfile(["*.bin"; "*.sce"; "*.cos*"])
uiputfile(["*.xcos|*.zcos", "Xcos files"; "*.sce|*.sci", "Scilab scripts"])
uiputfile(["*.sci"; "*.bin"], "SCI/modules/gui/macros/")
uiputfile(["*.sc*"; "*.bin"], "SCI/modules/gui/macros/")
uiputfile(["*.x*","X files"; "*.bin","BIN files"], "SCI/modules/gui/macros/")
uiputfile(["*.sce"; "*.bin"], "SCI/modules/gui/macros/", "Choose a file name");

See also

  • uigetfile — dialog window to get a file(s) name(s), path and filter index
  • uigetdir — dialog for selecting a directory
Report an issue
<< uigetfont Interface graphique usecanvas >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Tue Feb 25 08:50:27 CET 2020