Nigel Rantor / azure_c_shared_utility

Azure IoT common library

Fork of azure_c_shared_utility by Azure IoT

strings.c@8:3db46d1e5471, 2016-08-12 (annotated)

Committer:
AzureIoTClient
Date:
Fri Aug 12 10:04:46 2016 -0700
Revision:
8:3db46d1e5471
Parent:
6:c55b013dfc2a
Child:
9:079c39803432
1.0.10

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