epicsStdlib.h

Go to the documentation of this file.

/*************************************************************************\
* Copyright (c) 2012 UChicago Argonne LLC, as Operator of Argonne
* National Laboratory.
* Copyright (c) 2002 The Regents of the University of California, as
* Operator of Los Alamos National Laboratory.
* SPDX-License-Identifier: EPICS
* EPICS BASE is distributed subject to a Software License Agreement found
* in file LICENSE that is included with this distribution.
\*************************************************************************/
/* epicsStdlib.h */
/* Author: Eric Norum */

#ifndef INC_epicsStdlib_H
#define INC_epicsStdlib_H

#include <stdlib.h>
#include <limits.h>

#include "libComAPI.h"
#include "osdStrtod.h"
#include "epicsTypes.h"
#include "errMdef.h"

#ifdef __cplusplus
extern "C" {
#endif

#define S_stdlib_noConversion (M_stdlib | 1) /* No digits to convert */

#define S_stdlib_extraneous (M_stdlib | 2) /* Extraneous characters */

#define S_stdlib_underflow (M_stdlib | 3) /* Too small to represent */

#define S_stdlib_overflow (M_stdlib | 4) /* Too large to represent */

#define S_stdlib_badBase (M_stdlib | 5) /* Number base not supported */

LIBCOM_API int 
 epicsParseLong(const char *str, long *to, int base, char **units);

LIBCOM_API int
 epicsParseULong(const char *str, unsigned long *to, int base, char **units);

LIBCOM_API int
 epicsParseLLong(const char *str, long long *to, int base, char **units);

LIBCOM_API int
 epicsParseULLong(const char *str, unsigned long long *to, int base, char **units);

LIBCOM_API int
 epicsParseDouble(const char *str, double *to, char **units);

LIBCOM_API int
 epicsParseFloat(const char *str, float *to, char **units);

LIBCOM_API int
 epicsParseInt8(const char *str, epicsInt8 *to, int base, char **units);

LIBCOM_API int
 epicsParseUInt8(const char *str, epicsUInt8 *to, int base, char **units);

LIBCOM_API int
 epicsParseInt16(const char *str, epicsInt16 *to, int base, char **units);

LIBCOM_API int
 epicsParseUInt16(const char *str, epicsUInt16 *to, int base, char **units);

LIBCOM_API int
 epicsParseInt32(const char *str, epicsInt32 *to, int base, char **units);

LIBCOM_API int
 epicsParseUInt32(const char *str, epicsUInt32 *to, int base, char **units);

LIBCOM_API int
 epicsParseInt64(const char *str, epicsInt64 *to, int base, char **units);

LIBCOM_API int
 epicsParseUInt64(const char *str, epicsUInt64 *to, int base, char **units);

#define epicsParseFloat32(str, to, units) epicsParseFloat(str, to, units)

#define epicsParseFloat64(str, to, units) epicsParseDouble(str, to, units)

/* These macros return 1 if successful, 0 on failure.
 * This is analogous to the return value from sscanf()
 */

#define epicsScanLong(str, to, base) (!epicsParseLong(str, to, base, NULL))

#define epicsScanULong(str, to, base) (!epicsParseULong(str, to, base, NULL))

#define epicsScanLLong(str, to, base) (!epicsParseLLong(str, to, base, NULL))

#define epicsScanULLong(str, to, base) (!epicsParseULLong(str, to, base, NULL))

#define epicsScanFloat(str, to) (!epicsParseFloat(str, to, NULL))

#define epicsScanDouble(str, to) (!epicsParseDouble(str, to, NULL))

#ifdef __cplusplus
}
#endif

#endif /* INC_epicsStdlib_H */