function: map_sia_store_sharelibrary: avlmap

Name

map_sia_store_share

Synopsis

int map_sia_store_share( MAP mapping, signed int * data, size_t datalen )

Description

map_sia_store_share stores a data value of type array of signed int in the active member of a mapping using the original pointer so that any modifications to the original memory location will effectively modify the stored data value. The length of the array may not be modified in this way. The purpose for using this function is not to provide a means to modify the data in place, but instead, to avoid the overhead of duplicating the data when the calling program will be leaving the stored data intact (in particular, not freeing it).

Arguments

  1. mapping is the handle of the specified mapping.
  2. data is the value to store.
  3. datalen is the length of the data array.

Return values

Errors

The errno value is set by system functions when an error occurs.

See also

avlmap index page


The documentation, source code, and derived compilations are
Copyright © 2000 by Philip Howard.
This library 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.

This library 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 this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA