-
Notifications
You must be signed in to change notification settings - Fork 29
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Susan Su <[email protected]>
- Loading branch information
Showing
60,488 changed files
with
3,280,273 additions
and
2,525,979 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
89 changes: 89 additions & 0 deletions
89
..._examples/azure_iot_embedded_sdk/azure_iot/azure-sdk-for-c/sdk/inc/azure/core/az_base64.h
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,89 @@ | ||
| // Copyright (c) Microsoft Corporation. All rights reserved. | ||
| // SPDX-License-Identifier: MIT | ||
|
|
||
| /** | ||
| * @file | ||
| * | ||
| * @brief Defines APIs to convert between binary data and UTF-8 encoded text that is represented in | ||
| * base 64. | ||
| * | ||
| * @note You MUST NOT use any symbols (macros, functions, structures, enums, etc.) | ||
| * prefixed with an underscore ('_') directly in your application code. These symbols | ||
| * are part of Azure SDK's internal implementation; we do not document these symbols | ||
| * and they are subject to change in future versions of the SDK which would break your code. | ||
| */ | ||
|
|
||
| #ifndef _az_BASE64_H | ||
| #define _az_BASE64_H | ||
|
|
||
| #include <azure/core/az_result.h> | ||
| #include <azure/core/az_span.h> | ||
|
|
||
| #include <stdint.h> | ||
|
|
||
| #include <azure/core/_az_cfg_prefix.h> | ||
|
|
||
| /** | ||
| * @brief Encodes the span of binary data into UTF-8 encoded text represented as base 64. | ||
| * | ||
| * @param destination_base64_text The output #az_span where the encoded base 64 text should be | ||
| * copied to as a result of the operation. | ||
| * @param[in] source_bytes The input #az_span that contains binary data to be encoded. | ||
| * @param[out] out_written A pointer to an `int32_t` that receives the number of bytes written into | ||
| * the destination #az_span. This can be used to slice the output for subsequent calls, if | ||
| * necessary. | ||
| * | ||
| * @return An #az_result value indicating the result of the operation. | ||
| * @retval #AZ_OK Success. | ||
| * @retval #AZ_ERROR_NOT_ENOUGH_SPACE The \p destination_base64_text is not large enough to contain | ||
| * the encoded bytes. | ||
| */ | ||
| AZ_NODISCARD az_result | ||
| az_base64_encode(az_span destination_base64_text, az_span source_bytes, int32_t* out_written); | ||
|
|
||
| /** | ||
| * @brief Returns the maximum length of the result if you were to encode an #az_span of the | ||
| * specified length which contained binary data. | ||
| * | ||
| * @param source_bytes_size The size of the span containing binary data. | ||
| * | ||
| * @return The maximum length of the result. | ||
| */ | ||
| AZ_NODISCARD int32_t az_base64_get_max_encoded_size(int32_t source_bytes_size); | ||
|
|
||
| /** | ||
| * @brief Decodes the span of UTF-8 encoded text represented as base 64 into binary data. | ||
| * | ||
| * @param destination_bytes The output #az_span where the decoded binary data should be copied to as | ||
| * a result of the operation. | ||
| * @param[in] source_base64_text The input #az_span that contains the base 64 text to be decoded. | ||
| * @param[out] out_written A pointer to an `int32_t` that receives the number of bytes written into | ||
| * the destination #az_span. This can be used to slice the output for subsequent calls, if | ||
| * necessary. | ||
| * | ||
| * @return An #az_result value indicating the result of the operation. | ||
| * @retval #AZ_OK Success. | ||
| * @retval #AZ_ERROR_NOT_ENOUGH_SPACE The \p destination_bytes is not large enough to contain | ||
| * the decoded text. | ||
| * @retval #AZ_ERROR_UNEXPECTED_CHAR The input \p source_base64_text contains characters outside of | ||
| * the expected base 64 range, has invalid or more than two padding characters, or is incomplete | ||
| * (that is, not a multiple of 4). | ||
| * @retval #AZ_ERROR_UNEXPECTED_END The input \p source_base64_text is incomplete (that is, it is | ||
| * not of a size which is a multiple of 4). | ||
| */ | ||
| AZ_NODISCARD az_result | ||
| az_base64_decode(az_span destination_bytes, az_span source_base64_text, int32_t* out_written); | ||
|
|
||
| /** | ||
| * @brief Returns the maximum length of the result if you were to decode an #az_span of the | ||
| * specified length which contained base 64 encoded text. | ||
| * | ||
| * @param source_base64_text_size The size of the span containing base 64 encoded text. | ||
| * | ||
| * @return The maximum length of the result. | ||
| */ | ||
| AZ_NODISCARD int32_t az_base64_get_max_decoded_size(int32_t source_base64_text_size); | ||
|
|
||
| #include <azure/core/_az_cfg_suffix.h> | ||
|
|
||
| #endif // _az_BASE64_H |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.