summaryrefslogtreecommitdiff
path: root/support/dktools/dk4mao8dns.h
blob: ab6671b957e7e4fd27ea81e20e5a4b2aec5a11ba (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
/*
Copyright (C) 2017-2020, Dirk Krause
SPDX-License-Identifier: BSD-3-Clause
*/

/*
	WARNING: This file was generated by the dkct program (see
	http://dktools.sourceforge.net/ for details).
	Changes you make here will be lost if dkct is run again!
	You should modify the original source and run dkct on it.
	Original source: dk4mao8dns.ctr
*/

#ifndef DK4MAO8DNS_H_INCLUDED
/** Avoid multiple inclusions. */
#define DK4MAO8DNS_H_INCLUDED 1


#line 8 "dk4mao8dns.ctr"


/**	@file	dk4mao8dns.h	Print double without scientific notation.

The dk4ma_write_c8_double_no_sci_to_stream() function is intended to write
coordinates to PDF, PS and EPS output.

In contrast to the dk4c8dbl_double_to_stream() function from the dk4c8dbl
this function uses parameter eps to print 0 instead of
very small absolute values.

This module is in the libdk4c library, not libdk4maio8d, as it uses
the dk4_stream_t data type and related functions.

*/

#ifndef DK4CONF_H_INCLUDED
#if DK4_BUILDING_DKTOOLS4
#include "dk4conf.h"
#else
#include <dktools-4/dk4conf.h>
#endif
#endif

#ifndef DK4TYPES_H_INCLUDED
#if DK4_BUILDING_DKTOOLS4
#include "dk4types.h"
#else
#include <dktools-4/dk4types.h>
#endif
#endif

#ifndef DK4ERROR_H_INCLUDED
#if DK4_BUILDING_DKTOOLS4
#include "dk4error.h"
#else
#include <dktools-4/dk4error.h>
#endif
#endif

#ifndef	DK4STRM_H_INCLUDED
#if DK4_BUILDING_DKTOOLS4
#include "dk4strm.h"
#else
#include <dktools-4/dk4strm.h>
#endif
#endif

#ifndef STDLIB_H_INCLUDED
#include <stdlib.h>
#define STDLIB_H_INCLUDED 1
#endif

#ifdef	__cplusplus
extern "C" {
#endif

/**	Write a double value stored in a buffer to a stream, avoid
	scientific notation.
	@param	strm	Stream to write to.
	@param	buf		Buffer containing string representation of double value.
					The buffer contents is modified and probably
					damaged during operation.
	@param	erp		Error report, may be NULL.
	@return	1 on success, 0 on error.

	Error codes:
	- DK4_E_INVALID_ARGUMENTS<br>
	  if strm or buf is NULL,
	- DK4_E_WRITE_FAILED<br>
	  if writing one ore multiple bytes to the stream failed,
	- DK4_E_FLUSH_FAILED<br>
	  if flushing data downwards failed,
	- DK4_E_MATH_OVERFLOW<br>
	  if the exponent is out of range for integer values,<br>
	- DK4_E_SYNTAX<br>
	  if input contains invalid characters.
*/
int
dk4ma_write_c8_double_string_no_sci_to_stream(
	dk4_stream_t	*strm,
	char			*buf,
	dk4_er_t		*erp
);

/**	Write double value to stream, avoid scientific notation.
	@param	strm		Stream to write to.
	@param	v			Value to write.
	@param	eps			Epsilon (values below epsilon are written as 0).
	@param	ex			Flag: Use exact representation.
	@param	min			Minimize text representation.
	@param	erp			Error report, may be NULL.
	@return	1 on success, 0 on error.

	Error codes:
	- DK4_E_INVALID_ARGUMENTS<br>
	  if strm is NULL.
	- DK4_E_WRITE_FAILED<br>
	  if writing one ore multiple bytes to the stream failed,
	- DK4_E_FLUSH_FAILED<br>
	  if flushing data downwards failed,
	- DK4_E_MATH_OVERFLOW<br>
	  if the exponent is out of range for integer values,<br>
	- DK4_E_SYNTAX<br>
	  if input contains invalid characters.
*/
int
dk4ma_write_c8_double_no_sci_to_stream(
	dk4_stream_t	*strm,
	double			 v,
	double			 eps,
	int				 ex,
	int				 min,
	dk4_er_t		*erp
);

#ifdef	__cplusplus
}
#endif


/* vim: set ai sw=4 ts=4 : */


#endif