objlist.c 19.5 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
/*
 * This file is part of the Micro Python project, http://micropython.org/
 *
 * The MIT License (MIT)
 *
 * Copyright (c) 2013, 2014 Damien P. George
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

27
28
29
#include <string.h>
#include <assert.h>

30
31
32
33
#include "py/nlr.h"
#include "py/objlist.h"
#include "py/runtime0.h"
#include "py/runtime.h"
34
#include "py/stackctrl.h"
35

36
37
STATIC mp_obj_t mp_obj_new_list_iterator(mp_obj_list_t *list, mp_uint_t cur);
STATIC mp_obj_list_t *list_new(mp_uint_t n);
38
STATIC mp_obj_t list_extend(mp_obj_t self_in, mp_obj_t arg_in);
39
STATIC mp_obj_t list_pop(mp_uint_t n_args, const mp_obj_t *args);
40

41
42
43
// TODO: Move to mpconfig.h
#define LIST_MIN_ALLOC 4

44
45
46
/******************************************************************************/
/* list                                                                       */

47
STATIC void list_print(void (*print)(void *env, const char *fmt, ...), void *env, mp_obj_t o_in, mp_print_kind_t kind) {
48
    mp_obj_list_t *o = o_in;
49
50
51
    if (!(MICROPY_PY_UJSON && kind == PRINT_JSON)) {
        kind = PRINT_REPR;
    }
52
    print(env, "[");
53
    for (mp_uint_t i = 0; i < o->len; i++) {
54
55
56
        if (i > 0) {
            print(env, ", ");
        }
57
        mp_obj_print_helper(print, env, o->items[i], kind);
58
59
60
61
    }
    print(env, "]");
}

62
63
64
STATIC mp_obj_t list_extend_from_iter(mp_obj_t list, mp_obj_t iterable) {
    mp_obj_t iter = mp_getiter(iterable);
    mp_obj_t item;
65
    while ((item = mp_iternext(iter)) != MP_OBJ_STOP_ITERATION) {
66
67
68
69
70
        mp_obj_list_append(list, item);
    }
    return list;
}

71
STATIC mp_obj_t list_make_new(mp_obj_t type_in, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args) {
72
    (void)type_in;
73
    mp_arg_check_num(n_args, n_kw, 0, 1, false);
74

75
76
77
    switch (n_args) {
        case 0:
            // return a new, empty list
78
            return mp_obj_new_list(0, NULL);
79
80

        case 1:
81
        default: {
82
            // make list from iterable
83
            // TODO: optimize list/tuple
84
            mp_obj_t list = mp_obj_new_list(0, NULL);
85
            return list_extend_from_iter(list, args[0]);
86
87
88
89
        }
    }
}

Damien George's avatar
Damien George committed
90
// Don't pass MP_BINARY_OP_NOT_EQUAL here
91
STATIC bool list_cmp_helper(mp_uint_t op, mp_obj_t self_in, mp_obj_t another_in) {
92
93
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
    if (!MP_OBJ_IS_TYPE(another_in, &mp_type_list)) {
94
95
96
97
98
        return false;
    }
    mp_obj_list_t *self = self_in;
    mp_obj_list_t *another = another_in;

99
    return mp_seq_cmp_objs(op, self->items, self->len, another->items, another->len);
100
101
}

102
STATIC mp_obj_t list_unary_op(mp_uint_t op, mp_obj_t self_in) {
103
104
    mp_obj_list_t *self = self_in;
    switch (op) {
Damien George's avatar
Damien George committed
105
106
        case MP_UNARY_OP_BOOL: return MP_BOOL(self->len != 0);
        case MP_UNARY_OP_LEN: return MP_OBJ_NEW_SMALL_INT(self->len);
107
        default: return MP_OBJ_NULL; // op not supported
108
109
110
    }
}

111
STATIC mp_obj_t list_binary_op(mp_uint_t op, mp_obj_t lhs, mp_obj_t rhs) {
112
113
    mp_obj_list_t *o = lhs;
    switch (op) {
114
        case MP_BINARY_OP_ADD: {
115
            if (!MP_OBJ_IS_TYPE(rhs, &mp_type_list)) {
116
                return MP_OBJ_NULL; // op not supported
John R. Lenton's avatar
John R. Lenton committed
117
118
119
            }
            mp_obj_list_t *p = rhs;
            mp_obj_list_t *s = list_new(o->len + p->len);
120
            mp_seq_cat(s->items, o->items, o->len, p->items, p->len, mp_obj_t);
John R. Lenton's avatar
John R. Lenton committed
121
            return s;
122
        }
123
        case MP_BINARY_OP_INPLACE_ADD: {
124
            if (!MP_OBJ_IS_TYPE(rhs, &mp_type_list)) {
125
                return MP_OBJ_NULL; // op not supported
126
127
128
129
            }
            list_extend(lhs, rhs);
            return o;
        }
130
        case MP_BINARY_OP_MULTIPLY: {
131
            mp_int_t n;
132
            if (!mp_obj_get_int_maybe(rhs, &n)) {
133
                return MP_OBJ_NULL; // op not supported
134
            }
135
136
137
            if (n < 0) {
                n = 0;
            }
138
139
            mp_obj_list_t *s = list_new(o->len * n);
            mp_seq_multiply(o->items, sizeof(*o->items), o->len, n, s->items);
140
141
            return s;
        }
Damien George's avatar
Damien George committed
142
143
144
145
146
        case MP_BINARY_OP_EQUAL:
        case MP_BINARY_OP_LESS:
        case MP_BINARY_OP_LESS_EQUAL:
        case MP_BINARY_OP_MORE:
        case MP_BINARY_OP_MORE_EQUAL:
147
148
            return MP_BOOL(list_cmp_helper(op, lhs, rhs));

149
        default:
150
            return MP_OBJ_NULL; // op not supported
151
152
153
    }
}

154
STATIC mp_obj_t list_subscr(mp_obj_t self_in, mp_obj_t index, mp_obj_t value) {
155
    if (value == MP_OBJ_NULL) {
156
        // delete
157
#if MICROPY_PY_BUILTINS_SLICE
158
159
        if (MP_OBJ_IS_TYPE(index, &mp_type_slice)) {
            mp_obj_list_t *self = self_in;
160
161
            mp_bound_slice_t slice;
            if (!mp_seq_get_fast_slice_indexes(self->len, index, &slice)) {
162
163
164
                assert(0);
            }

165
            mp_int_t len_adj = slice.start - slice.stop;
166
167
            //printf("Len adj: %d\n", len_adj);
            assert(len_adj <= 0);
168
            mp_seq_replace_slice_no_grow(self->items, self->len, slice.start, slice.stop, self->items/*NULL*/, 0, mp_obj_t);
169
170
171
172
173
174
            // Clear "freed" elements at the end of list
            mp_seq_clear(self->items, self->len + len_adj, self->len, sizeof(*self->items));
            self->len += len_adj;
            return mp_const_none;
        }
#endif
175
176
        mp_obj_t args[2] = {self_in, index};
        list_pop(2, args);
177
178
179
180
        return mp_const_none;
    } else if (value == MP_OBJ_SENTINEL) {
        // load
        mp_obj_list_t *self = self_in;
181
#if MICROPY_PY_BUILTINS_SLICE
182
        if (MP_OBJ_IS_TYPE(index, &mp_type_slice)) {
183
184
            mp_bound_slice_t slice;
            if (!mp_seq_get_fast_slice_indexes(self->len, index, &slice)) {
185
                return mp_seq_extract_slice(self->len, self->items, &slice);
186
            }
187
188
            mp_obj_list_t *res = list_new(slice.stop - slice.start);
            mp_seq_copy(res->items, self->items + slice.start, res->len, mp_obj_t);
189
190
191
            return res;
        }
#endif
192
        mp_uint_t index_val = mp_get_index(self->base.type, self->len, index, false);
193
        return self->items[index_val];
194
    } else {
195
#if MICROPY_PY_BUILTINS_SLICE
196
197
198
199
        if (MP_OBJ_IS_TYPE(index, &mp_type_slice)) {
            mp_obj_list_t *self = self_in;
            assert(MP_OBJ_IS_TYPE(value, &mp_type_list));
            mp_obj_list_t *slice = value;
200
201
            mp_bound_slice_t slice_out;
            if (!mp_seq_get_fast_slice_indexes(self->len, index, &slice_out)) {
202
203
                assert(0);
            }
204
            mp_int_t len_adj = slice->len - (slice_out.stop - slice_out.start);
205
            //printf("Len adj: %d\n", len_adj);
206
207
208
209
210
211
212
            if (len_adj > 0) {
                if (self->len + len_adj > self->alloc) {
                    // TODO: Might optimize memory copies here by checking if block can
                    // be grown inplace or not
                    self->items = m_renew(mp_obj_t, self->items, self->alloc, self->len + len_adj);
                    self->alloc = self->len + len_adj;
                }
213
214
                mp_seq_replace_slice_grow_inplace(self->items, self->len,
                    slice_out.start, slice_out.stop, slice->items, slice->len, len_adj, mp_obj_t);
215
            } else {
216
217
                mp_seq_replace_slice_no_grow(self->items, self->len,
                    slice_out.start, slice_out.stop, slice->items, slice->len, mp_obj_t);
218
219
220
221
                // Clear "freed" elements at the end of list
                mp_seq_clear(self->items, self->len + len_adj, self->len, sizeof(*self->items));
                // TODO: apply allocation policy re: alloc_size
            }
222
223
224
225
            self->len += len_adj;
            return mp_const_none;
        }
#endif
226
        mp_obj_list_store(self_in, index, value);
227
        return mp_const_none;
228
229
230
    }
}

231
STATIC mp_obj_t list_getiter(mp_obj_t o_in) {
232
233
234
235
    return mp_obj_new_list_iterator(o_in, 0);
}

mp_obj_t mp_obj_list_append(mp_obj_t self_in, mp_obj_t arg) {
236
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
237
238
    mp_obj_list_t *self = self_in;
    if (self->len >= self->alloc) {
239
        self->items = m_renew(mp_obj_t, self->items, self->alloc, self->alloc * 2);
240
        self->alloc *= 2;
241
        mp_seq_clear(self->items, self->len + 1, self->alloc, sizeof(*self->items));
242
243
244
245
246
    }
    self->items[self->len++] = arg;
    return mp_const_none; // return None, as per CPython
}

247
STATIC mp_obj_t list_extend(mp_obj_t self_in, mp_obj_t arg_in) {
248
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
249
250
251
252
253
254
255
256
    if (MP_OBJ_IS_TYPE(arg_in, &mp_type_list)) {
        mp_obj_list_t *self = self_in;
        mp_obj_list_t *arg = arg_in;

        if (self->len + arg->len > self->alloc) {
            // TODO: use alloc policy for "4"
            self->items = m_renew(mp_obj_t, self->items, self->alloc, self->len + arg->len + 4);
            self->alloc = self->len + arg->len + 4;
257
            mp_seq_clear(self->items, self->len + arg->len, self->alloc, sizeof(*self->items));
258
        }
259

260
261
262
263
        memcpy(self->items + self->len, arg->items, sizeof(mp_obj_t) * arg->len);
        self->len += arg->len;
    } else {
        list_extend_from_iter(self_in, arg_in);
264
265
266
267
    }
    return mp_const_none; // return None, as per CPython
}

268
STATIC mp_obj_t list_pop(mp_uint_t n_args, const mp_obj_t *args) {
John R. Lenton's avatar
John R. Lenton committed
269
    assert(1 <= n_args && n_args <= 2);
270
    assert(MP_OBJ_IS_TYPE(args[0], &mp_type_list));
John R. Lenton's avatar
John R. Lenton committed
271
272
    mp_obj_list_t *self = args[0];
    if (self->len == 0) {
273
        nlr_raise(mp_obj_new_exception_msg(&mp_type_IndexError, "pop from empty list"));
John R. Lenton's avatar
John R. Lenton committed
274
    }
275
    mp_uint_t index = mp_get_index(self->base.type, self->len, n_args == 1 ? MP_OBJ_NEW_SMALL_INT(-1) : args[1], false);
276
277
    mp_obj_t ret = self->items[index];
    self->len -= 1;
278
    memmove(self->items + index, self->items + index + 1, (self->len - index) * sizeof(mp_obj_t));
279
280
    // Clear stale pointer from slot which just got freed to prevent GC issues
    self->items[self->len] = MP_OBJ_NULL;
281
    if (self->alloc > LIST_MIN_ALLOC && self->alloc > 2 * self->len) {
John R. Lenton's avatar
John R. Lenton committed
282
283
284
        self->items = m_renew(mp_obj_t, self->items, self->alloc, self->alloc/2);
        self->alloc /= 2;
    }
285
286
287
    return ret;
}

288
289
STATIC void mp_quicksort(mp_obj_t *head, mp_obj_t *tail, mp_obj_t key_fn, mp_obj_t binop_less_result) {
    MP_STACK_CHECK();
290
291
292
    while (head < tail) {
        mp_obj_t *h = head - 1;
        mp_obj_t *t = tail;
293
        mp_obj_t v = key_fn == MP_OBJ_NULL ? tail[0] : mp_call_function_1(key_fn, tail[0]); // get pivot using key_fn
294
        for (;;) {
295
296
            do ++h; while (h < t && mp_binary_op(MP_BINARY_OP_LESS, key_fn == MP_OBJ_NULL ? h[0] : mp_call_function_1(key_fn, h[0]), v) == binop_less_result);
            do --t; while (h < t && mp_binary_op(MP_BINARY_OP_LESS, v, key_fn == MP_OBJ_NULL ? t[0] : mp_call_function_1(key_fn, t[0])) == binop_less_result);
297
298
299
300
301
302
303
304
            if (h >= t) break;
            mp_obj_t x = h[0];
            h[0] = t[0];
            t[0] = x;
        }
        mp_obj_t x = h[0];
        h[0] = tail[0];
        tail[0] = x;
305
306
307
308
309
310
311
312
        // do the smaller recursive call first, to keep stack within O(log(N))
        if (t - head < tail - h - 1) {
            mp_quicksort(head, t, key_fn, binop_less_result);
            head = h + 1;
        } else {
            mp_quicksort(h + 1, tail, key_fn, binop_less_result);
            tail = t;
        }
313
314
315
    }
}

316
317
318
319
320
321
322
323
324
325
326
327
328
329
// TODO Python defines sort to be stable but ours is not
mp_obj_t mp_obj_list_sort(mp_uint_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args) {
    static const mp_arg_t allowed_args[] = {
        { MP_QSTR_key, MP_ARG_KW_ONLY | MP_ARG_OBJ, {.u_obj = mp_const_none} },
        { MP_QSTR_reverse, MP_ARG_KW_ONLY | MP_ARG_BOOL, {.u_bool = false} },
    };

    // parse args
    mp_arg_val_t args[MP_ARRAY_SIZE(allowed_args)];
    mp_arg_parse_all(n_args - 1, pos_args + 1, kw_args, MP_ARRAY_SIZE(allowed_args), allowed_args, args);

    mp_obj_list_t *self = pos_args[0];
    assert(MP_OBJ_IS_TYPE(self, &mp_type_list));

330
    if (self->len > 1) {
331
        mp_quicksort(self->items, self->items + self->len - 1,
332
333
                     args[0].u_obj == mp_const_none ? MP_OBJ_NULL : args[0].u_obj,
                     args[1].u_bool ? mp_const_false : mp_const_true);
334
    }
335
336

    return mp_const_none;
337
338
}

339
STATIC mp_obj_t list_clear(mp_obj_t self_in) {
340
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
341
342
    mp_obj_list_t *self = self_in;
    self->len = 0;
343
344
    self->items = m_renew(mp_obj_t, self->items, self->alloc, LIST_MIN_ALLOC);
    self->alloc = LIST_MIN_ALLOC;
345
    mp_seq_clear(self->items, 0, self->alloc, sizeof(*self->items));
346
347
348
    return mp_const_none;
}

349
STATIC mp_obj_t list_copy(mp_obj_t self_in) {
350
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
351
352
353
354
    mp_obj_list_t *self = self_in;
    return mp_obj_new_list(self->len, self->items);
}

355
STATIC mp_obj_t list_count(mp_obj_t self_in, mp_obj_t value) {
356
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
John R. Lenton's avatar
John R. Lenton committed
357
    mp_obj_list_t *self = self_in;
358
    return mp_seq_count_obj(self->items, self->len, value);
John R. Lenton's avatar
John R. Lenton committed
359
360
}

361
STATIC mp_obj_t list_index(mp_uint_t n_args, const mp_obj_t *args) {
362
    assert(2 <= n_args && n_args <= 4);
363
    assert(MP_OBJ_IS_TYPE(args[0], &mp_type_list));
364
    mp_obj_list_t *self = args[0];
365
    return mp_seq_index_obj(self->items, self->len, n_args, args);
366
367
}

368
STATIC mp_obj_t list_insert(mp_obj_t self_in, mp_obj_t idx, mp_obj_t obj) {
369
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
370
371
    mp_obj_list_t *self = self_in;
    // insert has its own strange index logic
372
    mp_int_t index = MP_OBJ_SMALL_INT_VALUE(idx);
373
374
375
376
377
378
    if (index < 0) {
         index += self->len;
    }
    if (index < 0) {
         index = 0;
    }
379
    if ((mp_uint_t)index > self->len) {
380
381
382
383
384
         index = self->len;
    }

    mp_obj_list_append(self_in, mp_const_none);

385
    for (mp_int_t i = self->len-1; i > index; i--) {
386
387
388
389
390
391
392
         self->items[i] = self->items[i-1];
    }
    self->items[index] = obj;

    return mp_const_none;
}

393
STATIC mp_obj_t list_remove(mp_obj_t self_in, mp_obj_t value) {
394
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
395
396
397
398
399
400
401
    mp_obj_t args[] = {self_in, value};
    args[1] = list_index(2, args);
    list_pop(2, args);

    return mp_const_none;
}

402
STATIC mp_obj_t list_reverse(mp_obj_t self_in) {
403
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
404
405
    mp_obj_list_t *self = self_in;

406
407
    mp_int_t len = self->len;
    for (mp_int_t i = 0; i < len/2; i++) {
408
409
410
411
412
413
414
415
         mp_obj_t *a = self->items[i];
         self->items[i] = self->items[len-i-1];
         self->items[len-i-1] = a;
    }

    return mp_const_none;
}

416
417
418
419
420
421
422
423
424
425
STATIC MP_DEFINE_CONST_FUN_OBJ_2(list_append_obj, mp_obj_list_append);
STATIC MP_DEFINE_CONST_FUN_OBJ_2(list_extend_obj, list_extend);
STATIC MP_DEFINE_CONST_FUN_OBJ_1(list_clear_obj, list_clear);
STATIC MP_DEFINE_CONST_FUN_OBJ_1(list_copy_obj, list_copy);
STATIC MP_DEFINE_CONST_FUN_OBJ_2(list_count_obj, list_count);
STATIC MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(list_index_obj, 2, 4, list_index);
STATIC MP_DEFINE_CONST_FUN_OBJ_3(list_insert_obj, list_insert);
STATIC MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(list_pop_obj, 1, 2, list_pop);
STATIC MP_DEFINE_CONST_FUN_OBJ_2(list_remove_obj, list_remove);
STATIC MP_DEFINE_CONST_FUN_OBJ_1(list_reverse_obj, list_reverse);
426
STATIC MP_DEFINE_CONST_FUN_OBJ_KW(list_sort_obj, 1, mp_obj_list_sort);
427

428
429
430
431
432
433
434
435
436
437
438
439
STATIC const mp_map_elem_t list_locals_dict_table[] = {
    { MP_OBJ_NEW_QSTR(MP_QSTR_append), (mp_obj_t)&list_append_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_clear), (mp_obj_t)&list_clear_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_copy), (mp_obj_t)&list_copy_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_count), (mp_obj_t)&list_count_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_extend), (mp_obj_t)&list_extend_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_index), (mp_obj_t)&list_index_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_insert), (mp_obj_t)&list_insert_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_pop), (mp_obj_t)&list_pop_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_remove), (mp_obj_t)&list_remove_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_reverse), (mp_obj_t)&list_reverse_obj },
    { MP_OBJ_NEW_QSTR(MP_QSTR_sort), (mp_obj_t)&list_sort_obj },
ian-v's avatar
ian-v committed
440
};
441

442
443
STATIC MP_DEFINE_CONST_DICT(list_locals_dict, list_locals_dict_table);

444
const mp_obj_type_t mp_type_list = {
445
    { &mp_type_type },
446
    .name = MP_QSTR_list,
447
448
    .print = list_print,
    .make_new = list_make_new,
449
    .unary_op = list_unary_op,
450
    .binary_op = list_binary_op,
451
    .subscr = list_subscr,
452
    .getiter = list_getiter,
453
    .locals_dict = (mp_obj_t)&list_locals_dict,
454
455
};

456
void mp_obj_list_init(mp_obj_list_t *o, mp_uint_t n) {
457
    o->base.type = &mp_type_list;
458
    o->alloc = n < LIST_MIN_ALLOC ? LIST_MIN_ALLOC : n;
459
460
    o->len = n;
    o->items = m_new(mp_obj_t, o->alloc);
461
    mp_seq_clear(o->items, n, o->alloc, sizeof(*o->items));
462
463
}

464
STATIC mp_obj_list_t *list_new(mp_uint_t n) {
465
466
    mp_obj_list_t *o = m_new_obj(mp_obj_list_t);
    mp_obj_list_init(o, n);
467
468
469
    return o;
}

470
mp_obj_t mp_obj_new_list(mp_uint_t n, mp_obj_t *items) {
471
    mp_obj_list_t *o = list_new(n);
472
    if (items != NULL) {
473
        for (mp_uint_t i = 0; i < n; i++) {
474
475
            o->items[i] = items[i];
        }
476
477
478
479
    }
    return o;
}

480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
// Special method for usage with exceptions
// Doesn't initialize items, assumes they will be initialized by client.
mp_obj_t mp_obj_new_list_maybe(mp_uint_t n) {
    mp_obj_list_t *o = m_new_obj_maybe(mp_obj_list_t);
    if (!o) {
        return o;
    }
    o->items = m_new_maybe(mp_obj_t, n);
    if (!o->items) {
        m_del_obj(mp_obj_list_t, o);
        return MP_OBJ_NULL;
    }

    o->base.type = &mp_type_list;
    o->len = o->alloc = n;

    return o;
}

499
void mp_obj_list_get(mp_obj_t self_in, mp_uint_t *len, mp_obj_t **items) {
500
501
502
503
504
    mp_obj_list_t *self = self_in;
    *len = self->len;
    *items = self->items;
}

505
void mp_obj_list_set_len(mp_obj_t self_in, mp_uint_t len) {
506
507
508
509
510
511
    // trust that the caller knows what it's doing
    // TODO realloc if len got much smaller than alloc
    mp_obj_list_t *self = self_in;
    self->len = len;
}

512
513
void mp_obj_list_store(mp_obj_t self_in, mp_obj_t index, mp_obj_t value) {
    mp_obj_list_t *self = self_in;
514
    mp_uint_t i = mp_get_index(self->base.type, self->len, index, false);
515
516
517
518
519
520
521
522
523
    self->items[i] = value;
}

/******************************************************************************/
/* list iterator                                                              */

typedef struct _mp_obj_list_it_t {
    mp_obj_base_t base;
    mp_obj_list_t *list;
524
    mp_uint_t cur;
525
526
} mp_obj_list_it_t;

527
STATIC mp_obj_t list_it_iternext(mp_obj_t self_in) {
528
529
530
531
532
533
    mp_obj_list_it_t *self = self_in;
    if (self->cur < self->list->len) {
        mp_obj_t o_out = self->list->items[self->cur];
        self->cur += 1;
        return o_out;
    } else {
534
        return MP_OBJ_STOP_ITERATION;
535
536
537
    }
}

538
STATIC const mp_obj_type_t mp_type_list_it = {
539
    { &mp_type_type },
540
    .name = MP_QSTR_iterator,
541
    .getiter = mp_identity,
542
    .iternext = list_it_iternext,
543
544
};

545
mp_obj_t mp_obj_new_list_iterator(mp_obj_list_t *list, mp_uint_t cur) {
546
    mp_obj_list_it_t *o = m_new_obj(mp_obj_list_it_t);
547
    o->base.type = &mp_type_list_it;
548
549
550
551
    o->list = list;
    o->cur = cur;
    return o;
}