utils.c File Reference

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <math.h>
#include "utils_private.h"
#include "utils.h"

Go to the source code of this file.

Macros
#define	ADD_CHAR(c)
#define	ADD_CHAR(c)
#define	SKIP_PATTERN(n)
#define	SKIP_CMD(n)
#define	SCPI_DTOSTRE_BUFFER_SIZE   32

Functions
static size_t	patternSeparatorShortPos (const char *pattern, size_t len)
static size_t	patternSeparatorPos (const char *pattern, size_t len)
static size_t	cmdSeparatorPos (const char *cmd, size_t len)
char *	strnpbrk (const char *str, size_t size, const char *set)
size_t	UInt32ToStrBaseSign (uint32_t val, char *str, size_t len, int8_t base, scpi_bool_t sign)
size_t	SCPI_Int32ToStr (int32_t val, char *str, size_t len)
size_t	SCPI_UInt32ToStrBase (uint32_t val, char *str, size_t len, int8_t base)
size_t	UInt64ToStrBaseSign (uint64_t val, char *str, size_t len, int8_t base, scpi_bool_t sign)
size_t	SCPI_Int64ToStr (int64_t val, char *str, size_t len)
size_t	SCPI_UInt64ToStrBase (uint64_t val, char *str, size_t len, int8_t base)
size_t	SCPI_FloatToStr (float val, char *str, size_t len)
size_t	SCPI_DoubleToStr (double val, char *str, size_t len)
size_t	strBaseToInt32 (const char *str, int32_t *val, int8_t base)
size_t	strBaseToUInt32 (const char *str, uint32_t *val, int8_t base)
size_t	strBaseToInt64 (const char *str, int64_t *val, int8_t base)
size_t	strBaseToUInt64 (const char *str, uint64_t *val, int8_t base)
size_t	strToFloat (const char *str, float *val)
size_t	strToDouble (const char *str, double *val)
scpi_bool_t	compareStr (const char *str1, size_t len1, const char *str2, size_t len2)
scpi_bool_t	compareStrAndNum (const char *str1, size_t len1, const char *str2, size_t len2, int32_t *num)
size_t	skipWhitespace (const char *cmd, size_t len)
scpi_bool_t	matchPattern (const char *pattern, size_t pattern_len, const char *str, size_t str_len, int32_t *num)
scpi_bool_t	matchCommand (const char *pattern, const char *cmd, size_t len, int32_t *numbers, size_t numbers_len, int32_t default_value, bool *query)
scpi_bool_t	composeCompoundCommand (const scpi_token_t *prev, scpi_token_t *current)
size_t	BSD_strnlen (const char *s, size_t maxlen)
int	OUR_strncasecmp (const char *s1, const char *s2, size_t n)
static char *	scpi_ecvt (double arg, int ndigits, int *decpt, int *sign, char *buf, size_t bufsize)
char *	SCPI_dtostre (double __val, char *__s, size_t __ssize, unsigned char __prec, unsigned char __flags)
scpi_array_format_t	SCPI_GetNativeFormat (void)
uint16_t	SCPI_Swap16 (uint16_t val)
uint32_t	SCPI_Swap32 (uint32_t val)
uint64_t	SCPI_Swap64 (uint64_t val)

Macro Definition Documentation

ADD_CHAR [1/2]

#define ADD_CHAR

(

c

)

Value:

if (pos < len) str[pos++] = (c)

ADD_CHAR [2/2]

#define ADD_CHAR

(

c

)

Value:

if (pos < len) str[pos++] = (c)

SCPI_DTOSTRE_BUFFER_SIZE

#define SCPI_DTOSTRE_BUFFER_SIZE   32

Definition at line 1015 of file utils.c.

SKIP_CMD

#define SKIP_CMD

(

n

)

Value:

do {cmd_ptr += (n);  cmd_len -= (n);} while(0)

SKIP_PATTERN

#define SKIP_PATTERN

(

n

)

Value:

do {pattern_ptr += (n);  pattern_len -= (n);} while(0)

Function Documentation

BSD_strnlen()

size_t BSD_strnlen	(	const char *	s,
		size_t	maxlen )

Definition at line 734 of file utils.c.

cmdSeparatorPos()

size_t cmdSeparatorPos ( const char * cmd, size_t len )

static

Find command separator position

Parameters

cmd	- input command
len	- max search length

Returns

position of separator or len

Definition at line 459 of file utils.c.

compareStr()

scpi_bool_t compareStr	(	const char *	str1,
		size_t	len1,
		const char *	str2,
		size_t	len2 )

Compare two strings with exact length

Parameters

str1
len1
str2
len2

Returns

TRUE if len1==len2 and "len" characters of both strings are equal

Definition at line 348 of file utils.c.

compareStrAndNum()

scpi_bool_t compareStrAndNum	(	const char *	str1,
		size_t	len1,
		const char *	str2,
		size_t	len2,
		int32_t *	num )

Compare two strings, one be longer but may contains only numbers in that section

Parameters

str1
len1
str2
len2

Returns

TRUE if strings match

Definition at line 368 of file utils.c.

composeCompoundCommand()

scpi_bool_t composeCompoundCommand	(	const scpi_token_t *	prev,
		scpi_token_t *	current )

Compose command from previous command anc current command

Parameters

prev	pointer to previous command
current	pointer of current command

prev and current should be in the same memory buffer

Definition at line 688 of file utils.c.

matchCommand()

scpi_bool_t matchCommand	(	const char *	pattern,
		const char *	cmd,
		size_t	len,
		int32_t *	numbers,
		size_t	numbers_len,
		int32_t	default_value,
		bool *	query )

Compare pattern and command

Parameters

pattern	eg. [:MEASure]:VOLTage:DC?
cmd	- command
len	- max search length

Returns

TRUE if pattern matches, FALSE otherwise

Definition at line 505 of file utils.c.

matchPattern()

scpi_bool_t matchPattern	(	const char *	pattern,
		size_t	pattern_len,
		const char *	str,
		size_t	str_len,
		int32_t *	num )

Match pattern and str. Pattern is in format UPPERCASElowercase

Parameters

pattern
pattern_len
str
str_len

Returns

Definition at line 479 of file utils.c.

OUR_strncasecmp()

int OUR_strncasecmp	(	const char *	s1,
		const char *	s2,
		size_t	n )

Definition at line 747 of file utils.c.

patternSeparatorPos()

size_t patternSeparatorPos ( const char * pattern, size_t len )

static

Find pattern separator position

Parameters

pattern
len	- max search length

Returns

position of separator or len

Definition at line 443 of file utils.c.

patternSeparatorShortPos()

size_t patternSeparatorShortPos ( const char * pattern, size_t len )

static

Pattern is composed from upper case an lower case letters. This function search the first lowercase letter

Parameters

pattern
len	- max search length

Returns

position of separator or len

Definition at line 427 of file utils.c.

SCPI_DoubleToStr()

size_t SCPI_DoubleToStr	(	double	val,
		char *	str,
		size_t	len )

Converts double (64 bit) value to string

Parameters

val	double value
str	converted textual representation
len	string buffer length

Returns

number of bytes written to str (without '\0')

Definition at line 263 of file utils.c.

SCPI_dtostre()

char * SCPI_dtostre	(	double	__val,
		char *	__s,
		size_t	__ssize,
		unsigned char	__prec,
		unsigned char	__flags )

Definition at line 1017 of file utils.c.

scpi_ecvt()

char * scpi_ecvt ( double arg, int ndigits, int * decpt, int * sign, char * buf, size_t bufsize )

static

Definition at line 947 of file utils.c.

SCPI_FloatToStr()

size_t SCPI_FloatToStr	(	float	val,
		char *	str,
		size_t	len )

Converts float (32 bit) value to string

Parameters

val	long value
str	converted textual representation
len	string buffer length

Returns

number of bytes written to str (without '\0')

Definition at line 251 of file utils.c.

SCPI_GetNativeFormat()

scpi_array_format_t SCPI_GetNativeFormat

(

void

)

Get native CPU endiannes

Returns

Definition at line 1106 of file utils.c.

SCPI_Int32ToStr()

size_t SCPI_Int32ToStr	(	int32_t	val,
		char *	str,
		size_t	len )

Converts signed 32 bit integer value to string

Parameters

val	integer value
str	converted textual representation
len	string buffer length

Returns

number of bytes written to str (without '\0')

Definition at line 142 of file utils.c.

SCPI_Int64ToStr()

size_t SCPI_Int64ToStr	(	int64_t	val,
		char *	str,
		size_t	len )

Converts signed 64 bit integer value to string

Parameters

val	integer value
str	converted textual representation
len	string buffer length

Returns

number of bytes written to str (without '\0')

Definition at line 228 of file utils.c.

SCPI_Swap16()

uint16_t SCPI_Swap16

(

uint16_t

val

)

Swap 16bit number

Parameters

val

Returns

Definition at line 1121 of file utils.c.

SCPI_Swap32()

uint32_t SCPI_Swap32

(

uint32_t

val

)

Swap 32bit number

Parameters

val

Returns

Definition at line 1131 of file utils.c.

SCPI_Swap64()

uint64_t SCPI_Swap64

(

uint64_t

val

)

Swap 64bit number

Parameters

val

Returns

Definition at line 1143 of file utils.c.

SCPI_UInt32ToStrBase()

size_t SCPI_UInt32ToStrBase	(	uint32_t	val,
		char *	str,
		size_t	len,
		int8_t	base )

Converts unsigned 32 bit integer value to string in specific base

Parameters

val	integer value
str	converted textual representation
len	string buffer length
base	output base

Returns

number of bytes written to str (without '\0')

Definition at line 154 of file utils.c.

SCPI_UInt64ToStrBase()

size_t SCPI_UInt64ToStrBase	(	uint64_t	val,
		char *	str,
		size_t	len,
		int8_t	base )

Converts signed/unsigned 64 bit integer value to string in specific base

Parameters

val	integer value
str	converted textual representation
len	string buffer length
base	output base

Returns

number of bytes written to str (without '\0')

Definition at line 240 of file utils.c.

skipWhitespace()

size_t skipWhitespace	(	const char *	cmd,
		size_t	len )

Count white spaces from the beggining

Parameters

cmd	- command
len	- max search length

Returns

number of white spaces

Definition at line 410 of file utils.c.

strBaseToInt32()

size_t strBaseToInt32	(	const char *	str,
		int32_t *	val,
		int8_t	base )

Converts string to signed 32bit integer representation

Parameters

str	string value
val	32bit integer result

Returns

number of bytes used in string

Definition at line 274 of file utils.c.

strBaseToInt64()

size_t strBaseToInt64	(	const char *	str,
		int64_t *	val,
		int8_t	base )

Converts string to signed 64bit integer representation

Parameters

str	string value
val	64bit integer result

Returns

number of bytes used in string

Definition at line 298 of file utils.c.

strBaseToUInt32()

size_t strBaseToUInt32	(	const char *	str,
		uint32_t *	val,
		int8_t	base )

Converts string to unsigned 32bit integer representation

Parameters

str	string value
val	32bit integer result

Returns

number of bytes used in string

Definition at line 286 of file utils.c.

strBaseToUInt64()

size_t strBaseToUInt64	(	const char *	str,
		uint64_t *	val,
		int8_t	base )

Converts string to unsigned 64bit integer representation

Parameters

str	string value
val	64bit integer result

Returns

number of bytes used in string

Definition at line 310 of file utils.c.

strnpbrk()

char * strnpbrk	(	const char *	str,
		size_t	size,
		const char *	set )

Find the first occurrence in str of a character in set.

Parameters

str
size
set

Returns

Definition at line 59 of file utils.c.

strToDouble()

size_t strToDouble	(	const char *	str,
		double *	val )

Converts string to double (64 bit) representation

Parameters

str	string value
val	double result

Returns

number of bytes used in string

Definition at line 334 of file utils.c.

strToFloat()

size_t strToFloat	(	const char *	str,
		float *	val )

Converts string to float (32 bit) representation

Parameters

str	string value
val	float result

Returns

number of bytes used in string

Definition at line 322 of file utils.c.

UInt32ToStrBaseSign()

size_t UInt32ToStrBaseSign	(	uint32_t	val,
		char *	str,
		size_t	len,
		int8_t	base,
		scpi_bool_t	sign )

Converts signed/unsigned 32 bit integer value to string in specific base

Parameters

val	integer value
str	converted textual representation
len	string buffer length
base	output base
sign

Returns

number of bytes written to str (without '\0')

Definition at line 81 of file utils.c.

UInt64ToStrBaseSign()

size_t UInt64ToStrBaseSign	(	uint64_t	val,
		char *	str,
		size_t	len,
		int8_t	base,
		scpi_bool_t	sign )

Converts signed/unsigned 64 bit integer value to string in specific base

Parameters

val	integer value
str	converted textual representation
len	string buffer length
base	output base
sign

Returns

number of bytes written to str (without '\0')

Definition at line 167 of file utils.c.