Commit | Line | Data |
---|---|---|
45f4cbdf | 1 | /* Copyright (C) 1995,1996,2000,2001, 2004, 2005, 2006, 2008, 2009 Free Software Foundation, Inc. |
0f2d19dd | 2 | * |
73be1d9e | 3 | * This library is free software; you can redistribute it and/or |
53befeb7 NJ |
4 | * modify it under the terms of the GNU Lesser General Public License |
5 | * as published by the Free Software Foundation; either version 3 of | |
6 | * the License, or (at your option) any later version. | |
0f2d19dd | 7 | * |
53befeb7 NJ |
8 | * This library is distributed in the hope that it will be useful, but |
9 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
73be1d9e MV |
10 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
11 | * Lesser General Public License for more details. | |
0f2d19dd | 12 | * |
73be1d9e MV |
13 | * You should have received a copy of the GNU Lesser General Public |
14 | * License along with this library; if not, write to the Free Software | |
53befeb7 NJ |
15 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
16 | * 02110-1301 USA | |
73be1d9e | 17 | */ |
1bbd0b84 | 18 | |
1bbd0b84 | 19 | |
0f2d19dd | 20 | \f |
dbb605f5 LC |
21 | #ifdef HAVE_CONFIG_H |
22 | # include <config.h> | |
23 | #endif | |
4983cbe4 | 24 | |
a0599745 | 25 | #include "libguile/_scm.h" |
a0599745 | 26 | #include "libguile/validate.h" |
1bbd0b84 | 27 | |
4983cbe4 DH |
28 | #include "libguile/pairs.h" |
29 | ||
45f4cbdf MW |
30 | #include "verify.h" |
31 | ||
0f2d19dd JB |
32 | \f |
33 | ||
0f2d19dd JB |
34 | /* {Pairs} |
35 | */ | |
36 | ||
45f4cbdf MW |
37 | /* |
38 | * This compile-time test verifies the properties needed for the | |
39 | * efficient test macro scm_is_null_or_nil defined in pairs.h, | |
40 | * which is defined in terms of the SCM_MATCHES_BITS_IN_COMMON macro. | |
41 | * | |
42 | * See the comments preceeding the definitions of SCM_BOOL_F and | |
43 | * SCM_MATCHES_BITS_IN_COMMON in tags.h for more information. | |
44 | */ | |
45 | verify (SCM_VALUES_DIFFER_IN_EXACTLY_ONE_BIT_POSITION \ | |
46 | (SCM_ELISP_NIL, SCM_EOL)); | |
47 | ||
48 | ||
e81d98ec DH |
49 | #if (SCM_DEBUG_PAIR_ACCESSES == 1) |
50 | ||
ba1b2226 | 51 | #include "libguile/ports.h" |
e81d98ec DH |
52 | #include "libguile/strings.h" |
53 | ||
54 | void scm_error_pair_access (SCM non_pair) | |
55 | { | |
bab246f3 | 56 | static unsigned int running = 0; |
f32632e6 | 57 | SCM message = scm_from_locale_string ("Non-pair accessed with SCM_C[AD]R: `~S'\n"); |
bab246f3 DH |
58 | |
59 | if (!running) | |
60 | { | |
61 | running = 1; | |
62 | scm_simple_format (scm_current_error_port (), | |
1afff620 | 63 | message, scm_list_1 (non_pair)); |
bab246f3 DH |
64 | abort (); |
65 | } | |
e81d98ec DH |
66 | } |
67 | ||
68 | #endif | |
69 | ||
3b3b36dd | 70 | SCM_DEFINE (scm_cons, "cons", 2, 0, 0, |
4983cbe4 | 71 | (SCM x, SCM y), |
1e6808ea MG |
72 | "Return a newly allocated pair whose car is @var{x} and whose\n" |
73 | "cdr is @var{y}. The pair is guaranteed to be different (in the\n" | |
74 | "sense of @code{eq?}) from every previously existing object.") | |
1bbd0b84 | 75 | #define FUNC_NAME s_scm_cons |
0f2d19dd | 76 | { |
228a24ef | 77 | return scm_cell (SCM_UNPACK (x), SCM_UNPACK (y)); |
0f2d19dd | 78 | } |
1bbd0b84 | 79 | #undef FUNC_NAME |
0f2d19dd | 80 | |
1cc91f1b | 81 | |
0f2d19dd | 82 | SCM |
1bbd0b84 | 83 | scm_cons2 (SCM w, SCM x, SCM y) |
0f2d19dd | 84 | { |
16d4699b | 85 | return scm_cons (w, scm_cons (x, y)); |
0f2d19dd JB |
86 | } |
87 | ||
88 | ||
a1ec6916 | 89 | SCM_DEFINE (scm_pair_p, "pair?", 1, 0, 0, |
1bbd0b84 | 90 | (SCM x), |
1e6808ea MG |
91 | "Return @code{#t} if @var{x} is a pair; otherwise return\n" |
92 | "@code{#f}.") | |
1bbd0b84 | 93 | #define FUNC_NAME s_scm_pair_p |
0f2d19dd | 94 | { |
6fcc7d48 | 95 | return scm_from_bool (scm_is_pair (x)); |
0f2d19dd | 96 | } |
1bbd0b84 | 97 | #undef FUNC_NAME |
0f2d19dd | 98 | |
6fcc7d48 MV |
99 | SCM |
100 | scm_car (SCM pair) | |
101 | { | |
102 | if (!scm_is_pair (pair)) | |
103 | scm_wrong_type_arg_msg (NULL, 0, pair, "pair"); | |
104 | return SCM_CAR (pair); | |
105 | } | |
106 | ||
107 | SCM | |
108 | scm_cdr (SCM pair) | |
109 | { | |
110 | if (!scm_is_pair (pair)) | |
111 | scm_wrong_type_arg_msg (NULL, 0, pair, "pair"); | |
112 | return SCM_CDR (pair); | |
113 | } | |
114 | ||
115 | SCM | |
7dab4b37 | 116 | scm_i_chase_pairs (SCM tree, scm_t_uint32 pattern) |
6fcc7d48 MV |
117 | { |
118 | do | |
119 | { | |
120 | if (!scm_is_pair (tree)) | |
121 | scm_wrong_type_arg_msg (NULL, 0, tree, "pair"); | |
122 | tree = (pattern & 1) ? SCM_CAR (tree) : SCM_CDR (tree); | |
123 | pattern >>= 2; | |
124 | } | |
125 | while (pattern); | |
126 | return tree; | |
127 | } | |
4983cbe4 | 128 | |
a1ec6916 | 129 | SCM_DEFINE (scm_set_car_x, "set-car!", 2, 0, 0, |
1bbd0b84 | 130 | (SCM pair, SCM value), |
d7588e54 GB |
131 | "Stores @var{value} in the car field of @var{pair}. The value returned\n" |
132 | "by @code{set-car!} is unspecified.") | |
1bbd0b84 | 133 | #define FUNC_NAME s_scm_set_car_x |
0f2d19dd | 134 | { |
4983cbe4 | 135 | SCM_VALIDATE_CONS (1, pair); |
d65010b8 | 136 | SCM_SETCAR (pair, value); |
9b8721aa | 137 | return SCM_UNSPECIFIED; |
0f2d19dd | 138 | } |
1bbd0b84 | 139 | #undef FUNC_NAME |
0f2d19dd | 140 | |
4983cbe4 | 141 | |
a1ec6916 | 142 | SCM_DEFINE (scm_set_cdr_x, "set-cdr!", 2, 0, 0, |
1bbd0b84 | 143 | (SCM pair, SCM value), |
d7588e54 GB |
144 | "Stores @var{value} in the cdr field of @var{pair}. The value returned\n" |
145 | "by @code{set-cdr!} is unspecified.") | |
1bbd0b84 | 146 | #define FUNC_NAME s_scm_set_cdr_x |
0f2d19dd | 147 | { |
4983cbe4 | 148 | SCM_VALIDATE_CONS (1, pair); |
d65010b8 | 149 | SCM_SETCDR (pair, value); |
9b8721aa | 150 | return SCM_UNSPECIFIED; |
0f2d19dd | 151 | } |
1bbd0b84 | 152 | #undef FUNC_NAME |
0f2d19dd | 153 | |
0f2d19dd JB |
154 | \f |
155 | ||
14b18ed6 DH |
156 | /* Every cxr-pattern is made up of pairs of bits, starting with the two least |
157 | * significant bits. If in a pair of bits the least significant of the two | |
158 | * bits is 0, this means CDR, otherwise CAR. The most significant bits of the | |
159 | * two bits is only needed to indicate when cxr-ing is ready. This is the | |
160 | * case, when all remaining pairs of bits equal 00. */ | |
161 | ||
162 | typedef struct { | |
163 | const char *name; | |
164 | unsigned char pattern; | |
165 | } t_cxr; | |
166 | ||
167 | static const t_cxr cxrs[] = | |
0f2d19dd | 168 | { |
14b18ed6 DH |
169 | {"cdr", 0x02}, /* 00000010 */ |
170 | {"car", 0x03}, /* 00000011 */ | |
171 | {"cddr", 0x0a}, /* 00001010 */ | |
172 | {"cdar", 0x0b}, /* 00001011 */ | |
173 | {"cadr", 0x0e}, /* 00001110 */ | |
174 | {"caar", 0x0f}, /* 00001111 */ | |
175 | {"cdddr", 0x2a}, /* 00101010 */ | |
176 | {"cddar", 0x2b}, /* 00101011 */ | |
177 | {"cdadr", 0x2e}, /* 00101110 */ | |
178 | {"cdaar", 0x2f}, /* 00101111 */ | |
179 | {"caddr", 0x3a}, /* 00111010 */ | |
180 | {"cadar", 0x3b}, /* 00111011 */ | |
181 | {"caadr", 0x3e}, /* 00111110 */ | |
182 | {"caaar", 0x3f}, /* 00111111 */ | |
183 | {"cddddr", 0xaa}, /* 10101010 */ | |
184 | {"cdddar", 0xab}, /* 10101011 */ | |
185 | {"cddadr", 0xae}, /* 10101110 */ | |
186 | {"cddaar", 0xaf}, /* 10101111 */ | |
187 | {"cdaddr", 0xba}, /* 10111010 */ | |
188 | {"cdadar", 0xbb}, /* 10111011 */ | |
189 | {"cdaadr", 0xbe}, /* 10111110 */ | |
190 | {"cdaaar", 0xbf}, /* 10111111 */ | |
191 | {"cadddr", 0xea}, /* 11101010 */ | |
192 | {"caddar", 0xeb}, /* 11101011 */ | |
193 | {"cadadr", 0xee}, /* 11101110 */ | |
194 | {"cadaar", 0xef}, /* 11101111 */ | |
195 | {"caaddr", 0xfa}, /* 11111010 */ | |
196 | {"caadar", 0xfb}, /* 11111011 */ | |
197 | {"caaadr", 0xfe}, /* 11111110 */ | |
198 | {"caaaar", 0xff}, /* 11111111 */ | |
199 | {0, 0} | |
0f2d19dd JB |
200 | }; |
201 | ||
202 | \f | |
1cc91f1b | 203 | |
0f2d19dd JB |
204 | void |
205 | scm_init_pairs () | |
0f2d19dd | 206 | { |
e59bb516 DH |
207 | unsigned int subnr = 0; |
208 | ||
14b18ed6 DH |
209 | for (subnr = 0; cxrs[subnr].name; subnr++) |
210 | { | |
211 | SCM (*pattern) () = (SCM (*) ()) (scm_t_bits) cxrs[subnr].pattern; | |
212 | scm_c_define_subr (cxrs[subnr].name, scm_tc7_cxr, pattern); | |
213 | } | |
e59bb516 | 214 | |
a0599745 | 215 | #include "libguile/pairs.x" |
0f2d19dd JB |
216 | } |
217 | ||
89e00824 ML |
218 | |
219 | /* | |
220 | Local Variables: | |
221 | c-file-style: "gnu" | |
222 | End: | |
223 | */ |