mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
f9a93a55d7
Centralize the `SWIFT_{BEGIN/END}_NULLABILITY_ANNOTATIONS` definitions in a new
Nullability.h header to share.
111 lines
4.3 KiB
C
111 lines
4.3 KiB
C
//===--- CBasicBridging.h - header for the swift SILBridging module -------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2023 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_C_BASIC_BASICBRIDGING_H
|
|
#define SWIFT_C_BASIC_BASICBRIDGING_H
|
|
|
|
#include "swift/Basic/Compiler.h"
|
|
#include "swift/Basic/Nullability.h"
|
|
|
|
// NOTE: DO NOT #include any stdlib headers here. e.g. <stdint.h>. Those are
|
|
// part of "Darwin"/"Glibc" module, so when a Swift file imports this header,
|
|
// it causes importing the "Darwin"/"Glibc" overlay module. That violates
|
|
// layering. i.e. Darwin overlay is created by Swift compiler.
|
|
|
|
SWIFT_BEGIN_NULLABILITY_ANNOTATIONS
|
|
SWIFT_BEGIN_ASSUME_NONNULL
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
|
|
#define _Bool bool
|
|
|
|
#endif
|
|
|
|
typedef struct BridgedData {
|
|
const char *_Nullable baseAddress;
|
|
unsigned long size;
|
|
} BridgedData;
|
|
|
|
void BridgedData_free(BridgedData data);
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
// Plugins
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/// Create a new root 'null' JSON value. Clients must call \c JSON_value_delete
|
|
/// after using it.
|
|
void *JSON_newValue();
|
|
|
|
/// Parse \p data as a JSON data and return the top-level value. Clients must
|
|
/// call \c JSON_value_delete after using it.
|
|
void *JSON_deserializedValue(BridgedData data);
|
|
|
|
/// Serialize a value and populate \p result with the result data. Clients
|
|
/// must call \c BridgedData_free after using the \p result.
|
|
void JSON_value_serialize(void *valuePtr, BridgedData *result);
|
|
|
|
/// Destroy and release the memory for \p valuePtr that is a result from
|
|
/// \c JSON_newValue() or \c JSON_deserializedValue() .
|
|
void JSON_value_delete(void *valuePtr);
|
|
|
|
_Bool JSON_value_getAsNull(void *valuePtr);
|
|
_Bool JSON_value_getAsBoolean(void *valuePtr, _Bool *result);
|
|
_Bool JSON_value_getAsString(void *valuePtr, BridgedData *result);
|
|
_Bool JSON_value_getAsDouble(void *valuePtr, double *result);
|
|
_Bool JSON_value_getAsInteger(void *valuePtr, long long *result);
|
|
_Bool JSON_value_getAsObject(void *valuePtr, void *_Nullable *_Nonnull result);
|
|
_Bool JSON_value_getAsArray(void *valuePtr, void *_Nullable *_Nonnull result);
|
|
|
|
unsigned long JSON_object_getSize(void *objectPtr);
|
|
BridgedData JSON_object_getKey(void *objectPtr, unsigned long i);
|
|
_Bool JSON_object_hasKey(void *objectPtr, const char *key);
|
|
void *JSON_object_getValue(void *objectPtr, const char *key);
|
|
|
|
long long JSON_array_getSize(void *arrayPtr);
|
|
void *JSON_array_getValue(void *arrayPtr, long long index);
|
|
|
|
void JSON_value_emplaceNull(void *valuePtr);
|
|
void JSON_value_emplaceBoolean(void *valuePtr, _Bool value);
|
|
void JSON_value_emplaceString(void *valuePtr, const char *value);
|
|
void JSON_value_emplaceDouble(void *valuePtr, double value);
|
|
void JSON_value_emplaceInteger(void *valuePtr, long long value);
|
|
void *JSON_value_emplaceNewObject(void *valuePtr);
|
|
void *JSON_value_emplaceNewArray(void *valuePtr);
|
|
|
|
void JSON_object_setNull(void *objectPtr, const char *key);
|
|
void JSON_object_setBoolean(void *objectPtr, const char *key, _Bool value);
|
|
void JSON_object_setString(void *objectPtr, const char *key, const char *value);
|
|
void JSON_object_setDouble(void *objectPtr, const char *key, double value);
|
|
void JSON_object_setInteger(void *objectPtr, const char *key, long long value);
|
|
void *JSON_object_setNewObject(void *objectPtr, const char *key);
|
|
void *JSON_object_setNewArray(void *objectPtr, const char *key);
|
|
void *JSON_object_setNewValue(void *objectPtr, const char *key);
|
|
|
|
void JSON_array_pushNull(void *arrayPtr);
|
|
void JSON_array_pushBoolean(void *arrayPtr, _Bool value);
|
|
void JSON_array_pushString(void *arrayPtr, const char *value);
|
|
void JSON_array_pushDouble(void *arrayPtr, double value);
|
|
void JSON_array_pushInteger(void *arrayPtr, long long value);
|
|
void *JSON_array_pushNewObject(void *arrayPtr);
|
|
void *JSON_array_pushNewArray(void *arrayPtr);
|
|
void *JSON_array_pushNewValue(void *arrayPtr);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
SWIFT_END_ASSUME_NONNULL
|
|
SWIFT_END_NULLABILITY_ANNOTATIONS
|
|
|
|
#endif // SWIFT_C_BASIC_BASICBRIDGING_H
|