1 /*
2 * Copyright (c) 2005-2017 National Technology & Engineering Solutions
3 * of Sandia, LLC (NTESS). Under the terms of Contract DE-NA0003525 with
4 * NTESS, the U.S. Government retains certain rights in this software.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions are
8 * met:
9 *
10 * * Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 *
13 * * Redistributions in binary form must reproduce the above
14 * copyright notice, this list of conditions and the following
15 * disclaimer in the documentation and/or other materials provided
16 * with the distribution.
17 *
18 * * Neither the name of NTESS nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
25 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
26 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 *
34 */
35 #include "exodusII.h"
36
37 /*!
38 \deprecated Use ex_get_conn()(exoid, EX_ELEM_BLOCK, elem_blk_id, connect, 0, 0)
39 instead
40
41 The function ex_get_elem_conn() reads the connectivity array for an
42 element block. Memory must be allocated for the connectivity array
43 (num_elem_this_blk * num_nodes_per_elem in length) before
44 this routine is called.
45
46 \return In case of an error, ex_get_elem_conn() returns a negative number; a
47 warning will return a positive number. Possible causes of errors
48 include:
49 - an element block with the specified ID is not stored in the file.
50
51 \param[in] exoid exodus file ID returned from a previous call to
52 ex_create() or ex_open().
53 \param[in] elem_blk_id The element block ID.
54 \param[out] connect Size [num_elem_this_blk,num_nodes_per_elem].
55 Returned connectivity array; a list of nodes (internal
56 node
57 IDs; See Section LocalNodeIds) that define each
58 element. The
59 node index cycles faster than the element index.
60
61 Refer to the code example in ex_get_elem_block() for an example of
62 reading the connectivity for an element block.
63
64 */
65
ex_get_elem_conn(int exoid,ex_entity_id elem_blk_id,void_int * connect)66 int ex_get_elem_conn(int exoid, ex_entity_id elem_blk_id, void_int *connect)
67 {
68 return ex_get_conn(exoid, EX_ELEM_BLOCK, elem_blk_id, connect, 0, 0);
69 }
70