uiputfile Open standard dialog box for selecting and saving file.

## Syntax

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

## Arguments

### Input parameters

file_mask

  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"].

dir

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

boxTitle

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

### Output parameters

PathFileName

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

Path

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

FilterIndex

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

## Description

Creates a dialog window for file saving.

## Examples

    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
- uigetdir