libguile/bytevectors.h

   1 #ifndef SCM_BYTEVECTORS_H
   2 #define SCM_BYTEVECTORS_H
   3
   4 /* Copyright (C) 2009 Free Software Foundation, Inc.
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public License
   8  * as published by the Free Software Foundation; either version 3 of
   9  * the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful, but
  12  * WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  19  * 02110-1301 USA
  20  */
  21
  22 \f
  23
  24 #include "libguile/__scm.h"
  25
  26
  27 /* R6RS bytevectors.  */
  28
  29 /* The size in words of the bytevector header (type tag, flags, and
  30    length).  */
  31 #define SCM_BYTEVECTOR_HEADER_SIZE   2U
  32
  33 #define SCM_BYTEVECTOR_LENGTH(_bv)              \
  34   ((size_t) SCM_CELL_WORD_1 (_bv))
  35 #define SCM_BYTEVECTOR_CONTENTS(_bv)                                    \
  36   ((signed char *) SCM_CELL_OBJECT_LOC ((_bv),                          \
  37                                         SCM_BYTEVECTOR_HEADER_SIZE))
  38
  39
  40 SCM_API SCM scm_endianness_big;
  41 SCM_API SCM scm_endianness_little;
  42
  43 SCM_API SCM scm_c_make_bytevector (size_t);
  44 SCM_API int scm_is_bytevector (SCM);
  45 SCM_API size_t scm_c_bytevector_length (SCM);
  46 SCM_API scm_t_uint8 scm_c_bytevector_ref (SCM, size_t);
  47 SCM_API void scm_c_bytevector_set_x (SCM, size_t, scm_t_uint8);
  48
  49 SCM_API SCM scm_make_bytevector (SCM, SCM);
  50 SCM_API SCM scm_native_endianness (void);
  51 SCM_API SCM scm_bytevector_p (SCM);
  52 SCM_API SCM scm_bytevector_length (SCM);
  53 SCM_API SCM scm_bytevector_eq_p (SCM, SCM);
  54 SCM_API SCM scm_bytevector_fill_x (SCM, SCM);
  55 SCM_API SCM scm_bytevector_copy_x (SCM, SCM, SCM, SCM, SCM);
  56 SCM_API SCM scm_bytevector_copy (SCM);
  57
  58 SCM_API SCM scm_uniform_array_to_bytevector (SCM);
  59
  60 SCM_API SCM scm_bytevector_to_u8_list (SCM);
  61 SCM_API SCM scm_u8_list_to_bytevector (SCM);
  62 SCM_API SCM scm_uint_list_to_bytevector (SCM, SCM, SCM);
  63 SCM_API SCM scm_bytevector_to_uint_list (SCM, SCM, SCM);
  64 SCM_API SCM scm_sint_list_to_bytevector (SCM, SCM, SCM);
  65 SCM_API SCM scm_bytevector_to_sint_list (SCM, SCM, SCM);
  66
  67 SCM_API SCM scm_bytevector_u16_native_ref (SCM, SCM);
  68 SCM_API SCM scm_bytevector_s16_native_ref (SCM, SCM);
  69 SCM_API SCM scm_bytevector_u32_native_ref (SCM, SCM);
  70 SCM_API SCM scm_bytevector_s32_native_ref (SCM, SCM);
  71 SCM_API SCM scm_bytevector_u64_native_ref (SCM, SCM);
  72 SCM_API SCM scm_bytevector_s64_native_ref (SCM, SCM);
  73 SCM_API SCM scm_bytevector_u8_ref (SCM, SCM);
  74 SCM_API SCM scm_bytevector_s8_ref (SCM, SCM);
  75 SCM_API SCM scm_bytevector_uint_ref (SCM, SCM, SCM, SCM);
  76 SCM_API SCM scm_bytevector_sint_ref (SCM, SCM, SCM, SCM);
  77 SCM_API SCM scm_bytevector_u16_ref (SCM, SCM, SCM);
  78 SCM_API SCM scm_bytevector_s16_ref (SCM, SCM, SCM);
  79 SCM_API SCM scm_bytevector_u32_ref (SCM, SCM, SCM);
  80 SCM_API SCM scm_bytevector_s32_ref (SCM, SCM, SCM);
  81 SCM_API SCM scm_bytevector_u64_ref (SCM, SCM, SCM);
  82 SCM_API SCM scm_bytevector_s64_ref (SCM, SCM, SCM);
  83 SCM_API SCM scm_bytevector_u16_native_set_x (SCM, SCM, SCM);
  84 SCM_API SCM scm_bytevector_s16_native_set_x (SCM, SCM, SCM);
  85 SCM_API SCM scm_bytevector_u32_native_set_x (SCM, SCM, SCM);
  86 SCM_API SCM scm_bytevector_s32_native_set_x (SCM, SCM, SCM);
  87 SCM_API SCM scm_bytevector_u64_native_set_x (SCM, SCM, SCM);
  88 SCM_API SCM scm_bytevector_s64_native_set_x (SCM, SCM, SCM);
  89 SCM_API SCM scm_bytevector_u8_set_x (SCM, SCM, SCM);
  90 SCM_API SCM scm_bytevector_s8_set_x (SCM, SCM, SCM);
  91 SCM_API SCM scm_bytevector_uint_set_x (SCM, SCM, SCM, SCM, SCM);
  92 SCM_API SCM scm_bytevector_sint_set_x (SCM, SCM, SCM, SCM, SCM);
  93 SCM_API SCM scm_bytevector_u16_set_x (SCM, SCM, SCM, SCM);
  94 SCM_API SCM scm_bytevector_s16_set_x (SCM, SCM, SCM, SCM);
  95 SCM_API SCM scm_bytevector_u32_set_x (SCM, SCM, SCM, SCM);
  96 SCM_API SCM scm_bytevector_s32_set_x (SCM, SCM, SCM, SCM);
  97 SCM_API SCM scm_bytevector_u64_set_x (SCM, SCM, SCM, SCM);
  98 SCM_API SCM scm_bytevector_s64_set_x (SCM, SCM, SCM, SCM);
  99 SCM_API SCM scm_bytevector_ieee_single_ref (SCM, SCM, SCM);
 100 SCM_API SCM scm_bytevector_ieee_single_native_ref (SCM, SCM);
 101 SCM_API SCM scm_bytevector_ieee_single_set_x (SCM, SCM, SCM, SCM);
 102 SCM_API SCM scm_bytevector_ieee_single_native_set_x (SCM, SCM, SCM);
 103 SCM_API SCM scm_bytevector_ieee_double_ref (SCM, SCM, SCM);
 104 SCM_API SCM scm_bytevector_ieee_double_native_ref (SCM, SCM);
 105 SCM_API SCM scm_bytevector_ieee_double_set_x (SCM, SCM, SCM, SCM);
 106 SCM_API SCM scm_bytevector_ieee_double_native_set_x (SCM, SCM, SCM);
 107 SCM_API SCM scm_string_to_utf8 (SCM);
 108 SCM_API SCM scm_string_to_utf16 (SCM, SCM);
 109 SCM_API SCM scm_string_to_utf32 (SCM, SCM);
 110 SCM_API SCM scm_utf8_to_string (SCM);
 111 SCM_API SCM scm_utf16_to_string (SCM, SCM);
 112 SCM_API SCM scm_utf32_to_string (SCM, SCM);
 113
 114
 115 \f
 116 /* Internal API.  */
 117
 118 #define SCM_BYTEVECTOR_P(x)                             \
 119   (!SCM_IMP (x) && SCM_TYP7(x) == scm_tc7_bytevector)
 120 #define SCM_BYTEVECTOR_FLAGS(_bv)               \
 121   (SCM_CELL_TYPE (_bv) >> 7UL)
 122 #define SCM_SET_BYTEVECTOR_FLAGS(_bv, _f)                               \
 123   SCM_SET_CELL_TYPE ((_bv),                                             \
 124                      scm_tc7_bytevector | ((scm_t_bits)(_f) << 7UL))
 125
 126 #define SCM_BYTEVECTOR_ELEMENT_TYPE(_bv)        \
 127   (SCM_BYTEVECTOR_FLAGS (_bv))
 128
 129 /* Hint that is passed to `scm_gc_malloc ()' and friends.  */
 130 #define SCM_GC_BYTEVECTOR "bytevector"
 131
 132 SCM_INTERNAL void scm_bootstrap_bytevectors (void);
 133 SCM_INTERNAL void scm_init_bytevectors (void);
 134
 135 SCM_INTERNAL SCM scm_i_native_endianness;
 136 SCM_INTERNAL SCM scm_c_take_bytevector (signed char *, size_t);
 137
 138 SCM_INTERNAL int scm_i_print_bytevector (SCM, SCM, scm_print_state *);
 139
 140 SCM_INTERNAL SCM scm_c_shrink_bytevector (SCM, size_t);
 141 SCM_INTERNAL void scm_i_bytevector_generalized_set_x (SCM, size_t, SCM);
 142 SCM_INTERNAL SCM scm_null_bytevector;
 143
 144 #endif /* SCM_BYTEVECTORS_H */