mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
228f6f75f0
OS X build regularly reports some 39 warnings falling in 3 major categories: * "static function '...' is used in an inline function with external linkage [-Wstatic-in-inline]": Some semantics around `inline` have changed between C89 and C99, and gcc and clang seem to disagree on how strict they should be about them. Solution chosen is to use `-Wnostatic-in-inline` command line option for clang. * "implicit conversion turns floating-point number into integer: 'double' to 'bool' [-Wfloat-conversion]": `if (fmod (..., ...))` was used at different places, which is not nice anyway, thus the return value is compared explicitly against `ECMA_NUMBER_ZERO`. * "format string is not a string literal [-Wformat-nonliteral]": Console and log port I/O functions have a printf-like interface, and the default implementations actually pass both format string and the remaining arguments to a vfprintf. However, clang is strict about the format string parameter of vfprintf and expects a literal there. By annotating the port I/O functions with `__attribute__ ((format (printf, ..., ...)))`, clang will check the format string being a literal string earlier, when the port functions are called, and will not complain within them when vfprintf is called. (Actually, this has revealed an incorrect format string, which has been fixed as well.) (There were also some single conversion errors not listed above.) The patch was tested on OS X (where all warnings disappeared), but it should help clang compilation on other OS's as well. JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
151 lines
4.3 KiB
C
151 lines
4.3 KiB
C
/* Copyright 2015-2016 Samsung Electronics Co., Ltd.
|
|
* Copyright 2016 University of Szeged.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef JERRY_PORT_H
|
|
#define JERRY_PORT_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdio.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif /* __cplusplus */
|
|
|
|
/** \addtogroup jerry_port Jerry engine port
|
|
* @{
|
|
*/
|
|
|
|
/*
|
|
* Termination Port API
|
|
*
|
|
* Note:
|
|
* It is questionable whether a library should be able to terminate an
|
|
* application. However, as of now, we only have the concept of completion
|
|
* code around jerry_parse and jerry_run. Most of the other API functions
|
|
* have no way of signaling an error. So, we keep the termination approach
|
|
* with this port function.
|
|
*/
|
|
|
|
/**
|
|
* Error codes
|
|
*/
|
|
typedef enum
|
|
{
|
|
ERR_OUT_OF_MEMORY = 10,
|
|
ERR_SYSCALL = 11,
|
|
ERR_REF_COUNT_LIMIT = 12,
|
|
ERR_FAILED_INTERNAL_ASSERTION = 120
|
|
} jerry_fatal_code_t;
|
|
|
|
/**
|
|
* Signal the port that jerry experienced a fatal failure from which it cannot
|
|
* recover.
|
|
*
|
|
* @param code gives the cause of the error.
|
|
*
|
|
* Note:
|
|
* Jerry expects the function not to return.
|
|
*
|
|
* Example: a libc-based port may implement this with exit() or abort(), or both.
|
|
*/
|
|
void jerry_port_fatal (jerry_fatal_code_t code);
|
|
|
|
/*
|
|
* I/O Port API
|
|
*/
|
|
|
|
/**
|
|
* Print a string to the console. The function should implement a printf-like
|
|
* interface, where the first argument specifies a format string on how to
|
|
* stringify the rest of the parameter list.
|
|
*
|
|
* This function is only called with strings coming from the executed ECMAScript
|
|
* wanting to print something as the result of its normal operation.
|
|
*
|
|
* It should be the port that decides what a "console" is.
|
|
*
|
|
* Example: a libc-based port may implement this with vprintf().
|
|
*/
|
|
void jerry_port_console (const char *format, ...) __attribute__ ((format (printf, 1, 2)));
|
|
|
|
/**
|
|
* Jerry log levels. The levels are in severity order
|
|
* where the most serious levels come first.
|
|
*/
|
|
typedef enum
|
|
{
|
|
JERRY_LOG_LEVEL_ERROR, /**< the engine will terminate after the message is printed */
|
|
JERRY_LOG_LEVEL_WARNING, /**< a request is aborted, but the engine continues its operation */
|
|
JERRY_LOG_LEVEL_DEBUG, /**< debug messages from the engine, low volume */
|
|
JERRY_LOG_LEVEL_TRACE /**< detailed info about engine internals, potentially high volume */
|
|
} jerry_log_level_t;
|
|
|
|
/**
|
|
* Display or log a debug/error message. The function should implement a printf-like
|
|
* interface, where the first argument specifies the log level
|
|
* and the second argument specifies a format string on how to stringify the rest
|
|
* of the parameter list.
|
|
*
|
|
* This function is only called with messages coming from the jerry engine as
|
|
* the result of some abnormal operation or describing its internal operations
|
|
* (e.g., data structure dumps or tracing info).
|
|
*
|
|
* It should be the port that decides whether error and debug messages are logged to
|
|
* the console, or saved to a database or to a file.
|
|
*
|
|
* Example: a libc-based port may implement this with vfprintf(stderr) or
|
|
* vfprintf(logfile), or both, depending on log level.
|
|
*/
|
|
void jerry_port_log (jerry_log_level_t level, const char *format, ...) __attribute__ ((format (printf, 2, 3)));
|
|
|
|
/*
|
|
* Date Port API
|
|
*/
|
|
|
|
/**
|
|
* Jerry time zone structure
|
|
*/
|
|
typedef struct
|
|
{
|
|
int offset; /**< minutes from west */
|
|
int daylight_saving_time; /**< daylight saving time (1 - DST applies, 0 - not on DST) */
|
|
} jerry_time_zone_t;
|
|
|
|
/**
|
|
* Get timezone and daylight saving data
|
|
*
|
|
* @return true - if success
|
|
* false - otherwise
|
|
*/
|
|
bool jerry_port_get_time_zone (jerry_time_zone_t *tz_p);
|
|
|
|
/**
|
|
* Get system time
|
|
*
|
|
* @return milliseconds since Unix epoch
|
|
*/
|
|
double jerry_port_get_current_time (void);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif /* !JERRY_PORT_H */
|