/* Copyright (C) 2013, 2016 D. V. Wiebe
 *
 ***************************************************************************
 *
 * This file is part of the GetData project.
 *
 * GetData is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by the
 * Free Software Foundation; either version 2.1 of the License, or (at your
 * option) any later version.
 *
 * GetData is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with GetData; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */
#include "gd_matlab.h"

/*
 % GD_ERROR_STRING  retrieve the library error string
 %
 %   S = GD_ERROR_STRING(DIRFILE)
 %             returns the error string, S, associated with the last call to the
 %             C GetData library.  Since the MATLAB bindings throw exceptions
 %             on library error, it is only ever useful to use this inside a
 %             CATCH block after a GetData Library error has been thrown.  In
 %             this case, the .message member of thrown MEXCEPTION object also
 %             contains this string.
 %
 %   The DIRFILE object should have previously been created with GD_OPEN.
 %
 %   See the documentation on the C API function gd_error_string(3) in section 3
 %   of the UNIX manual for more details.
 %
 %   See also GD_ERROR, GD_OPEN
 */

void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[])
{
  DIRFILE *D;
  char *s;

  GDMX_CHECK_RHS(1);

  D = gdmx_to_dirfile(prhs[0]);

  s = gd_error_string(D, NULL, 0);

  plhs[0] = gdmx_from_string(s);
  mxFree(s);
}
