%NUMEL   Number of elements in a matrix
%   N = NUMEL(A)  returns the scalar count, N, of the
%   number of elements in the matrix, A.
%   
%   NUMEL(A) gives the same answer as PROD(SIZE(A)).
%   However, if the SIZE function has been overloaded,
%   PROD(SIZE(A)) may not provide an accurate count.
%
%   NOTE: It is strongly recommended that you not overload 
%   the NUMEL function.
%
%   NUMEL can also be used with SUBSREF to determine the 
%   number of values that will be returned from a particular 
%   call to SUBSREF.
%
%   Example:
%      Create a 4-by-4-by-2 matrix. numel counts 32 elments 
%      in the matrix.
%
%         A = magic(4);
%         A(:,:,2) = A';
%
%         numel(A)
%         ans =
%             32
%
%   See also SIZE, PROD, SUBSREF

%   Copyright 1984-2000 The MathWorks, Inc. 
%   $Revision: 1.1 $Date:  $
%   Built-in function.
