builtin.c 15.4 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 <stdio.h>
#include <assert.h>

30
#include "mpconfig.h"
31
32
#include "nlr.h"
#include "misc.h"
33
#include "qstr.h"
34
#include "obj.h"
35
#include "objstr.h"
36
#include "runtime0.h"
37
38
39
#include "runtime.h"
#include "builtin.h"

40
41
42
43
#if MICROPY_ENABLE_FLOAT
#include <math.h>
#endif

Damien George's avatar
Damien George committed
44
45
46
// args[0] is function from class body
// args[1] is class name
// args[2:] are base objects
47
STATIC mp_obj_t mp_builtin___build_class__(uint n_args, const mp_obj_t *args) {
Damien George's avatar
Damien George committed
48
49
    assert(2 <= n_args);

50
51
    // set the new classes __locals__ object
    mp_obj_dict_t *old_locals = mp_locals_get();
52
    mp_obj_t class_locals = mp_obj_new_dict(0);
53
    mp_locals_set(class_locals);
54
55

    // call the class code
56
    mp_obj_t cell = mp_call_function_0(args[0]);
57
58

    // restore old __locals__ object
Damien George's avatar
Damien George committed
59
    mp_locals_set(old_locals);
60

Damien George's avatar
Damien George committed
61
62
63
64
    // get the class type (meta object) from the base objects
    mp_obj_t meta;
    if (n_args == 2) {
        // no explicit bases, so use 'type'
65
        meta = (mp_obj_t)&mp_type_type;
Damien George's avatar
Damien George committed
66
67
68
69
70
71
72
73
74
    } else {
        // use type of first base object
        meta = mp_obj_get_type(args[2]);
    }

    // TODO do proper metaclass resolution for multiple base objects

    // create the new class using a call to the meta object
    mp_obj_t meta_args[3];
75
    meta_args[0] = args[1]; // class name
Damien George's avatar
Damien George committed
76
    meta_args[1] = mp_obj_new_tuple(n_args - 2, args + 2); // tuple of bases
77
    meta_args[2] = class_locals; // dict of members
Damien George's avatar
Damien George committed
78
    mp_obj_t new_class = mp_call_function_n_kw(meta, 3, 0, meta_args);
Damien George's avatar
Damien George committed
79
80
81
82
83
84
85

    // store into cell if neede
    if (cell != mp_const_none) {
        mp_obj_cell_set(cell, new_class);
    }

    return new_class;
86
87
}

Damien George's avatar
Damien George committed
88
89
MP_DEFINE_CONST_FUN_OBJ_VAR(mp_builtin___build_class___obj, 2, mp_builtin___build_class__);

90
STATIC mp_obj_t mp_builtin___repl_print__(mp_obj_t o) {
91
    if (o != mp_const_none) {
92
        mp_obj_print(o, PRINT_REPR);
93
94
        printf("\n");
    }
95
    return mp_const_none;
96
97
}

98
99
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin___repl_print___obj, mp_builtin___repl_print__);

100
101
102
mp_obj_t mp_builtin_abs(mp_obj_t o_in) {
    if (MP_OBJ_IS_SMALL_INT(o_in)) {
        mp_small_int_t val = MP_OBJ_SMALL_INT_VALUE(o_in);
103
104
        if (val < 0) {
            val = -val;
105
        }
106
        return MP_OBJ_NEW_SMALL_INT(val);
107
#if MICROPY_ENABLE_FLOAT
108
    } else if (MP_OBJ_IS_TYPE(o_in, &mp_type_float)) {
109
        mp_float_t value = mp_obj_float_get(o_in);
110
        // TODO check for NaN etc
111
112
        if (value < 0) {
            return mp_obj_new_float(-value);
113
        } else {
114
            return o_in;
115
        }
116
    } else if (MP_OBJ_IS_TYPE(o_in, &mp_type_complex)) {
117
118
        mp_float_t real, imag;
        mp_obj_complex_get(o_in, &real, &imag);
119
        return mp_obj_new_float(MICROPY_FLOAT_C_FUN(sqrt)(real*real + imag*imag));
120
121
122
#endif
    } else {
        assert(0);
123
        return mp_const_none;
124
125
126
    }
}

127
128
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_abs_obj, mp_builtin_abs);

129
STATIC mp_obj_t mp_builtin_all(mp_obj_t o_in) {
Damien George's avatar
Damien George committed
130
    mp_obj_t iterable = mp_getiter(o_in);
131
    mp_obj_t item;
132
    while ((item = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
Damien George's avatar
Damien George committed
133
        if (!mp_obj_is_true(item)) {
134
            return mp_const_false;
135
136
        }
    }
137
    return mp_const_true;
138
139
}

140
141
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_all_obj, mp_builtin_all);

142
STATIC mp_obj_t mp_builtin_any(mp_obj_t o_in) {
Damien George's avatar
Damien George committed
143
    mp_obj_t iterable = mp_getiter(o_in);
144
    mp_obj_t item;
145
    while ((item = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
Damien George's avatar
Damien George committed
146
        if (mp_obj_is_true(item)) {
147
            return mp_const_true;
148
149
        }
    }
150
    return mp_const_false;
151
152
}

153
154
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_any_obj, mp_builtin_any);

155
156
STATIC mp_obj_t mp_builtin_bin(mp_obj_t o_in) {
    mp_obj_t args[] = { MP_OBJ_NEW_QSTR(MP_QSTR__brace_open__colon__hash_b_brace_close_), o_in };
157
    return mp_obj_str_format(ARRAY_SIZE(args), args);
158
159
160
161
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_bin_obj, mp_builtin_bin);

162
STATIC mp_obj_t mp_builtin_callable(mp_obj_t o_in) {
163
164
    if (mp_obj_is_callable(o_in)) {
        return mp_const_true;
165
    } else {
166
        return mp_const_false;
167
168
169
    }
}

170
171
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_callable_obj, mp_builtin_callable);

172
STATIC mp_obj_t mp_builtin_chr(mp_obj_t o_in) {
173
    int ord = mp_obj_get_int(o_in);
174
    if (0 <= ord && ord <= 0x10ffff) {
175
176
        byte str[1] = {ord};
        return mp_obj_new_str(str, 1, true);
177
    } else {
178
        nlr_raise(mp_obj_new_exception_msg(&mp_type_ValueError, "chr() arg not in range(0x110000)"));
179
    }
180
181
}

182
183
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_chr_obj, mp_builtin_chr);

184
STATIC mp_obj_t mp_builtin_dir(uint n_args, const mp_obj_t *args) {
185
186
    // TODO make this function more general and less of a hack

187
    mp_obj_dict_t *dict = NULL;
188
189
    if (n_args == 0) {
        // make a list of names in the local name space
190
        dict = mp_locals_get();
191
192
    } else { // n_args == 1
        // make a list of names in the given object
Damien George's avatar
Damien George committed
193
        if (MP_OBJ_IS_TYPE(args[0], &mp_type_module)) {
194
            dict = mp_obj_module_get_globals(args[0]);
Damien George's avatar
Damien George committed
195
196
197
198
199
200
201
        } else {
            mp_obj_type_t *type;
            if (MP_OBJ_IS_TYPE(args[0], &mp_type_type)) {
                type = args[0];
            } else {
                type = mp_obj_get_type(args[0]);
            }
202
            if (type->locals_dict != MP_OBJ_NULL && MP_OBJ_IS_TYPE(type->locals_dict, &mp_type_dict)) {
203
                dict = type->locals_dict;
Damien George's avatar
Damien George committed
204
            }
205
        }
206
207
208
    }

    mp_obj_t dir = mp_obj_new_list(0, NULL);
209
210
211
212
    if (dict != NULL) {
        for (uint i = 0; i < dict->map.alloc; i++) {
            if (MP_MAP_SLOT_IS_FILLED(&dict->map, i)) {
                mp_obj_list_append(dir, dict->map.table[i].key);
213
214
215
            }
        }
    }
216

217
218
219
220
221
    return dir;
}

MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_dir_obj, 0, 1, mp_builtin_dir);

222
STATIC mp_obj_t mp_builtin_divmod(mp_obj_t o1_in, mp_obj_t o2_in) {
223
224
225
    if (MP_OBJ_IS_SMALL_INT(o1_in) && MP_OBJ_IS_SMALL_INT(o2_in)) {
        mp_small_int_t i1 = MP_OBJ_SMALL_INT_VALUE(o1_in);
        mp_small_int_t i2 = MP_OBJ_SMALL_INT_VALUE(o2_in);
226
227
228
        mp_obj_t args[2];
        args[0] = MP_OBJ_NEW_SMALL_INT(i1 / i2);
        args[1] = MP_OBJ_NEW_SMALL_INT(i1 % i2);
229
        return mp_obj_new_tuple(2, args);
230
    } else {
231
        nlr_raise(mp_obj_new_exception_msg_varg(&mp_type_TypeError, "unsupported operand type(s) for divmod(): '%s' and '%s'", mp_obj_get_type_str(o1_in), mp_obj_get_type_str(o2_in)));
232
233
234
    }
}

235
236
MP_DEFINE_CONST_FUN_OBJ_2(mp_builtin_divmod_obj, mp_builtin_divmod);

237
STATIC mp_obj_t mp_builtin_hash(mp_obj_t o_in) {
238
    // TODO hash will generally overflow small integer; can we safely truncate it?
239
    return mp_obj_new_int(mp_obj_hash(o_in));
240
241
}

242
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_hash_obj, mp_builtin_hash);
243

Damien George's avatar
Damien George committed
244
STATIC mp_obj_t mp_builtin_hex(mp_obj_t o_in) {
245
    return mp_binary_op(MP_BINARY_OP_MODULO, MP_OBJ_NEW_QSTR(MP_QSTR__percent__hash_x), o_in);
Damien George's avatar
Damien George committed
246
247
248
249
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_hex_obj, mp_builtin_hex);

250
STATIC mp_obj_t mp_builtin_iter(mp_obj_t o_in) {
Damien George's avatar
Damien George committed
251
    return mp_getiter(o_in);
252
253
}

254
255
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_iter_obj, mp_builtin_iter);

256
STATIC mp_obj_t mp_builtin_len(mp_obj_t o_in) {
257
258
    mp_obj_t len = mp_obj_len_maybe(o_in);
    if (len == NULL) {
259
        nlr_raise(mp_obj_new_exception_msg_varg(&mp_type_TypeError, "object of type '%s' has no len()", mp_obj_get_type_str(o_in)));
260
261
    } else {
        return len;
262
263
264
    }
}

265
266
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_len_obj, mp_builtin_len);

267
STATIC mp_obj_t mp_builtin_max(uint n_args, const mp_obj_t *args) {
268
269
    if (n_args == 1) {
        // given an iterable
Damien George's avatar
Damien George committed
270
        mp_obj_t iterable = mp_getiter(args[0]);
271
272
        mp_obj_t max_obj = NULL;
        mp_obj_t item;
273
        while ((item = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
274
            if (max_obj == NULL || (mp_binary_op(MP_BINARY_OP_LESS, max_obj, item) == mp_const_true)) {
275
276
                max_obj = item;
            }
277
        }
278
        if (max_obj == NULL) {
279
            nlr_raise(mp_obj_new_exception_msg(&mp_type_ValueError, "max() arg is an empty sequence"));
280
281
        }
        return max_obj;
282
    } else {
283
        // given many args
284
        mp_obj_t max_obj = args[0];
285
        for (int i = 1; i < n_args; i++) {
286
            if (mp_binary_op(MP_BINARY_OP_LESS, max_obj, args[i]) == mp_const_true) {
287
288
289
290
                max_obj = args[i];
            }
        }
        return max_obj;
291
292
293
    }
}

294
295
MP_DEFINE_CONST_FUN_OBJ_VAR(mp_builtin_max_obj, 1, mp_builtin_max);

296
STATIC mp_obj_t mp_builtin_min(uint n_args, const mp_obj_t *args) {
297
298
    if (n_args == 1) {
        // given an iterable
Damien George's avatar
Damien George committed
299
        mp_obj_t iterable = mp_getiter(args[0]);
300
301
        mp_obj_t min_obj = NULL;
        mp_obj_t item;
302
        while ((item = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
303
            if (min_obj == NULL || (mp_binary_op(MP_BINARY_OP_LESS, item, min_obj) == mp_const_true)) {
304
305
306
307
                min_obj = item;
            }
        }
        if (min_obj == NULL) {
308
            nlr_raise(mp_obj_new_exception_msg(&mp_type_ValueError, "min() arg is an empty sequence"));
309
310
311
312
        }
        return min_obj;
    } else {
        // given many args
313
        mp_obj_t min_obj = args[0];
314
        for (int i = 1; i < n_args; i++) {
315
            if (mp_binary_op(MP_BINARY_OP_LESS, args[i], min_obj) == mp_const_true) {
316
317
318
319
320
321
                min_obj = args[i];
            }
        }
        return min_obj;
    }
}
322

323
324
MP_DEFINE_CONST_FUN_OBJ_VAR(mp_builtin_min_obj, 1, mp_builtin_min);

325
STATIC mp_obj_t mp_builtin_next(mp_obj_t o) {
Damien George's avatar
Damien George committed
326
    mp_obj_t ret = mp_iternext_allow_raise(o);
327
    if (ret == MP_OBJ_STOP_ITERATION) {
328
        nlr_raise(mp_obj_new_exception(&mp_type_StopIteration));
329
330
331
    } else {
        return ret;
    }
332
333
334
335
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_next_obj, mp_builtin_next);

336
337
338
339
340
341
STATIC mp_obj_t mp_builtin_oct(mp_obj_t o_in) {
    return mp_binary_op(MP_BINARY_OP_MODULO, MP_OBJ_NEW_QSTR(MP_QSTR__percent__hash_o), o_in);
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_oct_obj, mp_builtin_oct);

342
STATIC mp_obj_t mp_builtin_ord(mp_obj_t o_in) {
343
    uint len;
344
    const char *str = mp_obj_str_get_data(o_in, &len);
345
    if (len == 1) {
346
347
348
        // don't sign extend when converting to ord
        // TODO unicode
        return mp_obj_new_int(((const byte*)str)[0]);
349
    } else {
350
        nlr_raise(mp_obj_new_exception_msg_varg(&mp_type_TypeError, "ord() expected a character, but string of length %d found", len));
351
352
    }
}
353

354
355
MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_ord_obj, mp_builtin_ord);

356
STATIC mp_obj_t mp_builtin_pow(uint n_args, const mp_obj_t *args) {
357
    assert(2 <= n_args && n_args <= 3);
358
    switch (n_args) {
Damien George's avatar
Damien George committed
359
360
        case 2: return mp_binary_op(MP_BINARY_OP_POWER, args[0], args[1]);
        default: return mp_binary_op(MP_BINARY_OP_MODULO, mp_binary_op(MP_BINARY_OP_POWER, args[0], args[1]), args[2]); // TODO optimise...
361
362
    }
}
363

364
365
MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_pow_obj, 2, 3, mp_builtin_pow);

366
367
368
369
370
371
372
373
374
375
376
377
378
STATIC mp_obj_t mp_builtin_print(uint n_args, const mp_obj_t *args, mp_map_t *kwargs) {
    mp_map_elem_t *sep_elem = mp_map_lookup(kwargs, MP_OBJ_NEW_QSTR(MP_QSTR_sep), MP_MAP_LOOKUP);
    mp_map_elem_t *end_elem = mp_map_lookup(kwargs, MP_OBJ_NEW_QSTR(MP_QSTR_end), MP_MAP_LOOKUP);
    const char *sep_data = " ";
    uint sep_len = 1;
    const char *end_data = "\n";
    uint end_len = 1;
    if (sep_elem != NULL && sep_elem->value != mp_const_none) {
        sep_data = mp_obj_str_get_data(sep_elem->value, &sep_len);
    }
    if (end_elem != NULL && end_elem->value != mp_const_none) {
        end_data = mp_obj_str_get_data(end_elem->value, &end_len);
    }
379
380
    for (int i = 0; i < n_args; i++) {
        if (i > 0) {
381
            printf("%.*s", sep_len, sep_data);
382
        }
383
        mp_obj_print(args[i], PRINT_STR);
384
    }
385
    printf("%.*s", end_len, end_data);
386
    return mp_const_none;
387
388
}

389
MP_DEFINE_CONST_FUN_OBJ_KW(mp_builtin_print_obj, 0, mp_builtin_print);
390

391
STATIC mp_obj_t mp_builtin_repr(mp_obj_t o_in) {
Damien George's avatar
Damien George committed
392
    vstr_t *vstr = vstr_new();
393
    mp_obj_print_helper((void (*)(void *env, const char *fmt, ...))vstr_printf, vstr, o_in, PRINT_REPR);
394
395
396
    mp_obj_t s = mp_obj_new_str((byte*)vstr->buf, vstr->len, false);
    vstr_free(vstr);
    return s;
Damien George's avatar
Damien George committed
397
398
399
400
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_repr_obj, mp_builtin_repr);

401
STATIC mp_obj_t mp_builtin_sum(uint n_args, const mp_obj_t *args) {
402
    assert(1 <= n_args && n_args <= 2);
403
    mp_obj_t value;
404
    switch (n_args) {
405
        case 1: value = mp_obj_new_int(0); break;
406
        default: value = args[1]; break;
407
    }
Damien George's avatar
Damien George committed
408
    mp_obj_t iterable = mp_getiter(args[0]);
409
    mp_obj_t item;
410
    while ((item = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
Damien George's avatar
Damien George committed
411
        value = mp_binary_op(MP_BINARY_OP_ADD, value, item);
412
413
414
    }
    return value;
}
Damien George's avatar
Damien George committed
415

416
MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_sum_obj, 1, 2, mp_builtin_sum);
John R. Lenton's avatar
sorted    
John R. Lenton committed
417

418
STATIC mp_obj_t mp_builtin_sorted(uint n_args, const mp_obj_t *args, mp_map_t *kwargs) {
419
420
    assert(n_args >= 1);
    if (n_args > 1) {
421
        nlr_raise(mp_obj_new_exception_msg(&mp_type_TypeError,
John R. Lenton's avatar
sorted    
John R. Lenton committed
422
423
                                          "must use keyword argument for key function"));
    }
424
    mp_obj_t self = mp_type_list.make_new((mp_obj_t)&mp_type_list, 1, 0, args);
425
    mp_obj_list_sort(1, &self, kwargs);
John R. Lenton's avatar
sorted    
John R. Lenton committed
426
427
428

    return self;
}
Damien George's avatar
Damien George committed
429

430
MP_DEFINE_CONST_FUN_OBJ_KW(mp_builtin_sorted_obj, 1, mp_builtin_sorted);
431

432
STATIC mp_obj_t mp_builtin_id(mp_obj_t o_in) {
433
    return mp_obj_new_int((machine_int_t)o_in);
434
435
436
}

MP_DEFINE_CONST_FUN_OBJ_1(mp_builtin_id_obj, mp_builtin_id);
437

438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
// See mp_load_attr() if making any changes
STATIC inline mp_obj_t mp_load_attr_default(mp_obj_t base, qstr attr, mp_obj_t defval) {
    mp_obj_t dest[2];
    // use load_method, raising or not raising exception
    ((defval == MP_OBJ_NULL) ? mp_load_method : mp_load_method_maybe)(base, attr, dest);
    if (dest[0] == MP_OBJ_NULL) {
        return defval;
    } else if (dest[1] == MP_OBJ_NULL) {
        // load_method returned just a normal attribute
        return dest[0];
    } else {
        // load_method returned a method, so build a bound method object
        return mp_obj_new_bound_meth(dest[0], dest[1]);
    }
}

454
455
456
457
458
459
460
STATIC mp_obj_t mp_builtin_getattr(uint n_args, const mp_obj_t *args) {
    assert(MP_OBJ_IS_QSTR(args[1]));
    mp_obj_t defval = MP_OBJ_NULL;
    if (n_args > 2) {
        defval = args[2];
    }
    return mp_load_attr_default(args[0], MP_OBJ_QSTR_VALUE(args[1]), defval);
461
462
}

463
MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(mp_builtin_getattr_obj, 2, 3, mp_builtin_getattr);
464

465
466
467
// These two are defined in terms of MicroPython API functions right away
MP_DEFINE_CONST_FUN_OBJ_0(mp_builtin_globals_obj, mp_globals_get);
MP_DEFINE_CONST_FUN_OBJ_0(mp_builtin_locals_obj, mp_locals_get);