Nigel Rantor / azure_c_shared_utility

Azure IoT common library

Fork of azure_c_shared_utility by Azure IoT

strings.c@21:b92006c5b9ff, 2017-02-24 (annotated)

Committer:
AzureIoTClient
Date:
Fri Feb 24 14:01:41 2017 -0800
Revision:
21:b92006c5b9ff
Parent:
19:2e0811512ceb
Child:
25:8507bf644fdf
1.1.8

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Azure.IoT Build 0:fa2de1b79154 1 // Copyright (c) Microsoft. All rights reserved.
Azure.IoT Build 0:fa2de1b79154 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
Azure.IoT Build 0:fa2de1b79154 3
Azure.IoT Build 0:fa2de1b79154 4 //
Azure.IoT Build 0:fa2de1b79154 5 // PUT NO INCLUDES BEFORE HERE
Azure.IoT Build 0:fa2de1b79154 6 //
Azure.IoT Build 0:fa2de1b79154 7 #include <stdlib.h>
Azure.IoT Build 0:fa2de1b79154 8 #include "azure_c_shared_utility/gballoc.h"
Azure.IoT Build 0:fa2de1b79154 9 #include <stddef.h>
Azure.IoT Build 0:fa2de1b79154 10 #include <string.h>
AzureIoTClient 8:3db46d1e5471 11 #include <stdarg.h>
AzureIoTClient 8:3db46d1e5471 12 #include <stdio.h>
AzureIoTClient 8:3db46d1e5471 13
Azure.IoT Build 0:fa2de1b79154 14 //
Azure.IoT Build 0:fa2de1b79154 15 // PUT NO CLIENT LIBRARY INCLUDES BEFORE HERE
Azure.IoT Build 0:fa2de1b79154 16 //
Azure.IoT Build 0:fa2de1b79154 17
Azure.IoT Build 0:fa2de1b79154 18 #include "azure_c_shared_utility/strings.h"
AzureIoTClient 21:b92006c5b9ff 19 #include "azure_c_shared_utility/optimize_size.h"
Azure.IoT Build 6:c55b013dfc2a 20 #include "azure_c_shared_utility/xlogging.h"
Azure.IoT Build 0:fa2de1b79154 21
Azure.IoT Build 0:fa2de1b79154 22 static const char hexToASCII[16] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
Azure.IoT Build 0:fa2de1b79154 23
Azure.IoT Build 0:fa2de1b79154 24 typedef struct STRING_TAG
Azure.IoT Build 0:fa2de1b79154 25 {
Azure.IoT Build 0:fa2de1b79154 26 char* s;
Azure.IoT Build 0:fa2de1b79154 27 }STRING;
Azure.IoT Build 0:fa2de1b79154 28
Azure.IoT Build 0:fa2de1b79154 29 /*this function will allocate a new string with just '\0' in it*/
Azure.IoT Build 0:fa2de1b79154 30 /*return NULL if it fails*/
Azure.IoT Build 0:fa2de1b79154 31 /* Codes_SRS_STRING_07_001: [STRING_new shall allocate a new STRING_HANDLE pointing to an empty string.] */
Azure.IoT Build 0:fa2de1b79154 32 STRING_HANDLE STRING_new(void)
Azure.IoT Build 0:fa2de1b79154 33 {
Azure.IoT Build 0:fa2de1b79154 34 STRING* result;
Azure.IoT Build 0:fa2de1b79154 35 if ((result = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 36 {
Azure.IoT Build 0:fa2de1b79154 37 if ((result->s = (char*)malloc(1)) != NULL)
Azure.IoT Build 0:fa2de1b79154 38 {
Azure.IoT Build 0:fa2de1b79154 39 result->s[0] = '\0';
Azure.IoT Build 0:fa2de1b79154 40 }
Azure.IoT Build 0:fa2de1b79154 41 else
Azure.IoT Build 0:fa2de1b79154 42 {
Azure.IoT Build 0:fa2de1b79154 43 /* Codes_SRS_STRING_07_002: [STRING_new shall return an NULL STRING_HANDLE on any error that is encountered.] */
Azure.IoT Build 0:fa2de1b79154 44 free(result);
Azure.IoT Build 0:fa2de1b79154 45 result = NULL;
Azure.IoT Build 0:fa2de1b79154 46 }
Azure.IoT Build 0:fa2de1b79154 47 }
Azure.IoT Build 0:fa2de1b79154 48 return (STRING_HANDLE)result;
Azure.IoT Build 0:fa2de1b79154 49 }
Azure.IoT Build 0:fa2de1b79154 50
Azure.IoT Build 0:fa2de1b79154 51 /*Codes_SRS_STRING_02_001: [STRING_clone shall produce a new string having the same content as the handle string.*/
Azure.IoT Build 0:fa2de1b79154 52 STRING_HANDLE STRING_clone(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 53 {
Azure.IoT Build 0:fa2de1b79154 54 STRING* result;
Azure.IoT Build 0:fa2de1b79154 55 /*Codes_SRS_STRING_02_002: [If parameter handle is NULL then STRING_clone shall return NULL.]*/
Azure.IoT Build 0:fa2de1b79154 56 if (handle == NULL)
Azure.IoT Build 0:fa2de1b79154 57 {
Azure.IoT Build 0:fa2de1b79154 58 result = NULL;
Azure.IoT Build 0:fa2de1b79154 59 }
Azure.IoT Build 0:fa2de1b79154 60 else
Azure.IoT Build 0:fa2de1b79154 61 {
Azure.IoT Build 0:fa2de1b79154 62 /*Codes_SRS_STRING_02_003: [If STRING_clone fails for any reason, it shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 63 if ((result = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 64 {
Azure.IoT Build 0:fa2de1b79154 65 STRING* source = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 66 /*Codes_SRS_STRING_02_003: [If STRING_clone fails for any reason, it shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 67 size_t sourceLen = strlen(source->s);
Azure.IoT Build 0:fa2de1b79154 68 if ((result->s = (char*)malloc(sourceLen + 1)) == NULL)
Azure.IoT Build 0:fa2de1b79154 69 {
Azure.IoT Build 0:fa2de1b79154 70 free(result);
Azure.IoT Build 0:fa2de1b79154 71 result = NULL;
Azure.IoT Build 0:fa2de1b79154 72 }
Azure.IoT Build 0:fa2de1b79154 73 else
Azure.IoT Build 0:fa2de1b79154 74 {
AzureIoTClient 19:2e0811512ceb 75 (void)memcpy(result->s, source->s, sourceLen + 1);
Azure.IoT Build 0:fa2de1b79154 76 }
Azure.IoT Build 0:fa2de1b79154 77 }
Azure.IoT Build 0:fa2de1b79154 78 else
Azure.IoT Build 0:fa2de1b79154 79 {
Azure.IoT Build 0:fa2de1b79154 80 /*not much to do, result is NULL from malloc*/
Azure.IoT Build 0:fa2de1b79154 81 }
Azure.IoT Build 0:fa2de1b79154 82 }
Azure.IoT Build 0:fa2de1b79154 83 return (STRING_HANDLE)result;
Azure.IoT Build 0:fa2de1b79154 84 }
Azure.IoT Build 0:fa2de1b79154 85
Azure.IoT Build 0:fa2de1b79154 86 /* Codes_SRS_STRING_07_003: [STRING_construct shall allocate a new string with the value of the specified const char*.] */
Azure.IoT Build 0:fa2de1b79154 87 STRING_HANDLE STRING_construct(const char* psz)
Azure.IoT Build 0:fa2de1b79154 88 {
Azure.IoT Build 0:fa2de1b79154 89 STRING_HANDLE result;
Azure.IoT Build 0:fa2de1b79154 90 if (psz == NULL)
Azure.IoT Build 0:fa2de1b79154 91 {
Azure.IoT Build 0:fa2de1b79154 92 /* Codes_SRS_STRING_07_005: [If the supplied const char* is NULL STRING_construct shall return a NULL value.] */
Azure.IoT Build 0:fa2de1b79154 93 result = NULL;
Azure.IoT Build 0:fa2de1b79154 94 }
Azure.IoT Build 0:fa2de1b79154 95 else
Azure.IoT Build 0:fa2de1b79154 96 {
Azure.IoT Build 0:fa2de1b79154 97 STRING* str;
Azure.IoT Build 0:fa2de1b79154 98 if ((str = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 99 {
Azure.IoT Build 0:fa2de1b79154 100 size_t nLen = strlen(psz) + 1;
Azure.IoT Build 0:fa2de1b79154 101 if ((str->s = (char*)malloc(nLen)) != NULL)
Azure.IoT Build 0:fa2de1b79154 102 {
AzureIoTClient 19:2e0811512ceb 103 (void)memcpy(str->s, psz, nLen);
Azure.IoT Build 0:fa2de1b79154 104 result = (STRING_HANDLE)str;
Azure.IoT Build 0:fa2de1b79154 105 }
Azure.IoT Build 0:fa2de1b79154 106 /* Codes_SRS_STRING_07_032: [STRING_construct encounters any error it shall return a NULL value.] */
Azure.IoT Build 0:fa2de1b79154 107 else
Azure.IoT Build 0:fa2de1b79154 108 {
Azure.IoT Build 0:fa2de1b79154 109 free(str);
Azure.IoT Build 0:fa2de1b79154 110 result = NULL;
Azure.IoT Build 0:fa2de1b79154 111 }
Azure.IoT Build 0:fa2de1b79154 112 }
Azure.IoT Build 0:fa2de1b79154 113 else
Azure.IoT Build 0:fa2de1b79154 114 {
Azure.IoT Build 0:fa2de1b79154 115 /* Codes_SRS_STRING_07_032: [STRING_construct encounters any error it shall return a NULL value.] */
Azure.IoT Build 0:fa2de1b79154 116 result = NULL;
Azure.IoT Build 0:fa2de1b79154 117 }
Azure.IoT Build 0:fa2de1b79154 118 }
Azure.IoT Build 0:fa2de1b79154 119 return result;
Azure.IoT Build 0:fa2de1b79154 120 }
Azure.IoT Build 0:fa2de1b79154 121
AzureIoTClient 8:3db46d1e5471 122 STRING_HANDLE STRING_construct_sprintf(const char* format, ...)
AzureIoTClient 8:3db46d1e5471 123 {
AzureIoTClient 8:3db46d1e5471 124 STRING* result;
Azure.IoT.Build 16:18e7ebd42bb2 125
Azure.IoT.Build 16:18e7ebd42bb2 126 #ifdef ARDUINO_ARCH_ESP8266
Azure.IoT.Build 16:18e7ebd42bb2 127 size_t maxBufSize = 512;
Azure.IoT.Build 16:18e7ebd42bb2 128 char buf[512];
Azure.IoT.Build 16:18e7ebd42bb2 129 #else
Azure.IoT.Build 16:18e7ebd42bb2 130 size_t maxBufSize = 0;
Azure.IoT.Build 16:18e7ebd42bb2 131 char* buf = NULL;
Azure.IoT.Build 16:18e7ebd42bb2 132 #endif
Azure.IoT.Build 16:18e7ebd42bb2 133
AzureIoTClient 8:3db46d1e5471 134 if (format != NULL)
AzureIoTClient 8:3db46d1e5471 135 {
AzureIoTClient 8:3db46d1e5471 136 va_list arg_list;
AzureIoTClient 9:079c39803432 137 int length;
AzureIoTClient 8:3db46d1e5471 138 va_start(arg_list, format);
AzureIoTClient 8:3db46d1e5471 139
AzureIoTClient 8:3db46d1e5471 140 /* Codes_SRS_STRING_07_041: [STRING_construct_sprintf shall determine the size of the resulting string and allocate the necessary memory.] */
Azure.IoT.Build 16:18e7ebd42bb2 141 length = vsnprintf(buf, maxBufSize, format, arg_list);
AzureIoTClient 8:3db46d1e5471 142 va_end(arg_list);
AzureIoTClient 8:3db46d1e5471 143 if (length > 0)
AzureIoTClient 8:3db46d1e5471 144 {
AzureIoTClient 8:3db46d1e5471 145 result = (STRING*)malloc(sizeof(STRING));
AzureIoTClient 8:3db46d1e5471 146 if (result != NULL)
AzureIoTClient 8:3db46d1e5471 147 {
AzureIoTClient 8:3db46d1e5471 148 result->s = (char*)malloc(length+1);
AzureIoTClient 8:3db46d1e5471 149 if (result->s != NULL)
AzureIoTClient 8:3db46d1e5471 150 {
AzureIoTClient 8:3db46d1e5471 151 va_start(arg_list, format);
AzureIoTClient 8:3db46d1e5471 152 if (vsnprintf(result->s, length+1, format, arg_list) < 0)
AzureIoTClient 8:3db46d1e5471 153 {
AzureIoTClient 8:3db46d1e5471 154 /* Codes_SRS_STRING_07_040: [If any error is encountered STRING_construct_sprintf shall return NULL.] */
AzureIoTClient 8:3db46d1e5471 155 free(result->s);
AzureIoTClient 8:3db46d1e5471 156 free(result);
AzureIoTClient 8:3db46d1e5471 157 result = NULL;
AzureIoTClient 8:3db46d1e5471 158 LogError("Failure: vsnprintf formatting failed.");
AzureIoTClient 8:3db46d1e5471 159 }
AzureIoTClient 8:3db46d1e5471 160 va_end(arg_list);
AzureIoTClient 8:3db46d1e5471 161 }
AzureIoTClient 8:3db46d1e5471 162 else
AzureIoTClient 8:3db46d1e5471 163 {
AzureIoTClient 8:3db46d1e5471 164 /* Codes_SRS_STRING_07_040: [If any error is encountered STRING_construct_sprintf shall return NULL.] */
AzureIoTClient 8:3db46d1e5471 165 free(result);
AzureIoTClient 8:3db46d1e5471 166 result = NULL;
AzureIoTClient 8:3db46d1e5471 167 LogError("Failure: allocation failed.");
AzureIoTClient 8:3db46d1e5471 168 }
AzureIoTClient 8:3db46d1e5471 169 }
AzureIoTClient 8:3db46d1e5471 170 else
AzureIoTClient 8:3db46d1e5471 171 {
AzureIoTClient 8:3db46d1e5471 172 LogError("Failure: allocation failed.");
AzureIoTClient 8:3db46d1e5471 173 }
AzureIoTClient 8:3db46d1e5471 174 }
AzureIoTClient 8:3db46d1e5471 175 else if (length == 0)
AzureIoTClient 8:3db46d1e5471 176 {
AzureIoTClient 8:3db46d1e5471 177 result = (STRING*)STRING_new();
AzureIoTClient 8:3db46d1e5471 178 }
AzureIoTClient 8:3db46d1e5471 179 else
AzureIoTClient 8:3db46d1e5471 180 {
AzureIoTClient 8:3db46d1e5471 181 /* Codes_SRS_STRING_07_039: [If the parameter format is NULL then STRING_construct_sprintf shall return NULL.] */
AzureIoTClient 8:3db46d1e5471 182 result = NULL;
AzureIoTClient 8:3db46d1e5471 183 LogError("Failure: vsnprintf return 0 length");
AzureIoTClient 8:3db46d1e5471 184 }
AzureIoTClient 8:3db46d1e5471 185 }
AzureIoTClient 8:3db46d1e5471 186 else
AzureIoTClient 8:3db46d1e5471 187 {
AzureIoTClient 8:3db46d1e5471 188 LogError("Failure: invalid argument.");
AzureIoTClient 8:3db46d1e5471 189 result = NULL;
AzureIoTClient 8:3db46d1e5471 190 }
AzureIoTClient 8:3db46d1e5471 191 /* Codes_SRS_STRING_07_045: [STRING_construct_sprintf shall allocate a new string with the value of the specified printf formated const char. ] */
AzureIoTClient 8:3db46d1e5471 192 return (STRING_HANDLE)result;
AzureIoTClient 8:3db46d1e5471 193 }
AzureIoTClient 8:3db46d1e5471 194
Azure.IoT Build 0:fa2de1b79154 195 /*this function will return a new STRING with the memory for the actual string passed in as a parameter.*/
Azure.IoT Build 0:fa2de1b79154 196 /*return NULL if it fails.*/
Azure.IoT Build 0:fa2de1b79154 197 /* The supplied memory must have been allocated with malloc! */
Azure.IoT Build 0:fa2de1b79154 198 /* Codes_SRS_STRING_07_006: [STRING_new_with_memory shall return a STRING_HANDLE by using the supplied char* memory.] */
Azure.IoT Build 0:fa2de1b79154 199 STRING_HANDLE STRING_new_with_memory(const char* memory)
Azure.IoT Build 0:fa2de1b79154 200 {
Azure.IoT Build 0:fa2de1b79154 201 STRING* result;
Azure.IoT Build 0:fa2de1b79154 202 if (memory == NULL)
Azure.IoT Build 0:fa2de1b79154 203 {
Azure.IoT Build 0:fa2de1b79154 204 /* Codes_SRS_STRING_07_007: [STRING_new_with_memory shall return a NULL STRING_HANDLE if the supplied char* is NULL.] */
Azure.IoT Build 0:fa2de1b79154 205 result = NULL;
Azure.IoT Build 0:fa2de1b79154 206 }
Azure.IoT Build 0:fa2de1b79154 207 else
Azure.IoT Build 0:fa2de1b79154 208 {
Azure.IoT Build 0:fa2de1b79154 209 if ((result = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 210 {
Azure.IoT Build 0:fa2de1b79154 211 result->s = (char*)memory;
Azure.IoT Build 0:fa2de1b79154 212 }
Azure.IoT Build 0:fa2de1b79154 213 }
Azure.IoT Build 0:fa2de1b79154 214 return (STRING_HANDLE)result;
Azure.IoT Build 0:fa2de1b79154 215 }
Azure.IoT Build 0:fa2de1b79154 216
Azure.IoT Build 0:fa2de1b79154 217 /* Codes_SRS_STRING_07_008: [STRING_new_quoted shall return a valid STRING_HANDLE Copying the supplied const char* value surrounded by quotes.] */
Azure.IoT Build 0:fa2de1b79154 218 STRING_HANDLE STRING_new_quoted(const char* source)
Azure.IoT Build 0:fa2de1b79154 219 {
Azure.IoT Build 0:fa2de1b79154 220 STRING* result;
Azure.IoT Build 0:fa2de1b79154 221 if (source == NULL)
Azure.IoT Build 0:fa2de1b79154 222 {
Azure.IoT Build 0:fa2de1b79154 223 /* Codes_SRS_STRING_07_009: [STRING_new_quoted shall return a NULL STRING_HANDLE if the supplied const char* is NULL.] */
Azure.IoT Build 0:fa2de1b79154 224 result = NULL;
Azure.IoT Build 0:fa2de1b79154 225 }
Azure.IoT Build 0:fa2de1b79154 226 else if ((result = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 227 {
Azure.IoT Build 0:fa2de1b79154 228 size_t sourceLength = strlen(source);
Azure.IoT Build 0:fa2de1b79154 229 if ((result->s = (char*)malloc(sourceLength + 3)) != NULL)
Azure.IoT Build 0:fa2de1b79154 230 {
Azure.IoT Build 0:fa2de1b79154 231 result->s[0] = '"';
AzureIoTClient 19:2e0811512ceb 232 (void)memcpy(result->s + 1, source, sourceLength);
Azure.IoT Build 0:fa2de1b79154 233 result->s[sourceLength + 1] = '"';
Azure.IoT Build 0:fa2de1b79154 234 result->s[sourceLength + 2] = '\0';
Azure.IoT Build 0:fa2de1b79154 235 }
Azure.IoT Build 0:fa2de1b79154 236 else
Azure.IoT Build 0:fa2de1b79154 237 {
Azure.IoT Build 0:fa2de1b79154 238 /* Codes_SRS_STRING_07_031: [STRING_new_quoted shall return a NULL STRING_HANDLE if any error is encountered.] */
Azure.IoT Build 0:fa2de1b79154 239 free(result);
Azure.IoT Build 0:fa2de1b79154 240 result = NULL;
Azure.IoT Build 0:fa2de1b79154 241 }
Azure.IoT Build 0:fa2de1b79154 242 }
Azure.IoT Build 0:fa2de1b79154 243 return (STRING_HANDLE)result;
Azure.IoT Build 0:fa2de1b79154 244 }
Azure.IoT Build 0:fa2de1b79154 245
Azure.IoT Build 0:fa2de1b79154 246 /*this function takes a regular const char* and turns in into "this is a\"JSON\" strings\u0008" (starting and ending quote included)*/
Azure.IoT Build 0:fa2de1b79154 247 /*the newly created handle needs to be disposed of with STRING_delete*/
Azure.IoT Build 0:fa2de1b79154 248 /*returns NULL if there are errors*/
Azure.IoT Build 0:fa2de1b79154 249 STRING_HANDLE STRING_new_JSON(const char* source)
Azure.IoT Build 0:fa2de1b79154 250 {
Azure.IoT Build 0:fa2de1b79154 251 STRING* result;
Azure.IoT Build 0:fa2de1b79154 252 if (source == NULL)
Azure.IoT Build 0:fa2de1b79154 253 {
Azure.IoT Build 0:fa2de1b79154 254 /*Codes_SRS_STRING_02_011: [If source is NULL then STRING_new_JSON shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 255 result = NULL;
AzureIoTClient 1:9190c0f4d23a 256 LogError("invalid arg (NULL)");
Azure.IoT Build 0:fa2de1b79154 257 }
Azure.IoT Build 0:fa2de1b79154 258 else
Azure.IoT Build 0:fa2de1b79154 259 {
Azure.IoT Build 0:fa2de1b79154 260 size_t i;
Azure.IoT Build 0:fa2de1b79154 261 size_t nControlCharacters = 0; /*counts how many characters are to be expanded from 1 character to \uxxxx (6 characters)*/
Azure.IoT Build 0:fa2de1b79154 262 size_t nEscapeCharacters = 0;
Azure.IoT Build 0:fa2de1b79154 263 size_t vlen = strlen(source);
Azure.IoT Build 0:fa2de1b79154 264
Azure.IoT Build 0:fa2de1b79154 265 for (i = 0; i < vlen; i++)
Azure.IoT Build 0:fa2de1b79154 266 {
Azure.IoT Build 0:fa2de1b79154 267 /*Codes_SRS_STRING_02_014: [If any character has the value outside [1...127] then STRING_new_JSON shall fail and return NULL.] */
Azure.IoT Build 0:fa2de1b79154 268 if ((unsigned char)source[i] >= 128) /*this be a UNICODE character begin*/
Azure.IoT Build 0:fa2de1b79154 269 {
Azure.IoT Build 0:fa2de1b79154 270 break;
Azure.IoT Build 0:fa2de1b79154 271 }
Azure.IoT Build 0:fa2de1b79154 272 else
Azure.IoT Build 0:fa2de1b79154 273 {
Azure.IoT Build 0:fa2de1b79154 274 if (source[i] <= 0x1F)
Azure.IoT Build 0:fa2de1b79154 275 {
Azure.IoT Build 0:fa2de1b79154 276 nControlCharacters++;
Azure.IoT Build 0:fa2de1b79154 277 }
Azure.IoT Build 0:fa2de1b79154 278 else if (
Azure.IoT Build 0:fa2de1b79154 279 (source[i] == '"') ||
Azure.IoT Build 0:fa2de1b79154 280 (source[i] == '\\') ||
Azure.IoT Build 0:fa2de1b79154 281 (source[i] == '/')
Azure.IoT Build 0:fa2de1b79154 282 )
Azure.IoT Build 0:fa2de1b79154 283 {
Azure.IoT Build 0:fa2de1b79154 284 nEscapeCharacters++;
Azure.IoT Build 0:fa2de1b79154 285 }
Azure.IoT Build 0:fa2de1b79154 286 }
Azure.IoT Build 0:fa2de1b79154 287 }
Azure.IoT Build 0:fa2de1b79154 288
Azure.IoT Build 0:fa2de1b79154 289 if (i < vlen)
Azure.IoT Build 0:fa2de1b79154 290 {
Azure.IoT Build 0:fa2de1b79154 291 result = NULL;
AzureIoTClient 1:9190c0f4d23a 292 LogError("invalid character in input string");
Azure.IoT Build 0:fa2de1b79154 293 }
Azure.IoT Build 0:fa2de1b79154 294 else
Azure.IoT Build 0:fa2de1b79154 295 {
Azure.IoT Build 0:fa2de1b79154 296 if ((result = (STRING*)malloc(sizeof(STRING))) == NULL)
Azure.IoT Build 0:fa2de1b79154 297 {
Azure.IoT Build 0:fa2de1b79154 298 /*Codes_SRS_STRING_02_021: [If the complete JSON representation cannot be produced, then STRING_new_JSON shall fail and return NULL.] */
AzureIoTClient 1:9190c0f4d23a 299 LogError("malloc failure");
Azure.IoT Build 0:fa2de1b79154 300 }
Azure.IoT Build 0:fa2de1b79154 301 else if ((result->s = (char*)malloc(vlen + 5 * nControlCharacters + nEscapeCharacters + 3)) == NULL)
Azure.IoT Build 0:fa2de1b79154 302 {
Azure.IoT Build 0:fa2de1b79154 303 /*Codes_SRS_STRING_02_021: [If the complete JSON representation cannot be produced, then STRING_new_JSON shall fail and return NULL.] */
Azure.IoT Build 0:fa2de1b79154 304 free(result);
Azure.IoT Build 0:fa2de1b79154 305 result = NULL;
AzureIoTClient 1:9190c0f4d23a 306 LogError("malloc failed");
Azure.IoT Build 0:fa2de1b79154 307 }
Azure.IoT Build 0:fa2de1b79154 308 else
Azure.IoT Build 0:fa2de1b79154 309 {
Azure.IoT Build 0:fa2de1b79154 310 size_t pos = 0;
Azure.IoT Build 0:fa2de1b79154 311 /*Codes_SRS_STRING_02_012: [The string shall begin with the quote character.] */
Azure.IoT Build 0:fa2de1b79154 312 result->s[pos++] = '"';
Azure.IoT Build 0:fa2de1b79154 313 for (i = 0; i < vlen; i++)
Azure.IoT Build 0:fa2de1b79154 314 {
Azure.IoT Build 0:fa2de1b79154 315 if (source[i] <= 0x1F)
Azure.IoT Build 0:fa2de1b79154 316 {
Azure.IoT Build 0:fa2de1b79154 317 /*Codes_SRS_STRING_02_019: [If the character code is less than 0x20 then it shall be represented as \u00xx, where xx is the hex representation of the character code.]*/
Azure.IoT Build 0:fa2de1b79154 318 result->s[pos++] = '\\';
Azure.IoT Build 0:fa2de1b79154 319 result->s[pos++] = 'u';
Azure.IoT Build 0:fa2de1b79154 320 result->s[pos++] = '0';
Azure.IoT Build 0:fa2de1b79154 321 result->s[pos++] = '0';
Azure.IoT Build 0:fa2de1b79154 322 result->s[pos++] = hexToASCII[(source[i] & 0xF0) >> 4]; /*high nibble*/
Azure.IoT Build 0:fa2de1b79154 323 result->s[pos++] = hexToASCII[source[i] & 0x0F]; /*low nibble*/
Azure.IoT Build 0:fa2de1b79154 324 }
Azure.IoT Build 0:fa2de1b79154 325 else if (source[i] == '"')
Azure.IoT Build 0:fa2de1b79154 326 {
Azure.IoT Build 0:fa2de1b79154 327 /*Codes_SRS_STRING_02_016: [If the character is " (quote) then it shall be repsented as \".] */
Azure.IoT Build 0:fa2de1b79154 328 result->s[pos++] = '\\';
Azure.IoT Build 0:fa2de1b79154 329 result->s[pos++] = '"';
Azure.IoT Build 0:fa2de1b79154 330 }
Azure.IoT Build 0:fa2de1b79154 331 else if (source[i] == '\\')
Azure.IoT Build 0:fa2de1b79154 332 {
Azure.IoT Build 0:fa2de1b79154 333 /*Codes_SRS_STRING_02_017: [If the character is \ (backslash) then it shall represented as \\.] */
Azure.IoT Build 0:fa2de1b79154 334 result->s[pos++] = '\\';
Azure.IoT Build 0:fa2de1b79154 335 result->s[pos++] = '\\';
Azure.IoT Build 0:fa2de1b79154 336 }
Azure.IoT Build 0:fa2de1b79154 337 else if (source[i] == '/')
Azure.IoT Build 0:fa2de1b79154 338 {
Azure.IoT Build 0:fa2de1b79154 339 /*Codes_SRS_STRING_02_018: [If the character is / (slash) then it shall be represented as \/.] */
Azure.IoT Build 0:fa2de1b79154 340 result->s[pos++] = '\\';
Azure.IoT Build 0:fa2de1b79154 341 result->s[pos++] = '/';
Azure.IoT Build 0:fa2de1b79154 342 }
Azure.IoT Build 0:fa2de1b79154 343 else
Azure.IoT Build 0:fa2de1b79154 344 {
Azure.IoT Build 0:fa2de1b79154 345 /*Codes_SRS_STRING_02_013: [The string shall copy the characters of source "as they are" (until the '\0' character) with the following exceptions:] */
Azure.IoT Build 0:fa2de1b79154 346 result->s[pos++] = source[i];
Azure.IoT Build 0:fa2de1b79154 347 }
Azure.IoT Build 0:fa2de1b79154 348 }
Azure.IoT Build 0:fa2de1b79154 349 /*Codes_SRS_STRING_02_020: [The string shall end with " (quote).] */
Azure.IoT Build 0:fa2de1b79154 350 result->s[pos++] = '"';
Azure.IoT Build 0:fa2de1b79154 351 /*zero terminating it*/
Azure.IoT Build 0:fa2de1b79154 352 result->s[pos] = '\0';
Azure.IoT Build 0:fa2de1b79154 353 }
Azure.IoT Build 0:fa2de1b79154 354 }
Azure.IoT Build 0:fa2de1b79154 355
Azure.IoT Build 0:fa2de1b79154 356 }
Azure.IoT Build 0:fa2de1b79154 357 return (STRING_HANDLE)result;
Azure.IoT Build 0:fa2de1b79154 358 }
Azure.IoT Build 0:fa2de1b79154 359
Azure.IoT Build 0:fa2de1b79154 360 /*this function will concatenate to the string s1 the string s2, resulting in s1+s2*/
Azure.IoT Build 0:fa2de1b79154 361 /*returns 0 if success*/
Azure.IoT Build 0:fa2de1b79154 362 /*any other error code is failure*/
Azure.IoT Build 0:fa2de1b79154 363 /* Codes_SRS_STRING_07_012: [STRING_concat shall concatenate the given STRING_HANDLE and the const char* value and place the value in the handle.] */
Azure.IoT Build 0:fa2de1b79154 364 int STRING_concat(STRING_HANDLE handle, const char* s2)
Azure.IoT Build 0:fa2de1b79154 365 {
Azure.IoT Build 0:fa2de1b79154 366 int result;
Azure.IoT Build 0:fa2de1b79154 367 if ((handle == NULL) || (s2 == NULL))
Azure.IoT Build 0:fa2de1b79154 368 {
Azure.IoT Build 0:fa2de1b79154 369 /* Codes_SRS_STRING_07_013: [STRING_concat shall return a nonzero number if an error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 370 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 371 }
Azure.IoT Build 0:fa2de1b79154 372 else
Azure.IoT Build 0:fa2de1b79154 373 {
Azure.IoT Build 0:fa2de1b79154 374 STRING* s1 = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 375 size_t s1Length = strlen(s1->s);
Azure.IoT Build 0:fa2de1b79154 376 size_t s2Length = strlen(s2);
Azure.IoT Build 0:fa2de1b79154 377 char* temp = (char*)realloc(s1->s, s1Length + s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 378 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 379 {
Azure.IoT Build 0:fa2de1b79154 380 /* Codes_SRS_STRING_07_013: [STRING_concat shall return a nonzero number if an error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 381 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 382 }
Azure.IoT Build 0:fa2de1b79154 383 else
Azure.IoT Build 0:fa2de1b79154 384 {
Azure.IoT Build 0:fa2de1b79154 385 s1->s = temp;
AzureIoTClient 19:2e0811512ceb 386 (void)memcpy(s1->s + s1Length, s2, s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 387 result = 0;
Azure.IoT Build 0:fa2de1b79154 388 }
Azure.IoT Build 0:fa2de1b79154 389 }
Azure.IoT Build 0:fa2de1b79154 390 return result;
Azure.IoT Build 0:fa2de1b79154 391 }
Azure.IoT Build 0:fa2de1b79154 392
Azure.IoT Build 0:fa2de1b79154 393 /*this function will concatenate to the string s1 the string s2, resulting in s1+s2*/
Azure.IoT Build 0:fa2de1b79154 394 /*returns 0 if success*/
Azure.IoT Build 0:fa2de1b79154 395 /*any other error code is failure*/
Azure.IoT Build 0:fa2de1b79154 396 /* Codes_SRS_STRING_07_034: [String_Concat_with_STRING shall concatenate a given STRING_HANDLE variable with a source STRING_HANDLE.] */
Azure.IoT Build 0:fa2de1b79154 397 int STRING_concat_with_STRING(STRING_HANDLE s1, STRING_HANDLE s2)
Azure.IoT Build 0:fa2de1b79154 398 {
Azure.IoT Build 0:fa2de1b79154 399 int result;
Azure.IoT Build 0:fa2de1b79154 400 if ((s1 == NULL) || (s2 == NULL))
Azure.IoT Build 0:fa2de1b79154 401 {
Azure.IoT Build 0:fa2de1b79154 402 /* Codes_SRS_STRING_07_035: [String_Concat_with_STRING shall return a nonzero number if an error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 403 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 404 }
Azure.IoT Build 0:fa2de1b79154 405 else
Azure.IoT Build 0:fa2de1b79154 406 {
Azure.IoT Build 0:fa2de1b79154 407 STRING* dest = (STRING*)s1;
Azure.IoT Build 0:fa2de1b79154 408 STRING* src = (STRING*)s2;
Azure.IoT Build 0:fa2de1b79154 409
Azure.IoT Build 0:fa2de1b79154 410 size_t s1Length = strlen(dest->s);
Azure.IoT Build 0:fa2de1b79154 411 size_t s2Length = strlen(src->s);
Azure.IoT Build 0:fa2de1b79154 412 char* temp = (char*)realloc(dest->s, s1Length + s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 413 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 414 {
Azure.IoT Build 0:fa2de1b79154 415 /* Codes_SRS_STRING_07_035: [String_Concat_with_STRING shall return a nonzero number if an error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 416 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 417 }
Azure.IoT Build 0:fa2de1b79154 418 else
Azure.IoT Build 0:fa2de1b79154 419 {
Azure.IoT Build 0:fa2de1b79154 420 dest->s = temp;
Azure.IoT Build 0:fa2de1b79154 421 /* Codes_SRS_STRING_07_034: [String_Concat_with_STRING shall concatenate a given STRING_HANDLE variable with a source STRING_HANDLE.] */
AzureIoTClient 19:2e0811512ceb 422 (void)memcpy(dest->s + s1Length, src->s, s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 423 result = 0;
Azure.IoT Build 0:fa2de1b79154 424 }
Azure.IoT Build 0:fa2de1b79154 425 }
Azure.IoT Build 0:fa2de1b79154 426 return result;
Azure.IoT Build 0:fa2de1b79154 427 }
Azure.IoT Build 0:fa2de1b79154 428
Azure.IoT Build 0:fa2de1b79154 429 /*this function will copy the string from s2 to s1*/
Azure.IoT Build 0:fa2de1b79154 430 /*returns 0 if success*/
Azure.IoT Build 0:fa2de1b79154 431 /*any other error code is failure*/
Azure.IoT Build 0:fa2de1b79154 432 /* Codes_SRS_STRING_07_016: [STRING_copy shall copy the const char* into the supplied STRING_HANDLE.] */
Azure.IoT Build 0:fa2de1b79154 433 int STRING_copy(STRING_HANDLE handle, const char* s2)
Azure.IoT Build 0:fa2de1b79154 434 {
Azure.IoT Build 0:fa2de1b79154 435 int result;
Azure.IoT Build 0:fa2de1b79154 436 if ((handle == NULL) || (s2 == NULL))
Azure.IoT Build 0:fa2de1b79154 437 {
Azure.IoT Build 0:fa2de1b79154 438 /* Codes_SRS_STRING_07_017: [STRING_copy shall return a nonzero value if any of the supplied parameters are NULL.] */
AzureIoTClient 21:b92006c5b9ff 439 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 440 }
Azure.IoT Build 0:fa2de1b79154 441 else
Azure.IoT Build 0:fa2de1b79154 442 {
Azure.IoT Build 0:fa2de1b79154 443 STRING* s1 = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 444 /* Codes_SRS_STRING_07_026: [If the underlying char* refered to by s1 handle is equal to char* s2 than STRING_copy shall be a noop and return 0.] */
Azure.IoT Build 0:fa2de1b79154 445 if (s1->s != s2)
Azure.IoT Build 0:fa2de1b79154 446 {
Azure.IoT Build 0:fa2de1b79154 447 size_t s2Length = strlen(s2);
Azure.IoT Build 0:fa2de1b79154 448 char* temp = (char*)realloc(s1->s, s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 449 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 450 {
Azure.IoT Build 0:fa2de1b79154 451 /* Codes_SRS_STRING_07_027: [STRING_copy shall return a nonzero value if any error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 452 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 453 }
Azure.IoT Build 0:fa2de1b79154 454 else
Azure.IoT Build 0:fa2de1b79154 455 {
Azure.IoT Build 0:fa2de1b79154 456 s1->s = temp;
Azure.IoT Build 0:fa2de1b79154 457 memmove(s1->s, s2, s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 458 result = 0;
Azure.IoT Build 0:fa2de1b79154 459 }
Azure.IoT Build 0:fa2de1b79154 460 }
Azure.IoT Build 0:fa2de1b79154 461 else
Azure.IoT Build 0:fa2de1b79154 462 {
Azure.IoT Build 0:fa2de1b79154 463 /* Codes_SRS_STRING_07_033: [If overlapping pointer address is given to STRING_copy the behavior is undefined.] */
Azure.IoT Build 0:fa2de1b79154 464 result = 0;
Azure.IoT Build 0:fa2de1b79154 465 }
Azure.IoT Build 0:fa2de1b79154 466 }
Azure.IoT Build 0:fa2de1b79154 467 return result;
Azure.IoT Build 0:fa2de1b79154 468 }
Azure.IoT Build 0:fa2de1b79154 469
Azure.IoT Build 0:fa2de1b79154 470 /*this function will copy n chars from s2 to the string s1, resulting in n chars only from s2 being stored in s1.*/
Azure.IoT Build 0:fa2de1b79154 471 /*returns 0 if success*/
Azure.IoT Build 0:fa2de1b79154 472 /*any other error code is failure*/
Azure.IoT Build 0:fa2de1b79154 473 /* Codes_SRS_STRING_07_018: [STRING_copy_n shall copy the number of characters in const char* or the size_t whichever is lesser.] */
Azure.IoT Build 0:fa2de1b79154 474 int STRING_copy_n(STRING_HANDLE handle, const char* s2, size_t n)
Azure.IoT Build 0:fa2de1b79154 475 {
Azure.IoT Build 0:fa2de1b79154 476 int result;
Azure.IoT Build 0:fa2de1b79154 477 if ((handle == NULL) || (s2 == NULL))
Azure.IoT Build 0:fa2de1b79154 478 {
Azure.IoT Build 0:fa2de1b79154 479 /* Codes_SRS_STRING_07_019: [STRING_copy_n shall return a nonzero value if STRING_HANDLE or const char* is NULL.] */
AzureIoTClient 21:b92006c5b9ff 480 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 481 }
Azure.IoT Build 0:fa2de1b79154 482 else
Azure.IoT Build 0:fa2de1b79154 483 {
Azure.IoT Build 0:fa2de1b79154 484 STRING* s1 = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 485 size_t s2Length = strlen(s2);
Azure.IoT Build 0:fa2de1b79154 486 char* temp;
Azure.IoT Build 0:fa2de1b79154 487 if (s2Length > n)
Azure.IoT Build 0:fa2de1b79154 488 {
Azure.IoT Build 0:fa2de1b79154 489 s2Length = n;
Azure.IoT Build 0:fa2de1b79154 490 }
Azure.IoT Build 0:fa2de1b79154 491
Azure.IoT Build 0:fa2de1b79154 492 temp = (char*)realloc(s1->s, s2Length + 1);
Azure.IoT Build 0:fa2de1b79154 493 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 494 {
Azure.IoT Build 0:fa2de1b79154 495 /* Codes_SRS_STRING_07_028: [STRING_copy_n shall return a nonzero value if any error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 496 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 497 }
Azure.IoT Build 0:fa2de1b79154 498 else
Azure.IoT Build 0:fa2de1b79154 499 {
Azure.IoT Build 0:fa2de1b79154 500 s1->s = temp;
AzureIoTClient 19:2e0811512ceb 501 (void)memcpy(s1->s, s2, s2Length);
Azure.IoT Build 0:fa2de1b79154 502 s1->s[s2Length] = 0;
Azure.IoT Build 0:fa2de1b79154 503 result = 0;
Azure.IoT Build 0:fa2de1b79154 504 }
Azure.IoT Build 0:fa2de1b79154 505
Azure.IoT Build 0:fa2de1b79154 506 }
Azure.IoT Build 0:fa2de1b79154 507 return result;
Azure.IoT Build 0:fa2de1b79154 508 }
Azure.IoT Build 0:fa2de1b79154 509
AzureIoTClient 8:3db46d1e5471 510 int STRING_sprintf(STRING_HANDLE handle, const char* format, ...)
AzureIoTClient 8:3db46d1e5471 511 {
AzureIoTClient 8:3db46d1e5471 512 int result;
Azure.IoT.Build 16:18e7ebd42bb2 513
Azure.IoT.Build 16:18e7ebd42bb2 514 #ifdef ARDUINO_ARCH_ESP8266
Azure.IoT.Build 16:18e7ebd42bb2 515 size_t maxBufSize = 512;
Azure.IoT.Build 16:18e7ebd42bb2 516 char buf[512];
Azure.IoT.Build 16:18e7ebd42bb2 517 #else
Azure.IoT.Build 16:18e7ebd42bb2 518 size_t maxBufSize = 0;
Azure.IoT.Build 16:18e7ebd42bb2 519 char* buf = NULL;
Azure.IoT.Build 16:18e7ebd42bb2 520 #endif
Azure.IoT.Build 16:18e7ebd42bb2 521
AzureIoTClient 8:3db46d1e5471 522 if (handle == NULL || format == NULL)
AzureIoTClient 8:3db46d1e5471 523 {
AzureIoTClient 8:3db46d1e5471 524 /* Codes_SRS_STRING_07_042: [if the parameters s1 or format are NULL then STRING_sprintf shall return non zero value.] */
AzureIoTClient 8:3db46d1e5471 525 LogError("Invalid arg (NULL)");
AzureIoTClient 21:b92006c5b9ff 526 result = __FAILURE__;
AzureIoTClient 8:3db46d1e5471 527 }
AzureIoTClient 8:3db46d1e5471 528 else
AzureIoTClient 8:3db46d1e5471 529 {
AzureIoTClient 8:3db46d1e5471 530 va_list arg_list;
AzureIoTClient 9:079c39803432 531 int s2Length;
AzureIoTClient 8:3db46d1e5471 532 va_start(arg_list, format);
AzureIoTClient 8:3db46d1e5471 533
Azure.IoT.Build 16:18e7ebd42bb2 534 s2Length = vsnprintf(buf, maxBufSize, format, arg_list);
AzureIoTClient 8:3db46d1e5471 535 va_end(arg_list);
AzureIoTClient 8:3db46d1e5471 536 if (s2Length < 0)
AzureIoTClient 8:3db46d1e5471 537 {
AzureIoTClient 8:3db46d1e5471 538 /* Codes_SRS_STRING_07_043: [If any error is encountered STRING_sprintf shall return a non zero value.] */
AzureIoTClient 8:3db46d1e5471 539 LogError("Failure vsnprintf return < 0");
AzureIoTClient 21:b92006c5b9ff 540 result = __FAILURE__;
AzureIoTClient 8:3db46d1e5471 541 }
AzureIoTClient 8:3db46d1e5471 542 else if (s2Length == 0)
AzureIoTClient 8:3db46d1e5471 543 {
AzureIoTClient 8:3db46d1e5471 544 // Don't need to reallocate and nothing should be added
AzureIoTClient 8:3db46d1e5471 545 result = 0;
AzureIoTClient 8:3db46d1e5471 546 }
AzureIoTClient 8:3db46d1e5471 547 else
AzureIoTClient 8:3db46d1e5471 548 {
AzureIoTClient 8:3db46d1e5471 549 STRING* s1 = (STRING*)handle;
AzureIoTClient 9:079c39803432 550 char* temp;
AzureIoTClient 8:3db46d1e5471 551 size_t s1Length = strlen(s1->s);
AzureIoTClient 9:079c39803432 552 temp = (char*)realloc(s1->s, s1Length + s2Length + 1);
AzureIoTClient 8:3db46d1e5471 553 if (temp != NULL)
AzureIoTClient 8:3db46d1e5471 554 {
AzureIoTClient 8:3db46d1e5471 555 s1->s = temp;
AzureIoTClient 8:3db46d1e5471 556 va_start(arg_list, format);
AzureIoTClient 8:3db46d1e5471 557 if (vsnprintf(s1->s + s1Length, s1Length + s2Length + 1, format, arg_list) < 0)
AzureIoTClient 8:3db46d1e5471 558 {
AzureIoTClient 8:3db46d1e5471 559 /* Codes_SRS_STRING_07_043: [If any error is encountered STRING_sprintf shall return a non zero value.] */
AzureIoTClient 8:3db46d1e5471 560 LogError("Failure vsnprintf formatting error");
AzureIoTClient 8:3db46d1e5471 561 s1->s[s1Length] = '\0';
AzureIoTClient 21:b92006c5b9ff 562 result = __FAILURE__;
AzureIoTClient 8:3db46d1e5471 563 }
AzureIoTClient 8:3db46d1e5471 564 else
AzureIoTClient 8:3db46d1e5471 565 {
AzureIoTClient 8:3db46d1e5471 566 /* Codes_SRS_STRING_07_044: [On success STRING_sprintf shall return 0.]*/
AzureIoTClient 8:3db46d1e5471 567 result = 0;
AzureIoTClient 8:3db46d1e5471 568 }
AzureIoTClient 8:3db46d1e5471 569 va_end(arg_list);
AzureIoTClient 8:3db46d1e5471 570 }
AzureIoTClient 8:3db46d1e5471 571 else
AzureIoTClient 8:3db46d1e5471 572 {
AzureIoTClient 8:3db46d1e5471 573 /* Codes_SRS_STRING_07_043: [If any error is encountered STRING_sprintf shall return a non zero value.] */
AzureIoTClient 8:3db46d1e5471 574 LogError("Failure unable to reallocate memory");
AzureIoTClient 21:b92006c5b9ff 575 result = __FAILURE__;
AzureIoTClient 8:3db46d1e5471 576 }
AzureIoTClient 8:3db46d1e5471 577 }
AzureIoTClient 8:3db46d1e5471 578 }
AzureIoTClient 8:3db46d1e5471 579 return result;
AzureIoTClient 8:3db46d1e5471 580 }
AzureIoTClient 8:3db46d1e5471 581
Azure.IoT Build 0:fa2de1b79154 582 /*this function will quote the string passed as argument string =>"string"*/
Azure.IoT Build 0:fa2de1b79154 583 /*returns 0 if success*/ /*doesn't change the string otherwise*/
Azure.IoT Build 0:fa2de1b79154 584 /*any other error code is failure*/
Azure.IoT Build 0:fa2de1b79154 585 /* Codes_SRS_STRING_07_014: [STRING_quote shall "quote" the supplied STRING_HANDLE and return 0 on success.] */
Azure.IoT Build 0:fa2de1b79154 586 int STRING_quote(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 587 {
Azure.IoT Build 0:fa2de1b79154 588 int result;
Azure.IoT Build 0:fa2de1b79154 589 if (handle == NULL)
Azure.IoT Build 0:fa2de1b79154 590 {
Azure.IoT Build 0:fa2de1b79154 591 /* Codes_SRS_STRING_07_015: [STRING_quote shall return a nonzero value if any of the supplied parameters are NULL.] */
AzureIoTClient 21:b92006c5b9ff 592 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 593 }
Azure.IoT Build 0:fa2de1b79154 594 else
Azure.IoT Build 0:fa2de1b79154 595 {
Azure.IoT Build 0:fa2de1b79154 596 STRING* s1 = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 597 size_t s1Length = strlen(s1->s);
Azure.IoT Build 0:fa2de1b79154 598 char* temp = (char*)realloc(s1->s, s1Length + 2 + 1);/*2 because 2 quotes, 1 because '\0'*/
Azure.IoT Build 0:fa2de1b79154 599 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 600 {
Azure.IoT Build 0:fa2de1b79154 601 /* Codes_SRS_STRING_07_029: [STRING_quote shall return a nonzero value if any error is encountered.] */
AzureIoTClient 21:b92006c5b9ff 602 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 603 }
Azure.IoT Build 0:fa2de1b79154 604 else
Azure.IoT Build 0:fa2de1b79154 605 {
Azure.IoT Build 0:fa2de1b79154 606 s1->s = temp;
Azure.IoT Build 0:fa2de1b79154 607 memmove(s1->s + 1, s1->s, s1Length);
Azure.IoT Build 0:fa2de1b79154 608 s1->s[0] = '"';
Azure.IoT Build 0:fa2de1b79154 609 s1->s[s1Length + 1] = '"';
Azure.IoT Build 0:fa2de1b79154 610 s1->s[s1Length + 2] = '\0';
Azure.IoT Build 0:fa2de1b79154 611 result = 0;
Azure.IoT Build 0:fa2de1b79154 612 }
Azure.IoT Build 0:fa2de1b79154 613 }
Azure.IoT Build 0:fa2de1b79154 614 return result;
Azure.IoT Build 0:fa2de1b79154 615 }
Azure.IoT Build 0:fa2de1b79154 616 /*this function will revert a string to an empty state*/
Azure.IoT Build 0:fa2de1b79154 617 /*Returns 0 if the revert was succesful*/
Azure.IoT Build 0:fa2de1b79154 618 /* Codes_SRS_STRING_07_022: [STRING_empty shall revert the STRING_HANDLE to an empty state.] */
Azure.IoT Build 0:fa2de1b79154 619 int STRING_empty(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 620 {
Azure.IoT Build 0:fa2de1b79154 621 int result;
Azure.IoT Build 0:fa2de1b79154 622 if (handle == NULL)
Azure.IoT Build 0:fa2de1b79154 623 {
Azure.IoT Build 0:fa2de1b79154 624 /* Codes_SRS_STRING_07_023: [STRING_empty shall return a nonzero value if the STRING_HANDLE is NULL.] */
AzureIoTClient 21:b92006c5b9ff 625 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 626 }
Azure.IoT Build 0:fa2de1b79154 627 else
Azure.IoT Build 0:fa2de1b79154 628 {
Azure.IoT Build 0:fa2de1b79154 629 STRING* s1 = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 630 char* temp = (char*)realloc(s1->s, 1);
Azure.IoT Build 0:fa2de1b79154 631 if (temp == NULL)
Azure.IoT Build 0:fa2de1b79154 632 {
Azure.IoT Build 0:fa2de1b79154 633 /* Codes_SRS_STRING_07_030: [STRING_empty shall return a nonzero value if the STRING_HANDLE is NULL.] */
AzureIoTClient 21:b92006c5b9ff 634 result = __FAILURE__;
Azure.IoT Build 0:fa2de1b79154 635 }
Azure.IoT Build 0:fa2de1b79154 636 else
Azure.IoT Build 0:fa2de1b79154 637 {
Azure.IoT Build 0:fa2de1b79154 638 s1->s = temp;
Azure.IoT Build 0:fa2de1b79154 639 s1->s[0] = '\0';
Azure.IoT Build 0:fa2de1b79154 640 result = 0;
Azure.IoT Build 0:fa2de1b79154 641 }
Azure.IoT Build 0:fa2de1b79154 642 }
Azure.IoT Build 0:fa2de1b79154 643 return result;
Azure.IoT Build 0:fa2de1b79154 644 }
Azure.IoT Build 0:fa2de1b79154 645
Azure.IoT Build 0:fa2de1b79154 646 /*this function will deallocate a string constructed by str_new*/
Azure.IoT Build 0:fa2de1b79154 647 /* Codes_SRS_STRING_07_010: [STRING_delete will free the memory allocated by the STRING_HANDLE.] */
Azure.IoT Build 0:fa2de1b79154 648 void STRING_delete(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 649 {
Azure.IoT Build 0:fa2de1b79154 650 /* Codes_SRS_STRING_07_011: [STRING_delete will not attempt to free anything with a NULL STRING_HANDLE.] */
Azure.IoT Build 0:fa2de1b79154 651 if (handle != NULL)
Azure.IoT Build 0:fa2de1b79154 652 {
Azure.IoT Build 0:fa2de1b79154 653 STRING* value = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 654 free(value->s);
Azure.IoT Build 0:fa2de1b79154 655 value->s = NULL;
Azure.IoT Build 0:fa2de1b79154 656 free(value);
Azure.IoT Build 0:fa2de1b79154 657 }
Azure.IoT Build 0:fa2de1b79154 658 }
Azure.IoT Build 0:fa2de1b79154 659
Azure.IoT Build 0:fa2de1b79154 660 /* Codes_SRS_STRING_07_020: [STRING_c_str shall return the const char* associated with the given STRING_HANDLE.] */
Azure.IoT Build 0:fa2de1b79154 661 const char* STRING_c_str(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 662 {
Azure.IoT Build 0:fa2de1b79154 663 const char* result;
Azure.IoT Build 0:fa2de1b79154 664 if (handle != NULL)
Azure.IoT Build 0:fa2de1b79154 665 {
Azure.IoT Build 0:fa2de1b79154 666 result = ((STRING*)handle)->s;
Azure.IoT Build 0:fa2de1b79154 667 }
Azure.IoT Build 0:fa2de1b79154 668 else
Azure.IoT Build 0:fa2de1b79154 669 {
Azure.IoT Build 0:fa2de1b79154 670 /* Codes_SRS_STRING_07_021: [STRING_c_str shall return NULL if the STRING_HANDLE is NULL.] */
Azure.IoT Build 0:fa2de1b79154 671 result = NULL;
Azure.IoT Build 0:fa2de1b79154 672 }
Azure.IoT Build 0:fa2de1b79154 673 return result;
Azure.IoT Build 0:fa2de1b79154 674 }
Azure.IoT Build 0:fa2de1b79154 675
Azure.IoT Build 0:fa2de1b79154 676 /* Codes_SRS_STRING_07_024: [STRING_length shall return the length of the underlying char* for the given handle] */
Azure.IoT Build 0:fa2de1b79154 677 size_t STRING_length(STRING_HANDLE handle)
Azure.IoT Build 0:fa2de1b79154 678 {
Azure.IoT Build 0:fa2de1b79154 679 size_t result = 0;
Azure.IoT Build 0:fa2de1b79154 680 /* Codes_SRS_STRING_07_025: [STRING_length shall return zero if the given handle is NULL.] */
Azure.IoT Build 0:fa2de1b79154 681 if (handle != NULL)
Azure.IoT Build 0:fa2de1b79154 682 {
Azure.IoT Build 0:fa2de1b79154 683 STRING* value = (STRING*)handle;
Azure.IoT Build 0:fa2de1b79154 684 result = strlen(value->s);
Azure.IoT Build 0:fa2de1b79154 685 }
Azure.IoT Build 0:fa2de1b79154 686 return result;
Azure.IoT Build 0:fa2de1b79154 687 }
Azure.IoT Build 0:fa2de1b79154 688
Azure.IoT Build 0:fa2de1b79154 689 /*Codes_SRS_STRING_02_007: [STRING_construct_n shall construct a STRING_HANDLE from first "n" characters of the string pointed to by psz parameter.]*/
Azure.IoT Build 0:fa2de1b79154 690 STRING_HANDLE STRING_construct_n(const char* psz, size_t n)
Azure.IoT Build 0:fa2de1b79154 691 {
Azure.IoT Build 0:fa2de1b79154 692 STRING_HANDLE result;
Azure.IoT Build 0:fa2de1b79154 693 /*Codes_SRS_STRING_02_008: [If psz is NULL then STRING_construct_n shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 694 if (psz == NULL)
Azure.IoT Build 0:fa2de1b79154 695 {
Azure.IoT Build 0:fa2de1b79154 696 result = NULL;
AzureIoTClient 1:9190c0f4d23a 697 LogError("invalid arg (NULL)");
Azure.IoT Build 0:fa2de1b79154 698 }
Azure.IoT Build 0:fa2de1b79154 699 else
Azure.IoT Build 0:fa2de1b79154 700 {
Azure.IoT Build 0:fa2de1b79154 701 size_t len = strlen(psz);
Azure.IoT Build 0:fa2de1b79154 702 /*Codes_SRS_STRING_02_009: [If n is bigger than the size of the string psz, then STRING_construct_n shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 703 if (n > len)
Azure.IoT Build 0:fa2de1b79154 704 {
Azure.IoT Build 0:fa2de1b79154 705 result = NULL;
AzureIoTClient 1:9190c0f4d23a 706 LogError("invalig arg (n is bigger than the size of the string)");
Azure.IoT Build 0:fa2de1b79154 707 }
Azure.IoT Build 0:fa2de1b79154 708 else
Azure.IoT Build 0:fa2de1b79154 709 {
Azure.IoT Build 0:fa2de1b79154 710 STRING* str;
Azure.IoT Build 0:fa2de1b79154 711 if ((str = (STRING*)malloc(sizeof(STRING))) != NULL)
Azure.IoT Build 0:fa2de1b79154 712 {
Azure.IoT Build 0:fa2de1b79154 713 if ((str->s = (char*)malloc(len + 1)) != NULL)
Azure.IoT Build 0:fa2de1b79154 714 {
AzureIoTClient 19:2e0811512ceb 715 (void)memcpy(str->s, psz, n);
Azure.IoT Build 0:fa2de1b79154 716 str->s[n] = '\0';
Azure.IoT Build 0:fa2de1b79154 717 result = (STRING_HANDLE)str;
Azure.IoT Build 0:fa2de1b79154 718 }
Azure.IoT Build 0:fa2de1b79154 719 /* Codes_SRS_STRING_02_010: [In all other error cases, STRING_construct_n shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 720 else
Azure.IoT Build 0:fa2de1b79154 721 {
Azure.IoT Build 0:fa2de1b79154 722 free(str);
Azure.IoT Build 0:fa2de1b79154 723 result = NULL;
Azure.IoT Build 0:fa2de1b79154 724 }
Azure.IoT Build 0:fa2de1b79154 725 }
Azure.IoT Build 0:fa2de1b79154 726 else
Azure.IoT Build 0:fa2de1b79154 727 {
Azure.IoT Build 0:fa2de1b79154 728 /* Codes_SRS_STRING_02_010: [In all other error cases, STRING_construct_n shall return NULL.] */
Azure.IoT Build 0:fa2de1b79154 729 result = NULL;
Azure.IoT Build 0:fa2de1b79154 730 }
Azure.IoT Build 0:fa2de1b79154 731 }
Azure.IoT Build 0:fa2de1b79154 732 }
Azure.IoT Build 0:fa2de1b79154 733 return result;
Azure.IoT Build 0:fa2de1b79154 734 }
Azure.IoT Build 0:fa2de1b79154 735
Azure.IoT Build 0:fa2de1b79154 736 /* Codes_SRS_STRING_07_034: [STRING_compare returns an integer greater than, equal to, or less than zero, accordingly as the string pointed to by s1 is greater than, equal to, or less than the string s2.] */
Azure.IoT Build 0:fa2de1b79154 737 int STRING_compare(STRING_HANDLE s1, STRING_HANDLE s2)
Azure.IoT Build 0:fa2de1b79154 738 {
Azure.IoT Build 0:fa2de1b79154 739 int result;
Azure.IoT Build 0:fa2de1b79154 740 if (s1 == NULL && s2 == NULL)
Azure.IoT Build 0:fa2de1b79154 741 {
Azure.IoT Build 0:fa2de1b79154 742 /* Codes_SRS_STRING_07_035: [If h1 and h2 are both NULL then STRING_compare shall return 0.]*/
Azure.IoT Build 0:fa2de1b79154 743 result = 0;
Azure.IoT Build 0:fa2de1b79154 744 }
Azure.IoT Build 0:fa2de1b79154 745 else if (s1 == NULL)
Azure.IoT Build 0:fa2de1b79154 746 {
Azure.IoT Build 0:fa2de1b79154 747 /* Codes_SRS_STRING_07_036: [If h1 is NULL and h2 is nonNULL then STRING_compare shall return 1.]*/
Azure.IoT Build 0:fa2de1b79154 748 result = 1;
Azure.IoT Build 0:fa2de1b79154 749 }
Azure.IoT Build 0:fa2de1b79154 750 else if (s2 == NULL)
Azure.IoT Build 0:fa2de1b79154 751 {
Azure.IoT Build 0:fa2de1b79154 752 /* Codes_SRS_STRING_07_037: [If h2 is NULL and h1 is nonNULL then STRING_compare shall return -1.] */
Azure.IoT Build 0:fa2de1b79154 753 result = -1;
Azure.IoT Build 0:fa2de1b79154 754 }
Azure.IoT Build 0:fa2de1b79154 755 else
Azure.IoT Build 0:fa2de1b79154 756 {
Azure.IoT Build 0:fa2de1b79154 757 /* Codes_SRS_STRING_07_038: [STRING_compare shall compare the char s variable using the strcmp function.] */
Azure.IoT Build 0:fa2de1b79154 758 STRING* value1 = (STRING*)s1;
Azure.IoT Build 0:fa2de1b79154 759 STRING* value2 = (STRING*)s2;
Azure.IoT Build 0:fa2de1b79154 760 result = strcmp(value1->s, value2->s);
Azure.IoT Build 0:fa2de1b79154 761 }
Azure.IoT Build 0:fa2de1b79154 762 return result;
Azure.IoT Build 0:fa2de1b79154 763 }
AzureIoTClient 4:2bd2074fe6c4 764
AzureIoTClient 4:2bd2074fe6c4 765 STRING_HANDLE STRING_from_byte_array(const unsigned char* source, size_t size)
AzureIoTClient 4:2bd2074fe6c4 766 {
AzureIoTClient 4:2bd2074fe6c4 767 STRING* result;
AzureIoTClient 4:2bd2074fe6c4 768 /*Codes_SRS_STRING_02_022: [ If source is NULL and size > 0 then STRING_from_BUFFER shall fail and return NULL. ]*/
AzureIoTClient 4:2bd2074fe6c4 769 if ((source == NULL) && (size > 0))
AzureIoTClient 4:2bd2074fe6c4 770 {
AzureIoTClient 4:2bd2074fe6c4 771 LogError("invalid parameter (NULL)");
AzureIoTClient 4:2bd2074fe6c4 772 result = NULL;
AzureIoTClient 4:2bd2074fe6c4 773 }
AzureIoTClient 4:2bd2074fe6c4 774 else
AzureIoTClient 4:2bd2074fe6c4 775 {
AzureIoTClient 4:2bd2074fe6c4 776 /*Codes_SRS_STRING_02_023: [ Otherwise, STRING_from_BUFFER shall build a string that has the same content (byte-by-byte) as source and return a non-NULL handle. ]*/
AzureIoTClient 4:2bd2074fe6c4 777 result = (STRING*)malloc(sizeof(STRING));
AzureIoTClient 4:2bd2074fe6c4 778 if (result == NULL)
AzureIoTClient 4:2bd2074fe6c4 779 {
AzureIoTClient 4:2bd2074fe6c4 780 /*Codes_SRS_STRING_02_024: [ If building the string fails, then STRING_from_BUFFER shall fail and return NULL. ]*/
AzureIoTClient 4:2bd2074fe6c4 781 LogError("oom - unable to malloc");
AzureIoTClient 4:2bd2074fe6c4 782 /*return as is*/
AzureIoTClient 4:2bd2074fe6c4 783 }
AzureIoTClient 4:2bd2074fe6c4 784 else
AzureIoTClient 4:2bd2074fe6c4 785 {
AzureIoTClient 4:2bd2074fe6c4 786 /*Codes_SRS_STRING_02_023: [ Otherwise, STRING_from_BUFFER shall build a string that has the same content (byte-by-byte) as source and return a non-NULL handle. ]*/
AzureIoTClient 4:2bd2074fe6c4 787 result->s = (char*)malloc(size + 1);
AzureIoTClient 4:2bd2074fe6c4 788 if (result->s == NULL)
AzureIoTClient 4:2bd2074fe6c4 789 {
AzureIoTClient 4:2bd2074fe6c4 790 /*Codes_SRS_STRING_02_024: [ If building the string fails, then STRING_from_BUFFER shall fail and return NULL. ]*/
AzureIoTClient 4:2bd2074fe6c4 791 LogError("oom - unable to malloc");
AzureIoTClient 4:2bd2074fe6c4 792 free(result);
AzureIoTClient 4:2bd2074fe6c4 793 result = NULL;
AzureIoTClient 4:2bd2074fe6c4 794 }
AzureIoTClient 4:2bd2074fe6c4 795 else
AzureIoTClient 4:2bd2074fe6c4 796 {
AzureIoTClient 19:2e0811512ceb 797 (void)memcpy(result->s, source, size);
AzureIoTClient 4:2bd2074fe6c4 798 result->s[size] = '\0'; /*all is fine*/
AzureIoTClient 4:2bd2074fe6c4 799 }
AzureIoTClient 4:2bd2074fe6c4 800 }
AzureIoTClient 4:2bd2074fe6c4 801 }
AzureIoTClient 4:2bd2074fe6c4 802 return (STRING_HANDLE)result;
AzureIoTClient 4:2bd2074fe6c4 803 }