Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Français - 日本語 - Русский
Ajuda do Scilab >> IGU > 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
Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Feb 14 15:00:47 CET 2019