function: map_uss_store_sharelibrary: avlmap

Name

map_uss_store_share

Synopsis

int map_uss_store_share( MAP mapping, unsigned short * data )

Description

map_uss_store_share stores a data value of type string of unsigned short 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 string 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.

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