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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2002-2-1 (1.70)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Function: get</TITLE>
<META NAME="description" CONTENT="Function: get">
<META NAME="keywords" CONTENT="users_guide">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="users_guide.css">
<LINK REL="next" HREF="node82.html">
<LINK REL="previous" HREF="node80.html">
<LINK REL="up" HREF="node65.html">
<LINK REL="next" HREF="node82.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html1878"
HREF="node82.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html1872"
HREF="node65.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html1866"
HREF="node80.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html1874"
HREF="node14.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html1876"
HREF="node317.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1879"
HREF="node82.html">Function: set1</A>
<B> Up:</B> <A NAME="tex2html1873"
HREF="node65.html">The Array API</A>
<B> Previous:</B> <A NAME="tex2html1867"
HREF="node80.html">Function: get5-7</A>
<B> <A NAME="tex2html1875"
HREF="node14.html">Contents</A></B>
<B> <A NAME="tex2html1877"
HREF="node317.html">Index</A></B>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H3><A NAME="SECTION024461600000000000000"></A><A NAME="2932"></A>
<BR>
Function: get
</H3>
<P>
<BR>
<PRE CLASS="verbatim">/* C */
double
sidl_double__array_get(const struct sidl_double__array* array,
const int32_t indices[]);
// C++
double
sidl::array<double>::get(const int32_t indices[]);
C FORTRAN 77
subroutine sidl_double__array_get_f(array, indices, result)
integer*8 array
integer*4 indices()
real*8 result
! FORTRAN 90
subroutine get(array, indices, result)
type(sidl_real_1d), intent(in) :: array ! type depends on dimension
integer (selected_int_kind(9)), dimension(:), intent(in) ::indices
real (selected_real_kind(17,308)), intent(out) :: result
// Java
public native double _get(int i, int j, int k, int l, int m, int n, int o);
</PRE></td></tr></table></blockquote>
<P>
This method returns the element whose index is indices for an array of any dimension.
The return type of this method is the value type for the SIDL type being held
(see Table <A HREF="node65.html#tbl:basics:arraytypes">5.2</A>).
This method can be called for any positively dimensioned array.
For objects and interfaces, the client owns the returned reference
(i.e., the client is obliged to call <TT>deleteRef()</TT> when they are
done with the reference unless it is <TT>NULL</TT>).
For arrays of strings, the client owns the returned string (i.e., the client is
obliged to call <TT>free()</TT> on the returned pointer unless it is <TT>NULL</TT>).
There is no reliable way to determine from the return value cases when indices
has an element out of bounds.
<P>
<BR><HR>
<ADDRESS>
<br><br>babel-0.10.2<br>users_guide Last Modified 2005-03-23<br><br><a href="http://www.llnl.gov/CASC/components">http://www.llnl.gov/CASC/components</a><br><a href="mailto:components@llnl.gov">components@llnl.gov</a>
</ADDRESS>
</BODY>
</HTML>
|
