xml/cxmllibrary/src/utils/src/nwx_buffer.c
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 31 Aug 2010 17:02:56 +0300
branchRCL_3
changeset 20 889504eac4fb
permissions -rw-r--r--
Revision: 201014 Kit: 201035

/*
* Copyright (c) 1999 - 2001 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
*
*/


/*****************************************************************
**    File name:  NW_Buffer.c
**    Part of: Buffer
**    Version: 3/16/99      Initial version
**    Description:  Provides the interface to a managerd buffer of bytes.
**                  The buffer contains an allocated size and an in use 
**                  size (length)  and also a pointer to a data array.
******************************************************************/

/*
**-------------------------------------------------------------------------
**  Include Files
**-------------------------------------------------------------------------
*/
#include "nwx_buffer.h"
#include "nwx_mem.h"
#include "nwx_assert.h"
#include "nw_string_utils.h"

/*
**-------------------------------------------------------------------------
**  Constants
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  Internal Types
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  Macros
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  Internal Prototypes
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  File Scoped Static Variables
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  Global Variable Definitions
**-------------------------------------------------------------------------
*/

/*
**-------------------------------------------------------------------------
**  Internal Functions
**-------------------------------------------------------------------------
*/
static NW_Status_t Resize_Data(NW_Buffer_t *buffer, const NW_Uint32 len)
{
  void *temp;

  if (buffer->allocatedLength < len) {
    temp = NW_Mem_Malloc(len);
    if (temp == NULL)
      return NW_STAT_OUT_OF_MEMORY;
    NW_Mem_Free(buffer->data);
    buffer->length = 0;
    buffer->allocatedLength = len;
    buffer->data = temp;
  }
  return NW_STAT_SUCCESS;
}


/*
**-------------------------------------------------------------------------
**  External Public (Exported) Functions
**-------------------------------------------------------------------------
*/

/*****************************************************************
**  Name:  NW_Buffer_New
**  Description:  creates a new buffer
**  Parameters:   size  - size to allocate
**  Return Value: pointer to the new buffer
******************************************************************/
NW_Buffer_t *NW_Buffer_New(const NW_Uint32 size)    
{
  NW_Buffer_t *buffer;

  buffer = NW_Mem_Malloc(sizeof(NW_Buffer_t));
  if (buffer != NULL) {
    buffer->length = 0;
    buffer->allocatedLength = size;
    buffer->data = NULL;
    if (size > 0) {
      buffer->data = NW_Mem_Malloc(size);
      if (buffer->data == NULL) {
        NW_Mem_Free(buffer);
        return NULL;
      }
    }
  }
  return buffer;
}

/*****************************************************************
**  Name:  NW_Buffer_Free
**  Description:  frees the space allocated for a buffer
**  Parameters:   *buffer - the buffer to free
**  Return Value: void 
******************************************************************/
EXPORT_C void NW_Buffer_Free(NW_Buffer_t *buffer)    
{
  if (buffer != NULL) {
    if (buffer->data != NULL) {
      NW_Mem_Free(buffer->data);
      buffer->data = NULL;
    }
    NW_Mem_Free(buffer);
  }
  return;
}

/*****************************************************************
**  Name:  NW_Buffer_FreeNotData
**  Description:  free the space allocated for a buffer. 
**  Parameters:   *buffer - the buffer to free
**  Return Value: void 
**  Notes:  This does not free the data
******************************************************************/
EXPORT_C void NW_Buffer_FreeNotData(NW_Buffer_t *buffer)
{
  if (buffer != NULL) {
    buffer->data = NULL;
    NW_Mem_Free(buffer);
  }
  return;
}

/*****************************************************************
**  Name:  NW_Buffer_CopyStr
**  Description:  Copy NULL terminated string into buffer and adjust 
**                length.  If necessary, reallocate space.
**  Parameters:   *buffer - the buffer to copy to
**                *str - the string to copy from
**  Return Value: NW_STAT_SUCCESS if succeeds, else NW_STAT_OUT_OF_MEMORY 
******************************************************************/
NW_Status_t NW_Buffer_CopyStr(NW_Buffer_t *buffer, const NW_Ucs2 *str)
{
  NW_Uint16 len;

  NW_ASSERT(buffer != NULL);
  NW_ASSERT(str != NULL);

  len = (NW_Uint16)NW_Str_Strsize(str);
  if (Resize_Data(buffer, len) == NW_STAT_OUT_OF_MEMORY)
    return NW_STAT_OUT_OF_MEMORY;
  NW_Mem_memcpy(buffer->data, str, len);
  buffer->length = len;
  return NW_STAT_SUCCESS;
}

/*****************************************************************
**  Name:  NW_Buffer_CopyBuffers
**  Description:  Copy NW_Buffer into buffer (NW_Buffer) 
**                and adjust length. If necessary, reallocate space.
**  Parameters:   *to - the buffer to copy to
**                *from - the buffer to copy from
**  Return Value: NW_STAT_SUCCESS if succeeds, else NW_STAT_OUT_OF_MEMORY 
******************************************************************/
NW_Status_t NW_Buffer_CopyBuffers(NW_Buffer_t *to, const NW_Buffer_t *from)
{
  NW_ASSERT(to != NULL);
  NW_ASSERT(from != NULL);

  if (Resize_Data(to, from->length) == NW_STAT_OUT_OF_MEMORY)
    return NW_STAT_OUT_OF_MEMORY;
  NW_Mem_memcpy(to->data, from->data, from->length);
  to->length = from->length;
  return NW_STAT_SUCCESS;
}

/*****************************************************************
**  Name:  NW_Buffer_SetData
**  Description:  Set NULL terminated ascii string into buffer and  
**                adjust length.
**  Parameters:   *buffer - the buffer to copy to
**                *str - the string to set into buffer
**  Return Value: void 
******************************************************************/
void NW_Buffer_SetData(NW_Buffer_t *buffer, char *str)
{
  NW_Uint32 len;

  NW_ASSERT(buffer != NULL);
  NW_ASSERT(str != NULL);

  if(buffer->data != NULL) {
    NW_Mem_Free(buffer->data);
  } 
  len = (NW_Asc_strlen(str) + 1) * sizeof(char);
  buffer->length = len;
  buffer->allocatedLength = len;
  buffer->data = (NW_Byte *)str;
  return;
}