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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Vec/VecGetArrayWrite.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>VecGetArrayWrite</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.14.5 2021-03-03</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.14.5 v3.14.5 docs/manualpages/Vec/VecGetArrayWrite.html "><small>Report Typos and Errors</small></a></div>
<A NAME="VecGetArrayWrite"><H1>VecGetArrayWrite</H1></A>
Returns a pointer to a contiguous array that WILL contains this processor's portion of the vector data. The values in this array are NOT valid, the routine calling this routine is responsible for putting values into the array; any values it does not set will be invalid
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscvec.h"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../Vec/VecGetArrayWrite.html#VecGetArrayWrite">VecGetArrayWrite</A>(<A HREF="../Vec/Vec.html#Vec">Vec</A> x,<A HREF="../Sys/PetscScalar.html#PetscScalar">PetscScalar</A> **a)
</PRE>
Logically Collective on <A HREF="../Vec/Vec.html#Vec">Vec</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>x </B></TD><TD>- the vector
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>a </B></TD><TD>- location to put pointer to the array
</TD></TR></TABLE>
<P>
<P>
This is for vectors associate with GPUs, the vector is not copied up before giving access. If you need correct
values in the array use <A HREF="../Vec/VecGetArray.html#VecGetArray">VecGetArray</A>()
<P>
Concepts: vector^accessing local values
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Vec/VecRestoreArray.html#VecRestoreArray">VecRestoreArray</A>(), <A HREF="../Vec/VecGetArrayRead.html#VecGetArrayRead">VecGetArrayRead</A>(), <A HREF="../Vec/VecGetArrays.html#VecGetArrays">VecGetArrays</A>(), <A HREF="../Vec/VecGetArrayF90.html#VecGetArrayF90">VecGetArrayF90</A>(), <A HREF="../Vec/VecGetArrayReadF90.html#VecGetArrayReadF90">VecGetArrayReadF90</A>(), <A HREF="../Vec/VecPlaceArray.html#VecPlaceArray">VecPlaceArray</A>(), <A HREF="../Vec/VecGetArray2d.html#VecGetArray2d">VecGetArray2d</A>(),
<BR><A HREF="../Vec/VecGetArrayPair.html#VecGetArrayPair">VecGetArrayPair</A>(), <A HREF="../Vec/VecRestoreArrayPair.html#VecRestoreArrayPair">VecRestoreArrayPair</A>(), <A HREF="../Vec/VecGetArray.html#VecGetArray">VecGetArray</A>(), <A HREF="../Vec/VecRestoreArrayWrite.html#VecRestoreArrayWrite">VecRestoreArrayWrite</A>()
<P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>intermediate<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/vec/vec/interface/rvector.c.html#VecGetArrayWrite">src/vec/vec/interface/rvector.c</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ts/tutorials/ex3.c.html">src/ts/tutorials/ex3.c.html</A><BR>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx.html#VecGetArrayWrite_SeqKokkos">VecGetArrayWrite_SeqKokkos in src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx</A><BR>
<A HREF="../../../src/vec/vec/impls/seq/seqcuda/veccuda.c.html#VecGetArrayWrite_SeqCUDA">VecGetArrayWrite_SeqCUDA in src/vec/vec/impls/seq/seqcuda/veccuda.c</A><BR>
<BR><A HREF="./index.html">Index of all Vec routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
</BODY></HTML>
|
