File: gd_entry_list.c

package info (click to toggle)
libgetdata 0.11.0-17
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 13,144 kB
  • sloc: ansic: 100,814; cpp: 4,843; fortran: 4,548; f90: 2,561; python: 2,406; perl: 2,274; makefile: 1,487; php: 1,465; sh: 86
file content (69 lines) | stat: -rw-r--r-- 2,439 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
/* 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_ENTRY_LIST  Retrieve a list of field names
 %
 %   L = GD_ENTRY_LIST(DIRFILE [, PARENT [, TYPE [, FLAGS]]])
 %             returns a cell array of strings, L, listing all fields in the
 %             dirfile DIRFILE which satisfy the supplied PARENT, TYPE, and/or
 %             FLAGS.
 %
 %   If PARENT is given, and not numeric zero, metafields of the specified
 %   parent field will be searched.  Otherwise, only top level fields are
 %   considered.  If non-zero (matching all types), TYPE should be either one
 %   of the GD.xxx_ENTRY symbols or else one of the special GD.xxx_ENTRIES
 %   symbols provided by GETDATA_CONSTANTS.  FLAGS, if given, should be zero
 %   or more of the GD.ENTRIES_... flags, bitwise or'd together.
 %
 %   The DIRFILE object should have previously been created with GD_OPEN.
 %
 %   See the documentation on the C API function gd_entry_list(3) in
 %   section 3 of the UNIX manual for more details.
 %
 %   See also GD_NENTRIES, GD_OPEN, GETDATA_CONSTANTS
 */

void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[])
{
  DIRFILE *D;
  char *parent = NULL;
  unsigned int type = 0, flags = 0;
  const char **fl;

  GDMX_CHECK_RHS2(1,4);

  D = gdmx_to_dirfile(prhs[0]);
  if (nrhs > 1)
    parent = gdmx_to_string(prhs, 1, 1);
  if (nrhs > 2)
    type = gdmx_to_uint(prhs, 2);
  if (nrhs > 3)
    flags = gdmx_to_uint(prhs, 3);

  fl = gd_entry_list(D, parent, type, flags);

  mxFree(parent);
  gdmx_err(D, 0);

  plhs[0] = gdmx_from_string_list(fl);
}