mirror of
https://github.com/mruby/mruby
synced 2026-06-08 16:11:16 +00:00
Yukihiro "Matz" Matsumoto
b99c389ec3
Internal functions can only be called from within the library. Functions listed in `mruby/internal.h` can be called from: * core (src/*.c) * gems (mrbgems/**/*.c) But not from the application linked with `libmruby`.
78 lines
2.0 KiB
C
78 lines
2.0 KiB
C
/**
|
|
** @file mruby/range.h - Range class
|
|
**
|
|
** See Copyright Notice in mruby.h
|
|
*/
|
|
|
|
#ifndef MRUBY_RANGE_H
|
|
#define MRUBY_RANGE_H
|
|
|
|
#include "common.h"
|
|
|
|
/**
|
|
* Range class
|
|
*/
|
|
MRB_BEGIN_DECL
|
|
|
|
#if defined(MRB_NAN_BOXING) && defined(MRB_64BIT) || defined(MRB_WORD_BOXING)
|
|
# define MRB_RANGE_EMBED
|
|
#endif
|
|
|
|
#ifdef MRB_RANGE_EMBED
|
|
struct RRange {
|
|
MRB_OBJECT_HEADER;
|
|
mrb_value beg;
|
|
mrb_value end;
|
|
mrb_bool excl;
|
|
};
|
|
# define mrb_gc_free_range(mrb, p) ((void)0)
|
|
# define RANGE_BEG(p) ((p)->beg)
|
|
# define RANGE_END(p) ((p)->end)
|
|
#else
|
|
typedef struct mrb_range_edges {
|
|
mrb_value beg;
|
|
mrb_value end;
|
|
} mrb_range_edges;
|
|
struct RRange {
|
|
MRB_OBJECT_HEADER;
|
|
mrb_range_edges *edges;
|
|
mrb_bool excl;
|
|
};
|
|
# define mrb_gc_free_range(mrb, p) mrb_free(mrb, (p)->edges)
|
|
# define RANGE_BEG(p) ((p)->edges->beg)
|
|
# define RANGE_END(p) ((p)->edges->end)
|
|
#endif
|
|
|
|
#define mrb_range_beg(mrb, r) RANGE_BEG(mrb_range_ptr(mrb, r))
|
|
#define mrb_range_end(mrb, r) RANGE_END(mrb_range_ptr(mrb, r))
|
|
#define mrb_range_excl_p(mrb, r) RANGE_EXCL(mrb_range_ptr(mrb, r))
|
|
#define mrb_range_raw_ptr(r) ((struct RRange*)mrb_ptr(r))
|
|
#define mrb_range_value(p) mrb_obj_value((void*)(p))
|
|
#define RANGE_EXCL(p) ((p)->excl)
|
|
|
|
MRB_API struct RRange* mrb_range_ptr(mrb_state *mrb, mrb_value range);
|
|
|
|
/*
|
|
* Initializes a Range.
|
|
*
|
|
* If the third parameter is FALSE then it includes the last value in the range.
|
|
* If the third parameter is TRUE then it excludes the last value in the range.
|
|
*
|
|
* @param start the beginning value.
|
|
* @param end the ending value.
|
|
* @param exclude represents the inclusion or exclusion of the last value.
|
|
*/
|
|
MRB_API mrb_value mrb_range_new(mrb_state *mrb, mrb_value start, mrb_value end, mrb_bool exclude);
|
|
|
|
enum mrb_range_beg_len {
|
|
MRB_RANGE_TYPE_MISMATCH = 0, /* (failure) not range */
|
|
MRB_RANGE_OK = 1, /* (success) range */
|
|
MRB_RANGE_OUT = 2 /* (failure) out of range */
|
|
};
|
|
|
|
MRB_API enum mrb_range_beg_len mrb_range_beg_len(mrb_state *mrb, mrb_value range, mrb_int *begp, mrb_int *lenp, mrb_int len, mrb_bool trunc);
|
|
|
|
MRB_END_DECL
|
|
|
|
#endif /* MRUBY_RANGE_H */
|