1998-03-07 07:06:55 -05:00
|
|
|
|
1995-11-28 12:22:13 -05:00
|
|
|
/* pngmem.c - stub functions for memory allocation
|
1998-01-01 08:13:13 -05:00
|
|
|
*
|
2011-11-03 17:11:08 -04:00
|
|
|
* Last changed in libpng 1.5.7 [(PENDING RELEASE)]
|
2011-01-04 10:57:06 -05:00
|
|
|
* Copyright (c) 1998-2011 Glenn Randers-Pehrson
|
2000-06-04 15:29:29 -04:00
|
|
|
* (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
|
|
|
|
* (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
|
1998-01-01 08:13:13 -05:00
|
|
|
*
|
2009-06-26 22:46:52 -04:00
|
|
|
* This code is released under the libpng license.
|
2009-06-25 14:43:50 -04:00
|
|
|
* For conditions of distribution and use, see the disclaimer
|
2009-06-24 11:27:36 -04:00
|
|
|
* and license in png.h
|
2009-06-24 10:31:28 -04:00
|
|
|
*
|
1998-04-21 16:03:57 -04:00
|
|
|
* This file provides a location for all memory allocation. Users who
|
1998-06-14 15:43:31 -04:00
|
|
|
* need special memory handling are expected to supply replacement
|
|
|
|
* functions for png_malloc() and png_free(), and to use
|
|
|
|
* png_create_read_struct_2() and png_create_write_struct_2() to
|
|
|
|
* identify the replacement functions.
|
1998-01-01 08:13:13 -05:00
|
|
|
*/
|
1995-07-20 03:43:20 -04:00
|
|
|
|
2008-07-10 10:13:13 -04:00
|
|
|
#include "pngpriv.h"
|
2006-02-20 23:09:05 -05:00
|
|
|
|
2010-03-08 22:10:25 -05:00
|
|
|
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
|
1996-06-05 16:50:50 -04:00
|
|
|
/* Allocate memory for a png_struct or a png_info. The malloc and
|
1997-01-17 02:34:35 -05:00
|
|
|
memset can be replaced by a single call to calloc() if this is thought
|
2002-06-20 07:54:34 -04:00
|
|
|
to improve performance noticably. */
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp /* PRIVATE */,
|
|
|
|
png_create_struct,(int type),PNG_ALLOCATED)
|
1996-06-05 16:50:50 -04:00
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
2006-08-19 14:59:24 -04:00
|
|
|
return (png_create_struct_2(type, NULL, NULL));
|
1998-06-06 16:31:35 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/* Allocate memory for a png_struct or a png_info. The malloc and
|
|
|
|
memset can be replaced by a single call to calloc() if this is thought
|
2002-06-20 07:54:34 -04:00
|
|
|
to improve performance noticably. */
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp /* PRIVATE */,
|
|
|
|
png_create_struct_2,(int type, png_malloc_ptr malloc_fn, png_voidp mem_ptr),
|
|
|
|
PNG_ALLOCATED)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
1997-05-16 03:46:07 -04:00
|
|
|
png_size_t size;
|
1996-06-05 16:50:50 -04:00
|
|
|
png_voidp struct_ptr;
|
|
|
|
|
|
|
|
if (type == PNG_STRUCT_INFO)
|
2008-07-10 10:13:13 -04:00
|
|
|
size = png_sizeof(png_info);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
1996-06-05 16:50:50 -04:00
|
|
|
else if (type == PNG_STRUCT_PNG)
|
2008-07-10 10:13:13 -04:00
|
|
|
size = png_sizeof(png_struct);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
1996-06-05 16:50:50 -04:00
|
|
|
else
|
2001-10-27 08:35:13 -04:00
|
|
|
return (NULL);
|
1996-06-05 16:50:50 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
2006-08-19 14:59:24 -04:00
|
|
|
if (malloc_fn != NULL)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
2001-11-07 08:10:08 -05:00
|
|
|
png_struct dummy_struct;
|
|
|
|
png_structp png_ptr = &dummy_struct;
|
|
|
|
png_ptr->mem_ptr=mem_ptr;
|
2001-11-24 15:53:31 -05:00
|
|
|
struct_ptr = (*(malloc_fn))(png_ptr, size);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2001-05-18 05:54:50 -04:00
|
|
|
if (struct_ptr != NULL)
|
1998-06-06 16:31:35 -04:00
|
|
|
png_memset(struct_ptr, 0, size);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
1998-06-06 16:31:35 -04:00
|
|
|
return (struct_ptr);
|
|
|
|
}
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
1998-06-06 16:31:35 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# if defined(__TURBOC__) && !defined(__FLAT__)
|
2008-07-10 10:13:13 -04:00
|
|
|
struct_ptr = (png_voidp)farmalloc(size);
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
|
|
|
# if defined(_MSC_VER) && defined(MAXSEG_64K)
|
2008-07-10 10:13:13 -04:00
|
|
|
struct_ptr = (png_voidp)halloc(size, 1);
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
2008-07-10 10:13:13 -04:00
|
|
|
struct_ptr = (png_voidp)malloc(size);
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
|
|
|
# endif
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2004-07-28 09:20:44 -04:00
|
|
|
if (struct_ptr != NULL)
|
1996-06-05 16:50:50 -04:00
|
|
|
png_memset(struct_ptr, 0, size);
|
|
|
|
|
|
|
|
return (struct_ptr);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/* Free memory allocated by a png_create_struct() call */
|
2000-05-06 15:09:57 -04:00
|
|
|
void /* PRIVATE */
|
1996-06-05 16:50:50 -04:00
|
|
|
png_destroy_struct(png_voidp struct_ptr)
|
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
2006-08-19 14:59:24 -04:00
|
|
|
png_destroy_struct_2(struct_ptr, NULL, NULL);
|
1998-06-06 16:31:35 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/* Free memory allocated by a png_create_struct() call */
|
2000-05-06 15:09:57 -04:00
|
|
|
void /* PRIVATE */
|
2001-05-18 05:54:50 -04:00
|
|
|
png_destroy_struct_2(png_voidp struct_ptr, png_free_ptr free_fn,
|
|
|
|
png_voidp mem_ptr)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
1997-05-16 03:46:07 -04:00
|
|
|
if (struct_ptr != NULL)
|
1998-01-30 22:45:12 -05:00
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
2008-07-10 10:13:13 -04:00
|
|
|
if (free_fn != NULL)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
|
|
|
png_struct dummy_struct;
|
|
|
|
png_structp png_ptr = &dummy_struct;
|
2001-05-18 05:54:50 -04:00
|
|
|
png_ptr->mem_ptr=mem_ptr;
|
1998-06-06 16:31:35 -04:00
|
|
|
(*(free_fn))(png_ptr, struct_ptr);
|
|
|
|
return;
|
|
|
|
}
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
|
|
|
# if defined(__TURBOC__) && !defined(__FLAT__)
|
2008-07-10 10:13:13 -04:00
|
|
|
farfree(struct_ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
|
|
|
# if defined(_MSC_VER) && defined(MAXSEG_64K)
|
2008-07-10 10:13:13 -04:00
|
|
|
hfree(struct_ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
2008-07-10 10:13:13 -04:00
|
|
|
free(struct_ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
|
|
|
# endif
|
1998-01-30 22:45:12 -05:00
|
|
|
}
|
1996-06-05 16:50:50 -04:00
|
|
|
}
|
|
|
|
|
1996-01-16 02:51:56 -05:00
|
|
|
/* Allocate memory. For reasonable files, size should never exceed
|
2009-05-15 21:39:34 -04:00
|
|
|
* 64K. However, zlib may allocate more then 64K if you don't tell
|
|
|
|
* it not to. See zconf.h and png.h for more information. zlib does
|
|
|
|
* need to allocate exactly 64K, so whatever you call here must
|
|
|
|
* have the ability to do that.
|
|
|
|
*/
|
1996-01-16 02:51:56 -05:00
|
|
|
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp,PNGAPI
|
|
|
|
png_calloc,(png_structp png_ptr, png_alloc_size_t size),PNG_ALLOCATED)
|
2009-02-14 11:32:18 -05:00
|
|
|
{
|
|
|
|
png_voidp ret;
|
|
|
|
|
|
|
|
ret = (png_malloc(png_ptr, size));
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-02-14 11:32:18 -05:00
|
|
|
if (ret != NULL)
|
|
|
|
png_memset(ret,0,(png_size_t)size);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-02-14 11:32:18 -05:00
|
|
|
return (ret);
|
|
|
|
}
|
|
|
|
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp,PNGAPI
|
|
|
|
png_malloc,(png_structp png_ptr, png_alloc_size_t size),PNG_ALLOCATED)
|
1996-01-16 02:51:56 -05:00
|
|
|
{
|
1996-01-26 02:38:47 -05:00
|
|
|
png_voidp ret;
|
2002-05-25 12:12:10 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
1997-05-16 03:46:07 -04:00
|
|
|
if (png_ptr == NULL || size == 0)
|
2001-10-27 08:35:13 -04:00
|
|
|
return (NULL);
|
1996-01-16 02:51:56 -05:00
|
|
|
|
2006-08-19 14:59:24 -04:00
|
|
|
if (png_ptr->malloc_fn != NULL)
|
2009-05-15 21:39:34 -04:00
|
|
|
ret = ((png_voidp)(*(png_ptr->malloc_fn))(png_ptr, (png_size_t)size));
|
2010-05-06 10:44:04 -04:00
|
|
|
|
1998-06-06 16:31:35 -04:00
|
|
|
else
|
2009-05-15 21:39:34 -04:00
|
|
|
ret = (png_malloc_default(png_ptr, size));
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2004-07-28 09:20:44 -04:00
|
|
|
if (ret == NULL && (png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
|
2008-07-10 10:13:13 -04:00
|
|
|
png_error(png_ptr, "Out of Memory");
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2004-07-28 09:20:44 -04:00
|
|
|
return (ret);
|
1998-06-06 16:31:35 -04:00
|
|
|
}
|
2002-05-25 12:12:10 -04:00
|
|
|
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp,PNGAPI
|
|
|
|
png_malloc_default,(png_structp png_ptr, png_alloc_size_t size),PNG_ALLOCATED)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
|
|
|
png_voidp ret;
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
1998-06-06 16:31:35 -04:00
|
|
|
|
2004-08-04 07:34:52 -04:00
|
|
|
if (png_ptr == NULL || size == 0)
|
|
|
|
return (NULL);
|
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_MAX_MALLOC_64K
|
2008-07-10 10:13:13 -04:00
|
|
|
if (size > (png_uint_32)65536L)
|
2002-02-22 00:14:23 -05:00
|
|
|
{
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifndef PNG_USER_MEM_SUPPORTED
|
2008-07-10 10:13:13 -04:00
|
|
|
if ((png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
|
2002-02-22 00:14:23 -05:00
|
|
|
png_error(png_ptr, "Cannot Allocate > 64K");
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2002-02-22 00:14:23 -05:00
|
|
|
else
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
2002-02-22 00:14:23 -05:00
|
|
|
return NULL;
|
|
|
|
}
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
1995-07-20 03:43:20 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
/* Check for overflow */
|
2010-03-06 14:54:59 -05:00
|
|
|
# if defined(__TURBOC__) && !defined(__FLAT__)
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
if (size != (unsigned long)size)
|
|
|
|
ret = NULL;
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
else
|
|
|
|
ret = farmalloc(size);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
|
|
|
# if defined(_MSC_VER) && defined(MAXSEG_64K)
|
2009-05-15 21:39:34 -04:00
|
|
|
if (size != (unsigned long)size)
|
|
|
|
ret = NULL;
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
else
|
|
|
|
ret = halloc(size, 1);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
2009-05-15 21:39:34 -04:00
|
|
|
if (size != (size_t)size)
|
|
|
|
ret = NULL;
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
else
|
|
|
|
ret = malloc((size_t)size);
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
|
|
|
# endif
|
1995-07-20 03:43:20 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifndef PNG_USER_MEM_SUPPORTED
|
2002-02-22 00:14:23 -05:00
|
|
|
if (ret == NULL && (png_ptr->flags&PNG_FLAG_MALLOC_NULL_MEM_OK) == 0)
|
1995-12-19 04:22:19 -05:00
|
|
|
png_error(png_ptr, "Out of Memory");
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
1995-07-20 03:43:20 -04:00
|
|
|
|
1998-01-31 21:07:59 -05:00
|
|
|
return (ret);
|
1995-07-20 03:43:20 -04:00
|
|
|
}
|
|
|
|
|
1998-06-06 16:31:35 -04:00
|
|
|
/* Free a pointer allocated by png_malloc(). If ptr is NULL, return
|
2009-05-15 21:39:34 -04:00
|
|
|
* without taking any action.
|
|
|
|
*/
|
2000-05-06 15:09:57 -04:00
|
|
|
void PNGAPI
|
1998-06-06 16:31:35 -04:00
|
|
|
png_free(png_structp png_ptr, png_voidp ptr)
|
1995-07-20 03:43:20 -04:00
|
|
|
{
|
1997-05-16 03:46:07 -04:00
|
|
|
if (png_ptr == NULL || ptr == NULL)
|
1996-01-26 02:38:47 -05:00
|
|
|
return;
|
1995-07-20 03:43:20 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# ifdef PNG_USER_MEM_SUPPORTED
|
1998-06-06 16:31:35 -04:00
|
|
|
if (png_ptr->free_fn != NULL)
|
|
|
|
{
|
|
|
|
(*(png_ptr->free_fn))(png_ptr, ptr);
|
|
|
|
return;
|
|
|
|
}
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2009-05-15 21:39:34 -04:00
|
|
|
else
|
|
|
|
png_free_default(png_ptr, ptr);
|
1998-06-06 16:31:35 -04:00
|
|
|
}
|
2010-08-02 09:00:10 -04:00
|
|
|
|
2002-03-25 19:49:08 -05:00
|
|
|
void PNGAPI
|
1998-06-06 16:31:35 -04:00
|
|
|
png_free_default(png_structp png_ptr, png_voidp ptr)
|
|
|
|
{
|
1999-10-23 09:39:18 -04:00
|
|
|
if (png_ptr == NULL || ptr == NULL)
|
|
|
|
return;
|
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif /* PNG_USER_MEM_SUPPORTED */
|
2008-07-10 10:13:13 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# if defined(__TURBOC__) && !defined(__FLAT__)
|
2008-07-10 10:13:13 -04:00
|
|
|
farfree(ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
|
|
|
# if defined(_MSC_VER) && defined(MAXSEG_64K)
|
2008-07-10 10:13:13 -04:00
|
|
|
hfree(ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# else
|
2008-07-10 10:13:13 -04:00
|
|
|
free(ptr);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
2010-03-06 14:54:59 -05:00
|
|
|
# endif
|
|
|
|
# endif
|
1995-07-20 03:43:20 -04:00
|
|
|
}
|
1995-12-19 04:22:19 -05:00
|
|
|
|
2002-07-01 23:23:46 -04:00
|
|
|
/* This function was added at libpng version 1.2.3. The png_malloc_warn()
|
2004-07-28 09:20:44 -04:00
|
|
|
* function will set up png_malloc() to issue a png_warning and return NULL
|
|
|
|
* instead of issuing a png_error, if it fails to allocate the requested
|
|
|
|
* memory.
|
2002-05-25 12:12:10 -04:00
|
|
|
*/
|
2010-08-02 09:00:10 -04:00
|
|
|
PNG_FUNCTION(png_voidp,PNGAPI
|
|
|
|
png_malloc_warn,(png_structp png_ptr, png_alloc_size_t size),PNG_ALLOCATED)
|
2002-05-25 12:12:10 -04:00
|
|
|
{
|
|
|
|
png_voidp ptr;
|
2006-11-16 21:35:49 -05:00
|
|
|
png_uint_32 save_flags;
|
2009-05-15 21:39:34 -04:00
|
|
|
if (png_ptr == NULL)
|
|
|
|
return (NULL);
|
2002-05-25 12:12:10 -04:00
|
|
|
|
2008-07-25 09:51:18 -04:00
|
|
|
save_flags = png_ptr->flags;
|
2002-05-25 12:12:10 -04:00
|
|
|
png_ptr->flags|=PNG_FLAG_MALLOC_NULL_MEM_OK;
|
|
|
|
ptr = (png_voidp)png_malloc((png_structp)png_ptr, size);
|
|
|
|
png_ptr->flags=save_flags;
|
|
|
|
return(ptr);
|
|
|
|
}
|
|
|
|
|
2008-07-10 10:13:13 -04:00
|
|
|
|
1998-06-06 16:31:35 -04:00
|
|
|
#ifdef PNG_USER_MEM_SUPPORTED
|
|
|
|
/* This function is called when the application wants to use another method
|
|
|
|
* of allocating and freeing memory.
|
|
|
|
*/
|
2000-05-06 15:09:57 -04:00
|
|
|
void PNGAPI
|
1998-06-06 16:31:35 -04:00
|
|
|
png_set_mem_fn(png_structp png_ptr, png_voidp mem_ptr, png_malloc_ptr
|
|
|
|
malloc_fn, png_free_ptr free_fn)
|
|
|
|
{
|
2008-07-25 09:51:18 -04:00
|
|
|
if (png_ptr != NULL)
|
|
|
|
{
|
|
|
|
png_ptr->mem_ptr = mem_ptr;
|
|
|
|
png_ptr->malloc_fn = malloc_fn;
|
|
|
|
png_ptr->free_fn = free_fn;
|
2006-11-14 11:53:30 -05:00
|
|
|
}
|
1998-06-06 16:31:35 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/* This function returns a pointer to the mem_ptr associated with the user
|
|
|
|
* functions. The application should free any memory associated with this
|
|
|
|
* pointer before png_write_destroy and png_read_destroy are called.
|
|
|
|
*/
|
2000-05-06 15:09:57 -04:00
|
|
|
png_voidp PNGAPI
|
2011-01-22 18:36:34 -05:00
|
|
|
png_get_mem_ptr(png_const_structp png_ptr)
|
1998-06-06 16:31:35 -04:00
|
|
|
{
|
2009-05-15 21:39:34 -04:00
|
|
|
if (png_ptr == NULL)
|
|
|
|
return (NULL);
|
2010-05-06 10:44:04 -04:00
|
|
|
|
1998-06-06 16:31:35 -04:00
|
|
|
return ((png_voidp)png_ptr->mem_ptr);
|
|
|
|
}
|
|
|
|
#endif /* PNG_USER_MEM_SUPPORTED */
|
2006-02-20 23:09:05 -05:00
|
|
|
#endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */
|