1/* *********************************************************************

2 * This Original Work is copyright of 51 Degrees Mobile Experts Limited.

4 * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.

5 *

6 * This Original Work is licensed under the European Union Public Licence

7 * (EUPL) v.1.2 and is subject to its terms as set out below.

8 *

9 * If a copy of the EUPL was not distributed with this file, You can obtain

10 * one at https://opensource.org/licenses/EUPL-1.2.

11 *

12 * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

13 * amended by the European Commission) shall be deemed incompatible for

14 * the purposes of the Work and the provisions of the compatibility

15 * clause in Article 5 of the EUPL shall not apply.

16 *

17 * If using the Work as, or as part of, a network application, by

18 * including the attribution notice(s) required under Article 5 of the EUPL

19 * in the end user terms of the application under an appropriate heading,

20 * such notice(s) shall fulfill the requirements of that article.

21 * ********************************************************************* */

22

23#ifndef FIFTYONE_DEGREES_STRING_BUILDER_H_INCLUDED

24#define FIFTYONE_DEGREES_STRING_BUILDER_H_INCLUDED

25

26#ifdef FIFTYONE_DEGREES_IPI_SYMBOLS

27#include "ipiSymbols.h"

28#endif

29

69

70#include <stdint.h>

71#include <ctype.h>

72#include "exceptions.h"

73#include "collection.h"

74#include "float.h"

75#include "common.h"

76#include "ip.h"

77#include "propertyValueType.h"

78

79union fiftyone_degrees_stored_binary_value_t;

80typedef union fiftyone_degrees_stored_binary_value_t fiftyoneDegreesStoredBinaryValue;

81

82struct fiftyone_degrees_var_length_byte_array_t;

83typedef struct fiftyone_degrees_var_length_byte_array_t fiftyoneDegreesVarLengthByteArray;

84

86typedef struct fiftyone_degrees_string_builder_t {

87 char* const ptr;

88 size_t const length;

89 char* current;

90 size_t remaining;

91 size_t added;

93 bool full;

94} fiftyoneDegreesStringBuilder;

95

101EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderInit(

102 fiftyoneDegreesStringBuilder* builder);

103

110EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderAddChar(

111 fiftyoneDegreesStringBuilder* builder,

112 char const value);

113

120EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderAddInteger(

121 fiftyoneDegreesStringBuilder* builder,

122 int64_t const value);

123

131EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderAddDouble(

132 fiftyoneDegreesStringBuilder* builder,

133 double value,

134 uint8_t decimalPlaces);

135

143EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderAddChars(

144 fiftyoneDegreesStringBuilder* builder,

145 const char* value,

146 size_t length);

147

155EXTERNAL void fiftyoneDegreesStringBuilderAddIpAddress(

156 fiftyoneDegreesStringBuilder* builder,

157 const fiftyoneDegreesVarLengthByteArray *ipAddress,

158 fiftyoneDegreesIpType type,

159 fiftyoneDegreesException *exception);

160

169EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderAddStringValue(

170 fiftyoneDegreesStringBuilder* builder,

171 const fiftyoneDegreesStoredBinaryValue* value,

172 fiftyoneDegreesPropertyValueType valueType,

173 uint8_t decimalPlaces,

174 fiftyoneDegreesException *exception);

175

181EXTERNAL fiftyoneDegreesStringBuilder* fiftyoneDegreesStringBuilderComplete(

182 fiftyoneDegreesStringBuilder* builder);

183

187

188#endif

fiftyoneDegreesStringBuilderAddInteger

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderAddInteger(fiftyoneDegreesStringBuilder *builder, int64_t const value)

Adds the integer to the buffer.

fiftyoneDegreesStringBuilderAddStringValue

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderAddStringValue(fiftyoneDegreesStringBuilder *builder, const fiftyoneDegreesStoredBinaryValue *value, fiftyoneDegreesPropertyValueType valueType, uint8_t decimalPlaces, fiftyoneDegreesException *exception)

Adds a potentially packed value as a proper string to the buffer.

fiftyoneDegreesStringBuilderComplete

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderComplete(fiftyoneDegreesStringBuilder *builder)

Adds a null terminating character to the buffer.

fiftyoneDegreesStringBuilderAddIpAddress

void fiftyoneDegreesStringBuilderAddIpAddress(fiftyoneDegreesStringBuilder *builder, const fiftyoneDegreesVarLengthByteArray *ipAddress, fiftyoneDegreesIpType type, fiftyoneDegreesException *exception)

Adds an the IP (as string) from byte "string".

fiftyoneDegreesStringBuilderInit

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderInit(fiftyoneDegreesStringBuilder *builder)

Initializes the buffer.

fiftyoneDegreesStringBuilderAddChars

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderAddChars(fiftyoneDegreesStringBuilder *builder, const char *value, size_t length)

Adds the string to the buffer.

fiftyoneDegreesStringBuilderAddDouble

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderAddDouble(fiftyoneDegreesStringBuilder *builder, double value, uint8_t decimalPlaces)

Adds the double to the buffer.

fiftyoneDegreesStringBuilderAddChar

fiftyoneDegreesStringBuilder * fiftyoneDegreesStringBuilderAddChar(fiftyoneDegreesStringBuilder *builder, char const value)