[87005] | 1 | /* $Id: http.cpp 102562 2023-12-11 08:32:42Z vboxsync $ */
|
---|
| 2 | /** @file
|
---|
| 3 | * IPRT - HTTP common API.
|
---|
| 4 | */
|
---|
| 5 |
|
---|
| 6 | /*
|
---|
[98103] | 7 | * Copyright (C) 2012-2023 Oracle and/or its affiliates.
|
---|
[87005] | 8 | *
|
---|
[96407] | 9 | * This file is part of VirtualBox base platform packages, as
|
---|
| 10 | * available from https://www.virtualbox.org.
|
---|
[87005] | 11 | *
|
---|
[96407] | 12 | * This program is free software; you can redistribute it and/or
|
---|
| 13 | * modify it under the terms of the GNU General Public License
|
---|
| 14 | * as published by the Free Software Foundation, in version 3 of the
|
---|
| 15 | * License.
|
---|
| 16 | *
|
---|
| 17 | * This program is distributed in the hope that it will be useful, but
|
---|
| 18 | * WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
| 19 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
---|
| 20 | * General Public License for more details.
|
---|
| 21 | *
|
---|
| 22 | * You should have received a copy of the GNU General Public License
|
---|
| 23 | * along with this program; if not, see <https://www.gnu.org/licenses>.
|
---|
| 24 | *
|
---|
[87005] | 25 | * The contents of this file may alternatively be used under the terms
|
---|
| 26 | * of the Common Development and Distribution License Version 1.0
|
---|
[96407] | 27 | * (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
|
---|
| 28 | * in the VirtualBox distribution, in which case the provisions of the
|
---|
[87005] | 29 | * CDDL are applicable instead of those of the GPL.
|
---|
| 30 | *
|
---|
| 31 | * You may elect to license modified versions of this file under the
|
---|
| 32 | * terms and conditions of either the GPL or the CDDL or both.
|
---|
[96407] | 33 | *
|
---|
| 34 | * SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
|
---|
[87005] | 35 | */
|
---|
| 36 |
|
---|
| 37 |
|
---|
| 38 | /*********************************************************************************************************************************
|
---|
| 39 | * Header Files *
|
---|
| 40 | *********************************************************************************************************************************/
|
---|
| 41 | #define LOG_GROUP RTLOGGROUP_HTTP
|
---|
| 42 | #include <iprt/http-common.h>
|
---|
| 43 | #include "internal/iprt.h"
|
---|
| 44 |
|
---|
| 45 | #include <iprt/asm.h>
|
---|
| 46 | #include <iprt/assert.h>
|
---|
| 47 | #include <iprt/ctype.h>
|
---|
| 48 | #include <iprt/log.h>
|
---|
| 49 | #include <iprt/mem.h>
|
---|
| 50 | #include <iprt/string.h>
|
---|
| 51 |
|
---|
| 52 | #include "internal/magics.h"
|
---|
| 53 |
|
---|
| 54 |
|
---|
| 55 | /*********************************************************************************************************************************
|
---|
| 56 | * Defined Constants And Macros *
|
---|
| 57 | *********************************************************************************************************************************/
|
---|
| 58 | /** Validates a handle and returns VERR_INVALID_HANDLE if not valid. */
|
---|
| 59 | #define RTHTTPHEADERLIST_VALID_RETURN_RC(hList, a_rc) \
|
---|
| 60 | do { \
|
---|
| 61 | AssertPtrReturn((hList), (a_rc)); \
|
---|
| 62 | AssertReturn((hList)->u32Magic == RTHTTPHEADERLIST_MAGIC, (a_rc)); \
|
---|
| 63 | } while (0)
|
---|
| 64 |
|
---|
| 65 | /** Validates a handle and returns VERR_INVALID_HANDLE if not valid. */
|
---|
| 66 | #define RTHTTPHEADERLIST_VALID_RETURN(hList) RTHTTPHEADERLIST_VALID_RETURN_RC((hList), VERR_INVALID_HANDLE)
|
---|
| 67 |
|
---|
| 68 | /** Validates a handle and returns (void) if not valid. */
|
---|
| 69 | #define RTHTTPHEADERLIST_VALID_RETURN_VOID(hList) \
|
---|
| 70 | do { \
|
---|
| 71 | AssertPtrReturnVoid(hList); \
|
---|
| 72 | AssertReturnVoid((hList)->u32Magic == RTHTTPHEADERLIST_MAGIC); \
|
---|
| 73 | } while (0)
|
---|
| 74 |
|
---|
| 75 |
|
---|
| 76 | /*********************************************************************************************************************************
|
---|
| 77 | * Internal structs. *
|
---|
| 78 | *********************************************************************************************************************************/
|
---|
| 79 | /**
|
---|
| 80 | * HTTP header list, internal definition.
|
---|
| 81 | */
|
---|
| 82 | typedef struct RTHTTPHEADERLISTINTERNAL
|
---|
| 83 | {
|
---|
| 84 | /** The list node. */
|
---|
| 85 | RTLISTANCHOR List;
|
---|
| 86 | /** Magic value. */
|
---|
| 87 | uint32_t u32Magic;
|
---|
| 88 | } RTHTTPHEADERLISTINTERNAL;
|
---|
| 89 | /** Pointer to an internal HTTP header list. */
|
---|
| 90 | typedef RTHTTPHEADERLISTINTERNAL *PRTHTTPHEADERLISTINTERNAL;
|
---|
| 91 |
|
---|
| 92 |
|
---|
| 93 | /*********************************************************************************************************************************
|
---|
| 94 | * Prototypes. *
|
---|
| 95 | *********************************************************************************************************************************/
|
---|
| 96 | static void rtHttpHeaderListRemoveAll(PRTHTTPHEADERLISTINTERNAL pThis);
|
---|
| 97 |
|
---|
| 98 |
|
---|
| 99 | /*********************************************************************************************************************************
|
---|
| 100 | * Lookup / conversion functions *
|
---|
| 101 | *********************************************************************************************************************************/
|
---|
| 102 |
|
---|
| 103 | RTR3DECL(const char *) RTHttpMethodToStr(RTHTTPMETHOD enmMethod)
|
---|
| 104 | {
|
---|
| 105 | switch (enmMethod)
|
---|
| 106 | {
|
---|
| 107 | case RTHTTPMETHOD_INVALID: return "invalid";
|
---|
| 108 | case RTHTTPMETHOD_GET: return "GET";
|
---|
| 109 | case RTHTTPMETHOD_PUT: return "PUT";
|
---|
| 110 | case RTHTTPMETHOD_POST: return "POST";
|
---|
| 111 | case RTHTTPMETHOD_PATCH: return "PATCH";
|
---|
| 112 | case RTHTTPMETHOD_DELETE: return "DELETE";
|
---|
| 113 | case RTHTTPMETHOD_HEAD: return "HEAD";
|
---|
| 114 | case RTHTTPMETHOD_OPTIONS: return "OPTIONS";
|
---|
| 115 | case RTHTTPMETHOD_TRACE: return "TRACE";
|
---|
[87037] | 116 | #ifdef IPRT_HTTP_WITH_WEBDAV
|
---|
[87032] | 117 | case RTHTTPMETHOD_PROPFIND: return "PROPFIND";
|
---|
| 118 | #endif
|
---|
[87005] | 119 | case RTHTTPMETHOD_END:
|
---|
| 120 | RT_FALL_THROUGH();
|
---|
| 121 | case RTHTTPMETHOD_32BIT_HACK:
|
---|
| 122 | break;
|
---|
| 123 | }
|
---|
| 124 | return "unknown";
|
---|
| 125 | }
|
---|
| 126 |
|
---|
| 127 | RTR3DECL(const char *) RTHttpStatusToStr(RTHTTPSTATUS enmSts)
|
---|
| 128 | {
|
---|
[87010] | 129 | switch (enmSts)
|
---|
| 130 | {
|
---|
[87005] | 131 | case RTHTTPSTATUS_OK : return "OK";
|
---|
| 132 | case RTHTTPSTATUS_CREATED : return "Created";
|
---|
| 133 | case RTHTTPSTATUS_ACCEPTED : return "Accepted";
|
---|
| 134 | case RTHTTPSTATUS_NONAUTHORITATIVEINFORMATION : return "Non-Authoritative Information";
|
---|
| 135 | case RTHTTPSTATUS_NOCONTENT : return "No Content";
|
---|
| 136 | case RTHTTPSTATUS_RESETCONTENT : return "Reset Content";
|
---|
| 137 | case RTHTTPSTATUS_PARTIALCONTENT : return "Partial Content";
|
---|
| 138 | case RTHTTPSTATUS_MULTISTATUS : return "Multi-Status";
|
---|
| 139 | case RTHTTPSTATUS_ALREADYREPORTED : return "Already Reported";
|
---|
| 140 | case RTHTTPSTATUS_IMUSED : return "IM Used";
|
---|
| 141 |
|
---|
[87010] | 142 | case RTHTTPSTATUS_BADREQUEST : return "Bad Request";
|
---|
| 143 | case RTHTTPSTATUS_UNAUTHORIZED : return "Unauthorized";
|
---|
| 144 | case RTHTTPSTATUS_PAYMENTREQUIRED : return "Payment Required";
|
---|
| 145 | case RTHTTPSTATUS_FORBIDDEN : return "Forbidden";
|
---|
| 146 | case RTHTTPSTATUS_NOTFOUND : return "Not Found";
|
---|
| 147 | case RTHTTPSTATUS_METHODNOTALLOWED : return "Method Not Allowed";
|
---|
| 148 | case RTHTTPSTATUS_NOTACCEPTABLE : return "Not Acceptable";
|
---|
| 149 | case RTHTTPSTATUS_PROXYAUTHENTICATIONREQUIRED : return "Proxy Authentication Required";
|
---|
| 150 | case RTHTTPSTATUS_REQUESTTIMEOUT : return "Request Timeout";
|
---|
| 151 | case RTHTTPSTATUS_CONFLICT : return "Conflict";
|
---|
| 152 | case RTHTTPSTATUS_GONE : return "Gone";
|
---|
| 153 | case RTHTTPSTATUS_LENGTHREQUIRED : return "Length Required";
|
---|
| 154 | case RTHTTPSTATUS_PRECONDITIONFAILED : return "Precondition Failed";
|
---|
| 155 | case RTHTTPSTATUS_PAYLOADTOOLARGE : return "Payload Too Large";
|
---|
| 156 | case RTHTTPSTATUS_URITOOLONG : return "URI Too Long";
|
---|
| 157 | case RTHTTPSTATUS_UNSUPPORTEDMEDIATYPE : return "Unsupported Media Type";
|
---|
| 158 | case RTHTTPSTATUS_RANGENOTSATISFIABLE : return "Range Not Satisfiable";
|
---|
| 159 | case RTHTTPSTATUS_EXPECTATIONFAILED : return "Expectation Failed";
|
---|
| 160 | case RTHTTPSTATUS_IMATEAPOT : return "I'm a teapot";
|
---|
| 161 | case RTHTTPSTATUS_UNPROCESSABLEENTITY : return "Unprocessable Entity";
|
---|
| 162 | case RTHTTPSTATUS_LOCKED : return "Locked";
|
---|
| 163 | case RTHTTPSTATUS_FAILEDDEPENDENCY : return "Failed Dependency";
|
---|
| 164 | case RTHTTPSTATUS_UPGRADEREQUIRED : return "Upgrade Required";
|
---|
| 165 | case RTHTTPSTATUS_PRECONDITIONREQUIRED : return "Precondition Required";
|
---|
| 166 | case RTHTTPSTATUS_TOOMANYREQUESTS : return "Too Many Requests";
|
---|
| 167 | case RTHTTPSTATUS_REQUESTHEADERFIELDSTOOLARGE : return "Request Header Fields Too Large";
|
---|
| 168 | case RTHTTPSTATUS_UNAVAILABLEFORLEGALREASONS : return "Unavailable For Legal Reasons";
|
---|
[87005] | 169 |
|
---|
[87010] | 170 | case RTHTTPSTATUS_INTERNALSERVERERROR : return "Internal Server Error";
|
---|
| 171 | case RTHTTPSTATUS_NOTIMPLEMENTED : return "Not Implemented";
|
---|
| 172 | case RTHTTPSTATUS_BADGATEWAY : return "Bad Gateway";
|
---|
| 173 | case RTHTTPSTATUS_SERVICEUNAVAILABLE : return "Service Unavailable";
|
---|
| 174 | case RTHTTPSTATUS_GATEWAYTIMEOUT : return "Gateway Time-out";
|
---|
| 175 | case RTHTTPSTATUS_HTTPVERSIONNOTSUPPORTED : return "HTTP Version Not Supported";
|
---|
| 176 | case RTHTTPSTATUS_VARIANTALSONEGOTIATES : return "Variant Also Negotiates";
|
---|
| 177 | case RTHTTPSTATUS_INSUFFICIENTSTORAGE : return "Insufficient Storage";
|
---|
| 178 | case RTHTTPSTATUS_LOOPDETECTED : return "Loop Detected";
|
---|
| 179 | case RTHTTPSTATUS_NOTEXTENDED : return "Not Extended";
|
---|
| 180 | case RTHTTPSTATUS_NETWORKAUTHENTICATIONREQUIRED: return "Network Authentication Required";
|
---|
[87005] | 181 |
|
---|
[87010] | 182 | default: break;
|
---|
| 183 | }
|
---|
[87005] | 184 |
|
---|
| 185 | AssertFailed();
|
---|
| 186 | return "<Not implemented>";
|
---|
| 187 | }
|
---|
| 188 |
|
---|
| 189 |
|
---|
| 190 | /*********************************************************************************************************************************
|
---|
| 191 | * HTTP Header List *
|
---|
| 192 | *********************************************************************************************************************************/
|
---|
| 193 |
|
---|
| 194 | RTR3DECL(int) RTHttpHeaderListInit(PRTHTTPHEADERLIST hHdrLst)
|
---|
| 195 | {
|
---|
| 196 | PRTHTTPHEADERLISTINTERNAL pThis = (PRTHTTPHEADERLISTINTERNAL)RTMemAllocZ(sizeof(RTHTTPHEADERLISTINTERNAL));
|
---|
| 197 | if (pThis)
|
---|
| 198 | {
|
---|
| 199 | pThis->u32Magic = RTHTTPHEADERLIST_MAGIC;
|
---|
| 200 |
|
---|
| 201 | RTListInit(&pThis->List);
|
---|
| 202 |
|
---|
| 203 | *hHdrLst = (RTHTTPHEADERLIST)pThis;
|
---|
| 204 |
|
---|
| 205 | return VINF_SUCCESS;
|
---|
| 206 | }
|
---|
| 207 |
|
---|
| 208 | return VERR_NO_MEMORY;
|
---|
| 209 | }
|
---|
| 210 |
|
---|
| 211 |
|
---|
| 212 | RTR3DECL(void) RTHttpHeaderListDestroy(RTHTTPHEADERLIST hHdrLst)
|
---|
| 213 | {
|
---|
| 214 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 215 | RTHTTPHEADERLIST_VALID_RETURN_VOID(pThis);
|
---|
| 216 |
|
---|
| 217 | rtHttpHeaderListRemoveAll(pThis);
|
---|
[102562] | 218 |
|
---|
| 219 | RTMemFree(hHdrLst);
|
---|
| 220 | hHdrLst = NIL_RTHTTPHEADERLIST;
|
---|
[87005] | 221 | }
|
---|
| 222 |
|
---|
| 223 |
|
---|
| 224 | static void rtHttpHeaderListRemoveAll(PRTHTTPHEADERLISTINTERNAL pThis)
|
---|
| 225 | {
|
---|
| 226 | PRTHTTPHEADERENTRY pEntry, pNext;
|
---|
| 227 | RTListForEachSafe(&pThis->List, pEntry, pNext, RTHTTPHEADERENTRY, Node)
|
---|
| 228 | {
|
---|
| 229 | RTListNodeRemove(&pEntry->Node);
|
---|
| 230 | RTMemFree(pEntry);
|
---|
| 231 | }
|
---|
| 232 | }
|
---|
| 233 |
|
---|
| 234 | /**
|
---|
| 235 | * Worker for RTHttpHeaderListSet and RTHttpHeaderListAdd.
|
---|
| 236 | *
|
---|
| 237 | * @returns IPRT status code.
|
---|
| 238 | * @param pThis The HTTP header list instance.
|
---|
| 239 | * @param pchName The field name. Does not need to be terminated.
|
---|
| 240 | * @param cchName The field name length.
|
---|
| 241 | * @param pchValue The field value. Does not need to be terminated.
|
---|
| 242 | * @param cchValue The field value length.
|
---|
| 243 | * @param fFlags RTHTTPADDHDR_F_XXX.
|
---|
| 244 | */
|
---|
| 245 | static int rtHttpHeaderListAddWorker(PRTHTTPHEADERLISTINTERNAL pThis,
|
---|
| 246 | const char *pchName, size_t cchName, const char *pchValue, size_t cchValue, uint32_t fFlags)
|
---|
| 247 | {
|
---|
| 248 | /*
|
---|
| 249 | * Create the list entry.
|
---|
| 250 | */
|
---|
| 251 | size_t cbData = cchName + 2 + cchValue + 1;
|
---|
| 252 | PRTHTTPHEADERENTRY pHdr = (PRTHTTPHEADERENTRY)RTMemAlloc(RT_UOFFSETOF_DYN(RTHTTPHEADERENTRY, szData[cbData]));
|
---|
| 253 | if (pHdr)
|
---|
| 254 | {
|
---|
| 255 | pHdr->cchName = (uint32_t)cchName;
|
---|
| 256 | pHdr->offValue = (uint32_t)(cchName + 2);
|
---|
| 257 | char *psz = pHdr->szData;
|
---|
| 258 | memcpy(psz, pchName, cchName);
|
---|
| 259 | psz += cchName;
|
---|
| 260 | *psz++ = ':';
|
---|
| 261 | *psz++ = ' ';
|
---|
| 262 | memcpy(psz, pchValue, cchValue);
|
---|
| 263 | psz[cchValue] = '\0';
|
---|
| 264 |
|
---|
| 265 | /*
|
---|
| 266 | * Appending to an existing list requires no cURL interaction.
|
---|
| 267 | */
|
---|
| 268 | AssertCompile(RTHTTPHEADERLISTADD_F_FRONT != 0);
|
---|
| 269 | if (!(fFlags & RTHTTPHEADERLISTADD_F_FRONT))
|
---|
| 270 | {
|
---|
| 271 | RTListAppend(&pThis->List, &pHdr->Node);
|
---|
| 272 | return VINF_SUCCESS;
|
---|
| 273 | }
|
---|
| 274 |
|
---|
| 275 | /*
|
---|
| 276 | * When prepending or adding the first header we need to inform cURL
|
---|
| 277 | * about the new list head.
|
---|
| 278 | */
|
---|
| 279 | RTListPrepend(&pThis->List, &pHdr->Node);
|
---|
| 280 | return VINF_SUCCESS;
|
---|
| 281 | }
|
---|
| 282 | return VERR_NO_MEMORY;
|
---|
| 283 | }
|
---|
| 284 |
|
---|
| 285 |
|
---|
| 286 | RTR3DECL(int) RTHttpHeaderListSet(RTHTTPHEADERLIST hHdrLst,
|
---|
| 287 | size_t cHeaders, const char * const *papszHeaders)
|
---|
| 288 | {
|
---|
| 289 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 290 | RTHTTPHEADERLIST_VALID_RETURN(pThis);
|
---|
| 291 |
|
---|
| 292 | /*
|
---|
| 293 | * Drop old headers and reset state.
|
---|
| 294 | */
|
---|
| 295 | rtHttpHeaderListRemoveAll(pThis);
|
---|
| 296 |
|
---|
| 297 | /*
|
---|
| 298 | * We're done if no headers specified.
|
---|
| 299 | */
|
---|
| 300 | if (!cHeaders)
|
---|
| 301 | return VINF_SUCCESS;
|
---|
| 302 |
|
---|
| 303 | /*
|
---|
| 304 | * Add the headers, one by one.
|
---|
| 305 | */
|
---|
| 306 | int rc = VINF_SUCCESS;
|
---|
| 307 | for (size_t i = 0; i < cHeaders; i++)
|
---|
| 308 | {
|
---|
| 309 | const char *pszHeader = papszHeaders[i];
|
---|
| 310 | size_t cchHeader = strlen(pszHeader);
|
---|
| 311 | size_t cchName = (const char *)memchr(pszHeader, ':', cchHeader) - pszHeader;
|
---|
| 312 | AssertBreakStmt(cchName < cchHeader, rc = VERR_INVALID_PARAMETER);
|
---|
| 313 | size_t offValue = RT_C_IS_BLANK(pszHeader[cchName + 1]) ? cchName + 2 : cchName + 1;
|
---|
| 314 | rc = rtHttpHeaderListAddWorker(pThis, pszHeader, cchName, &pszHeader[offValue], cchHeader - offValue,
|
---|
| 315 | RTHTTPHEADERLISTADD_F_BACK);
|
---|
| 316 | AssertRCBreak(rc);
|
---|
| 317 | }
|
---|
| 318 | if (RT_SUCCESS(rc))
|
---|
| 319 | return rc;
|
---|
| 320 | rtHttpHeaderListRemoveAll(pThis);
|
---|
| 321 | return rc;
|
---|
| 322 | }
|
---|
| 323 |
|
---|
| 324 |
|
---|
| 325 | RTR3DECL(int) RTHttpHeaderListAdd(RTHTTPHEADERLIST hHdrLst,
|
---|
| 326 | const char *pszField, const char *pszValue, size_t cchValue, uint32_t fFlags)
|
---|
| 327 | {
|
---|
| 328 | /*
|
---|
| 329 | * Validate input and calc string lengths.
|
---|
| 330 | */
|
---|
| 331 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 332 | RTHTTPHEADERLIST_VALID_RETURN(pThis);
|
---|
| 333 | AssertReturn(!(fFlags & ~RTHTTPHEADERLISTADD_F_BACK), VERR_INVALID_FLAGS);
|
---|
| 334 | AssertPtr(pszField);
|
---|
| 335 | size_t const cchField = strlen(pszField);
|
---|
| 336 | AssertReturn(cchField > 0, VERR_INVALID_PARAMETER);
|
---|
| 337 | AssertReturn(pszField[cchField - 1] != ':', VERR_INVALID_PARAMETER);
|
---|
| 338 | AssertReturn(!RT_C_IS_SPACE(pszField[cchField - 1]), VERR_INVALID_PARAMETER);
|
---|
| 339 | #ifdef RT_STRICT
|
---|
| 340 | for (size_t i = 0; i < cchField; i++)
|
---|
| 341 | {
|
---|
| 342 | char const ch = pszField[i];
|
---|
| 343 | Assert(RT_C_IS_PRINT(ch) && ch != ':');
|
---|
| 344 | }
|
---|
| 345 | #endif
|
---|
| 346 |
|
---|
| 347 | AssertPtr(pszValue);
|
---|
| 348 | if (cchValue == RTSTR_MAX)
|
---|
| 349 | cchValue = strlen(pszValue);
|
---|
| 350 |
|
---|
| 351 | /*
|
---|
| 352 | * Just pass it along to the worker.
|
---|
| 353 | */
|
---|
| 354 | return rtHttpHeaderListAddWorker(pThis, pszField, cchField, pszValue, cchValue, fFlags);
|
---|
| 355 | }
|
---|
| 356 |
|
---|
| 357 |
|
---|
| 358 | RTR3DECL(const char *) RTHttpHeaderListGet(RTHTTPHEADERLIST hHdrLst, const char *pszField, size_t cchField)
|
---|
| 359 | {
|
---|
| 360 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 361 | RTHTTPHEADERLIST_VALID_RETURN_RC(pThis, NULL);
|
---|
| 362 |
|
---|
| 363 | if (cchField == RTSTR_MAX)
|
---|
| 364 | cchField = strlen(pszField);
|
---|
| 365 |
|
---|
| 366 | PRTHTTPHEADERENTRY pEntry;
|
---|
| 367 | RTListForEach(&pThis->List, pEntry, RTHTTPHEADERENTRY, Node)
|
---|
| 368 | {
|
---|
| 369 | if ( pEntry->cchName == cchField
|
---|
| 370 | && RTStrNICmpAscii(pEntry->szData, pszField, cchField) == 0)
|
---|
| 371 | return &pEntry->szData[pEntry->offValue];
|
---|
| 372 | }
|
---|
| 373 | return NULL;
|
---|
| 374 | }
|
---|
| 375 |
|
---|
| 376 |
|
---|
| 377 | RTR3DECL(size_t) RTHttpHeaderListGetCount(RTHTTPHEADERLIST hHdrLst)
|
---|
| 378 | {
|
---|
| 379 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 380 | RTHTTPHEADERLIST_VALID_RETURN_RC(pThis, 0);
|
---|
| 381 |
|
---|
| 382 | /* Note! Only for test cases and debugging, so we don't care about performance. */
|
---|
| 383 | size_t cHeaders = 0;
|
---|
| 384 | PRTHTTPHEADERENTRY pEntry;
|
---|
| 385 | RTListForEach(&pThis->List, pEntry, RTHTTPHEADERENTRY, Node)
|
---|
| 386 | cHeaders++;
|
---|
| 387 | return cHeaders;
|
---|
| 388 | }
|
---|
| 389 |
|
---|
| 390 |
|
---|
| 391 | RTR3DECL(const char *) RTHttpHeaderListGetByOrdinal(RTHTTPHEADERLIST hHdrLst, size_t iOrdinal)
|
---|
| 392 | {
|
---|
| 393 | PRTHTTPHEADERLISTINTERNAL pThis = hHdrLst;
|
---|
| 394 | RTHTTPHEADERLIST_VALID_RETURN_RC(pThis, NULL);
|
---|
| 395 |
|
---|
| 396 | /* Note! Only for test cases and debugging, so we don't care about performance. */
|
---|
| 397 | PRTHTTPHEADERENTRY pEntry;
|
---|
| 398 | RTListForEach(&pThis->List, pEntry, RTHTTPHEADERENTRY, Node)
|
---|
| 399 | {
|
---|
| 400 | if (iOrdinal == 0)
|
---|
| 401 | return pEntry->szData;
|
---|
| 402 | iOrdinal--;
|
---|
| 403 | }
|
---|
| 404 |
|
---|
| 405 | return NULL;
|
---|
| 406 | }
|
---|
| 407 |
|
---|