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
STATIC mp_obj_t mp_obj_new_list_iterator(mp_obj_t list, mp_uint_t cur);
37
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(const mp_print_t *print, mp_obj_t o_in, mp_print_kind_t kind) {
48
    mp_obj_list_t *o = MP_OBJ_CAST(o_in);
49
50
51
    if (!(MICROPY_PY_UJSON && kind == PRINT_JSON)) {
        kind = PRINT_REPR;
    }
52
    mp_print_str(print, "[");
53
    for (mp_uint_t i = 0; i < o->len; i++) {
54
        if (i > 0) {
55
            mp_print_str(print, ", ");
56
        }
57
        mp_obj_print_helper(print, o->items[i], kind);
58
    }
59
    mp_print_str(print, "]");
60
61
}

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
        return false;
    }
96
97
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
    mp_obj_list_t *another = MP_OBJ_CAST(another_in);
98

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
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
104
    switch (op) {
105
        case MP_UNARY_OP_BOOL: return mp_obj_new_bool(self->len != 0);
Damien George's avatar
Damien George committed
106
        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
    mp_obj_list_t *o = MP_OBJ_CAST(lhs);
113
    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
            mp_obj_list_t *p = MP_OBJ_CAST(rhs);
John R. Lenton's avatar
John R. Lenton committed
119
            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);
121
            return MP_OBJ_UNCAST(s);
122
        }
123
        case MP_BINARY_OP_INPLACE_ADD: {
124
            list_extend(lhs, rhs);
125
            return lhs;
126
        }
127
        case MP_BINARY_OP_MULTIPLY: {
128
            mp_int_t n;
129
            if (!mp_obj_get_int_maybe(rhs, &n)) {
130
                return MP_OBJ_NULL; // op not supported
131
            }
132
133
134
            if (n < 0) {
                n = 0;
            }
135
136
            mp_obj_list_t *s = list_new(o->len * n);
            mp_seq_multiply(o->items, sizeof(*o->items), o->len, n, s->items);
137
            return MP_OBJ_UNCAST(s);
138
        }
Damien George's avatar
Damien George committed
139
140
141
142
143
        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:
144
            return mp_obj_new_bool(list_cmp_helper(op, lhs, rhs));
145

146
        default:
147
            return MP_OBJ_NULL; // op not supported
148
149
150
    }
}

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

162
            mp_int_t len_adj = slice.start - slice.stop;
163
164
            //printf("Len adj: %d\n", len_adj);
            assert(len_adj <= 0);
165
            mp_seq_replace_slice_no_grow(self->items, self->len, slice.start, slice.stop, self->items/*NULL*/, 0, sizeof(*self->items));
166
167
168
169
170
171
            // 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
172
173
        mp_obj_t args[2] = {self_in, index};
        list_pop(2, args);
174
175
176
        return mp_const_none;
    } else if (value == MP_OBJ_SENTINEL) {
        // load
177
        mp_obj_list_t *self = MP_OBJ_CAST(self_in);
178
#if MICROPY_PY_BUILTINS_SLICE
179
        if (MP_OBJ_IS_TYPE(index, &mp_type_slice)) {
180
181
            mp_bound_slice_t slice;
            if (!mp_seq_get_fast_slice_indexes(self->len, index, &slice)) {
182
                return mp_seq_extract_slice(self->len, self->items, &slice);
183
            }
184
185
            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);
186
            return MP_OBJ_UNCAST(res);
187
188
        }
#endif
189
        mp_uint_t index_val = mp_get_index(self->base.type, self->len, index, false);
190
        return self->items[index_val];
191
    } else {
192
#if MICROPY_PY_BUILTINS_SLICE
193
        if (MP_OBJ_IS_TYPE(index, &mp_type_slice)) {
194
            mp_obj_list_t *self = MP_OBJ_CAST(self_in);
195
            assert(MP_OBJ_IS_TYPE(value, &mp_type_list));
196
            mp_obj_list_t *slice = MP_OBJ_CAST(value);
197
198
            mp_bound_slice_t slice_out;
            if (!mp_seq_get_fast_slice_indexes(self->len, index, &slice_out)) {
199
200
                assert(0);
            }
201
            mp_int_t len_adj = slice->len - (slice_out.stop - slice_out.start);
202
            //printf("Len adj: %d\n", len_adj);
203
204
205
206
207
208
209
            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;
                }
210
                mp_seq_replace_slice_grow_inplace(self->items, self->len,
211
                    slice_out.start, slice_out.stop, slice->items, slice->len, len_adj, sizeof(*self->items));
212
            } else {
213
                mp_seq_replace_slice_no_grow(self->items, self->len,
214
                    slice_out.start, slice_out.stop, slice->items, slice->len, sizeof(*self->items));
215
216
217
218
                // 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
            }
219
220
221
222
            self->len += len_adj;
            return mp_const_none;
        }
#endif
223
        mp_obj_list_store(self_in, index, value);
224
        return mp_const_none;
225
226
227
    }
}

228
STATIC mp_obj_t list_getiter(mp_obj_t o_in) {
229
230
231
232
    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) {
233
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
234
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
235
    if (self->len >= self->alloc) {
236
        self->items = m_renew(mp_obj_t, self->items, self->alloc, self->alloc * 2);
237
        self->alloc *= 2;
238
        mp_seq_clear(self->items, self->len + 1, self->alloc, sizeof(*self->items));
239
240
241
242
243
    }
    self->items[self->len++] = arg;
    return mp_const_none; // return None, as per CPython
}

244
STATIC mp_obj_t list_extend(mp_obj_t self_in, mp_obj_t arg_in) {
245
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
246
    if (MP_OBJ_IS_TYPE(arg_in, &mp_type_list)) {
247
248
        mp_obj_list_t *self = MP_OBJ_CAST(self_in);
        mp_obj_list_t *arg = MP_OBJ_CAST(arg_in);
249
250
251
252
253

        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;
254
            mp_seq_clear(self->items, self->len + arg->len, self->alloc, sizeof(*self->items));
255
        }
256

257
258
259
260
        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);
261
262
263
264
    }
    return mp_const_none; // return None, as per CPython
}

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

285
286
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();
287
288
289
    while (head < tail) {
        mp_obj_t *h = head - 1;
        mp_obj_t *t = tail;
290
        mp_obj_t v = key_fn == MP_OBJ_NULL ? tail[0] : mp_call_function_1(key_fn, tail[0]); // get pivot using key_fn
291
        for (;;) {
292
293
            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);
294
295
296
297
298
299
300
301
            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;
302
303
304
305
306
307
308
309
        // 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;
        }
310
311
312
    }
}

313
314
315
316
317
318
319
320
321
322
323
// 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);

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

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

    return mp_const_none;
334
335
}

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

346
STATIC mp_obj_t list_copy(mp_obj_t self_in) {
347
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
348
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
349
350
351
    return mp_obj_new_list(self->len, self->items);
}

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

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

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

    mp_obj_list_append(self_in, mp_const_none);

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

    return mp_const_none;
}

390
mp_obj_t mp_obj_list_remove(mp_obj_t self_in, mp_obj_t value) {
391
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
392
393
394
395
396
397
398
    mp_obj_t args[] = {self_in, value};
    args[1] = list_index(2, args);
    list_pop(2, args);

    return mp_const_none;
}

399
STATIC mp_obj_t list_reverse(mp_obj_t self_in) {
400
    assert(MP_OBJ_IS_TYPE(self_in, &mp_type_list));
401
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
402

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

    return mp_const_none;
}

413
414
415
416
417
418
419
420
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);
421
STATIC MP_DEFINE_CONST_FUN_OBJ_2(list_remove_obj, mp_obj_list_remove);
422
STATIC MP_DEFINE_CONST_FUN_OBJ_1(list_reverse_obj, list_reverse);
423
STATIC MP_DEFINE_CONST_FUN_OBJ_KW(list_sort_obj, 1, mp_obj_list_sort);
424

425
426
427
428
429
430
431
432
433
434
435
436
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
437
};
438

439
440
STATIC MP_DEFINE_CONST_DICT(list_locals_dict, list_locals_dict_table);

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

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

461
STATIC mp_obj_list_t *list_new(mp_uint_t n) {
462
463
    mp_obj_t o_in = m_new_obj(mp_obj_list_t);
    mp_obj_list_t *o = MP_OBJ_CAST(o_in);
464
    mp_obj_list_init(o, n);
465
466
467
    return o;
}

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

478
void mp_obj_list_get(mp_obj_t self_in, mp_uint_t *len, mp_obj_t **items) {
479
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
480
481
482
483
    *len = self->len;
    *items = self->items;
}

484
void mp_obj_list_set_len(mp_obj_t self_in, mp_uint_t len) {
485
486
    // trust that the caller knows what it's doing
    // TODO realloc if len got much smaller than alloc
487
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
488
489
490
    self->len = len;
}

491
void mp_obj_list_store(mp_obj_t self_in, mp_obj_t index, mp_obj_t value) {
492
    mp_obj_list_t *self = MP_OBJ_CAST(self_in);
493
    mp_uint_t i = mp_get_index(self->base.type, self->len, index, false);
494
495
496
497
498
499
500
501
    self->items[i] = value;
}

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

typedef struct _mp_obj_list_it_t {
    mp_obj_base_t base;
502
    mp_obj_t list;
503
    mp_uint_t cur;
504
505
} mp_obj_list_it_t;

506
STATIC mp_obj_t list_it_iternext(mp_obj_t self_in) {
507
508
509
510
    mp_obj_list_it_t *self = MP_OBJ_CAST(self_in);
    mp_obj_list_t *list = MP_OBJ_CAST(self->list);
    if (self->cur < list->len) {
        mp_obj_t o_out = list->items[self->cur];
511
512
513
        self->cur += 1;
        return o_out;
    } else {
514
        return MP_OBJ_STOP_ITERATION;
515
516
517
    }
}

518
STATIC const mp_obj_type_t mp_type_list_it = {
519
    { &mp_type_type },
520
    .name = MP_QSTR_iterator,
521
    .getiter = mp_identity,
522
    .iternext = list_it_iternext,
523
524
};

525
526
527
mp_obj_t mp_obj_new_list_iterator(mp_obj_t list, mp_uint_t cur) {
    mp_obj_t o_out = m_new_obj(mp_obj_list_it_t);
    mp_obj_list_it_t *o = MP_OBJ_CAST(o_out);
528
    o->base.type = &mp_type_list_it;
529
530
    o->list = list;
    o->cur = cur;
531
    return o_out;
532
}