This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


List variables in workspace, with sizes and types


whos -file filename
whos global
whos ___ variables
S = whos(___)



whos lists in alphabetical order the names, sizes, and types of all variables in the currently active workspace.


whos -file filename lists variables in the specified MAT-file.

whos global lists variables in the global workspace.


whos ___ variables lists only the specified variables. You can specify variables with any of the arguments in the previous syntaxes.


S = whos(___) stores information about the variables in the structure array S.


You must use the functional form of whos when there is an output argument.


collapse all

Display information about specific variables in the current workspace. For example, list information about variables with names that start with the letter a.

whos a*

Now, list information about variables with names that end with ion.

whos -regexp ion$

Display all the information on the variables stored in the sample MAT-file durer.mat.

whos -file durer.mat
  Name           Size               Bytes  Class     Attributes

  X            648x509            2638656  double              
  caption        2x28                 112  char                
  map          128x3                 3072  double              

Store information about the variables in durer.mat in structure array S.

S = whos('-file','durer.mat');

Display the contents of S.

for k = 1:length(S)
   disp(['  ' S(k).name ...
         '  ' mat2str(S(k).size) ...
         '  ' S(k).class]);
  X  [648 509]  double
  caption  [2 28]  char
  map  [128 3]  double

Create variables with various attributes, and then display information about them.

Create a file, show_attributes.m, that contains these statements.

function show_attributes
persistent p;
global g;
p = 1;
g = 2;
s = sparse(eye(5));
c = [4+5i 9-3i 7+6i];

Call show_attributes. When MATLAB® executes the whos command at the end of show_attributes, it lists each variable and its corresponding attribute.

  Name      Size            Bytes  Class     Attributes

  c         1x3                48  double    complex   
  g         1x1                 8  double    global    
  p         1x1                 8  double    persistent
  s         5x5               128  double    sparse    

List all the variables in the current workspace while paused in a nested function.

Create a file, whos_demo.m, that contains these statements.

function whos_demo
date_time = datestr(now,'dd-mmm-yyyy');
date_time_array = strsplit(date_time,{'-',''});

   function get_date(d)
      day = d{1};  %#ok<*NASGU>
      mon = d{2}; 
      year = d{3}; 


Run whos_demo. MATLAB® pauses at the line with the keyboard command.


Call the whos function. MATLAB displays the variables in the nested get_date function, and the variables in all functions that contain the nested function, grouped by function workspace.

K>> whos
Name                 Size            Bytes  Class    Attributes

  ---- whos_demo/get_date ---------------------------------------
  d                    1x3               354  cell               
  day                  1x2                 4  char               
  mon                  1x3                 6  char               
  year                 1x4                 8  char               

  ---- whos_demo ------------------------------------------------
  date_time            1x11               22  char               
  date_time_array      1x3               354  cell               

Input Arguments

collapse all

Variables to display, specified as one or more character vectors or string scalars in one of the following forms.

Form of Variables InputVariable Names
var1 ... varNList the named variables, specified as individual character vectors or string scalars.
Use the '*' wildcard to match patterns. For example, whos A* lists all variables in the workspace that start with A.
-regexp expr1 ... exprNList only the variables that match the regular expressions, specified as character vectors or string scalars. For example, whos -regexp ^Mon ^Tues lists only the variables in the workspace that begin with Mon or Tues.

Data Types: char | string

Name of MAT-file, specified as a character vector or string scalar. The file name can include the full, relative, or partial path. For example, whos -file myFile.mat lists all variables in the MAT-file named myFile.mat. The whos -file filename command does not return the sizes of any MATLAB objects in file filename.

Data Types: char | string

Output Arguments

collapse all

Variable information, returned as a nested structure array containing a scalar struct for each variable. Each scalar struct contains these fields.



Name of the variable.


Dimensions of the variable array.


Number of bytes allocated for the variable array.

whos returns the number of bytes each variable occupies in the workspace, which is not necessarily the same as the number of bytes each variable occupies in a MAT-file. MAT-files Version 7 and later are compressed, so the number of bytes required in the workspace is typically larger than the number of bytes in the file.

whos does not report the number of bytes consumed by handle objects. If a variable contains handle objects, the number of bytes that the whos function displays for the variable might be smaller than expected.


Class of the variable. If the variable has no value, class is '(unassigned)'.


true if the variable is global.


true if the variable is sparse.


true if the variable is complex.


Structure with these fields:

  • function — Name of the nested or outer function that defines the variable.

  • level — Nesting level of that function.


true if the variable is persistent.


  • You also can view the contents of MAT-files using the Details Panel of the Current Folder browser.

Introduced before R2006a

Was this topic helpful?