# uiputfile

## Purpose

Retrieve name of a file to write to through a dialog box.

## Synopsis

    [filename,pathname] = uiputfile('initFile','boxTitle',x,y)

## Description

`[filename,pathname] = uiputfile('initFile','boxTitle',x,y)` displays a dialog box in which you can fill in or select the filename and path strings, where

- `initFile` determines the initial display of files in the dialog box. This string can be a full filename, or it may include wildcards. For example, `'newfile.m'` initializes the text box to that filename, providing a default. A wildcard specification such as `'`*`.m'` does not provide a default, but the scroll box lists all files with the ".m" extension.
- `boxTitle` is a string containing the title of the dialog box.
- `x` is the x-position, in pixels, of the lower-left corner of the dialog box (not supported on all systems).
- `y` is the y-position, in pixels, of the lower-left corner of the dialog box (not supported on all systems).
  All parameters are optional, but if one is present, all preceding parameters must also be present. If you select a file that exists, a prompt is issued asking whether you want to delete the file. A Yes response successfully returns but does not delete the file (which is the responsibility of the calling routines). A No response returns control back to the dialog box. You can then enter another filename or press the Cancel button.

  `filename` is a string containing the name of the file selected in the dialog box. If you press the Cancel button or if any error occurs, `filename` is set to 0.

  `pathname` is a string containing the path of the file selected in the dialog box. If you press the Cancel button or if any error occurs, `pathname` is set to 0.

  ## Examples

  An example of `uiputfile`'s operation on one platform is

      [fname,pname] = uiputfile('animinit.m','Example Dialog
      Box')

      fname =
      animinit.m

      pname =
      /amnt/u/home2/pat

  The exact appearance of the dialog box depends on your windowing system.

  ## See Also

      uigetfile

  (c) Copyright 1994 by The MathWorks, Inc.