Conversion functions

SFL
Version 2.11

Conversion functions

Filename: sflconv.h
Package: Standard Function Library (SFL)
Written: 1995/12/17 iMatix SFL project team sfl@imatix.com
Revised: 1998/10/19
Copyright: Copyright (c) 1996-2000 iMatix Corporation

Synopsis

These functions provide conversion between a set of datatypes (dates, times, numbers, Booleans) and external strings that represent the values. The objective is to format datatypes for display or printing, and to validate and convert strings supplied by the user. Conversion is controlled by a set of options specific to each datatype. Additionally, dates and times may be formatted using picture strings. The functions were written for use in an interactive 'forms' environment.

List of Functions

char * conv number str
(const char *number, int flags, char point, int decimals, int decimal_format, int width, int sign_format);
char * conv str number
(const char *string, int flags, char point, int decimals, int decimal_format, int width);
char * conv date str
(long date, int flags, int format, int order, char datesep, int width);
long conv str date
(const char *string, int flags, int format, int order);
int conv str day
(const char *day_name);
char * conv time str
(long time, int flags, char timesep, int width);
long conv str time
(const char *string);
char * conv bool str
(Bool boolean, int format);
int conv str bool
(const char *string);
char * conv time pict
(long time, const char *picture);
char * conv date pict
(long date, const char *picture);

List of Symbol Definitions

sflconv.h defines these symbols, possibly conditionally:

Symbol: Defined as:
BOOL_1_0 4
BOOL_TRUE_FALSE 2
BOOL_T_F 3
BOOL_YES_NO 0 /* Boolean field formatting */
BOOL_Y_N 1
CONV_ERR_BAD_MONTH 8 /* Unknown month name */
CONV_ERR_DATE_OVERFLOW 5 /* Result too large for output */
CONV_ERR_DATE_SIZE 6 /* Too few or too many digits */
CONV_ERR_DECS_HIDDEN 18 /* Decimals not allowed if hidden */
CONV_ERR_DECS_MISSING 11 /* Not enough decimals supplied */
CONV_ERR_DECS_OVERFLOW 19 /* Too many decimal positions */
CONV_ERR_DECS_REJECTED 17 /* Decimals not allowed if integer */
CONV_ERR_INVALID_INPUT 1 /* Unrecognised char in input */
CONV_ERR_MULTIPLE_AM 4 /* More than one 'am' or 'pm' */
CONV_ERR_MULTIPLE_DELIM 7 /* Too many delimiters */
CONV_ERR_MULTIPLE_MONTH 10 /* More than one month name */
CONV_ERR_MULTIPLE_POINT 16 /* More than one decimal point */
CONV_ERR_MULTIPLE_SIGN 13 /* More than one sign character */
CONV_ERR_NOT_BOOLEAN 3 /* Not a yes/no or true/false value */
CONV_ERR_NUM_OVERFLOW 12 /* Result too large for output */
CONV_ERR_OUT_OF_RANGE 2 /* Value out of valid range */
CONV_ERR_REJECT_3_5 9 /* 3/5 digits in a row not allowed */
CONV_ERR_SIGN_BAD_FIN 15 /* Malformed financial negative */
CONV_ERR_SIGN_REJECTED 14 /* Sign not allowed if unsigned */
CONV_ERR_TOO_MANY_DIGITS 20 /* Too many digits for number */
CONV_MAX_DECS 100 /* Up to 100 decimal positions */
CONV_NO_ERRORS 0 /* No errors */
DATE_FORMAT_FIRST 0 /* Date field formatting */
DATE_FORMAT_LAST 9
DATE_MD_COMPACT 7
DATE_MD_DELIM 8
DATE_MD_LAST 9
DATE_MD_SPACE 9
DATE_ORDER_DMY 2
DATE_ORDER_FIRST 1 /* Values for date_order */
DATE_ORDER_LAST 3
DATE_ORDER_MDY 3
DATE_ORDER_YMD 1
DATE_YMD_COMMA 3
DATE_YMD_COMPACT 0
DATE_YMD_DELIM 1
DATE_YMD_LAST 3
DATE_YMD_SPACE 2
DATE_YM_COMPACT 4
DATE_YM_DELIM 5
DATE_YM_LAST 6
DATE_YM_SPACE 6
DECS_DROP_ZEROS 2
DECS_HIDE_ALL 3
DECS_SCIENTIFIC 4
DECS_SHOW_ALL 1
FLAG_D_CENTURY 8
FLAG_D_DD_AS_D 1 /* Date field flags */
FLAG_D_MM_AS_M 2
FLAG_D_MONTH_ABC 4
FLAG_D_ORDER_DMY 64
FLAG_D_ORDER_MDY 128
FLAG_D_ORDER_YMD 32
FLAG_D_UPPER 16
FLAG_N_DECIMALS 2
FLAG_N_LEFT 4
FLAG_N_SIGNED 1 /* Number field flags */
FLAG_N_THOUSANDS 32
FLAG_N_ZERO_BLANK 16
FLAG_N_ZERO_FILL 8
FLAG_T_12_HOUR 32
FLAG_T_CC_AS_C 8
FLAG_T_COMPACT 16
FLAG_T_HH_AS_H 1 /* Time field flags */
FLAG_T_MM_AS_M 2
FLAG_T_SS_AS_S 4
FORMAT_MAX 80 /* Max. size of formatted field */
SFLCONV_INCLUDED TRUE
SIGN_ALL_LEAD 4
SIGN_ALL_TRAIL 2
SIGN_FINANCIAL 5
SIGN_NEG_LEAD 3
SIGN_NEG_TRAIL 1 /* Number field formatting */

Symbol:	Defined as:
`BOOL_1_0`	4
`BOOL_TRUE_FALSE`	2
`BOOL_T_F`	3
`BOOL_YES_NO`	0 /* Boolean field formatting */
`BOOL_Y_N`	1
`CONV_ERR_BAD_MONTH`	8 /* Unknown month name */
`CONV_ERR_DATE_OVERFLOW`	5 /* Result too large for output */
`CONV_ERR_DATE_SIZE`	6 /* Too few or too many digits */
`CONV_ERR_DECS_HIDDEN`	18 /* Decimals not allowed if hidden */
`CONV_ERR_DECS_MISSING`	11 /* Not enough decimals supplied */
`CONV_ERR_DECS_OVERFLOW`	19 /* Too many decimal positions */
`CONV_ERR_DECS_REJECTED`	17 /* Decimals not allowed if integer */
`CONV_ERR_INVALID_INPUT`	1 /* Unrecognised char in input */
`CONV_ERR_MULTIPLE_AM`	4 /* More than one 'am' or 'pm' */
`CONV_ERR_MULTIPLE_DELIM`	7 /* Too many delimiters */
`CONV_ERR_MULTIPLE_MONTH`	10 /* More than one month name */
`CONV_ERR_MULTIPLE_POINT`	16 /* More than one decimal point */
`CONV_ERR_MULTIPLE_SIGN`	13 /* More than one sign character */
`CONV_ERR_NOT_BOOLEAN`	3 /* Not a yes/no or true/false value */
`CONV_ERR_NUM_OVERFLOW`	12 /* Result too large for output */
`CONV_ERR_OUT_OF_RANGE`	2 /* Value out of valid range */
`CONV_ERR_REJECT_3_5`	9 /* 3/5 digits in a row not allowed */
`CONV_ERR_SIGN_BAD_FIN`	15 /* Malformed financial negative */
`CONV_ERR_SIGN_REJECTED`	14 /* Sign not allowed if unsigned */
`CONV_ERR_TOO_MANY_DIGITS`	20 /* Too many digits for number */
`CONV_MAX_DECS`	100 /* Up to 100 decimal positions */
`CONV_NO_ERRORS`	0 /* No errors */
`DATE_FORMAT_FIRST`	0 /* Date field formatting */
`DATE_FORMAT_LAST`	9
`DATE_MD_COMPACT`	7
`DATE_MD_DELIM`	8
`DATE_MD_LAST`	9
`DATE_MD_SPACE`	9
`DATE_ORDER_DMY`	2
`DATE_ORDER_FIRST`	1 /* Values for date_order */
`DATE_ORDER_LAST`	3
`DATE_ORDER_MDY`	3
`DATE_ORDER_YMD`	1
`DATE_YMD_COMMA`	3
`DATE_YMD_COMPACT`	0
`DATE_YMD_DELIM`	1
`DATE_YMD_LAST`	3
`DATE_YMD_SPACE`	2
`DATE_YM_COMPACT`	4
`DATE_YM_DELIM`	5
`DATE_YM_LAST`	6
`DATE_YM_SPACE`	6
`DECS_DROP_ZEROS`	2
`DECS_HIDE_ALL`	3
`DECS_SCIENTIFIC`	4
`DECS_SHOW_ALL`	1
`FLAG_D_CENTURY`	8
`FLAG_D_DD_AS_D`	1 /* Date field flags */
`FLAG_D_MM_AS_M`	2
`FLAG_D_MONTH_ABC`	4
`FLAG_D_ORDER_DMY`	64
`FLAG_D_ORDER_MDY`	128
`FLAG_D_ORDER_YMD`	32
`FLAG_D_UPPER`	16
`FLAG_N_DECIMALS`	2
`FLAG_N_LEFT`	4
`FLAG_N_SIGNED`	1 /* Number field flags */
`FLAG_N_THOUSANDS`	32
`FLAG_N_ZERO_BLANK`	16
`FLAG_N_ZERO_FILL`	8
`FLAG_T_12_HOUR`	32
`FLAG_T_CC_AS_C`	8
`FLAG_T_COMPACT`	16
`FLAG_T_HH_AS_H`	1 /* Time field flags */
`FLAG_T_MM_AS_M`	2
`FLAG_T_SS_AS_S`	4
`FORMAT_MAX`	80 /* Max. size of formatted field */
`SFLCONV_INCLUDED`	TRUE
`SIGN_ALL_LEAD`	4
`SIGN_ALL_TRAIL`	2
`SIGN_FINANCIAL`	5
`SIGN_NEG_LEAD`	3
`SIGN_NEG_TRAIL`	1 /* Number field formatting */

| << | < | > | >>