1 /*
2 * Copyright (c) 2006 Sandia Corporation. Under the terms of Contract
3 * DE-AC04-94AL85000 with Sandia Corporation, the U.S. Governement
4 * 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 Sandia Corporation 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) instead
39
40 The function ex_get_elem_conn() reads the connectivity array for an
41 element block. Memory must be allocated for the connectivity array(\c
42 num_elem_this_blk * \c num_nodes_per_elem in length) before
43 this routine is called.
44
45 \return In case of an error, ex_get_elem_conn() returns a negative number; a
46 warning will return a positive number. Possible causes of errors
47 include:
48 - an element block with the specified ID is not stored in the file.
49
50 \param[in] exoid exodus file ID returned from a previous call to ex_create() or ex_open().
51 \param[in] elem_blk_id The element block ID.
52 \param[out] connect Size [num_elem_this_blk,num_nodes_per_elem].
53 Returned connectivity array; a list of nodes (internal node
54 IDs; See Section LocalNodeIds) that define each element. The
55 node index cycles faster than the element index.
56
57 Refer to the code example in ex_get_elem_block() for an example of
58 reading the connectivity for an element block.
59
60 */
61
ex_get_elem_conn(int exoid,int elem_blk_id,int * connect)62 int ex_get_elem_conn (int exoid,
63 int elem_blk_id,
64 int *connect)
65 {
66 return ex_get_conn( exoid, EX_ELEM_BLOCK, elem_blk_id, connect, 0, 0 );
67 }
68