% XLIM XLIM Adjust X Axis limits of plot
% 
% Usage
% 
% There are several ways to use xlim to adjust the X axis limits of
% a plot.  The various syntaxes are
% 
%    xlim
%    xlim([lo,hi])   
%    xlim('auto')
%    xlim('manual')
%    xlim('mode')
%    xlim(handle,...)
% 
% The first form (without arguments), returns a 2-vector containing the
% current limits.  The second form sets the limits on the plot to [lo,hi].
% The third and fourth form set the mode for the limit to auto and manual
% respectively.  In auto mode, FreeMat chooses the range for the axis 
% automatically.  The xlim('mode') form returns the current mode for the axis
% (either 'auto' or 'manual').  Finally, you can specify the handle of an
% axis to manipulate instead of using the current one.

%Copyright (c) 2004,2006 Brian Yanoff, Samit Basu
function ret = xlim(varargin)
  if ((nargin > 0) && isnumeric(varargin{1}) && isscalar(varargin{1}) && ishandle(varargin{1}))
    handle = varargin{1};
    varargin(1) = [];
    nargin = nargin - 1;
  else
    handle = gca;
  end
  if (nargin == 0)
    ret = get(handle,'xlim');
    return;
  end
  if (isstr(varargin{1}))
    if (strcmp(varargin{1},'mode'))
      ret = get(handle,'xlimmode');
      return;
    end
    if (strcmp(varargin{1},'auto'))
      set(handle,'xlimmode','auto');
      return;
    end
    if (strcmp(varargin{1},'manual'))
      set(handle,'xlimmode','manual');
      return;
    end
    error('Unrecognized argument to xlim');
  elseif (isnumeric(varargin{1}) && numel(varargin{1})==2)
    set(gca,'xlim',varargin{1});
  else
    error('Unrecognized argument to xlim');
  end
