From a1ac73728a6cc620e14b5e7c9b57236ce39a8b06 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=99=BD=E5=8F=B6=20=E8=97=A4=E5=8E=9F?= <1751842477@qq.com> Date: Tue, 18 Jul 2023 15:48:56 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E9=A1=B9=E7=9B=AE=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Lib/MJson/MJson.h | 331 + Lib/MJson/yyjson.c | 9201 +++++++++++++++++ Lib/MJson/yyjson.h | 7690 ++++++++++++++ Lib/OnnxRuntimeDmlProvider/.signature.p7s | Bin 0 -> 11402 bytes Lib/OnnxRuntimeDmlProvider/LICENSE.txt | 21 + .../Microsoft.ML.OnnxRuntime.DirectML.nuspec | 39 + .../ORT_icon_for_light_bg.png | Bin 0 -> 346655 bytes Lib/OnnxRuntimeDmlProvider/Privacy.md | 21 + .../ThirdPartyNotices.txt | 6024 +++++++++++ .../[Content_Types].xml | 14 + Lib/OnnxRuntimeDmlProvider/_rels/.rels | 5 + .../Microsoft.ML.OnnxRuntime.DirectML.props | 179 + .../Microsoft.ML.OnnxRuntime.DirectML.targets | 17 + .../native/include/cpu_provider_factory.h | 19 + .../native/include/dml_provider_factory.h | 106 + .../build/native/include/onnxruntime_c_api.h | 4324 ++++++++ .../native/include/onnxruntime_cxx_api.h | 2088 ++++ .../native/include/onnxruntime_cxx_inline.h | 2035 ++++ .../onnxruntime_run_options_config_keys.h | 32 + .../onnxruntime_session_options_config_keys.h | 199 + .../build/native/include/provider_options.h | 18 + .../Microsoft.ML.OnnxRuntime.DirectML.props | 179 + .../Microsoft.ML.OnnxRuntime.DirectML.targets | 17 + .../Microsoft.ML.OnnxRuntime.DirectML.props | 179 + .../Microsoft.ML.OnnxRuntime.DirectML.targets | 17 + .../c7795757db2346b9bcfb932f99cdb33f.psmdcp | 9 + .../runtimes/win-arm/native/onnxruntime.dll | Bin 0 -> 10488240 bytes .../runtimes/win-arm/native/onnxruntime.lib | Bin 0 -> 3186 bytes .../runtimes/win-arm64/native/onnxruntime.dll | Bin 0 -> 12856216 bytes .../runtimes/win-arm64/native/onnxruntime.lib | Bin 0 -> 3198 bytes .../runtimes/win-x64/native/onnxruntime.dll | Bin 0 -> 12632456 bytes .../runtimes/win-x64/native/onnxruntime.lib | Bin 0 -> 3198 bytes .../runtimes/win-x86/native/onnxruntime.dll | Bin 0 -> 11207600 bytes .../runtimes/win-x86/native/onnxruntime.lib | Bin 0 -> 3250 bytes Lib/World/LICENSE.txt | 39 + Lib/World/src/cheaptrick.cpp | 239 + Lib/World/src/codec.cpp | 324 + Lib/World/src/common.cpp | 228 + Lib/World/src/d4c.cpp | 401 + Lib/World/src/dio.cpp | 666 ++ Lib/World/src/fft.cpp | 2652 +++++ Lib/World/src/harvest.cpp | 1262 +++ Lib/World/src/matlabfunctions.cpp | 320 + Lib/World/src/stonemask.cpp | 218 + Lib/World/src/synthesis.cpp | 397 + Lib/World/src/synthesisrealtime.cpp | 600 ++ Lib/World/src/world/cheaptrick.h | 84 + Lib/World/src/world/codec.h | 92 + Lib/World/src/world/common.h | 138 + Lib/World/src/world/constantnumbers.h | 51 + Lib/World/src/world/d4c.h | 50 + Lib/World/src/world/dio.h | 65 + Lib/World/src/world/fft.h | 48 + Lib/World/src/world/harvest.h | 63 + Lib/World/src/world/macrodefinitions.h | 144 + Lib/World/src/world/matlabfunctions.h | 175 + Lib/World/src/world/stonemask.h | 33 + Lib/World/src/world/synthesis.h | 36 + Lib/World/src/world/synthesisrealtime.h | 152 + Lib/World/tools/audioio.cpp | 252 + Lib/World/tools/audioio.h | 53 + Lib/World/tools/parameterio.cpp | 243 + Lib/World/tools/parameterio.h | 120 + Lib/ffmpeg-4.2.1/COPYING.GPLv3 | 674 ++ Lib/ffmpeg-4.2.1/COPYING.LGPLv3 | 165 + Lib/ffmpeg-4.2.1/Lib/avcodec.lib | Bin 0 -> 50940 bytes Lib/ffmpeg-4.2.1/Lib/avformat.lib | Bin 0 -> 38788 bytes Lib/ffmpeg-4.2.1/Lib/avutil.lib | Bin 0 -> 117816 bytes Lib/ffmpeg-4.2.1/Lib/swresample.lib | Bin 0 -> 6420 bytes Lib/ffmpeg-4.2.1/Lib/swscale.lib | Bin 0 -> 8784 bytes .../include/libavcodec/ac3_parser.h | 36 + .../include/libavcodec/adts_parser.h | 37 + Lib/ffmpeg-4.2.1/include/libavcodec/avcodec.h | 6228 +++++++++++ Lib/ffmpeg-4.2.1/include/libavcodec/avdct.h | 84 + Lib/ffmpeg-4.2.1/include/libavcodec/avfft.h | 118 + Lib/ffmpeg-4.2.1/include/libavcodec/d3d11va.h | 112 + Lib/ffmpeg-4.2.1/include/libavcodec/dirac.h | 131 + .../include/libavcodec/dv_profile.h | 83 + Lib/ffmpeg-4.2.1/include/libavcodec/dxva2.h | 93 + Lib/ffmpeg-4.2.1/include/libavcodec/jni.h | 46 + .../include/libavcodec/mediacodec.h | 101 + Lib/ffmpeg-4.2.1/include/libavcodec/qsv.h | 107 + Lib/ffmpeg-4.2.1/include/libavcodec/vaapi.h | 86 + Lib/ffmpeg-4.2.1/include/libavcodec/vdpau.h | 176 + Lib/ffmpeg-4.2.1/include/libavcodec/version.h | 140 + .../include/libavcodec/videotoolbox.h | 127 + .../include/libavcodec/vorbis_parser.h | 74 + Lib/ffmpeg-4.2.1/include/libavcodec/xvmc.h | 170 + .../include/libavdevice/avdevice.h | 514 + .../include/libavdevice/version.h | 50 + .../include/libavfilter/avfilter.h | 1168 +++ .../include/libavfilter/buffersink.h | 165 + .../include/libavfilter/buffersrc.h | 209 + .../include/libavfilter/version.h | 66 + .../include/libavformat/avformat.h | 3092 ++++++ Lib/ffmpeg-4.2.1/include/libavformat/avio.h | 861 ++ .../include/libavformat/version.h | 114 + Lib/ffmpeg-4.2.1/include/libavutil/adler32.h | 60 + Lib/ffmpeg-4.2.1/include/libavutil/aes.h | 65 + Lib/ffmpeg-4.2.1/include/libavutil/aes_ctr.h | 88 + .../include/libavutil/attributes.h | 167 + .../include/libavutil/audio_fifo.h | 187 + Lib/ffmpeg-4.2.1/include/libavutil/avassert.h | 75 + Lib/ffmpeg-4.2.1/include/libavutil/avconfig.h | 6 + Lib/ffmpeg-4.2.1/include/libavutil/avstring.h | 413 + Lib/ffmpeg-4.2.1/include/libavutil/avutil.h | 365 + Lib/ffmpeg-4.2.1/include/libavutil/base64.h | 72 + Lib/ffmpeg-4.2.1/include/libavutil/blowfish.h | 82 + Lib/ffmpeg-4.2.1/include/libavutil/bprint.h | 219 + Lib/ffmpeg-4.2.1/include/libavutil/bswap.h | 109 + Lib/ffmpeg-4.2.1/include/libavutil/buffer.h | 291 + Lib/ffmpeg-4.2.1/include/libavutil/camellia.h | 70 + Lib/ffmpeg-4.2.1/include/libavutil/cast5.h | 80 + .../include/libavutil/channel_layout.h | 232 + Lib/ffmpeg-4.2.1/include/libavutil/common.h | 560 + Lib/ffmpeg-4.2.1/include/libavutil/cpu.h | 130 + Lib/ffmpeg-4.2.1/include/libavutil/crc.h | 100 + Lib/ffmpeg-4.2.1/include/libavutil/des.h | 77 + Lib/ffmpeg-4.2.1/include/libavutil/dict.h | 200 + Lib/ffmpeg-4.2.1/include/libavutil/display.h | 114 + .../include/libavutil/downmix_info.h | 115 + .../include/libavutil/encryption_info.h | 205 + Lib/ffmpeg-4.2.1/include/libavutil/error.h | 126 + Lib/ffmpeg-4.2.1/include/libavutil/eval.h | 113 + .../include/libavutil/ffversion.h | 5 + Lib/ffmpeg-4.2.1/include/libavutil/fifo.h | 179 + Lib/ffmpeg-4.2.1/include/libavutil/file.h | 71 + Lib/ffmpeg-4.2.1/include/libavutil/frame.h | 971 ++ Lib/ffmpeg-4.2.1/include/libavutil/hash.h | 269 + .../include/libavutil/hdr_dynamic_metadata.h | 343 + Lib/ffmpeg-4.2.1/include/libavutil/hmac.h | 100 + .../include/libavutil/hwcontext.h | 584 ++ .../include/libavutil/hwcontext_cuda.h | 52 + .../include/libavutil/hwcontext_d3d11va.h | 169 + .../include/libavutil/hwcontext_drm.h | 169 + .../include/libavutil/hwcontext_dxva2.h | 75 + .../include/libavutil/hwcontext_mediacodec.h | 36 + .../include/libavutil/hwcontext_qsv.h | 53 + .../include/libavutil/hwcontext_vaapi.h | 117 + .../include/libavutil/hwcontext_vdpau.h | 44 + .../libavutil/hwcontext_videotoolbox.h | 54 + Lib/ffmpeg-4.2.1/include/libavutil/imgutils.h | 277 + Lib/ffmpeg-4.2.1/include/libavutil/intfloat.h | 77 + .../include/libavutil/intreadwrite.h | 644 ++ Lib/ffmpeg-4.2.1/include/libavutil/lfg.h | 71 + Lib/ffmpeg-4.2.1/include/libavutil/log.h | 362 + Lib/ffmpeg-4.2.1/include/libavutil/lzo.h | 66 + Lib/ffmpeg-4.2.1/include/libavutil/macros.h | 50 + .../libavutil/mastering_display_metadata.h | 128 + .../include/libavutil/mathematics.h | 242 + Lib/ffmpeg-4.2.1/include/libavutil/md5.h | 98 + Lib/ffmpeg-4.2.1/include/libavutil/mem.h | 700 ++ .../include/libavutil/motion_vector.h | 57 + Lib/ffmpeg-4.2.1/include/libavutil/murmur3.h | 120 + Lib/ffmpeg-4.2.1/include/libavutil/opt.h | 865 ++ .../include/libavutil/parseutils.h | 193 + Lib/ffmpeg-4.2.1/include/libavutil/pixdesc.h | 440 + .../include/libavutil/pixelutils.h | 52 + Lib/ffmpeg-4.2.1/include/libavutil/pixfmt.h | 552 + .../include/libavutil/random_seed.h | 43 + Lib/ffmpeg-4.2.1/include/libavutil/rational.h | 214 + Lib/ffmpeg-4.2.1/include/libavutil/rc4.h | 66 + .../include/libavutil/replaygain.h | 50 + Lib/ffmpeg-4.2.1/include/libavutil/ripemd.h | 87 + .../include/libavutil/samplefmt.h | 272 + Lib/ffmpeg-4.2.1/include/libavutil/sha.h | 95 + Lib/ffmpeg-4.2.1/include/libavutil/sha512.h | 97 + .../include/libavutil/spherical.h | 232 + Lib/ffmpeg-4.2.1/include/libavutil/stereo3d.h | 233 + Lib/ffmpeg-4.2.1/include/libavutil/tea.h | 71 + .../include/libavutil/threadmessage.h | 115 + Lib/ffmpeg-4.2.1/include/libavutil/time.h | 56 + Lib/ffmpeg-4.2.1/include/libavutil/timecode.h | 140 + .../include/libavutil/timestamp.h | 78 + Lib/ffmpeg-4.2.1/include/libavutil/tree.h | 138 + Lib/ffmpeg-4.2.1/include/libavutil/twofish.h | 70 + Lib/ffmpeg-4.2.1/include/libavutil/tx.h | 81 + Lib/ffmpeg-4.2.1/include/libavutil/version.h | 139 + Lib/ffmpeg-4.2.1/include/libavutil/xtea.h | 94 + .../include/libswresample/swresample.h | 579 ++ .../include/libswresample/version.h | 45 + Lib/ffmpeg-4.2.1/include/libswscale/swscale.h | 336 + Lib/ffmpeg-4.2.1/include/libswscale/version.h | 53 + MoeVoiceStudioSvc - Core - Cmd.sln | 31 + .../Modules/AvCodec/AvCodeResample.h | 229 + .../Modules/AvCodec/Recorder.cpp | 184 + .../Modules/AvCodec/Recorder.h | 122 + .../Modules/DataStruct/KDTree.cpp | 323 + .../Modules/DataStruct/KDTree.hpp | 129 + .../Modules/DataStruct/README.md | 1 + .../InferTools/Cluster/MoeVSBaseCluster.cpp | 6 + .../InferTools/Cluster/MoeVSBaseCluster.hpp | 44 + .../Cluster/MoeVSClusterManager.cpp | 28 + .../Cluster/MoeVSClusterManager.hpp | 74 + .../InferTools/Cluster/MoeVSKmeansCluster.cpp | 30 + .../InferTools/Cluster/MoeVSKmeansCluster.hpp | 40 + .../BaseF0Extractor/BaseF0Extractor.cpp | 46 + .../BaseF0Extractor/BaseF0Extractor.hpp | 85 + .../DioF0Extractor/DioF0Extractor.cpp | 61 + .../DioF0Extractor/DioF0Extractor.hpp | 41 + .../F0Extractor/F0ExtractorManager.cpp | 41 + .../F0Extractor/F0ExtractorManager.hpp | 84 + .../HarvestF0Extractor/HarvestF0Extractor.cpp | 61 + .../HarvestF0Extractor/HarvestF0Extractor.hpp | 42 + .../InferTools/Sampler/MoeVSBaseSampler.cpp | 17 + .../InferTools/Sampler/MoeVSBaseSampler.hpp | 67 + .../Sampler/MoeVSSamplerManager.cpp | 39 + .../Sampler/MoeVSSamplerManager.hpp | 85 + .../InferTools/Sampler/MoeVSSamplers.cpp | 225 + .../InferTools/Sampler/MoeVSSamplers.hpp | 53 + .../MoeVSCoreTensorExtractor.cpp | 587 ++ .../MoeVSCoreTensorExtractor.hpp | 143 + .../MoeVoiceStudioTensorExtractor.cpp | 220 + .../MoeVoiceStudioTensorExtractor.hpp | 186 + .../TensorExtractorManager.cpp | 26 + .../TensorExtractorManager.hpp | 86 + .../Modules/InferTools/inferTools.cpp | 231 + .../Modules/InferTools/inferTools.hpp | 255 + .../Modules/Logger/MoeSSLogger.cpp | 25 + .../Modules/Logger/MoeSSLogger.hpp | 27 + .../Modules/Models/header/DiffSvc.hpp | 72 + .../Modules/Models/header/ModelBase.hpp | 123 + .../Modules/Models/header/MoeVSProject.hpp | 189 + .../Modules/Models/header/SVC.hpp | 213 + .../Modules/Models/header/VitsSvc.hpp | 81 + .../Modules/Models/src/DiffSvc.cpp | 934 ++ .../Modules/Models/src/ModelBase.cpp | 284 + .../Modules/Models/src/MoeVSProject.cpp | 264 + .../Modules/Models/src/SVC.cpp | 122 + .../Modules/Models/src/VitsSvc.cpp | 1167 +++ .../Modules/Modules.cpp | 106 + .../Modules/Modules.hpp | 65 + .../Modules/README.md | 43 + .../Modules/StringPreprocess.hpp | 13 + .../MoeVoiceStudioSvc - Core - Cmd.cpp | 52 + .../MoeVoiceStudioSvc - Core - Cmd.vcxproj | 221 + ...oiceStudioSvc - Core - Cmd.vcxproj.filters | 330 + 237 files changed, 81179 insertions(+) create mode 100644 Lib/MJson/MJson.h create mode 100644 Lib/MJson/yyjson.c create mode 100644 Lib/MJson/yyjson.h create mode 100644 Lib/OnnxRuntimeDmlProvider/.signature.p7s create mode 100644 Lib/OnnxRuntimeDmlProvider/LICENSE.txt create mode 100644 Lib/OnnxRuntimeDmlProvider/Microsoft.ML.OnnxRuntime.DirectML.nuspec create mode 100644 Lib/OnnxRuntimeDmlProvider/ORT_icon_for_light_bg.png create mode 100644 Lib/OnnxRuntimeDmlProvider/Privacy.md create mode 100644 Lib/OnnxRuntimeDmlProvider/ThirdPartyNotices.txt create mode 100644 Lib/OnnxRuntimeDmlProvider/[Content_Types].xml create mode 100644 Lib/OnnxRuntimeDmlProvider/_rels/.rels create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.props create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.targets create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/cpu_provider_factory.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/dml_provider_factory.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_c_api.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_api.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_inline.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_run_options_config_keys.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_session_options_config_keys.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/native/include/provider_options.h create mode 100644 Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.props create mode 100644 Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.targets create mode 100644 Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.props create mode 100644 Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.targets create mode 100644 Lib/OnnxRuntimeDmlProvider/package/services/metadata/core-properties/c7795757db2346b9bcfb932f99cdb33f.psmdcp create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-arm/native/onnxruntime.dll create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-arm/native/onnxruntime.lib create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-arm64/native/onnxruntime.dll create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-arm64/native/onnxruntime.lib create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-x64/native/onnxruntime.dll create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-x64/native/onnxruntime.lib create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-x86/native/onnxruntime.dll create mode 100644 Lib/OnnxRuntimeDmlProvider/runtimes/win-x86/native/onnxruntime.lib create mode 100644 Lib/World/LICENSE.txt create mode 100644 Lib/World/src/cheaptrick.cpp create mode 100644 Lib/World/src/codec.cpp create mode 100644 Lib/World/src/common.cpp create mode 100644 Lib/World/src/d4c.cpp create mode 100644 Lib/World/src/dio.cpp create mode 100644 Lib/World/src/fft.cpp create mode 100644 Lib/World/src/harvest.cpp create mode 100644 Lib/World/src/matlabfunctions.cpp create mode 100644 Lib/World/src/stonemask.cpp create mode 100644 Lib/World/src/synthesis.cpp create mode 100644 Lib/World/src/synthesisrealtime.cpp create mode 100644 Lib/World/src/world/cheaptrick.h create mode 100644 Lib/World/src/world/codec.h create mode 100644 Lib/World/src/world/common.h create mode 100644 Lib/World/src/world/constantnumbers.h create mode 100644 Lib/World/src/world/d4c.h create mode 100644 Lib/World/src/world/dio.h create mode 100644 Lib/World/src/world/fft.h create mode 100644 Lib/World/src/world/harvest.h create mode 100644 Lib/World/src/world/macrodefinitions.h create mode 100644 Lib/World/src/world/matlabfunctions.h create mode 100644 Lib/World/src/world/stonemask.h create mode 100644 Lib/World/src/world/synthesis.h create mode 100644 Lib/World/src/world/synthesisrealtime.h create mode 100644 Lib/World/tools/audioio.cpp create mode 100644 Lib/World/tools/audioio.h create mode 100644 Lib/World/tools/parameterio.cpp create mode 100644 Lib/World/tools/parameterio.h create mode 100644 Lib/ffmpeg-4.2.1/COPYING.GPLv3 create mode 100644 Lib/ffmpeg-4.2.1/COPYING.LGPLv3 create mode 100644 Lib/ffmpeg-4.2.1/Lib/avcodec.lib create mode 100644 Lib/ffmpeg-4.2.1/Lib/avformat.lib create mode 100644 Lib/ffmpeg-4.2.1/Lib/avutil.lib create mode 100644 Lib/ffmpeg-4.2.1/Lib/swresample.lib create mode 100644 Lib/ffmpeg-4.2.1/Lib/swscale.lib create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/ac3_parser.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/adts_parser.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/avcodec.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/avdct.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/avfft.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/d3d11va.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/dirac.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/dv_profile.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/dxva2.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/jni.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/mediacodec.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/qsv.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/vaapi.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/vdpau.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/videotoolbox.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/vorbis_parser.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavcodec/xvmc.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavdevice/avdevice.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavdevice/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavfilter/avfilter.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavfilter/buffersink.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavfilter/buffersrc.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavfilter/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavformat/avformat.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavformat/avio.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavformat/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/adler32.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/aes.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/aes_ctr.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/attributes.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/audio_fifo.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/avassert.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/avconfig.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/avstring.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/avutil.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/base64.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/blowfish.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/bprint.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/bswap.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/buffer.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/camellia.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/cast5.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/channel_layout.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/common.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/cpu.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/crc.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/des.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/dict.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/display.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/downmix_info.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/encryption_info.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/error.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/eval.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/ffversion.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/fifo.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/file.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/frame.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hash.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hdr_dynamic_metadata.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hmac.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_cuda.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_d3d11va.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_drm.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_dxva2.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_mediacodec.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_qsv.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_vaapi.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_vdpau.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/hwcontext_videotoolbox.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/imgutils.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/intfloat.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/intreadwrite.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/lfg.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/log.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/lzo.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/macros.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/mastering_display_metadata.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/mathematics.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/md5.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/mem.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/motion_vector.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/murmur3.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/opt.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/parseutils.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/pixdesc.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/pixelutils.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/pixfmt.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/random_seed.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/rational.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/rc4.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/replaygain.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/ripemd.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/samplefmt.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/sha.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/sha512.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/spherical.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/stereo3d.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/tea.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/threadmessage.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/time.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/timecode.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/timestamp.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/tree.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/twofish.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/tx.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libavutil/xtea.h create mode 100644 Lib/ffmpeg-4.2.1/include/libswresample/swresample.h create mode 100644 Lib/ffmpeg-4.2.1/include/libswresample/version.h create mode 100644 Lib/ffmpeg-4.2.1/include/libswscale/swscale.h create mode 100644 Lib/ffmpeg-4.2.1/include/libswscale/version.h create mode 100644 MoeVoiceStudioSvc - Core - Cmd.sln create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/AvCodec/AvCodeResample.h create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/AvCodec/Recorder.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/AvCodec/Recorder.h create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/DataStruct/KDTree.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/DataStruct/KDTree.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/DataStruct/README.md create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSBaseCluster.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSBaseCluster.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSClusterManager.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSClusterManager.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSKmeansCluster.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Cluster/MoeVSKmeansCluster.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/BaseF0Extractor/BaseF0Extractor.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/BaseF0Extractor/BaseF0Extractor.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/DioF0Extractor/DioF0Extractor.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/DioF0Extractor/DioF0Extractor.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/F0ExtractorManager.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/F0ExtractorManager.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/HarvestF0Extractor/HarvestF0Extractor.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/F0Extractor/HarvestF0Extractor/HarvestF0Extractor.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSBaseSampler.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSBaseSampler.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSSamplerManager.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSSamplerManager.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSSamplers.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/Sampler/MoeVSSamplers.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/MoeVSCoreTensorExtractor.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/MoeVSCoreTensorExtractor.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/MoeVoiceStudioTensorExtractor.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/MoeVoiceStudioTensorExtractor.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/TensorExtractorManager.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/TensorExtractor/TensorExtractorManager.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/inferTools.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/InferTools/inferTools.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Logger/MoeSSLogger.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Logger/MoeSSLogger.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/header/DiffSvc.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/header/ModelBase.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/header/MoeVSProject.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/header/SVC.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/header/VitsSvc.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/src/DiffSvc.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/src/ModelBase.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/src/MoeVSProject.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/src/SVC.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Models/src/VitsSvc.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Modules.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/Modules.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/README.md create mode 100644 MoeVoiceStudioSvc - Core - Cmd/Modules/StringPreprocess.hpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/MoeVoiceStudioSvc - Core - Cmd.cpp create mode 100644 MoeVoiceStudioSvc - Core - Cmd/MoeVoiceStudioSvc - Core - Cmd.vcxproj create mode 100644 MoeVoiceStudioSvc - Core - Cmd/MoeVoiceStudioSvc - Core - Cmd.vcxproj.filters diff --git a/Lib/MJson/MJson.h b/Lib/MJson/MJson.h new file mode 100644 index 0000000..4e673b4 --- /dev/null +++ b/Lib/MJson/MJson.h @@ -0,0 +1,331 @@ +#pragma once +#include "yyjson.h" +#include +class MJsonValue +{ +public: + MJsonValue() = default; + MJsonValue(yyjson_val* _val) : _Ptr(_val) {} + ~MJsonValue() = default; + MJsonValue(MJsonValue&& _val) noexcept + { + _Ptr = _val._Ptr; + _val._Ptr = nullptr; + } + MJsonValue(const MJsonValue& _val) = delete; + MJsonValue& operator=(MJsonValue&& _val) noexcept + { + _Ptr = _val._Ptr; + _val._Ptr = nullptr; + return *this; + } + MJsonValue& operator=(const MJsonValue& _val) = delete; + [[nodiscard]] bool IsNull() const + { + return yyjson_is_null(_Ptr); + } + [[nodiscard]] bool IsBoolean() const + { + return yyjson_is_bool(_Ptr); + } + [[nodiscard]] bool IsBool() const + { + return yyjson_is_bool(_Ptr); + } + [[nodiscard]] bool IsInt() const + { + return yyjson_is_num(_Ptr); + } + [[nodiscard]] bool IsFloat() const + { + return yyjson_is_num(_Ptr); + } + [[nodiscard]] bool IsInt64() const + { + return yyjson_is_num(_Ptr); + } + [[nodiscard]] bool IsDouble() const + { + return yyjson_is_num(_Ptr); + } + [[nodiscard]] bool IsString() const + { + return yyjson_is_str(_Ptr); + } + [[nodiscard]] bool IsArray() const + { + return yyjson_is_arr(_Ptr); + } + [[nodiscard]] bool GetBool() const + { + return yyjson_get_bool(_Ptr); + } + [[nodiscard]] bool GetBoolean() const + { + return yyjson_get_bool(_Ptr); + } + [[nodiscard]] int GetInt() const + { + return yyjson_get_int(_Ptr); + } + [[nodiscard]] int64_t GetInt64() const + { + return yyjson_get_sint(_Ptr); + } + [[nodiscard]] float GetFloat() const + { + return float(yyjson_get_real(_Ptr)); + } + [[nodiscard]] double GetDouble() const + { + return yyjson_get_real(_Ptr); + } + [[nodiscard]] std::string GetString() const + { + if (const auto _str = yyjson_get_str(_Ptr)) + return _str; + return ""; + } + [[nodiscard]] std::vector GetArray() const + { + std::vector _ret; + if (!IsArray()) + return {}; + const auto _PArray = _Ptr; + size_t idx, max; + yyjson_val* _Object; + yyjson_arr_foreach(_PArray, idx, max, _Object) + _ret.emplace_back(_Object); + return _ret; + } + [[nodiscard]] size_t GetSize() const + { + return yyjson_get_len(_Ptr); + } + [[nodiscard]] size_t Size() const + { + return yyjson_get_len(_Ptr); + } + [[nodiscard]] size_t GetStringLength() const + { + return yyjson_get_len(_Ptr); + } + [[nodiscard]] MJsonValue Get(const std::string& _key) const + { + return yyjson_obj_get(_Ptr, _key.c_str()); + } + [[nodiscard]] MJsonValue operator[](const std::string& _key) const + { + return yyjson_obj_get(_Ptr, _key.c_str()); + } + [[nodiscard]] MJsonValue operator[](size_t _idx) const + { + if (!IsArray()) + return _Ptr; + const auto _max = yyjson_arr_size(_Ptr); + const auto _val = yyjson_arr_get_first(_Ptr); + return _idx < _max ? _val + _idx : _val + _max - 1; + } + [[nodiscard]] bool Empty() const + { + if (!IsArray() && !IsString()) + return true; + const auto _max = yyjson_arr_size(_Ptr); + return !_max; + } + [[nodiscard]] size_t GetMemberCount() const + { + return yyjson_obj_size(_Ptr); + } + [[nodiscard]] std::vector> GetMemberArray() const + { + std::vector> ret; + yyjson_val* key; + yyjson_obj_iter iter = yyjson_obj_iter_with(_Ptr); + while ((key = yyjson_obj_iter_next(&iter))) { + const auto val = yyjson_obj_iter_get_val(key); + ret.emplace_back(MJsonValue(key).GetString(), val); + } + return ret; + } +private: + yyjson_val* _Ptr = nullptr; +}; + +class MJson +{ +public: + MJson() = default; + MJson(const char* _path) + { + _document = yyjson_read_file(_path, YYJSON_READ_NOFLAG, nullptr, nullptr); + if (!_document) + throw std::exception("Json Parse Error !"); + root = yyjson_doc_get_root(_document); + } + ~MJson() + { + if(_document) + { + yyjson_doc_free(_document); + _document = nullptr; + root = nullptr; + } + } + MJson(MJson&& _Right) noexcept + { + _document = _Right._document; + _Right._document = nullptr; + root = yyjson_doc_get_root(_document); + } + MJson(const MJson& _Right) = delete; + MJson& operator=(MJson&& _Right) noexcept + { + if (_document) + yyjson_doc_free(_document); + _document = _Right._document; + _Right._document = nullptr; + root = yyjson_doc_get_root(_document); + return *this; + } + MJson& operator=(const MJson& _Right) = delete; + void Parse(const std::string& _str) + { + _document = yyjson_read(_str.c_str(), _str.length(), YYJSON_READ_NOFLAG); + if (!_document) + throw std::exception("Json Parse Error !"); + root = yyjson_doc_get_root(_document); + } + [[nodiscard]] bool HasMember(const std::string& _key) const + { + return yyjson_obj_get(root, _key.c_str()); + } + [[nodiscard]] MJsonValue Get(const std::string& _key) const + { + return yyjson_obj_get(root, _key.c_str()); + } + [[nodiscard]] MJsonValue operator[](const std::string& _key) const + { + return yyjson_obj_get(root, _key.c_str()); + } + [[nodiscard]] MJsonValue operator[](size_t _idx) const + { + if (MJsonValue(root).IsArray()) + return root; + const auto _max = yyjson_arr_size(root); + const auto _val = yyjson_arr_get_first(root); + return _idx < _max ? _val + _idx : _val + _max - 1; + } + [[nodiscard]] bool HasParseError() const + { + return _document == nullptr; + } + [[nodiscard]] bool IsNull() const + { + return yyjson_is_null(root); + } + [[nodiscard]] bool IsBoolean() const + { + return yyjson_is_bool(root); + } + [[nodiscard]] bool IsBool() const + { + return yyjson_is_bool(root); + } + [[nodiscard]] bool IsInt() const + { + return yyjson_is_num(root); + } + [[nodiscard]] bool IsFloat() const + { + return yyjson_is_num(root); + } + [[nodiscard]] bool IsInt64() const + { + return yyjson_is_num(root); + } + [[nodiscard]] bool IsDouble() const + { + return yyjson_is_num(root); + } + [[nodiscard]] bool IsString() const + { + return yyjson_is_str(root); + } + [[nodiscard]] bool IsArray() const + { + return yyjson_is_arr(root); + } + [[nodiscard]] bool GetBool() const + { + return yyjson_get_bool(root); + } + [[nodiscard]] bool GetBoolean() const + { + return yyjson_get_bool(root); + } + [[nodiscard]] int GetInt() const + { + return yyjson_get_int(root); + } + [[nodiscard]] int64_t GetInt64() const + { + return yyjson_get_sint(root); + } + [[nodiscard]] float GetFloat() const + { + return float(yyjson_get_real(root)); + } + [[nodiscard]] double GetDouble() const + { + return yyjson_get_real(root); + } + [[nodiscard]] std::string GetString() const + { + if (const auto _str = yyjson_get_str(root)) + return _str; + return ""; + } + [[nodiscard]] std::vector GetArray() const + { + std::vector _ret; + if (!IsArray()) + return {}; + const auto _PArray = root; + size_t idx, max; + yyjson_val* _Object; + yyjson_arr_foreach(_PArray, idx, max, _Object) + _ret.emplace_back(_Object); + return _ret; + } + [[nodiscard]] size_t GetSize() const + { + return yyjson_get_len(root); + } + [[nodiscard]] size_t Size() const + { + return yyjson_get_len(root); + } + [[nodiscard]] size_t GetStringLength() const + { + return yyjson_get_len(root); + } + [[nodiscard]] size_t GetMemberCount() const + { + return yyjson_obj_size(root); + } + [[nodiscard]] std::vector> GetMemberArray() const + { + std::vector> ret; + yyjson_val* key; + yyjson_obj_iter iter = yyjson_obj_iter_with(root); + while ((key = yyjson_obj_iter_next(&iter))) { + const auto val = yyjson_obj_iter_get_val(key); + ret.emplace_back(MJsonValue(key).GetString(), val); + } + return ret; + } +private: + yyjson_doc* _document = nullptr; + yyjson_val* root = nullptr; +}; \ No newline at end of file diff --git a/Lib/MJson/yyjson.c b/Lib/MJson/yyjson.c new file mode 100644 index 0000000..d04930d --- /dev/null +++ b/Lib/MJson/yyjson.c @@ -0,0 +1,9201 @@ +/*============================================================================== + * Created by Yaoyuan on 2019/3/9. + * Copyright (C) 2019 Yaoyuan . + * + * Released under the MIT License: + * https://github.com/ibireme/yyjson/blob/master/LICENSE + *============================================================================*/ + +#include "yyjson.h" +#include + + + +/*============================================================================== + * Compile Hint Begin + *============================================================================*/ + +/* warning suppress begin */ +#if defined(__clang__) +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +# pragma clang diagnostic ignored "-Wunused-parameter" +# pragma clang diagnostic ignored "-Wunused-label" +# pragma clang diagnostic ignored "-Wunused-macros" +#elif defined(__GNUC__) +# if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) +# pragma GCC diagnostic push +# endif +# pragma GCC diagnostic ignored "-Wunused-function" +# pragma GCC diagnostic ignored "-Wunused-parameter" +# pragma GCC diagnostic ignored "-Wunused-label" +# pragma GCC diagnostic ignored "-Wunused-macros" +#elif defined(_MSC_VER) +# pragma warning(push) +# pragma warning(disable:4100) /* unreferenced formal parameter */ +# pragma warning(disable:4102) /* unreferenced label */ +# pragma warning(disable:4127) /* conditional expression is constant */ +# pragma warning(disable:4706) /* assignment within conditional expression */ +#endif + + + +/*============================================================================== + * Version + *============================================================================*/ + +uint32_t yyjson_version(void) { + return YYJSON_VERSION_HEX; +} + + + +/*============================================================================== + * Flags + *============================================================================*/ + +/* gcc version check */ +#if defined(__GNUC__) +# if defined(__GNUC_MINOR__) && defined(__GNUC_PATCHLEVEL__) +# define yyjson_gcc_available(major, minor, patch) \ + ((__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__) \ + >= (major * 10000 + minor * 100 + patch)) +# elif defined(__GNUC_MINOR__) +# define yyjson_gcc_available(major, minor, patch) \ + ((__GNUC__ * 10000 + __GNUC_MINOR__ * 100) \ + >= (major * 10000 + minor * 100 + patch)) +# else +# define yyjson_gcc_available(major, minor, patch) \ + ((__GNUC__ * 10000) >= (major * 10000 + minor * 100 + patch)) +# endif +#else +# define yyjson_gcc_available(major, minor, patch) 0 +#endif + +/* real gcc check */ +#if !defined(__clang__) && !defined(__INTEL_COMPILER) && !defined(__ICC) && \ + defined(__GNUC__) && defined(__GNUC_MINOR__) +# define YYJSON_IS_REAL_GCC 1 +#else +# define YYJSON_IS_REAL_GCC 0 +#endif + +/* msvc intrinsic */ +#if YYJSON_MSC_VER >= 1400 +# include +# if defined(_M_AMD64) || defined(_M_ARM64) +# define MSC_HAS_BIT_SCAN_64 1 +# pragma intrinsic(_BitScanForward64) +# pragma intrinsic(_BitScanReverse64) +# else +# define MSC_HAS_BIT_SCAN_64 0 +# endif +# if defined(_M_AMD64) || defined(_M_ARM64) || \ + defined(_M_IX86) || defined(_M_ARM) +# define MSC_HAS_BIT_SCAN 1 +# pragma intrinsic(_BitScanForward) +# pragma intrinsic(_BitScanReverse) +# else +# define MSC_HAS_BIT_SCAN 0 +# endif +# if defined(_M_AMD64) +# define MSC_HAS_UMUL128 1 +# pragma intrinsic(_umul128) +# else +# define MSC_HAS_UMUL128 0 +# endif +#else +# define MSC_HAS_BIT_SCAN_64 0 +# define MSC_HAS_BIT_SCAN 0 +# define MSC_HAS_UMUL128 0 +#endif + +/* gcc builtin */ +#if yyjson_has_builtin(__builtin_clzll) || yyjson_gcc_available(3, 4, 0) +# define GCC_HAS_CLZLL 1 +#else +# define GCC_HAS_CLZLL 0 +#endif + +#if yyjson_has_builtin(__builtin_ctzll) || yyjson_gcc_available(3, 4, 0) +# define GCC_HAS_CTZLL 1 +#else +# define GCC_HAS_CTZLL 0 +#endif + +/* int128 type */ +#if defined(__SIZEOF_INT128__) && (__SIZEOF_INT128__ == 16) && \ + (defined(__GNUC__) || defined(__clang__) || defined(__INTEL_COMPILER)) +# define YYJSON_HAS_INT128 1 +#else +# define YYJSON_HAS_INT128 0 +#endif + +/* IEEE 754 floating-point binary representation */ +#if defined(__STDC_IEC_559__) || defined(__STDC_IEC_60559_BFP__) +# define YYJSON_HAS_IEEE_754 1 +#elif (FLT_RADIX == 2) && (DBL_MANT_DIG == 53) && (DBL_DIG == 15) && \ + (DBL_MIN_EXP == -1021) && (DBL_MAX_EXP == 1024) && \ + (DBL_MIN_10_EXP == -307) && (DBL_MAX_10_EXP == 308) +# define YYJSON_HAS_IEEE_754 1 +#else +# define YYJSON_HAS_IEEE_754 0 +#endif + +/* + Correct rounding in double number computations. + + On the x86 architecture, some compilers may use x87 FPU instructions for + floating-point arithmetic. The x87 FPU loads all floating point number as + 80-bit double-extended precision internally, then rounds the result to original + precision, which may produce inaccurate results. For a more detailed + explanation, see the paper: https://arxiv.org/abs/cs/0701192 + + Here are some examples of double precision calculation error: + + 2877.0 / 1e6 == 0.002877, but x87 returns 0.0028770000000000002 + 43683.0 * 1e21 == 4.3683e25, but x87 returns 4.3683000000000004e25 + + Here are some examples of compiler flags to generate x87 instructions on x86: + + clang -m32 -mno-sse + gcc/icc -m32 -mfpmath=387 + msvc /arch:SSE or /arch:IA32 + + If we are sure that there's no similar error described above, we can define the + YYJSON_DOUBLE_MATH_CORRECT as 1 to enable the fast path calculation. This is + not an accurate detection, it's just try to avoid the error at compile-time. + An accurate detection can be done at run-time: + + bool is_double_math_correct(void) { + volatile double r = 43683.0; + r *= 1e21; + return r == 4.3683e25; + } + + See also: utils.h in https://github.com/google/double-conversion/ + */ +#if !defined(FLT_EVAL_METHOD) && defined(__FLT_EVAL_METHOD__) +# define FLT_EVAL_METHOD __FLT_EVAL_METHOD__ +#endif + +#if defined(FLT_EVAL_METHOD) && FLT_EVAL_METHOD != 0 && FLT_EVAL_METHOD != 1 +# define YYJSON_DOUBLE_MATH_CORRECT 0 +#elif defined(i386) || defined(__i386) || defined(__i386__) || \ + defined(_X86_) || defined(__X86__) || defined(_M_IX86) || \ + defined(__I86__) || defined(__IA32__) || defined(__THW_INTEL) +# if (defined(_MSC_VER) && defined(_M_IX86_FP) && _M_IX86_FP == 2) || \ + (defined(__SSE2_MATH__) && __SSE2_MATH__) +# define YYJSON_DOUBLE_MATH_CORRECT 1 +# else +# define YYJSON_DOUBLE_MATH_CORRECT 0 +# endif +#elif defined(__mc68000__) || defined(__pnacl__) || defined(__native_client__) +# define YYJSON_DOUBLE_MATH_CORRECT 0 +#else +# define YYJSON_DOUBLE_MATH_CORRECT 1 +#endif + +/* endian */ +#if yyjson_has_include() +# include +#endif + +#if yyjson_has_include() +# include +#elif yyjson_has_include() +# include +#elif yyjson_has_include() +# include +#endif + +#define YYJSON_BIG_ENDIAN 4321 +#define YYJSON_LITTLE_ENDIAN 1234 + +#if defined(__BYTE_ORDER__) && __BYTE_ORDER__ +# if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__ +# define YYJSON_ENDIAN YYJSON_BIG_ENDIAN +# elif __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__ +# define YYJSON_ENDIAN YYJSON_LITTLE_ENDIAN +# endif + +#elif defined(__BYTE_ORDER) && __BYTE_ORDER +# if __BYTE_ORDER == __BIG_ENDIAN +# define YYJSON_ENDIAN YYJSON_BIG_ENDIAN +# elif __BYTE_ORDER == __LITTLE_ENDIAN +# define YYJSON_ENDIAN YYJSON_LITTLE_ENDIAN +# endif + +#elif defined(BYTE_ORDER) && BYTE_ORDER +# if BYTE_ORDER == BIG_ENDIAN +# define YYJSON_ENDIAN YYJSON_BIG_ENDIAN +# elif BYTE_ORDER == LITTLE_ENDIAN +# define YYJSON_ENDIAN YYJSON_LITTLE_ENDIAN +# endif + +#elif (defined(__LITTLE_ENDIAN__) && __LITTLE_ENDIAN__ == 1) || \ + defined(__i386) || defined(__i386__) || \ + defined(_X86_) || defined(__X86__) || \ + defined(_M_IX86) || defined(__THW_INTEL__) || \ + defined(__x86_64) || defined(__x86_64__) || \ + defined(__amd64) || defined(__amd64__) || \ + defined(_M_AMD64) || defined(_M_X64) || \ + defined(__ia64) || defined(_IA64) || defined(__IA64__) || \ + defined(__ia64__) || defined(_M_IA64) || defined(__itanium__) || \ + defined(__ARMEL__) || defined(__THUMBEL__) || defined(__AARCH64EL__) || \ + defined(__alpha) || defined(__alpha__) || defined(_M_ALPHA) || \ + defined(__riscv) || defined(__riscv__) || \ + defined(_MIPSEL) || defined(__MIPSEL) || defined(__MIPSEL__) || \ + defined(__EMSCRIPTEN__) || defined(__wasm__) || \ + defined(__loongarch__) +# define YYJSON_ENDIAN YYJSON_LITTLE_ENDIAN + +#elif (defined(__BIG_ENDIAN__) && __BIG_ENDIAN__ == 1) || \ + defined(__ARMEB__) || defined(__THUMBEB__) || defined(__AARCH64EB__) || \ + defined(_MIPSEB) || defined(__MIPSEB) || defined(__MIPSEB__) || \ + defined(_ARCH_PPC) || defined(_ARCH_PPC64) || \ + defined(__ppc) || defined(__ppc__) || \ + defined(__sparc) || defined(__sparc__) || defined(__sparc64__) || \ + defined(__or1k__) || defined(__OR1K__) +# define YYJSON_ENDIAN YYJSON_BIG_ENDIAN + +#else +# define YYJSON_ENDIAN 0 /* unknown endian, detect at run-time */ +#endif + +/* + Unaligned memory access detection. + + Some architectures cannot perform unaligned memory access, or unaligned memory + accesses can have a large performance penalty. Modern compilers can make some + optimizations for unaligned access. For example: https://godbolt.org/z/Ejo3Pa + + typedef struct { char c[2] } vec2; + void copy_vec2(vec2 *dst, vec2 *src) { + *dst = *src; + } + + Compiler may generate `load/store` or `move` instruction if target architecture + supports unaligned access, otherwise it may generate `call memcpy` instruction. + + We want to avoid `memcpy` calls, so we should disable unaligned access by + define `YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS` as 1 on these architectures. + */ +#ifndef YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS +# if defined(i386) || defined(__i386) || defined(__i386__) || \ + defined(__i486__) || defined(__i586__) || defined(__i686__) || \ + defined(_X86_) || defined(__X86__) || defined(_M_IX86) || \ + defined(__I86__) || defined(__IA32__) || \ + defined(__THW_INTEL) || defined(__THW_INTEL__) || \ + defined(__x86_64) || defined(__x86_64__) || \ + defined(__amd64) || defined(__amd64__) || \ + defined(_M_AMD64) || defined(_M_X64) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 0 /* x86 */ + +# elif defined(__ia64) || defined(_IA64) || defined(__IA64__) || \ + defined(__ia64__) || defined(_M_IA64) || defined(__itanium__) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 1 /* Itanium */ + +# elif defined(__arm64) || defined(__arm64__) || \ + defined(__AARCH64EL__) || defined(__AARCH64EB__) || \ + defined(__aarch64__) || defined(_M_ARM64) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 0 /* ARM64 */ + +# elif defined(__ARM_ARCH_4__) || defined(__ARM_ARCH_4T__) || \ + defined(__ARM_ARCH_5TEJ__) || defined(__ARM_ARCH_5TE__) || \ + defined(__ARM_ARCH_6T2__) || defined(__ARM_ARCH_6KZ__) || \ + defined(__ARM_ARCH_6Z__) || defined(__ARM_ARCH_6K__) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 1 /* ARM */ + +# elif defined(__ppc64__) || defined(__PPC64__) || \ + defined(__powerpc64__) || defined(_ARCH_PPC64) || \ + defined(__ppc) || defined(__ppc__) || defined(__PPC__) || \ + defined(__powerpc) || defined(__powerpc__) || defined(__POWERPC__) || \ + defined(_ARCH_PPC) || defined(_M_PPC) || \ + defined(__PPCGECKO__) || defined(__PPCBROADWAY__) || defined(_XENON) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 0 /* PowerPC */ + +# elif defined(__loongarch__) +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 0 /* loongarch */ + +# else +# define YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS 0 /* Unknown */ +# endif + +#endif + +/* + Estimated initial ratio of the JSON data (data_size / value_count). + For example: + + data: {"id":12345678,"name":"Harry"} + data_size: 30 + value_count: 5 + ratio: 6 + + yyjson uses dynamic memory with a growth factor of 1.5 when reading and writing + JSON, the ratios below are used to determine the initial memory size. + + A too large ratio will waste memory, and a too small ratio will cause multiple + memory growths and degrade performance. Currently, these ratios are generated + with some commonly used JSON datasets. + */ +#define YYJSON_READER_ESTIMATED_PRETTY_RATIO 16 +#define YYJSON_READER_ESTIMATED_MINIFY_RATIO 6 +#define YYJSON_WRITER_ESTIMATED_PRETTY_RATIO 32 +#define YYJSON_WRITER_ESTIMATED_MINIFY_RATIO 18 + +/* The initial and maximum size of the memory pool's chunk in yyjson_mut_doc. */ +#define YYJSON_MUT_DOC_STR_POOL_INIT_SIZE 0x100 +#define YYJSON_MUT_DOC_STR_POOL_MAX_SIZE 0x10000000 +#define YYJSON_MUT_DOC_VAL_POOL_INIT_SIZE (0x10 * sizeof(yyjson_mut_val)) +#define YYJSON_MUT_DOC_VAL_POOL_MAX_SIZE (0x1000000 * sizeof(yyjson_mut_val)) + +/* Default value for compile-time options. */ +#ifndef YYJSON_DISABLE_READER +#define YYJSON_DISABLE_READER 0 +#endif +#ifndef YYJSON_DISABLE_WRITER +#define YYJSON_DISABLE_WRITER 0 +#endif +#ifndef YYJSON_DISABLE_UTILS +#define YYJSON_DISABLE_UTILS 0 +#endif +#ifndef YYJSON_DISABLE_FAST_FP_CONV +#define YYJSON_DISABLE_FAST_FP_CONV 0 +#endif +#ifndef YYJSON_DISABLE_NON_STANDARD +#define YYJSON_DISABLE_NON_STANDARD 0 +#endif + + + +/*============================================================================== + * Macros + *============================================================================*/ + +/* Macros used for loop unrolling and other purpose. */ +#define repeat2(x) { x x } +#define repeat3(x) { x x x } +#define repeat4(x) { x x x x } +#define repeat8(x) { x x x x x x x x } +#define repeat16(x) { x x x x x x x x x x x x x x x x } + +#define repeat2_incr(x) { x(0) x(1) } +#define repeat4_incr(x) { x(0) x(1) x(2) x(3) } +#define repeat8_incr(x) { x(0) x(1) x(2) x(3) x(4) x(5) x(6) x(7) } +#define repeat16_incr(x) { x(0) x(1) x(2) x(3) x(4) x(5) x(6) x(7) \ + x(8) x(9) x(10) x(11) x(12) x(13) x(14) x(15) } +#define repeat_in_1_18(x) { x(1) x(2) x(3) x(4) x(5) x(6) x(7) \ + x(8) x(9) x(10) x(11) x(12) x(13) x(14) x(15) \ + x(16) x(17) x(18) } + +/* Macros used to provide branch prediction information for compiler. */ +#undef likely +#define likely(x) yyjson_likely(x) +#undef unlikely +#define unlikely(x) yyjson_unlikely(x) + +/* Macros used to provide inline information for compiler. */ +#undef static_inline +#define static_inline static yyjson_inline +#undef static_noinline +#define static_noinline static yyjson_noinline + +/* Macros for min and max. */ +#undef yyjson_min +#define yyjson_min(x, y) ((x) < (y) ? (x) : (y)) +#undef yyjson_max +#define yyjson_max(x, y) ((x) > (y) ? (x) : (y)) + +/* Used to write u64 literal for C89 which doesn't support "ULL" suffix. */ +#undef U64 +#define U64(hi, lo) ((((u64)hi##UL) << 32U) + lo##UL) + +/* Used to cast away (remove) const qualifier. */ +#define constcast(type) (type)(void *)(size_t)(const void *) + + + +/*============================================================================== + * Integer Constants + *============================================================================*/ + +/* U64 constant values */ +#undef U64_MAX +#define U64_MAX U64(0xFFFFFFFF, 0xFFFFFFFF) +#undef I64_MAX +#define I64_MAX U64(0x7FFFFFFF, 0xFFFFFFFF) +#undef USIZE_MAX +#define USIZE_MAX ((usize)(~(usize)0)) + +/* Maximum number of digits for reading u32/u64/usize safety (not overflow). */ +#undef U32_SAFE_DIG +#define U32_SAFE_DIG 9 /* u32 max is 4294967295, 10 digits */ +#undef U64_SAFE_DIG +#define U64_SAFE_DIG 19 /* u64 max is 18446744073709551615, 20 digits */ +#undef USIZE_SAFE_DIG +#define USIZE_SAFE_DIG (sizeof(usize) == 64 ? U64_SAFE_DIG : U32_SAFE_DIG) + + + +/*============================================================================== + * IEEE-754 Double Number Constants + *============================================================================*/ + +/* Inf raw value (positive) */ +#define F64_RAW_INF U64(0x7FF00000, 0x00000000) + +/* NaN raw value (quiet NaN, no payload, no sign) */ +#if defined(__hppa__) || (defined(__mips__) && !defined(__mips_nan2008)) +#define F64_RAW_NAN U64(0x7FF7FFFF, 0xFFFFFFFF) +#else +#define F64_RAW_NAN U64(0x7FF80000, 0x00000000) +#endif + +/* double number bits */ +#define F64_BITS 64 + +/* double number exponent part bits */ +#define F64_EXP_BITS 11 + +/* double number significand part bits */ +#define F64_SIG_BITS 52 + +/* double number significand part bits (with 1 hidden bit) */ +#define F64_SIG_FULL_BITS 53 + +/* double number significand bit mask */ +#define F64_SIG_MASK U64(0x000FFFFF, 0xFFFFFFFF) + +/* double number exponent bit mask */ +#define F64_EXP_MASK U64(0x7FF00000, 0x00000000) + +/* double number exponent bias */ +#define F64_EXP_BIAS 1023 + +/* double number significant digits count in decimal */ +#define F64_DEC_DIG 17 + +/* max significant digits count in decimal when reading double number */ +#define F64_MAX_DEC_DIG 768 + +/* maximum decimal power of double number (1.7976931348623157e308) */ +#define F64_MAX_DEC_EXP 308 + +/* minimum decimal power of double number (4.9406564584124654e-324) */ +#define F64_MIN_DEC_EXP (-324) + +/* maximum binary power of double number */ +#define F64_MAX_BIN_EXP 1024 + +/* minimum binary power of double number */ +#define F64_MIN_BIN_EXP (-1021) + + + +/*============================================================================== + * Types + *============================================================================*/ + +/** Type define for primitive types. */ +typedef float f32; +typedef double f64; +typedef int8_t i8; +typedef uint8_t u8; +typedef int16_t i16; +typedef uint16_t u16; +typedef int32_t i32; +typedef uint32_t u32; +typedef int64_t i64; +typedef uint64_t u64; +typedef size_t usize; + +/** 128-bit integer, used by floating-point number reader and writer. */ +#if YYJSON_HAS_INT128 +__extension__ typedef __int128 i128; +__extension__ typedef unsigned __int128 u128; +#endif + +/** 16/32/64-bit vector */ +typedef struct v16 { char c1, c2; } v16; +typedef struct v32 { char c1, c2, c3, c4; } v32; +typedef struct v64 { char c1, c2, c3, c4, c5, c6, c7, c8; } v64; + +/** 16/32/64-bit vector union, used for unaligned memory access on modern CPU */ +typedef union v16_uni { v16 v; u16 u; } v16_uni; +typedef union v32_uni { v32 v; u32 u; } v32_uni; +typedef union v64_uni { v64 v; u64 u; } v64_uni; + + + +/*============================================================================== + * Load/Store Utils + *============================================================================*/ + +#define byte_move_idx(x) ((u8 *)dst)[x] = ((u8 *)src)[x]; + +static_inline void byte_move_2(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat2_incr(byte_move_idx) +#else + memmove(dst, src, 2); +#endif +} + +static_inline void byte_move_4(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat4_incr(byte_move_idx) +#else + memmove(dst, src, 4); +#endif +} + +static_inline void byte_move_8(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat8_incr(byte_move_idx) +#else + memmove(dst, src, 8); +#endif +} + +static_inline void byte_move_16(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat16_incr(byte_move_idx) +#else + memmove(dst, src, 16); +#endif +} + +static_inline void byte_copy_2(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat2_incr(byte_move_idx) +#else + memcpy(dst, src, 2); +#endif +} + +static_inline void byte_copy_4(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat4_incr(byte_move_idx) +#else + memcpy(dst, src, 4); +#endif +} + +static_inline void byte_copy_8(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat8_incr(byte_move_idx) +#else + memcpy(dst, src, 8); +#endif +} + +static_inline void byte_copy_16(void *dst, const void *src) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + repeat16_incr(byte_move_idx) +#else + memcpy(dst, src, 16); +#endif +} + +static_inline bool byte_match_2(void *buf, const char *pat) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + return + ((u8 *)buf)[0] == ((const u8 *)pat)[0] && + ((u8 *)buf)[1] == ((const u8 *)pat)[1]; +#else + v16_uni u1, u2; + u1.v = *(const v16 *)pat; + u2.v = *(const v16 *)buf; + return u1.u == u2.u; +#endif +} + +static_inline bool byte_match_4(void *buf, const char *pat) { +#if YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS + return + ((u8 *)buf)[0] == ((const u8 *)pat)[0] && + ((u8 *)buf)[1] == ((const u8 *)pat)[1] && + ((u8 *)buf)[2] == ((const u8 *)pat)[2] && + ((u8 *)buf)[3] == ((const u8 *)pat)[3]; +#else + v32_uni u1, u2; + u1.v = *(const v32 *)pat; + u2.v = *(const v32 *)buf; + return u1.u == u2.u; +#endif +} + +static_inline u16 byte_load_2(const void *src) { + v16_uni uni; + uni.v = *(const v16 *)src; + return uni.u; +} + +static_inline u32 byte_load_3(const void *src) { + v32_uni uni; + ((v16_uni *)&uni)->v = *(const v16 *)src; + uni.v.c3 = ((const char *)src)[2]; + uni.v.c4 = 0; + return uni.u; +} + +static_inline u32 byte_load_4(const void *src) { + v32_uni uni; + uni.v = *(const v32 *)src; + return uni.u; +} + +#undef byte_move_expr + + + +/*============================================================================== + * Number Utils + * These functions are used to detect and convert NaN and Inf numbers. + *============================================================================*/ + +/** + This union is used to avoid violating the strict aliasing rule in C. + `memcpy` can be used in both C and C++, but it may reduce performance without + compiler optimization. + */ +typedef union { u64 u; f64 f; } f64_uni; + +/** Convert raw binary to double. */ +static_inline f64 f64_from_raw(u64 u) { +#ifndef __cplusplus + f64_uni uni; + uni.u = u; + return uni.f; +#else + f64 f; + memcpy(&f, &u, 8); + return f; +#endif +} + +/** Convert double to raw binary. */ +static_inline u64 f64_to_raw(f64 f) { +#ifndef __cplusplus + f64_uni uni; + uni.f = f; + return uni.u; +#else + u64 u; + memcpy(&u, &f, 8); + return u; +#endif +} + +/** Get raw 'infinity' with sign. */ +static_inline u64 f64_raw_get_inf(bool sign) { +#if YYJSON_HAS_IEEE_754 + return F64_RAW_INF | ((u64)sign << 63); +#elif defined(INFINITY) + return f64_to_raw(sign ? -INFINITY : INFINITY); +#else + return f64_to_raw(sign ? -HUGE_VAL : HUGE_VAL); +#endif +} + +/** Get raw 'nan' with sign. */ +static_inline u64 f64_raw_get_nan(bool sign) { +#if YYJSON_HAS_IEEE_754 + return F64_RAW_NAN | ((u64)sign << 63); +#elif defined(NAN) + return f64_to_raw(sign ? (f64)-NAN : (f64)NAN); +#else + return f64_to_raw((sign ? -0.0 : 0.0) / 0.0); +#endif +} + +/** + Convert normalized u64 (highest bit is 1) to f64. + + Some compiler (such as Microsoft Visual C++ 6.0) do not support converting + number from u64 to f64. This function will first convert u64 to i64 and then + to f64, with `to nearest` rounding mode. + */ +static_inline f64 normalized_u64_to_f64(u64 val) { +#if YYJSON_U64_TO_F64_NO_IMPL + i64 sig = (i64)((val >> 1) | (val & 1)); + return ((f64)sig) * (f64)2.0; +#else + return (f64)val; +#endif +} + + + +/*============================================================================== + * Size Utils + * These functions are used for memory allocation. + *============================================================================*/ + +/** Returns whether the size is overflow after increment. */ +static_inline bool size_add_is_overflow(usize size, usize add) { + return size > (size + add); +} + +/** Returns whether the size is power of 2 (size should not be 0). */ +static_inline bool size_is_pow2(usize size) { + return (size & (size - 1)) == 0; +} + +/** Align size upwards (may overflow). */ +static_inline usize size_align_up(usize size, usize align) { + if (size_is_pow2(align)) { + return (size + (align - 1)) & ~(align - 1); + } else { + return size + align - (size + align - 1) % align - 1; + } +} + +/** Align size downwards. */ +static_inline usize size_align_down(usize size, usize align) { + if (size_is_pow2(align)) { + return size & ~(align - 1); + } else { + return size - (size % align); + } +} + +/** Align address upwards (may overflow). */ +static_inline void *mem_align_up(void *mem, usize align) { + usize size; + memcpy(&size, &mem, sizeof(usize)); + size = size_align_up(size, align); + memcpy(&mem, &size, sizeof(usize)); + return mem; +} + + + +/*============================================================================== + * Bits Utils + * These functions are used by the floating-point number reader and writer. + *============================================================================*/ + +/** Returns the number of leading 0-bits in value (input should not be 0). */ +static_inline u32 u64_lz_bits(u64 v) { +#if GCC_HAS_CLZLL + return (u32)__builtin_clzll(v); +#elif MSC_HAS_BIT_SCAN_64 + unsigned long r; + _BitScanReverse64(&r, v); + return (u32)63 - (u32)r; +#elif MSC_HAS_BIT_SCAN + unsigned long hi, lo; + bool hi_set = _BitScanReverse(&hi, (u32)(v >> 32)) != 0; + _BitScanReverse(&lo, (u32)v); + hi |= 32; + return (u32)63 - (u32)(hi_set ? hi : lo); +#else + /* + branchless, use de Bruijn sequences + see: https://www.chessprogramming.org/BitScan + */ + const u8 table[64] = { + 63, 16, 62, 7, 15, 36, 61, 3, 6, 14, 22, 26, 35, 47, 60, 2, + 9, 5, 28, 11, 13, 21, 42, 19, 25, 31, 34, 40, 46, 52, 59, 1, + 17, 8, 37, 4, 23, 27, 48, 10, 29, 12, 43, 20, 32, 41, 53, 18, + 38, 24, 49, 30, 44, 33, 54, 39, 50, 45, 55, 51, 56, 57, 58, 0 + }; + v |= v >> 1; + v |= v >> 2; + v |= v >> 4; + v |= v >> 8; + v |= v >> 16; + v |= v >> 32; + return table[(v * U64(0x03F79D71, 0xB4CB0A89)) >> 58]; +#endif +} + +/** Returns the number of trailing 0-bits in value (input should not be 0). */ +static_inline u32 u64_tz_bits(u64 v) { +#if GCC_HAS_CTZLL + return (u32)__builtin_ctzll(v); +#elif MSC_HAS_BIT_SCAN_64 + unsigned long r; + _BitScanForward64(&r, v); + return (u32)r; +#elif MSC_HAS_BIT_SCAN + unsigned long lo, hi; + bool lo_set = _BitScanForward(&lo, (u32)(v)) != 0; + _BitScanForward(&hi, (u32)(v >> 32)); + hi += 32; + return lo_set ? lo : hi; +#else + /* + branchless, use de Bruijn sequences + see: https://www.chessprogramming.org/BitScan + */ + const u8 table[64] = { + 0, 1, 2, 53, 3, 7, 54, 27, 4, 38, 41, 8, 34, 55, 48, 28, + 62, 5, 39, 46, 44, 42, 22, 9, 24, 35, 59, 56, 49, 18, 29, 11, + 63, 52, 6, 26, 37, 40, 33, 47, 61, 45, 43, 21, 23, 58, 17, 10, + 51, 25, 36, 32, 60, 20, 57, 16, 50, 31, 19, 15, 30, 14, 13, 12 + }; + return table[((v & (~v + 1)) * U64(0x022FDD63, 0xCC95386D)) >> 58]; +#endif +} + + + +/*============================================================================== + * 128-bit Integer Utils + * These functions are used by the floating-point number reader and writer. + *============================================================================*/ + +/** Multiplies two 64-bit unsigned integers (a * b), + returns the 128-bit result as 'hi' and 'lo'. */ +static_inline void u128_mul(u64 a, u64 b, u64 *hi, u64 *lo) { +#if YYJSON_HAS_INT128 + u128 m = (u128)a * b; + *hi = (u64)(m >> 64); + *lo = (u64)(m); +#elif MSC_HAS_UMUL128 + *lo = _umul128(a, b, hi); +#else + u32 a0 = (u32)(a), a1 = (u32)(a >> 32); + u32 b0 = (u32)(b), b1 = (u32)(b >> 32); + u64 p00 = (u64)a0 * b0, p01 = (u64)a0 * b1; + u64 p10 = (u64)a1 * b0, p11 = (u64)a1 * b1; + u64 m0 = p01 + (p00 >> 32); + u32 m00 = (u32)(m0), m01 = (u32)(m0 >> 32); + u64 m1 = p10 + m00; + u32 m10 = (u32)(m1), m11 = (u32)(m1 >> 32); + *hi = p11 + m01 + m11; + *lo = ((u64)m10 << 32) | (u32)p00; +#endif +} + +/** Multiplies two 64-bit unsigned integers and add a value (a * b + c), + returns the 128-bit result as 'hi' and 'lo'. */ +static_inline void u128_mul_add(u64 a, u64 b, u64 c, u64 *hi, u64 *lo) { +#if YYJSON_HAS_INT128 + u128 m = (u128)a * b + c; + *hi = (u64)(m >> 64); + *lo = (u64)(m); +#else + u64 h, l, t; + u128_mul(a, b, &h, &l); + t = l + c; + h += (u64)(((t < l) | (t < c))); + *hi = h; + *lo = t; +#endif +} + + + +/*============================================================================== + * File Utils + * These functions are used to read and write JSON files. + *============================================================================*/ + +#define YYJSON_FOPEN_EXT +#if !defined(_MSC_VER) && defined(__GLIBC__) && defined(__GLIBC_PREREQ) +# if __GLIBC_PREREQ(2, 7) +# undef YYJSON_FOPEN_EXT +# define YYJSON_FOPEN_EXT "e" /* glibc extension to enable O_CLOEXEC */ +# endif +#endif + +static_inline FILE *fopen_safe(const char *path, const char *mode) { +#if YYJSON_MSC_VER >= 1400 + FILE *file = NULL; + if (fopen_s(&file, path, mode) != 0) return NULL; + return file; +#else + return fopen(path, mode); +#endif +} + +static_inline FILE *fopen_readonly(const char *path) { + return fopen_safe(path, "rb" YYJSON_FOPEN_EXT); +} + +static_inline FILE *fopen_writeonly(const char *path) { + return fopen_safe(path, "wb" YYJSON_FOPEN_EXT); +} + +static_inline usize fread_safe(void *buf, usize size, FILE *file) { +#if YYJSON_MSC_VER >= 1400 + return fread_s(buf, size, 1, size, file); +#else + return fread(buf, 1, size, file); +#endif +} + + + +/*============================================================================== + * Default Memory Allocator + * This is a simple libc memory allocator wrapper. + *============================================================================*/ + +static void *default_malloc(void *ctx, usize size) { + return malloc(size); +} + +static void *default_realloc(void *ctx, void *ptr, usize old_size, usize size) { + return realloc(ptr, size); +} + +static void default_free(void *ctx, void *ptr) { + free(ptr); +} + +static const yyjson_alc YYJSON_DEFAULT_ALC = { + default_malloc, + default_realloc, + default_free, + NULL +}; + +static void *null_malloc(void *ctx, usize size) { + return NULL; +} + +static void *null_realloc(void *ctx, void *ptr, usize old_size, usize size) { + return NULL; +} + +static void null_free(void *ctx, void *ptr) { + return; +} + +static const yyjson_alc YYJSON_NULL_ALC = { + null_malloc, + null_realloc, + null_free, + NULL +}; + + + +/*============================================================================== + * Pool Memory Allocator + * This is a simple memory allocator that uses linked list memory chunk. + * The following code will be executed only when the library user creates + * this allocator manually. + *============================================================================*/ + +/** chunk header */ +typedef struct pool_chunk { + usize size; /* chunk memory size (include chunk header) */ + struct pool_chunk *next; +} pool_chunk; + +/** ctx header */ +typedef struct pool_ctx { + usize size; /* total memory size (include ctx header) */ + pool_chunk *free_list; +} pool_ctx; + +static void *pool_malloc(void *ctx_ptr, usize size) { + pool_ctx *ctx = (pool_ctx *)ctx_ptr; + pool_chunk *next, *prev = NULL, *cur = ctx->free_list; + + if (unlikely(size == 0 || size >= ctx->size)) return NULL; + size = size_align_up(size, sizeof(pool_chunk)) + sizeof(pool_chunk); + + while (cur) { + if (cur->size < size) { + /* not enough space, try next chunk */ + prev = cur; + cur = cur->next; + continue; + } + if (cur->size >= size + sizeof(pool_chunk) * 2) { + /* too much space, split this chunk */ + next = (pool_chunk *)(void *)((u8 *)cur + size); + next->size = cur->size - size; + next->next = cur->next; + cur->size = size; + } else { + /* just enough space, use whole chunk */ + next = cur->next; + } + if (prev) prev->next = next; + else ctx->free_list = next; + return (void *)(cur + 1); + } + return NULL; +} + +static void pool_free(void *ctx_ptr, void *ptr) { + pool_ctx *ctx = (pool_ctx *)ctx_ptr; + pool_chunk *cur = ((pool_chunk *)ptr) - 1; + pool_chunk *prev = NULL, *next = ctx->free_list; + + while (next && next < cur) { + prev = next; + next = next->next; + } + if (prev) prev->next = cur; + else ctx->free_list = cur; + cur->next = next; + + if (next && ((u8 *)cur + cur->size) == (u8 *)next) { + /* merge cur to higher chunk */ + cur->size += next->size; + cur->next = next->next; + } + if (prev && ((u8 *)prev + prev->size) == (u8 *)cur) { + /* merge cur to lower chunk */ + prev->size += cur->size; + prev->next = cur->next; + } +} + +static void *pool_realloc(void *ctx_ptr, void *ptr, + usize old_size, usize size) { + pool_ctx *ctx = (pool_ctx *)ctx_ptr; + pool_chunk *cur = ((pool_chunk *)ptr) - 1, *prev, *next, *tmp; + usize free_size; + void *new_ptr; + + if (unlikely(size == 0 || size >= ctx->size)) return NULL; + size = size_align_up(size, sizeof(pool_chunk)) + sizeof(pool_chunk); + + /* reduce size */ + if (unlikely(size <= cur->size)) { + free_size = cur->size - size; + if (free_size >= sizeof(pool_chunk) * 2) { + tmp = (pool_chunk *)(void *)((u8 *)cur + cur->size - free_size); + tmp->size = free_size; + pool_free(ctx_ptr, (void *)(tmp + 1)); + cur->size -= free_size; + } + return ptr; + } + + /* find next and prev chunk */ + prev = NULL; + next = ctx->free_list; + while (next && next < cur) { + prev = next; + next = next->next; + } + + /* merge to higher chunk if they are contiguous */ + if ((u8 *)cur + cur->size == (u8 *)next && + cur->size + next->size >= size) { + free_size = cur->size + next->size - size; + if (free_size > sizeof(pool_chunk) * 2) { + tmp = (pool_chunk *)(void *)((u8 *)cur + size); + if (prev) prev->next = tmp; + else ctx->free_list = tmp; + tmp->next = next->next; + tmp->size = free_size; + cur->size = size; + } else { + if (prev) prev->next = next->next; + else ctx->free_list = next->next; + cur->size += next->size; + } + return ptr; + } + + /* fallback to malloc and memcpy */ + new_ptr = pool_malloc(ctx_ptr, size - sizeof(pool_chunk)); + if (new_ptr) { + memcpy(new_ptr, ptr, cur->size - sizeof(pool_chunk)); + pool_free(ctx_ptr, ptr); + } + return new_ptr; +} + +bool yyjson_alc_pool_init(yyjson_alc *alc, void *buf, usize size) { + pool_chunk *chunk; + pool_ctx *ctx; + + if (unlikely(!alc)) return false; + *alc = YYJSON_NULL_ALC; + if (size < sizeof(pool_ctx) * 4) return false; + ctx = (pool_ctx *)mem_align_up(buf, sizeof(pool_ctx)); + if (unlikely(!ctx)) return false; + size -= (usize)((u8 *)ctx - (u8 *)buf); + size = size_align_down(size, sizeof(pool_ctx)); + + chunk = (pool_chunk *)(ctx + 1); + chunk->size = size - sizeof(pool_ctx); + chunk->next = NULL; + ctx->size = size; + ctx->free_list = chunk; + + alc->malloc = pool_malloc; + alc->realloc = pool_realloc; + alc->free = pool_free; + alc->ctx = (void *)ctx; + return true; +} + + + +/*============================================================================== + * JSON document and value + *============================================================================*/ + +static_inline void unsafe_yyjson_str_pool_release(yyjson_str_pool *pool, + yyjson_alc *alc) { + yyjson_str_chunk *chunk = pool->chunks, *next; + while (chunk) { + next = chunk->next; + alc->free(alc->ctx, chunk); + chunk = next; + } +} + +static_inline void unsafe_yyjson_val_pool_release(yyjson_val_pool *pool, + yyjson_alc *alc) { + yyjson_val_chunk *chunk = pool->chunks, *next; + while (chunk) { + next = chunk->next; + alc->free(alc->ctx, chunk); + chunk = next; + } +} + +bool unsafe_yyjson_str_pool_grow(yyjson_str_pool *pool, + const yyjson_alc *alc, usize len) { + yyjson_str_chunk *chunk; + usize size, max_len; + + /* create a new chunk */ + max_len = USIZE_MAX - sizeof(yyjson_str_chunk); + if (unlikely(len > max_len)) return false; + size = len + sizeof(yyjson_str_chunk); + size = yyjson_max(pool->chunk_size, size); + chunk = (yyjson_str_chunk *)alc->malloc(alc->ctx, size); + if (unlikely(!chunk)) return false; + + /* insert the new chunk as the head of the linked list */ + chunk->next = pool->chunks; + chunk->chunk_size = size; + pool->chunks = chunk; + pool->cur = (char *)chunk + sizeof(yyjson_str_chunk); + pool->end = (char *)chunk + size; + + /* the next chunk is twice the size of the current one */ + size = yyjson_min(pool->chunk_size * 2, pool->chunk_size_max); + if (size < pool->chunk_size) size = pool->chunk_size_max; /* overflow */ + pool->chunk_size = size; + return true; +} + +bool unsafe_yyjson_val_pool_grow(yyjson_val_pool *pool, + const yyjson_alc *alc, usize count) { + yyjson_val_chunk *chunk; + usize size, max_count; + + /* create a new chunk */ + max_count = USIZE_MAX / sizeof(yyjson_mut_val) - 1; + if (unlikely(count > max_count)) return false; + size = (count + 1) * sizeof(yyjson_mut_val); + size = yyjson_max(pool->chunk_size, size); + chunk = (yyjson_val_chunk *)alc->malloc(alc->ctx, size); + if (unlikely(!chunk)) return false; + + /* insert the new chunk as the head of the linked list */ + chunk->next = pool->chunks; + chunk->chunk_size = size; + pool->chunks = chunk; + pool->cur = (yyjson_mut_val *)(void *)((u8 *)chunk) + 1; + pool->end = (yyjson_mut_val *)(void *)((u8 *)chunk + size); + + /* the next chunk is twice the size of the current one */ + size = yyjson_min(pool->chunk_size * 2, pool->chunk_size_max); + if (size < pool->chunk_size) size = pool->chunk_size_max; /* overflow */ + pool->chunk_size = size; + return true; +} + +bool yyjson_mut_doc_set_str_pool_size(yyjson_mut_doc *doc, size_t len) { + usize max_size = USIZE_MAX - sizeof(yyjson_str_chunk); + if (!doc || !len || len > max_size) return false; + doc->str_pool.chunk_size = len + sizeof(yyjson_str_chunk); + return true; +} + +bool yyjson_mut_doc_set_val_pool_size(yyjson_mut_doc *doc, size_t count) { + usize max_count = USIZE_MAX / sizeof(yyjson_mut_val) - 1; + if (!doc || !count || count > max_count) return false; + doc->val_pool.chunk_size = (count + 1) * sizeof(yyjson_mut_val); + return true; +} + +void yyjson_mut_doc_free(yyjson_mut_doc *doc) { + if (doc) { + yyjson_alc alc = doc->alc; + unsafe_yyjson_str_pool_release(&doc->str_pool, &alc); + unsafe_yyjson_val_pool_release(&doc->val_pool, &alc); + alc.free(alc.ctx, doc); + } +} + +yyjson_mut_doc *yyjson_mut_doc_new(const yyjson_alc *alc) { + yyjson_mut_doc *doc; + if (!alc) alc = &YYJSON_DEFAULT_ALC; + doc = (yyjson_mut_doc *)alc->malloc(alc->ctx, sizeof(yyjson_mut_doc)); + if (!doc) return NULL; + memset(doc, 0, sizeof(yyjson_mut_doc)); + + doc->alc = *alc; + doc->str_pool.chunk_size = YYJSON_MUT_DOC_STR_POOL_INIT_SIZE; + doc->str_pool.chunk_size_max = YYJSON_MUT_DOC_STR_POOL_MAX_SIZE; + doc->val_pool.chunk_size = YYJSON_MUT_DOC_VAL_POOL_INIT_SIZE; + doc->val_pool.chunk_size_max = YYJSON_MUT_DOC_VAL_POOL_MAX_SIZE; + return doc; +} + +yyjson_mut_doc *yyjson_doc_mut_copy(yyjson_doc *doc, const yyjson_alc *alc) { + yyjson_mut_doc *m_doc; + yyjson_mut_val *m_val; + + if (!doc || !doc->root) return NULL; + m_doc = yyjson_mut_doc_new(alc); + if (!m_doc) return NULL; + m_val = yyjson_val_mut_copy(m_doc, doc->root); + if (!m_val) { + yyjson_mut_doc_free(m_doc); + return NULL; + } + yyjson_mut_doc_set_root(m_doc, m_val); + return m_doc; +} + +yyjson_mut_doc *yyjson_mut_doc_mut_copy(yyjson_mut_doc *doc, + const yyjson_alc *alc) { + yyjson_mut_doc *m_doc; + yyjson_mut_val *m_val; + + if (!doc) return NULL; + if (!doc->root) return yyjson_mut_doc_new(alc); + + m_doc = yyjson_mut_doc_new(alc); + if (!m_doc) return NULL; + m_val = yyjson_mut_val_mut_copy(m_doc, doc->root); + if (!m_val) { + yyjson_mut_doc_free(m_doc); + return NULL; + } + yyjson_mut_doc_set_root(m_doc, m_val); + return m_doc; +} + +yyjson_mut_val *yyjson_val_mut_copy(yyjson_mut_doc *m_doc, + yyjson_val *i_vals) { + /* + The immutable object or array stores all sub-values in a contiguous memory, + We copy them to another contiguous memory as mutable values, + then reconnect the mutable values with the original relationship. + */ + + usize i_vals_len; + yyjson_mut_val *m_vals, *m_val; + yyjson_val *i_val, *i_end; + + if (!m_doc || !i_vals) return NULL; + i_end = unsafe_yyjson_get_next(i_vals); + i_vals_len = (usize)(unsafe_yyjson_get_next(i_vals) - i_vals); + m_vals = unsafe_yyjson_mut_val(m_doc, i_vals_len); + if (!m_vals) return NULL; + i_val = i_vals; + m_val = m_vals; + + for (; i_val < i_end; i_val++, m_val++) { + yyjson_type type = unsafe_yyjson_get_type(i_val); + m_val->tag = i_val->tag; + m_val->uni.u64 = i_val->uni.u64; + if (type == YYJSON_TYPE_STR || type == YYJSON_TYPE_RAW) { + const char *str = i_val->uni.str; + usize str_len = unsafe_yyjson_get_len(i_val); + m_val->uni.str = unsafe_yyjson_mut_strncpy(m_doc, str, str_len); + if (!m_val->uni.str) return NULL; + } else if (type == YYJSON_TYPE_ARR) { + usize len = unsafe_yyjson_get_len(i_val); + if (len > 0) { + yyjson_val *ii_val = i_val + 1, *ii_next; + yyjson_mut_val *mm_val = m_val + 1, *mm_ctn = m_val, *mm_next; + while (len-- > 1) { + ii_next = unsafe_yyjson_get_next(ii_val); + mm_next = mm_val + (ii_next - ii_val); + mm_val->next = mm_next; + ii_val = ii_next; + mm_val = mm_next; + } + mm_val->next = mm_ctn + 1; + mm_ctn->uni.ptr = mm_val; + } + } else if (type == YYJSON_TYPE_OBJ) { + usize len = unsafe_yyjson_get_len(i_val); + if (len > 0) { + yyjson_val *ii_key = i_val + 1, *ii_nextkey; + yyjson_mut_val *mm_key = m_val + 1, *mm_ctn = m_val; + yyjson_mut_val *mm_nextkey; + while (len-- > 1) { + ii_nextkey = unsafe_yyjson_get_next(ii_key + 1); + mm_nextkey = mm_key + (ii_nextkey - ii_key); + mm_key->next = mm_key + 1; + mm_key->next->next = mm_nextkey; + ii_key = ii_nextkey; + mm_key = mm_nextkey; + } + mm_key->next = mm_key + 1; + mm_key->next->next = mm_ctn + 1; + mm_ctn->uni.ptr = mm_key; + } + } + } + + return m_vals; +} + +static yyjson_mut_val *unsafe_yyjson_mut_val_mut_copy(yyjson_mut_doc *m_doc, + yyjson_mut_val *m_vals) { + /* + The mutable object or array stores all sub-values in a circular linked + list, so we can traverse them in the same loop. The traversal starts from + the last item, continues with the first item in a list, and ends with the + second to last item, which needs to be linked to the last item to close the + circle. + */ + + yyjson_mut_val *m_val = unsafe_yyjson_mut_val(m_doc, 1); + if (unlikely(!m_val)) return NULL; + m_val->tag = m_vals->tag; + + switch (unsafe_yyjson_get_type(m_vals)) { + case YYJSON_TYPE_OBJ: + case YYJSON_TYPE_ARR: + if (unsafe_yyjson_get_len(m_vals) > 0) { + yyjson_mut_val *last = (yyjson_mut_val *)m_vals->uni.ptr; + yyjson_mut_val *next = last->next, *prev; + prev = unsafe_yyjson_mut_val_mut_copy(m_doc, last); + if (!prev) return NULL; + m_val->uni.ptr = (void *)prev; + while (next != last) { + prev->next = unsafe_yyjson_mut_val_mut_copy(m_doc, next); + if (!prev->next) return NULL; + prev = prev->next; + next = next->next; + } + prev->next = (yyjson_mut_val *)m_val->uni.ptr; + } + break; + + case YYJSON_TYPE_RAW: + case YYJSON_TYPE_STR: { + const char *str = m_vals->uni.str; + usize str_len = unsafe_yyjson_get_len(m_vals); + m_val->uni.str = unsafe_yyjson_mut_strncpy(m_doc, str, str_len); + if (!m_val->uni.str) return NULL; + break; + } + + default: + m_val->uni = m_vals->uni; + break; + } + + return m_val; +} + +yyjson_mut_val *yyjson_mut_val_mut_copy(yyjson_mut_doc *doc, + yyjson_mut_val *val) { + if (doc && val) return unsafe_yyjson_mut_val_mut_copy(doc, val); + return NULL; +} + +/* Count the number of values and the total length of the strings. */ +static void yyjson_mut_stat(yyjson_mut_val *val, + usize *val_sum, usize *str_sum) { + yyjson_type type = unsafe_yyjson_get_type(val); + *val_sum += 1; + if (type == YYJSON_TYPE_ARR || type == YYJSON_TYPE_OBJ) { + yyjson_mut_val *child = (yyjson_mut_val *)val->uni.ptr; + usize len = unsafe_yyjson_get_len(val), i; + len <<= (u8)(type == YYJSON_TYPE_OBJ); + *val_sum += len; + for (i = 0; i < len; i++) { + yyjson_type stype = unsafe_yyjson_get_type(child); + if (stype == YYJSON_TYPE_STR || stype == YYJSON_TYPE_RAW) { + *str_sum += unsafe_yyjson_get_len(child) + 1; + } else if (stype == YYJSON_TYPE_ARR || stype == YYJSON_TYPE_OBJ) { + yyjson_mut_stat(child, val_sum, str_sum); + *val_sum -= 1; + } + child = child->next; + } + } else if (type == YYJSON_TYPE_STR || type == YYJSON_TYPE_RAW) { + *str_sum += unsafe_yyjson_get_len(val) + 1; + } +} + +/* Copy mutable values to immutable value pool. */ +static usize yyjson_imut_copy(yyjson_val **val_ptr, char **buf_ptr, + yyjson_mut_val *mval) { + yyjson_val *val = *val_ptr; + yyjson_type type = unsafe_yyjson_get_type(mval); + if (type == YYJSON_TYPE_ARR || type == YYJSON_TYPE_OBJ) { + yyjson_mut_val *child = (yyjson_mut_val *)mval->uni.ptr; + usize len = unsafe_yyjson_get_len(mval), i; + usize val_sum = 1; + if (type == YYJSON_TYPE_OBJ) { + if (len) child = child->next->next; + len <<= 1; + } else { + if (len) child = child->next; + } + *val_ptr = val + 1; + for (i = 0; i < len; i++) { + val_sum += yyjson_imut_copy(val_ptr, buf_ptr, child); + child = child->next; + } + val->tag = mval->tag; + val->uni.ofs = val_sum * sizeof(yyjson_val); + return val_sum; + } else if (type == YYJSON_TYPE_STR || type == YYJSON_TYPE_RAW) { + char *buf = *buf_ptr; + usize len = unsafe_yyjson_get_len(mval); + memcpy((void *)buf, (const void *)mval->uni.str, len); + buf[len] = '\0'; + val->tag = mval->tag; + val->uni.str = buf; + *val_ptr = val + 1; + *buf_ptr = buf + len + 1; + return 1; + } else { + val->tag = mval->tag; + val->uni = mval->uni; + *val_ptr = val + 1; + return 1; + } +} + +yyjson_doc *yyjson_mut_doc_imut_copy(yyjson_mut_doc *mdoc, + const yyjson_alc *alc) { + if (!mdoc) return NULL; + return yyjson_mut_val_imut_copy(mdoc->root, alc); +} + +yyjson_doc *yyjson_mut_val_imut_copy(yyjson_mut_val *mval, + const yyjson_alc *alc) { + usize val_num = 0, str_sum = 0, hdr_size, buf_size; + yyjson_doc *doc = NULL; + yyjson_val *val_hdr = NULL; + + /* This value should be NULL here. Setting a non-null value suppresses + warning from the clang analyzer. */ + char *str_hdr = (char *)(void *)&str_sum; + if (!mval) return NULL; + if (!alc) alc = &YYJSON_DEFAULT_ALC; + + /* traverse the input value to get pool size */ + yyjson_mut_stat(mval, &val_num, &str_sum); + + /* create doc and val pool */ + hdr_size = size_align_up(sizeof(yyjson_doc), sizeof(yyjson_val)); + buf_size = hdr_size + val_num * sizeof(yyjson_val); + doc = (yyjson_doc *)alc->malloc(alc->ctx, buf_size); + if (!doc) return NULL; + memset(doc, 0, sizeof(yyjson_doc)); + val_hdr = (yyjson_val *)(void *)((char *)(void *)doc + hdr_size); + doc->root = val_hdr; + doc->alc = *alc; + + /* create str pool */ + if (str_sum > 0) { + str_hdr = (char *)alc->malloc(alc->ctx, str_sum); + doc->str_pool = str_hdr; + if (!str_hdr) { + alc->free(alc->ctx, (void *)doc); + return NULL; + } + } + + /* copy vals and strs */ + doc->val_read = yyjson_imut_copy(&val_hdr, &str_hdr, mval); + doc->dat_read = str_sum + 1; + return doc; +} + +static_inline bool unsafe_yyjson_num_equals(void *lhs, void *rhs) { + yyjson_val_uni *luni = &((yyjson_val *)lhs)->uni; + yyjson_val_uni *runi = &((yyjson_val *)rhs)->uni; + yyjson_subtype lt = unsafe_yyjson_get_subtype(lhs); + yyjson_subtype rt = unsafe_yyjson_get_subtype(rhs); + if (lt == rt) + return luni->u64 == runi->u64; + if (lt == YYJSON_SUBTYPE_SINT && rt == YYJSON_SUBTYPE_UINT) + return luni->i64 >= 0 && luni->u64 == runi->u64; + if (lt == YYJSON_SUBTYPE_UINT && rt == YYJSON_SUBTYPE_SINT) + return runi->i64 >= 0 && luni->u64 == runi->u64; + return false; +} + +static_inline bool unsafe_yyjson_str_equals(void *lhs, void *rhs) { + usize len = unsafe_yyjson_get_len(lhs); + if (len != unsafe_yyjson_get_len(rhs)) return false; + return !memcmp(unsafe_yyjson_get_str(lhs), + unsafe_yyjson_get_str(rhs), len); +} + +bool unsafe_yyjson_equals(yyjson_val *lhs, yyjson_val *rhs) { + yyjson_type type = unsafe_yyjson_get_type(lhs); + if (type != unsafe_yyjson_get_type(rhs)) return false; + + switch (type) { + case YYJSON_TYPE_OBJ: { + usize len = unsafe_yyjson_get_len(lhs); + if (len != unsafe_yyjson_get_len(rhs)) return false; + if (len > 0) { + yyjson_obj_iter iter; + yyjson_obj_iter_init(rhs, &iter); + lhs = unsafe_yyjson_get_first(lhs); + while (len-- > 0) { + rhs = yyjson_obj_iter_getn(&iter, lhs->uni.str, + unsafe_yyjson_get_len(lhs)); + if (!rhs || !unsafe_yyjson_equals(lhs + 1, rhs)) + return false; + lhs = unsafe_yyjson_get_next(lhs + 1); + } + } + /* yyjson allows duplicate keys, so the check may be inaccurate */ + return true; + } + + case YYJSON_TYPE_ARR: { + usize len = unsafe_yyjson_get_len(lhs); + if (len != unsafe_yyjson_get_len(rhs)) return false; + if (len > 0) { + lhs = unsafe_yyjson_get_first(lhs); + rhs = unsafe_yyjson_get_first(rhs); + while (len-- > 0) { + if (!unsafe_yyjson_equals(lhs, rhs)) return false; + lhs = unsafe_yyjson_get_next(lhs); + rhs = unsafe_yyjson_get_next(rhs); + } + } + return true; + } + + case YYJSON_TYPE_NUM: + return unsafe_yyjson_num_equals(lhs, rhs); + + case YYJSON_TYPE_RAW: + case YYJSON_TYPE_STR: + return unsafe_yyjson_str_equals(lhs, rhs); + + case YYJSON_TYPE_NULL: + case YYJSON_TYPE_BOOL: + return lhs->tag == rhs->tag; + + default: + return false; + } +} + +bool unsafe_yyjson_mut_equals(yyjson_mut_val *lhs, yyjson_mut_val *rhs) { + yyjson_type type = unsafe_yyjson_get_type(lhs); + if (type != unsafe_yyjson_get_type(rhs)) return false; + + switch (type) { + case YYJSON_TYPE_OBJ: { + usize len = unsafe_yyjson_get_len(lhs); + if (len != unsafe_yyjson_get_len(rhs)) return false; + if (len > 0) { + yyjson_mut_obj_iter iter; + yyjson_mut_obj_iter_init(rhs, &iter); + lhs = (yyjson_mut_val *)lhs->uni.ptr; + while (len-- > 0) { + rhs = yyjson_mut_obj_iter_getn(&iter, lhs->uni.str, + unsafe_yyjson_get_len(lhs)); + if (!rhs || !unsafe_yyjson_mut_equals(lhs->next, rhs)) + return false; + lhs = lhs->next->next; + } + } + /* yyjson allows duplicate keys, so the check may be inaccurate */ + return true; + } + + case YYJSON_TYPE_ARR: { + usize len = unsafe_yyjson_get_len(lhs); + if (len != unsafe_yyjson_get_len(rhs)) return false; + if (len > 0) { + lhs = (yyjson_mut_val *)lhs->uni.ptr; + rhs = (yyjson_mut_val *)rhs->uni.ptr; + while (len-- > 0) { + if (!unsafe_yyjson_mut_equals(lhs, rhs)) return false; + lhs = lhs->next; + rhs = rhs->next; + } + } + return true; + } + + case YYJSON_TYPE_NUM: + return unsafe_yyjson_num_equals(lhs, rhs); + + case YYJSON_TYPE_RAW: + case YYJSON_TYPE_STR: + return unsafe_yyjson_str_equals(lhs, rhs); + + case YYJSON_TYPE_NULL: + case YYJSON_TYPE_BOOL: + return lhs->tag == rhs->tag; + + default: + return false; + } +} + + + +#if !YYJSON_DISABLE_UTILS + +/*============================================================================== + * JSON Pointer API (RFC 6901) + *============================================================================*/ + +/** + Get a token from JSON pointer string. + @param ptr [in,out] + in: string that points to current token prefix `/` + out: string that points to next token prefix `/`, or string end + @param end [in] end of the entire JSON Pointer string + @param len [out] unescaped token length + @param esc [out] number of escaped characters in this token + @return head of the token, or NULL if syntax error + */ +static_inline const char *ptr_next_token(const char **ptr, const char *end, + usize *len, usize *esc) { + const char *hdr = *ptr + 1; + const char *cur = hdr; + /* skip unescaped characters */ + while (cur < end && *cur != '/' && *cur != '~') cur++; + if (likely(cur == end || *cur != '~')) { + /* no escaped characters, return */ + *ptr = cur; + *len = (usize)(cur - hdr); + *esc = 0; + return hdr; + } else { + /* handle escaped characters */ + usize esc_num = 0; + while (cur < end && *cur != '/') { + if (*cur++ == '~') { + if (cur == end || (*cur != '0' && *cur != '1')) { + *ptr = cur - 1; + return NULL; + } + esc_num++; + } + } + *ptr = cur; + *len = (usize)(cur - hdr) - esc_num; + *esc = esc_num; + return hdr; + } +} + +/** + Convert token string to index. + @param cur [in] token head + @param len [in] token length + @param idx [out] the index number, or USIZE_MAX if token is '-' + @return true if token is a valid array index + */ +static_inline bool ptr_token_to_idx(const char *cur, usize len, usize *idx) { + const char *end = cur + len; + usize num = 0, add; + if (unlikely(len == 0 || len > USIZE_SAFE_DIG)) return false; + if (*cur == '0') { + if (unlikely(len > 1)) return false; + *idx = 0; + return true; + } + if (*cur == '-') { + if (unlikely(len > 1)) return false; + *idx = USIZE_MAX; + return true; + } + for (; cur < end && (add = (usize)((u8)*cur - (u8)'0')) <= 9; cur++) { + num = num * 10 + add; + } + if (unlikely(num == 0 || cur < end)) return false; + *idx = num; + return true; +} + +/** + Compare JSON key with token. + @param key a string key (yyjson_val or yyjson_mut_val) + @param tag the expected string key tag + @param token a JSON pointer token + @param len unescaped token length + @param esc number of escaped characters in this token + @return true if `str` is equals to `token` + */ +static_inline bool ptr_token_eq(void *key, u64 tag, + const char *token, usize len, usize esc) { + yyjson_val *val = (yyjson_val *)key; + if (val->tag != tag) return false; + if (likely(!esc)) { + return memcmp(val->uni.str, token, len) == 0; + } else { + const char *str = val->uni.str; + for (; len-- > 0; token++, str++) { + if (*token == '~') { + if (*str != (*++token == '0' ? '~' : '/')) return false; + } else { + if (*str != *token) return false; + } + } + return true; + } +} + +/** + Get a value from array by token. + @param arr an array, should not be NULL or non-array type + @param token a JSON pointer token + @param len unescaped token length + @param esc number of escaped characters in this token + @return value at index, or NULL if token is not index or index is out of range + */ +static_inline yyjson_val *ptr_arr_get(yyjson_val *arr, const char *token, + usize len, usize esc) { + yyjson_val *val = unsafe_yyjson_get_first(arr); + usize num = unsafe_yyjson_get_len(arr), idx; + if (unlikely(num == 0)) return NULL; + if (unlikely(!ptr_token_to_idx(token, len, &idx))) return NULL; + if (unlikely(idx >= num)) return NULL; + if (unsafe_yyjson_arr_is_flat(arr)) { + return val + idx; + } else { + while (idx-- > 0) val = unsafe_yyjson_get_next(val); + return val; + } +} + +/** + Get a value from object by token. + @param obj [in] an object, should not be NULL or non-object type + @param token [in] a JSON pointer token + @param len [in] unescaped token length + @param esc [in] number of escaped characters in this token + @return value associated with the token, or NULL if no value + */ +static_inline yyjson_val *ptr_obj_get(yyjson_val *obj, const char *token, + usize len, usize esc) { + u64 tag = (((u64)len) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + yyjson_val *key = unsafe_yyjson_get_first(obj); + usize num = unsafe_yyjson_get_len(obj); + if (unlikely(num == 0)) return NULL; + for (; num > 0; num--, key = unsafe_yyjson_get_next(key + 1)) { + if (ptr_token_eq(key, tag, token, len, esc)) return key + 1; + } + return NULL; +} + +/** + Get a value from array by token. + @param arr [in] an array, should not be NULL or non-array type + @param token [in] a JSON pointer token + @param len [in] unescaped token length + @param esc [in] number of escaped characters in this token + @param pre [out] previous (sibling) value of the returned value + @param last [out] whether index is last + @return value at index, or NULL if token is not index or index is out of range + */ +static_inline yyjson_mut_val *ptr_mut_arr_get(yyjson_mut_val *arr, + const char *token, + usize len, usize esc, + yyjson_mut_val **pre, + bool *last) { + yyjson_mut_val *val = (yyjson_mut_val *)arr->uni.ptr; /* last (tail) */ + usize num = unsafe_yyjson_get_len(arr), idx; + if (last) *last = false; + if (pre) *pre = NULL; + if (unlikely(num == 0)) { + if (last && len == 1 && (*token == '0' || *token == '-')) *last = true; + return NULL; + } + if (unlikely(!ptr_token_to_idx(token, len, &idx))) return NULL; + if (last) *last = (idx == num || idx == USIZE_MAX); + if (unlikely(idx >= num)) return NULL; + while (idx-- > 0) val = val->next; + *pre = val; + return val->next; +} + +/** + Get a value from object by token. + @param obj [in] an object, should not be NULL or non-object type + @param token [in] a JSON pointer token + @param len [in] unescaped token length + @param esc [in] number of escaped characters in this token + @param pre [out] previous (sibling) key of the returned value's key + @return value associated with the token, or NULL if no value + */ +static_inline yyjson_mut_val *ptr_mut_obj_get(yyjson_mut_val *obj, + const char *token, + usize len, usize esc, + yyjson_mut_val **pre) { + u64 tag = (((u64)len) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + yyjson_mut_val *pre_key = (yyjson_mut_val *)obj->uni.ptr, *key; + usize num = unsafe_yyjson_get_len(obj); + if (pre) *pre = NULL; + if (unlikely(num == 0)) return NULL; + for (; num > 0; num--, pre_key = key) { + key = pre_key->next->next; + if (ptr_token_eq(key, tag, token, len, esc)) { + *pre = pre_key; + return key->next; + } + } + return NULL; +} + +/** + Create a string value with JSON pointer token. + @param token [in] a JSON pointer token + @param len [in] unescaped token length + @param esc [in] number of escaped characters in this token + @param doc [in] used for memory allocation when creating value + @return new string value, or NULL if memory allocation failed + */ +static_inline yyjson_mut_val *ptr_new_key(const char *token, + usize len, usize esc, + yyjson_mut_doc *doc) { + const char *src = token; + if (likely(!esc)) { + return yyjson_mut_strncpy(doc, src, len); + } else { + const char *end = src + len + esc; + char *dst = unsafe_yyjson_mut_str_alc(doc, len + esc); + char *str = dst; + if (unlikely(!dst)) return NULL; + for (; src < end; src++, dst++) { + if (*src != '~') *dst = *src; + else *dst = (*++src == '0' ? '~' : '/'); + } + *dst = '\0'; + return yyjson_mut_strn(doc, str, len); + } +} + +/* macros for yyjson_ptr */ +#define return_err(_ret, _code, _pos, _msg) do { \ + if (err) { \ + err->code = YYJSON_PTR_ERR_##_code; \ + err->msg = _msg; \ + err->pos = (usize)(_pos); \ + } \ + return _ret; \ +} while (false) + +#define return_err_resolve(_ret, _pos) \ + return_err(_ret, RESOLVE, _pos, "JSON pointer cannot be resolved") +#define return_err_syntax(_ret, _pos) \ + return_err(_ret, SYNTAX, _pos, "invalid escaped character") +#define return_err_alloc(_ret) \ + return_err(_ret, MEMORY_ALLOCATION, 0, "failed to create value") + +yyjson_val *unsafe_yyjson_ptr_getx(yyjson_val *val, + const char *ptr, size_t ptr_len, + yyjson_ptr_err *err) { + + const char *hdr = ptr, *end = ptr + ptr_len, *token; + usize len, esc; + yyjson_type type; + + while (true) { + token = ptr_next_token(&ptr, end, &len, &esc); + if (unlikely(!token)) return_err_syntax(NULL, ptr - hdr); + type = unsafe_yyjson_get_type(val); + if (type == YYJSON_TYPE_OBJ) { + val = ptr_obj_get(val, token, len, esc); + } else if (type == YYJSON_TYPE_ARR) { + val = ptr_arr_get(val, token, len, esc); + } else { + val = NULL; + } + if (!val) return_err_resolve(NULL, token - hdr); + if (ptr == end) return val; + } +} + +yyjson_mut_val *unsafe_yyjson_mut_ptr_getx(yyjson_mut_val *val, + const char *ptr, + size_t ptr_len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + + const char *hdr = ptr, *end = ptr + ptr_len, *token; + usize len, esc; + yyjson_mut_val *ctn, *pre = NULL; + yyjson_type type; + bool idx_is_last = false; + + while (true) { + token = ptr_next_token(&ptr, end, &len, &esc); + if (unlikely(!token)) return_err_syntax(NULL, ptr - hdr); + ctn = val; + type = unsafe_yyjson_get_type(val); + if (type == YYJSON_TYPE_OBJ) { + val = ptr_mut_obj_get(val, token, len, esc, &pre); + } else if (type == YYJSON_TYPE_ARR) { + val = ptr_mut_arr_get(val, token, len, esc, &pre, &idx_is_last); + } else { + val = NULL; + } + if (ctx && (ptr == end)) { + if (type == YYJSON_TYPE_OBJ || + (type == YYJSON_TYPE_ARR && (val || idx_is_last))) { + ctx->ctn = ctn; + ctx->pre = pre; + } + } + if (!val) return_err_resolve(NULL, token - hdr); + if (ptr == end) return val; + } +} + +bool unsafe_yyjson_mut_ptr_putx(yyjson_mut_val *val, + const char *ptr, size_t ptr_len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, bool insert_new, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + + const char *hdr = ptr, *end = ptr + ptr_len, *token; + usize token_len, esc, ctn_len; + yyjson_mut_val *ctn, *key, *pre = NULL; + yyjson_mut_val *sep_ctn = NULL, *sep_key = NULL, *sep_val = NULL; + yyjson_type ctn_type; + bool idx_is_last = false; + + /* skip exist parent nodes */ + while (true) { + token = ptr_next_token(&ptr, end, &token_len, &esc); + if (unlikely(!token)) return_err_syntax(false, ptr - hdr); + ctn = val; + ctn_type = unsafe_yyjson_get_type(ctn); + if (ctn_type == YYJSON_TYPE_OBJ) { + val = ptr_mut_obj_get(ctn, token, token_len, esc, &pre); + } else if (ctn_type == YYJSON_TYPE_ARR) { + val = ptr_mut_arr_get(ctn, token, token_len, esc, &pre, + &idx_is_last); + } else return_err_resolve(false, token - hdr); + if (!val) break; + if (ptr == end) break; /* is last token */ + } + + /* create parent nodes if not exist */ + if (unlikely(ptr != end)) { /* not last token */ + if (!create_parent) return_err_resolve(false, token - hdr); + + /* add value at last index if container is array */ + if (ctn_type == YYJSON_TYPE_ARR) { + if (!idx_is_last || !insert_new) { + return_err_resolve(false, token - hdr); + } + val = yyjson_mut_obj(doc); + if (!val) return_err_alloc(false); + + /* delay attaching until all operations are completed */ + sep_ctn = ctn; + sep_key = NULL; + sep_val = val; + + /* move to next token */ + ctn = val; + val = NULL; + ctn_type = YYJSON_TYPE_OBJ; + token = ptr_next_token(&ptr, end, &token_len, &esc); + if (unlikely(!token)) return_err_resolve(false, token - hdr); + } + + /* container is object, create parent nodes */ + while (ptr != end) { /* not last token */ + key = ptr_new_key(token, token_len, esc, doc); + if (!key) return_err_alloc(false); + val = yyjson_mut_obj(doc); + if (!val) return_err_alloc(false); + + /* delay attaching until all operations are completed */ + if (!sep_ctn) { + sep_ctn = ctn; + sep_key = key; + sep_val = val; + } else { + yyjson_mut_obj_add(ctn, key, val); + } + + /* move to next token */ + ctn = val; + val = NULL; + token = ptr_next_token(&ptr, end, &token_len, &esc); + if (unlikely(!token)) return_err_syntax(false, ptr - hdr); + } + } + + /* JSON pointer is resolved, insert or replace target value */ + ctn_len = unsafe_yyjson_get_len(ctn); + if (ctn_type == YYJSON_TYPE_OBJ) { + if (ctx) ctx->ctn = ctn; + if (!val || insert_new) { + /* insert new key-value pair */ + key = ptr_new_key(token, token_len, esc, doc); + if (unlikely(!key)) return_err_alloc(false); + if (ctx) ctx->pre = ctn_len ? (yyjson_mut_val *)ctn->uni.ptr : key; + unsafe_yyjson_mut_obj_add(ctn, key, new_val, ctn_len); + } else { + /* replace exist value */ + key = pre->next->next; + if (ctx) ctx->pre = pre; + if (ctx) ctx->old = val; + yyjson_mut_obj_put(ctn, key, new_val); + } + } else { + /* array */ + if (ctx && (val || idx_is_last)) ctx->ctn = ctn; + if (insert_new) { + /* append new value */ + if (val) { + pre->next = new_val; + new_val->next = val; + if (ctx) ctx->pre = pre; + unsafe_yyjson_set_len(ctn, ctn_len + 1); + } else if (idx_is_last) { + if (ctx) ctx->pre = ctn_len ? + (yyjson_mut_val *)ctn->uni.ptr : new_val; + yyjson_mut_arr_append(ctn, new_val); + } else { + return_err_resolve(false, token - hdr); + } + } else { + /* replace exist value */ + if (!val) return_err_resolve(false, token - hdr); + if (ctn_len > 1) { + new_val->next = val->next; + pre->next = new_val; + if (ctn->uni.ptr == val) ctn->uni.ptr = new_val; + } else { + new_val->next = new_val; + ctn->uni.ptr = new_val; + pre = new_val; + } + if (ctx) ctx->pre = pre; + if (ctx) ctx->old = val; + } + } + + /* all operations are completed, attach the new components to the target */ + if (unlikely(sep_ctn)) { + if (sep_key) yyjson_mut_obj_add(sep_ctn, sep_key, sep_val); + else yyjson_mut_arr_append(sep_ctn, sep_val); + } + return true; +} + +yyjson_mut_val *unsafe_yyjson_mut_ptr_replacex( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err) { + + yyjson_mut_val *cur_val; + yyjson_ptr_ctx cur_ctx; + memset(&cur_ctx, 0, sizeof(cur_ctx)); + if (!ctx) ctx = &cur_ctx; + cur_val = unsafe_yyjson_mut_ptr_getx(val, ptr, len, ctx, err); + if (!cur_val) return NULL; + + if (yyjson_mut_is_obj(ctx->ctn)) { + yyjson_mut_val *key = ctx->pre->next->next; + yyjson_mut_obj_put(ctx->ctn, key, new_val); + } else { + yyjson_ptr_ctx_replace(ctx, new_val); + } + ctx->old = cur_val; + return cur_val; +} + +yyjson_mut_val *unsafe_yyjson_mut_ptr_removex(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_mut_val *cur_val; + yyjson_ptr_ctx cur_ctx; + memset(&cur_ctx, 0, sizeof(cur_ctx)); + if (!ctx) ctx = &cur_ctx; + cur_val = unsafe_yyjson_mut_ptr_getx(val, ptr, len, ctx, err); + if (cur_val) { + if (yyjson_mut_is_obj(ctx->ctn)) { + yyjson_mut_val *key = ctx->pre->next->next; + yyjson_mut_obj_put(ctx->ctn, key, NULL); + } else { + yyjson_ptr_ctx_remove(ctx); + } + ctx->pre = NULL; + ctx->old = cur_val; + } + return cur_val; +} + +/* macros for yyjson_ptr */ +#undef return_err +#undef return_err_resolve +#undef return_err_syntax +#undef return_err_alloc + + + +/*============================================================================== + * JSON Patch API (RFC 6902) + *============================================================================*/ + +/* JSON Patch operation */ +typedef enum patch_op { + PATCH_OP_ADD, /* path, value */ + PATCH_OP_REMOVE, /* path */ + PATCH_OP_REPLACE, /* path, value */ + PATCH_OP_MOVE, /* from, path */ + PATCH_OP_COPY, /* from, path */ + PATCH_OP_TEST, /* path, value */ + PATCH_OP_NONE /* invalid */ +} patch_op; + +static patch_op patch_op_get(yyjson_val *op) { + const char *str = op->uni.str; + switch (unsafe_yyjson_get_len(op)) { + case 3: + if (!memcmp(str, "add", 3)) return PATCH_OP_ADD; + return PATCH_OP_NONE; + case 4: + if (!memcmp(str, "move", 4)) return PATCH_OP_MOVE; + if (!memcmp(str, "copy", 4)) return PATCH_OP_COPY; + if (!memcmp(str, "test", 4)) return PATCH_OP_TEST; + return PATCH_OP_NONE; + case 6: + if (!memcmp(str, "remove", 6)) return PATCH_OP_REMOVE; + return PATCH_OP_NONE; + case 7: + if (!memcmp(str, "replace", 7)) return PATCH_OP_REPLACE; + return PATCH_OP_NONE; + default: + return PATCH_OP_NONE; + } +} + +/* macros for yyjson_patch */ +#define return_err(_code, _msg) do { \ + if (err->ptr.code == YYJSON_PTR_ERR_MEMORY_ALLOCATION) { \ + err->code = YYJSON_PATCH_ERROR_MEMORY_ALLOCATION; \ + err->msg = _msg; \ + memset(&err->ptr, 0, sizeof(yyjson_ptr_err)); \ + } else { \ + err->code = YYJSON_PATCH_ERROR_##_code; \ + err->msg = _msg; \ + err->idx = iter.idx ? iter.idx - 1 : 0; \ + } \ + return NULL; \ +} while (false) + +#define return_err_copy() \ + return_err(MEMORY_ALLOCATION, "failed to copy value") +#define return_err_key(_key) \ + return_err(MISSING_KEY, "missing key " _key) +#define return_err_val(_key) \ + return_err(INVALID_MEMBER, "invalid member " _key) + +#define ptr_get(_ptr) yyjson_mut_ptr_getx( \ + root, _ptr->uni.str, _ptr##_len, NULL, &err->ptr) +#define ptr_add(_ptr, _val) yyjson_mut_ptr_addx( \ + root, _ptr->uni.str, _ptr##_len, _val, doc, false, NULL, &err->ptr) +#define ptr_remove(_ptr) yyjson_mut_ptr_removex( \ + root, _ptr->uni.str, _ptr##_len, NULL, &err->ptr) +#define ptr_replace(_ptr, _val)yyjson_mut_ptr_replacex( \ + root, _ptr->uni.str, _ptr##_len, _val, NULL, &err->ptr) + +yyjson_mut_val *yyjson_patch(yyjson_mut_doc *doc, + yyjson_val *orig, + yyjson_val *patch, + yyjson_patch_err *err) { + + yyjson_mut_val *root; + yyjson_val *obj; + yyjson_arr_iter iter; + yyjson_patch_err err_tmp; + if (!err) err = &err_tmp; + memset(err, 0, sizeof(*err)); + memset(&iter, 0, sizeof(iter)); + + if (unlikely(!doc || !orig || !patch)) { + return_err(INVALID_PARAMETER, "input parameter is NULL"); + } + if (unlikely(!yyjson_is_arr(patch))) { + return_err(INVALID_PARAMETER, "input patch is not array"); + } + root = yyjson_val_mut_copy(doc, orig); + if (unlikely(!root)) return_err_copy(); + + /* iterate through the patch array */ + yyjson_arr_iter_init(patch, &iter); + while ((obj = yyjson_arr_iter_next(&iter))) { + patch_op op_enum; + yyjson_val *op, *path, *from = NULL, *value; + yyjson_mut_val *val = NULL, *test; + usize path_len, from_len = 0; + if (unlikely(!unsafe_yyjson_is_obj(obj))) { + return_err(INVALID_OPERATION, "JSON patch operation is not object"); + } + + /* get required member: op */ + op = yyjson_obj_get(obj, "op"); + if (unlikely(!op)) return_err_key("`op`"); + if (unlikely(!yyjson_is_str(op))) return_err_val("`op`"); + op_enum = patch_op_get(op); + + /* get required member: path */ + path = yyjson_obj_get(obj, "path"); + if (unlikely(!path)) return_err_key("`path`"); + if (unlikely(!yyjson_is_str(path))) return_err_val("`path`"); + path_len = unsafe_yyjson_get_len(path); + + /* get required member: value, from */ + switch (op_enum) { + case PATCH_OP_ADD: case PATCH_OP_REPLACE: case PATCH_OP_TEST: + value = yyjson_obj_get(obj, "value"); + if (unlikely(!value)) return_err_key("`value`"); + val = yyjson_val_mut_copy(doc, value); + if (unlikely(!val)) return_err_copy(); + break; + case PATCH_OP_MOVE: case PATCH_OP_COPY: + from = yyjson_obj_get(obj, "from"); + if (unlikely(!from)) return_err_key("`from`"); + if (unlikely(!yyjson_is_str(from))) return_err_val("`from`"); + from_len = unsafe_yyjson_get_len(from); + break; + default: + break; + } + + /* perform an operation */ + switch (op_enum) { + case PATCH_OP_ADD: /* add(path, val) */ + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_REMOVE: /* remove(path) */ + if (unlikely(!ptr_remove(path))) { + return_err(POINTER, "failed to remove `path`"); + } + break; + case PATCH_OP_REPLACE: /* replace(path, val) */ + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_replace(path, val))) { + return_err(POINTER, "failed to replace `path`"); + } + break; + case PATCH_OP_MOVE: /* val = remove(from), add(path, val) */ + if (unlikely(from_len == 0 && path_len == 0)) break; + val = ptr_remove(from); + if (unlikely(!val)) { + return_err(POINTER, "failed to remove `from`"); + } + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_COPY: /* val = get(from).copy, add(path, val) */ + val = ptr_get(from); + if (unlikely(!val)) { + return_err(POINTER, "failed to get `from`"); + } + if (unlikely(path_len == 0)) { root = val; break; } + val = yyjson_mut_val_mut_copy(doc, val); + if (unlikely(!val)) return_err_copy(); + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_TEST: /* test = get(path), test.eq(val) */ + test = ptr_get(path); + if (unlikely(!test)) { + return_err(POINTER, "failed to get `path`"); + } + if (unlikely(!yyjson_mut_equals(val, test))) { + return_err(EQUAL, "failed to test equal"); + } + break; + default: + return_err(INVALID_MEMBER, "unsupported `op`"); + } + } + return root; +} + +yyjson_mut_val *yyjson_mut_patch(yyjson_mut_doc *doc, + yyjson_mut_val *orig, + yyjson_mut_val *patch, + yyjson_patch_err *err) { + yyjson_mut_val *root, *obj; + yyjson_mut_arr_iter iter; + yyjson_patch_err err_tmp; + if (!err) err = &err_tmp; + memset(err, 0, sizeof(*err)); + memset(&iter, 0, sizeof(iter)); + + if (unlikely(!doc || !orig || !patch)) { + return_err(INVALID_PARAMETER, "input parameter is NULL"); + } + if (unlikely(!yyjson_mut_is_arr(patch))) { + return_err(INVALID_PARAMETER, "input patch is not array"); + } + root = yyjson_mut_val_mut_copy(doc, orig); + if (unlikely(!root)) return_err_copy(); + + /* iterate through the patch array */ + yyjson_mut_arr_iter_init(patch, &iter); + while ((obj = yyjson_mut_arr_iter_next(&iter))) { + patch_op op_enum; + yyjson_mut_val *op, *path, *from = NULL, *value; + yyjson_mut_val *val = NULL, *test; + usize path_len, from_len = 0; + if (!unsafe_yyjson_is_obj(obj)) { + return_err(INVALID_OPERATION, "JSON patch operation is not object"); + } + + /* get required member: op */ + op = yyjson_mut_obj_get(obj, "op"); + if (unlikely(!op)) return_err_key("`op`"); + if (unlikely(!yyjson_mut_is_str(op))) return_err_val("`op`"); + op_enum = patch_op_get((yyjson_val *)(void *)op); + + /* get required member: path */ + path = yyjson_mut_obj_get(obj, "path"); + if (unlikely(!path)) return_err_key("`path`"); + if (unlikely(!yyjson_mut_is_str(path))) return_err_val("`path`"); + path_len = unsafe_yyjson_get_len(path); + + /* get required member: value, from */ + switch (op_enum) { + case PATCH_OP_ADD: case PATCH_OP_REPLACE: case PATCH_OP_TEST: + value = yyjson_mut_obj_get(obj, "value"); + if (unlikely(!value)) return_err_key("`value`"); + val = yyjson_mut_val_mut_copy(doc, value); + if (unlikely(!val)) return_err_copy(); + break; + case PATCH_OP_MOVE: case PATCH_OP_COPY: + from = yyjson_mut_obj_get(obj, "from"); + if (unlikely(!from)) return_err_key("`from`"); + if (unlikely(!yyjson_mut_is_str(from))) { + return_err_val("`from`"); + } + from_len = unsafe_yyjson_get_len(from); + break; + default: + break; + } + + /* perform an operation */ + switch (op_enum) { + case PATCH_OP_ADD: /* add(path, val) */ + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_REMOVE: /* remove(path) */ + if (unlikely(!ptr_remove(path))) { + return_err(POINTER, "failed to remove `path`"); + } + break; + case PATCH_OP_REPLACE: /* replace(path, val) */ + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_replace(path, val))) { + return_err(POINTER, "failed to replace `path`"); + } + break; + case PATCH_OP_MOVE: /* val = remove(from), add(path, val) */ + if (unlikely(from_len == 0 && path_len == 0)) break; + val = ptr_remove(from); + if (unlikely(!val)) { + return_err(POINTER, "failed to remove `from`"); + } + if (unlikely(path_len == 0)) { root = val; break; } + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_COPY: /* val = get(from).copy, add(path, val) */ + val = ptr_get(from); + if (unlikely(!val)) { + return_err(POINTER, "failed to get `from`"); + } + if (unlikely(path_len == 0)) { root = val; break; } + val = yyjson_mut_val_mut_copy(doc, val); + if (unlikely(!val)) return_err_copy(); + if (unlikely(!ptr_add(path, val))) { + return_err(POINTER, "failed to add `path`"); + } + break; + case PATCH_OP_TEST: /* test = get(path), test.eq(val) */ + test = ptr_get(path); + if (unlikely(!test)) { + return_err(POINTER, "failed to get `path`"); + } + if (unlikely(!yyjson_mut_equals(val, test))) { + return_err(EQUAL, "failed to test equal"); + } + break; + default: + return_err(INVALID_MEMBER, "unsupported `op`"); + } + } + return root; +} + +/* macros for yyjson_patch */ +#undef return_err +#undef return_err_copy +#undef return_err_key +#undef return_err_val +#undef ptr_get +#undef ptr_add +#undef ptr_remove +#undef ptr_replace + + + +/*============================================================================== + * JSON Merge-Patch API (RFC 7386) + *============================================================================*/ + +yyjson_mut_val *yyjson_merge_patch(yyjson_mut_doc *doc, + yyjson_val *orig, + yyjson_val *patch) { + usize idx, max; + yyjson_val *key, *orig_val, *patch_val, local_orig; + yyjson_mut_val *builder, *mut_key, *mut_val, *merged_val; + + if (unlikely(!yyjson_is_obj(patch))) { + return yyjson_val_mut_copy(doc, patch); + } + + builder = yyjson_mut_obj(doc); + if (unlikely(!builder)) return NULL; + + if (!yyjson_is_obj(orig)) { + orig = &local_orig; + orig->tag = builder->tag; + orig->uni = builder->uni; + } + + /* If orig is contributing, copy any items not modified by the patch */ + if (orig != &local_orig) + { + yyjson_obj_foreach(orig, idx, max, key, orig_val) { + patch_val = yyjson_obj_getn(patch, + unsafe_yyjson_get_str(key), + unsafe_yyjson_get_len(key)); + if (!patch_val) { + mut_key = yyjson_val_mut_copy(doc, key); + mut_val = yyjson_val_mut_copy(doc, orig_val); + if (!yyjson_mut_obj_add(builder, mut_key, mut_val)) return NULL; + } + } + } + + /* Merge items modified by the patch. */ + yyjson_obj_foreach(patch, idx, max, key, patch_val) { + /* null indicates the field is removed. */ + if (unsafe_yyjson_is_null(patch_val)) { + continue; + } + mut_key = yyjson_val_mut_copy(doc, key); + orig_val = yyjson_obj_getn(orig, + unsafe_yyjson_get_str(key), + unsafe_yyjson_get_len(key)); + merged_val = yyjson_merge_patch(doc, orig_val, patch_val); + if (!yyjson_mut_obj_add(builder, mut_key, merged_val)) return NULL; + } + + return builder; +} + +yyjson_mut_val *yyjson_mut_merge_patch(yyjson_mut_doc *doc, + yyjson_mut_val *orig, + yyjson_mut_val *patch) { + usize idx, max; + yyjson_mut_val *key, *orig_val, *patch_val, local_orig; + yyjson_mut_val *builder, *mut_key, *mut_val, *merged_val; + + if (unlikely(!yyjson_mut_is_obj(patch))) { + return yyjson_mut_val_mut_copy(doc, patch); + } + + builder = yyjson_mut_obj(doc); + if (unlikely(!builder)) return NULL; + + if (!yyjson_mut_is_obj(orig)) { + orig = &local_orig; + orig->tag = builder->tag; + orig->uni = builder->uni; + } + + /* If orig is contributing, copy any items not modified by the patch */ + if (orig != &local_orig) + { + yyjson_mut_obj_foreach(orig, idx, max, key, orig_val) { + patch_val = yyjson_mut_obj_getn(patch, + unsafe_yyjson_get_str(key), + unsafe_yyjson_get_len(key)); + if (!patch_val) { + mut_key = yyjson_mut_val_mut_copy(doc, key); + mut_val = yyjson_mut_val_mut_copy(doc, orig_val); + if (!yyjson_mut_obj_add(builder, mut_key, mut_val)) return NULL; + } + } + } + + /* Merge items modified by the patch. */ + yyjson_mut_obj_foreach(patch, idx, max, key, patch_val) { + /* null indicates the field is removed. */ + if (unsafe_yyjson_is_null(patch_val)) { + continue; + } + mut_key = yyjson_mut_val_mut_copy(doc, key); + orig_val = yyjson_mut_obj_getn(orig, + unsafe_yyjson_get_str(key), + unsafe_yyjson_get_len(key)); + merged_val = yyjson_mut_merge_patch(doc, orig_val, patch_val); + if (!yyjson_mut_obj_add(builder, mut_key, merged_val)) return NULL; + } + + return builder; +} + +#endif /* YYJSON_DISABLE_UTILS */ + + + +/*============================================================================== + * Power10 Lookup Table + * These data are used by the floating-point number reader and writer. + *============================================================================*/ + +#if (!YYJSON_DISABLE_READER || !YYJSON_DISABLE_WRITER) && \ + (!YYJSON_DISABLE_FAST_FP_CONV) + +/** Minimum decimal exponent in pow10_sig_table. */ +#define POW10_SIG_TABLE_MIN_EXP -343 + +/** Maximum decimal exponent in pow10_sig_table. */ +#define POW10_SIG_TABLE_MAX_EXP 324 + +/** Minimum exact decimal exponent in pow10_sig_table */ +#define POW10_SIG_TABLE_MIN_EXACT_EXP 0 + +/** Maximum exact decimal exponent in pow10_sig_table */ +#define POW10_SIG_TABLE_MAX_EXACT_EXP 55 + +/** Normalized significant 128 bits of pow10, no rounded up (size: 10.4KB). + This lookup table is used by both the double number reader and writer. + (generate with misc/make_tables.c) */ +static const u64 pow10_sig_table[] = { + U64(0xBF29DCAB, 0xA82FDEAE), U64(0x7432EE87, 0x3880FC33), /* ~= 10^-343 */ + U64(0xEEF453D6, 0x923BD65A), U64(0x113FAA29, 0x06A13B3F), /* ~= 10^-342 */ + U64(0x9558B466, 0x1B6565F8), U64(0x4AC7CA59, 0xA424C507), /* ~= 10^-341 */ + U64(0xBAAEE17F, 0xA23EBF76), U64(0x5D79BCF0, 0x0D2DF649), /* ~= 10^-340 */ + U64(0xE95A99DF, 0x8ACE6F53), U64(0xF4D82C2C, 0x107973DC), /* ~= 10^-339 */ + U64(0x91D8A02B, 0xB6C10594), U64(0x79071B9B, 0x8A4BE869), /* ~= 10^-338 */ + U64(0xB64EC836, 0xA47146F9), U64(0x9748E282, 0x6CDEE284), /* ~= 10^-337 */ + U64(0xE3E27A44, 0x4D8D98B7), U64(0xFD1B1B23, 0x08169B25), /* ~= 10^-336 */ + U64(0x8E6D8C6A, 0xB0787F72), U64(0xFE30F0F5, 0xE50E20F7), /* ~= 10^-335 */ + U64(0xB208EF85, 0x5C969F4F), U64(0xBDBD2D33, 0x5E51A935), /* ~= 10^-334 */ + U64(0xDE8B2B66, 0xB3BC4723), U64(0xAD2C7880, 0x35E61382), /* ~= 10^-333 */ + U64(0x8B16FB20, 0x3055AC76), U64(0x4C3BCB50, 0x21AFCC31), /* ~= 10^-332 */ + U64(0xADDCB9E8, 0x3C6B1793), U64(0xDF4ABE24, 0x2A1BBF3D), /* ~= 10^-331 */ + U64(0xD953E862, 0x4B85DD78), U64(0xD71D6DAD, 0x34A2AF0D), /* ~= 10^-330 */ + U64(0x87D4713D, 0x6F33AA6B), U64(0x8672648C, 0x40E5AD68), /* ~= 10^-329 */ + U64(0xA9C98D8C, 0xCB009506), U64(0x680EFDAF, 0x511F18C2), /* ~= 10^-328 */ + U64(0xD43BF0EF, 0xFDC0BA48), U64(0x0212BD1B, 0x2566DEF2), /* ~= 10^-327 */ + U64(0x84A57695, 0xFE98746D), U64(0x014BB630, 0xF7604B57), /* ~= 10^-326 */ + U64(0xA5CED43B, 0x7E3E9188), U64(0x419EA3BD, 0x35385E2D), /* ~= 10^-325 */ + U64(0xCF42894A, 0x5DCE35EA), U64(0x52064CAC, 0x828675B9), /* ~= 10^-324 */ + U64(0x818995CE, 0x7AA0E1B2), U64(0x7343EFEB, 0xD1940993), /* ~= 10^-323 */ + U64(0xA1EBFB42, 0x19491A1F), U64(0x1014EBE6, 0xC5F90BF8), /* ~= 10^-322 */ + U64(0xCA66FA12, 0x9F9B60A6), U64(0xD41A26E0, 0x77774EF6), /* ~= 10^-321 */ + U64(0xFD00B897, 0x478238D0), U64(0x8920B098, 0x955522B4), /* ~= 10^-320 */ + U64(0x9E20735E, 0x8CB16382), U64(0x55B46E5F, 0x5D5535B0), /* ~= 10^-319 */ + U64(0xC5A89036, 0x2FDDBC62), U64(0xEB2189F7, 0x34AA831D), /* ~= 10^-318 */ + U64(0xF712B443, 0xBBD52B7B), U64(0xA5E9EC75, 0x01D523E4), /* ~= 10^-317 */ + U64(0x9A6BB0AA, 0x55653B2D), U64(0x47B233C9, 0x2125366E), /* ~= 10^-316 */ + U64(0xC1069CD4, 0xEABE89F8), U64(0x999EC0BB, 0x696E840A), /* ~= 10^-315 */ + U64(0xF148440A, 0x256E2C76), U64(0xC00670EA, 0x43CA250D), /* ~= 10^-314 */ + U64(0x96CD2A86, 0x5764DBCA), U64(0x38040692, 0x6A5E5728), /* ~= 10^-313 */ + U64(0xBC807527, 0xED3E12BC), U64(0xC6050837, 0x04F5ECF2), /* ~= 10^-312 */ + U64(0xEBA09271, 0xE88D976B), U64(0xF7864A44, 0xC633682E), /* ~= 10^-311 */ + U64(0x93445B87, 0x31587EA3), U64(0x7AB3EE6A, 0xFBE0211D), /* ~= 10^-310 */ + U64(0xB8157268, 0xFDAE9E4C), U64(0x5960EA05, 0xBAD82964), /* ~= 10^-309 */ + U64(0xE61ACF03, 0x3D1A45DF), U64(0x6FB92487, 0x298E33BD), /* ~= 10^-308 */ + U64(0x8FD0C162, 0x06306BAB), U64(0xA5D3B6D4, 0x79F8E056), /* ~= 10^-307 */ + U64(0xB3C4F1BA, 0x87BC8696), U64(0x8F48A489, 0x9877186C), /* ~= 10^-306 */ + U64(0xE0B62E29, 0x29ABA83C), U64(0x331ACDAB, 0xFE94DE87), /* ~= 10^-305 */ + U64(0x8C71DCD9, 0xBA0B4925), U64(0x9FF0C08B, 0x7F1D0B14), /* ~= 10^-304 */ + U64(0xAF8E5410, 0x288E1B6F), U64(0x07ECF0AE, 0x5EE44DD9), /* ~= 10^-303 */ + U64(0xDB71E914, 0x32B1A24A), U64(0xC9E82CD9, 0xF69D6150), /* ~= 10^-302 */ + U64(0x892731AC, 0x9FAF056E), U64(0xBE311C08, 0x3A225CD2), /* ~= 10^-301 */ + U64(0xAB70FE17, 0xC79AC6CA), U64(0x6DBD630A, 0x48AAF406), /* ~= 10^-300 */ + U64(0xD64D3D9D, 0xB981787D), U64(0x092CBBCC, 0xDAD5B108), /* ~= 10^-299 */ + U64(0x85F04682, 0x93F0EB4E), U64(0x25BBF560, 0x08C58EA5), /* ~= 10^-298 */ + U64(0xA76C5823, 0x38ED2621), U64(0xAF2AF2B8, 0x0AF6F24E), /* ~= 10^-297 */ + U64(0xD1476E2C, 0x07286FAA), U64(0x1AF5AF66, 0x0DB4AEE1), /* ~= 10^-296 */ + U64(0x82CCA4DB, 0x847945CA), U64(0x50D98D9F, 0xC890ED4D), /* ~= 10^-295 */ + U64(0xA37FCE12, 0x6597973C), U64(0xE50FF107, 0xBAB528A0), /* ~= 10^-294 */ + U64(0xCC5FC196, 0xFEFD7D0C), U64(0x1E53ED49, 0xA96272C8), /* ~= 10^-293 */ + U64(0xFF77B1FC, 0xBEBCDC4F), U64(0x25E8E89C, 0x13BB0F7A), /* ~= 10^-292 */ + U64(0x9FAACF3D, 0xF73609B1), U64(0x77B19161, 0x8C54E9AC), /* ~= 10^-291 */ + U64(0xC795830D, 0x75038C1D), U64(0xD59DF5B9, 0xEF6A2417), /* ~= 10^-290 */ + U64(0xF97AE3D0, 0xD2446F25), U64(0x4B057328, 0x6B44AD1D), /* ~= 10^-289 */ + U64(0x9BECCE62, 0x836AC577), U64(0x4EE367F9, 0x430AEC32), /* ~= 10^-288 */ + U64(0xC2E801FB, 0x244576D5), U64(0x229C41F7, 0x93CDA73F), /* ~= 10^-287 */ + U64(0xF3A20279, 0xED56D48A), U64(0x6B435275, 0x78C1110F), /* ~= 10^-286 */ + U64(0x9845418C, 0x345644D6), U64(0x830A1389, 0x6B78AAA9), /* ~= 10^-285 */ + U64(0xBE5691EF, 0x416BD60C), U64(0x23CC986B, 0xC656D553), /* ~= 10^-284 */ + U64(0xEDEC366B, 0x11C6CB8F), U64(0x2CBFBE86, 0xB7EC8AA8), /* ~= 10^-283 */ + U64(0x94B3A202, 0xEB1C3F39), U64(0x7BF7D714, 0x32F3D6A9), /* ~= 10^-282 */ + U64(0xB9E08A83, 0xA5E34F07), U64(0xDAF5CCD9, 0x3FB0CC53), /* ~= 10^-281 */ + U64(0xE858AD24, 0x8F5C22C9), U64(0xD1B3400F, 0x8F9CFF68), /* ~= 10^-280 */ + U64(0x91376C36, 0xD99995BE), U64(0x23100809, 0xB9C21FA1), /* ~= 10^-279 */ + U64(0xB5854744, 0x8FFFFB2D), U64(0xABD40A0C, 0x2832A78A), /* ~= 10^-278 */ + U64(0xE2E69915, 0xB3FFF9F9), U64(0x16C90C8F, 0x323F516C), /* ~= 10^-277 */ + U64(0x8DD01FAD, 0x907FFC3B), U64(0xAE3DA7D9, 0x7F6792E3), /* ~= 10^-276 */ + U64(0xB1442798, 0xF49FFB4A), U64(0x99CD11CF, 0xDF41779C), /* ~= 10^-275 */ + U64(0xDD95317F, 0x31C7FA1D), U64(0x40405643, 0xD711D583), /* ~= 10^-274 */ + U64(0x8A7D3EEF, 0x7F1CFC52), U64(0x482835EA, 0x666B2572), /* ~= 10^-273 */ + U64(0xAD1C8EAB, 0x5EE43B66), U64(0xDA324365, 0x0005EECF), /* ~= 10^-272 */ + U64(0xD863B256, 0x369D4A40), U64(0x90BED43E, 0x40076A82), /* ~= 10^-271 */ + U64(0x873E4F75, 0xE2224E68), U64(0x5A7744A6, 0xE804A291), /* ~= 10^-270 */ + U64(0xA90DE353, 0x5AAAE202), U64(0x711515D0, 0xA205CB36), /* ~= 10^-269 */ + U64(0xD3515C28, 0x31559A83), U64(0x0D5A5B44, 0xCA873E03), /* ~= 10^-268 */ + U64(0x8412D999, 0x1ED58091), U64(0xE858790A, 0xFE9486C2), /* ~= 10^-267 */ + U64(0xA5178FFF, 0x668AE0B6), U64(0x626E974D, 0xBE39A872), /* ~= 10^-266 */ + U64(0xCE5D73FF, 0x402D98E3), U64(0xFB0A3D21, 0x2DC8128F), /* ~= 10^-265 */ + U64(0x80FA687F, 0x881C7F8E), U64(0x7CE66634, 0xBC9D0B99), /* ~= 10^-264 */ + U64(0xA139029F, 0x6A239F72), U64(0x1C1FFFC1, 0xEBC44E80), /* ~= 10^-263 */ + U64(0xC9874347, 0x44AC874E), U64(0xA327FFB2, 0x66B56220), /* ~= 10^-262 */ + U64(0xFBE91419, 0x15D7A922), U64(0x4BF1FF9F, 0x0062BAA8), /* ~= 10^-261 */ + U64(0x9D71AC8F, 0xADA6C9B5), U64(0x6F773FC3, 0x603DB4A9), /* ~= 10^-260 */ + U64(0xC4CE17B3, 0x99107C22), U64(0xCB550FB4, 0x384D21D3), /* ~= 10^-259 */ + U64(0xF6019DA0, 0x7F549B2B), U64(0x7E2A53A1, 0x46606A48), /* ~= 10^-258 */ + U64(0x99C10284, 0x4F94E0FB), U64(0x2EDA7444, 0xCBFC426D), /* ~= 10^-257 */ + U64(0xC0314325, 0x637A1939), U64(0xFA911155, 0xFEFB5308), /* ~= 10^-256 */ + U64(0xF03D93EE, 0xBC589F88), U64(0x793555AB, 0x7EBA27CA), /* ~= 10^-255 */ + U64(0x96267C75, 0x35B763B5), U64(0x4BC1558B, 0x2F3458DE), /* ~= 10^-254 */ + U64(0xBBB01B92, 0x83253CA2), U64(0x9EB1AAED, 0xFB016F16), /* ~= 10^-253 */ + U64(0xEA9C2277, 0x23EE8BCB), U64(0x465E15A9, 0x79C1CADC), /* ~= 10^-252 */ + U64(0x92A1958A, 0x7675175F), U64(0x0BFACD89, 0xEC191EC9), /* ~= 10^-251 */ + U64(0xB749FAED, 0x14125D36), U64(0xCEF980EC, 0x671F667B), /* ~= 10^-250 */ + U64(0xE51C79A8, 0x5916F484), U64(0x82B7E127, 0x80E7401A), /* ~= 10^-249 */ + U64(0x8F31CC09, 0x37AE58D2), U64(0xD1B2ECB8, 0xB0908810), /* ~= 10^-248 */ + U64(0xB2FE3F0B, 0x8599EF07), U64(0x861FA7E6, 0xDCB4AA15), /* ~= 10^-247 */ + U64(0xDFBDCECE, 0x67006AC9), U64(0x67A791E0, 0x93E1D49A), /* ~= 10^-246 */ + U64(0x8BD6A141, 0x006042BD), U64(0xE0C8BB2C, 0x5C6D24E0), /* ~= 10^-245 */ + U64(0xAECC4991, 0x4078536D), U64(0x58FAE9F7, 0x73886E18), /* ~= 10^-244 */ + U64(0xDA7F5BF5, 0x90966848), U64(0xAF39A475, 0x506A899E), /* ~= 10^-243 */ + U64(0x888F9979, 0x7A5E012D), U64(0x6D8406C9, 0x52429603), /* ~= 10^-242 */ + U64(0xAAB37FD7, 0xD8F58178), U64(0xC8E5087B, 0xA6D33B83), /* ~= 10^-241 */ + U64(0xD5605FCD, 0xCF32E1D6), U64(0xFB1E4A9A, 0x90880A64), /* ~= 10^-240 */ + U64(0x855C3BE0, 0xA17FCD26), U64(0x5CF2EEA0, 0x9A55067F), /* ~= 10^-239 */ + U64(0xA6B34AD8, 0xC9DFC06F), U64(0xF42FAA48, 0xC0EA481E), /* ~= 10^-238 */ + U64(0xD0601D8E, 0xFC57B08B), U64(0xF13B94DA, 0xF124DA26), /* ~= 10^-237 */ + U64(0x823C1279, 0x5DB6CE57), U64(0x76C53D08, 0xD6B70858), /* ~= 10^-236 */ + U64(0xA2CB1717, 0xB52481ED), U64(0x54768C4B, 0x0C64CA6E), /* ~= 10^-235 */ + U64(0xCB7DDCDD, 0xA26DA268), U64(0xA9942F5D, 0xCF7DFD09), /* ~= 10^-234 */ + U64(0xFE5D5415, 0x0B090B02), U64(0xD3F93B35, 0x435D7C4C), /* ~= 10^-233 */ + U64(0x9EFA548D, 0x26E5A6E1), U64(0xC47BC501, 0x4A1A6DAF), /* ~= 10^-232 */ + U64(0xC6B8E9B0, 0x709F109A), U64(0x359AB641, 0x9CA1091B), /* ~= 10^-231 */ + U64(0xF867241C, 0x8CC6D4C0), U64(0xC30163D2, 0x03C94B62), /* ~= 10^-230 */ + U64(0x9B407691, 0xD7FC44F8), U64(0x79E0DE63, 0x425DCF1D), /* ~= 10^-229 */ + U64(0xC2109436, 0x4DFB5636), U64(0x985915FC, 0x12F542E4), /* ~= 10^-228 */ + U64(0xF294B943, 0xE17A2BC4), U64(0x3E6F5B7B, 0x17B2939D), /* ~= 10^-227 */ + U64(0x979CF3CA, 0x6CEC5B5A), U64(0xA705992C, 0xEECF9C42), /* ~= 10^-226 */ + U64(0xBD8430BD, 0x08277231), U64(0x50C6FF78, 0x2A838353), /* ~= 10^-225 */ + U64(0xECE53CEC, 0x4A314EBD), U64(0xA4F8BF56, 0x35246428), /* ~= 10^-224 */ + U64(0x940F4613, 0xAE5ED136), U64(0x871B7795, 0xE136BE99), /* ~= 10^-223 */ + U64(0xB9131798, 0x99F68584), U64(0x28E2557B, 0x59846E3F), /* ~= 10^-222 */ + U64(0xE757DD7E, 0xC07426E5), U64(0x331AEADA, 0x2FE589CF), /* ~= 10^-221 */ + U64(0x9096EA6F, 0x3848984F), U64(0x3FF0D2C8, 0x5DEF7621), /* ~= 10^-220 */ + U64(0xB4BCA50B, 0x065ABE63), U64(0x0FED077A, 0x756B53A9), /* ~= 10^-219 */ + U64(0xE1EBCE4D, 0xC7F16DFB), U64(0xD3E84959, 0x12C62894), /* ~= 10^-218 */ + U64(0x8D3360F0, 0x9CF6E4BD), U64(0x64712DD7, 0xABBBD95C), /* ~= 10^-217 */ + U64(0xB080392C, 0xC4349DEC), U64(0xBD8D794D, 0x96AACFB3), /* ~= 10^-216 */ + U64(0xDCA04777, 0xF541C567), U64(0xECF0D7A0, 0xFC5583A0), /* ~= 10^-215 */ + U64(0x89E42CAA, 0xF9491B60), U64(0xF41686C4, 0x9DB57244), /* ~= 10^-214 */ + U64(0xAC5D37D5, 0xB79B6239), U64(0x311C2875, 0xC522CED5), /* ~= 10^-213 */ + U64(0xD77485CB, 0x25823AC7), U64(0x7D633293, 0x366B828B), /* ~= 10^-212 */ + U64(0x86A8D39E, 0xF77164BC), U64(0xAE5DFF9C, 0x02033197), /* ~= 10^-211 */ + U64(0xA8530886, 0xB54DBDEB), U64(0xD9F57F83, 0x0283FDFC), /* ~= 10^-210 */ + U64(0xD267CAA8, 0x62A12D66), U64(0xD072DF63, 0xC324FD7B), /* ~= 10^-209 */ + U64(0x8380DEA9, 0x3DA4BC60), U64(0x4247CB9E, 0x59F71E6D), /* ~= 10^-208 */ + U64(0xA4611653, 0x8D0DEB78), U64(0x52D9BE85, 0xF074E608), /* ~= 10^-207 */ + U64(0xCD795BE8, 0x70516656), U64(0x67902E27, 0x6C921F8B), /* ~= 10^-206 */ + U64(0x806BD971, 0x4632DFF6), U64(0x00BA1CD8, 0xA3DB53B6), /* ~= 10^-205 */ + U64(0xA086CFCD, 0x97BF97F3), U64(0x80E8A40E, 0xCCD228A4), /* ~= 10^-204 */ + U64(0xC8A883C0, 0xFDAF7DF0), U64(0x6122CD12, 0x8006B2CD), /* ~= 10^-203 */ + U64(0xFAD2A4B1, 0x3D1B5D6C), U64(0x796B8057, 0x20085F81), /* ~= 10^-202 */ + U64(0x9CC3A6EE, 0xC6311A63), U64(0xCBE33036, 0x74053BB0), /* ~= 10^-201 */ + U64(0xC3F490AA, 0x77BD60FC), U64(0xBEDBFC44, 0x11068A9C), /* ~= 10^-200 */ + U64(0xF4F1B4D5, 0x15ACB93B), U64(0xEE92FB55, 0x15482D44), /* ~= 10^-199 */ + U64(0x99171105, 0x2D8BF3C5), U64(0x751BDD15, 0x2D4D1C4A), /* ~= 10^-198 */ + U64(0xBF5CD546, 0x78EEF0B6), U64(0xD262D45A, 0x78A0635D), /* ~= 10^-197 */ + U64(0xEF340A98, 0x172AACE4), U64(0x86FB8971, 0x16C87C34), /* ~= 10^-196 */ + U64(0x9580869F, 0x0E7AAC0E), U64(0xD45D35E6, 0xAE3D4DA0), /* ~= 10^-195 */ + U64(0xBAE0A846, 0xD2195712), U64(0x89748360, 0x59CCA109), /* ~= 10^-194 */ + U64(0xE998D258, 0x869FACD7), U64(0x2BD1A438, 0x703FC94B), /* ~= 10^-193 */ + U64(0x91FF8377, 0x5423CC06), U64(0x7B6306A3, 0x4627DDCF), /* ~= 10^-192 */ + U64(0xB67F6455, 0x292CBF08), U64(0x1A3BC84C, 0x17B1D542), /* ~= 10^-191 */ + U64(0xE41F3D6A, 0x7377EECA), U64(0x20CABA5F, 0x1D9E4A93), /* ~= 10^-190 */ + U64(0x8E938662, 0x882AF53E), U64(0x547EB47B, 0x7282EE9C), /* ~= 10^-189 */ + U64(0xB23867FB, 0x2A35B28D), U64(0xE99E619A, 0x4F23AA43), /* ~= 10^-188 */ + U64(0xDEC681F9, 0xF4C31F31), U64(0x6405FA00, 0xE2EC94D4), /* ~= 10^-187 */ + U64(0x8B3C113C, 0x38F9F37E), U64(0xDE83BC40, 0x8DD3DD04), /* ~= 10^-186 */ + U64(0xAE0B158B, 0x4738705E), U64(0x9624AB50, 0xB148D445), /* ~= 10^-185 */ + U64(0xD98DDAEE, 0x19068C76), U64(0x3BADD624, 0xDD9B0957), /* ~= 10^-184 */ + U64(0x87F8A8D4, 0xCFA417C9), U64(0xE54CA5D7, 0x0A80E5D6), /* ~= 10^-183 */ + U64(0xA9F6D30A, 0x038D1DBC), U64(0x5E9FCF4C, 0xCD211F4C), /* ~= 10^-182 */ + U64(0xD47487CC, 0x8470652B), U64(0x7647C320, 0x0069671F), /* ~= 10^-181 */ + U64(0x84C8D4DF, 0xD2C63F3B), U64(0x29ECD9F4, 0x0041E073), /* ~= 10^-180 */ + U64(0xA5FB0A17, 0xC777CF09), U64(0xF4681071, 0x00525890), /* ~= 10^-179 */ + U64(0xCF79CC9D, 0xB955C2CC), U64(0x7182148D, 0x4066EEB4), /* ~= 10^-178 */ + U64(0x81AC1FE2, 0x93D599BF), U64(0xC6F14CD8, 0x48405530), /* ~= 10^-177 */ + U64(0xA21727DB, 0x38CB002F), U64(0xB8ADA00E, 0x5A506A7C), /* ~= 10^-176 */ + U64(0xCA9CF1D2, 0x06FDC03B), U64(0xA6D90811, 0xF0E4851C), /* ~= 10^-175 */ + U64(0xFD442E46, 0x88BD304A), U64(0x908F4A16, 0x6D1DA663), /* ~= 10^-174 */ + U64(0x9E4A9CEC, 0x15763E2E), U64(0x9A598E4E, 0x043287FE), /* ~= 10^-173 */ + U64(0xC5DD4427, 0x1AD3CDBA), U64(0x40EFF1E1, 0x853F29FD), /* ~= 10^-172 */ + U64(0xF7549530, 0xE188C128), U64(0xD12BEE59, 0xE68EF47C), /* ~= 10^-171 */ + U64(0x9A94DD3E, 0x8CF578B9), U64(0x82BB74F8, 0x301958CE), /* ~= 10^-170 */ + U64(0xC13A148E, 0x3032D6E7), U64(0xE36A5236, 0x3C1FAF01), /* ~= 10^-169 */ + U64(0xF18899B1, 0xBC3F8CA1), U64(0xDC44E6C3, 0xCB279AC1), /* ~= 10^-168 */ + U64(0x96F5600F, 0x15A7B7E5), U64(0x29AB103A, 0x5EF8C0B9), /* ~= 10^-167 */ + U64(0xBCB2B812, 0xDB11A5DE), U64(0x7415D448, 0xF6B6F0E7), /* ~= 10^-166 */ + U64(0xEBDF6617, 0x91D60F56), U64(0x111B495B, 0x3464AD21), /* ~= 10^-165 */ + U64(0x936B9FCE, 0xBB25C995), U64(0xCAB10DD9, 0x00BEEC34), /* ~= 10^-164 */ + U64(0xB84687C2, 0x69EF3BFB), U64(0x3D5D514F, 0x40EEA742), /* ~= 10^-163 */ + U64(0xE65829B3, 0x046B0AFA), U64(0x0CB4A5A3, 0x112A5112), /* ~= 10^-162 */ + U64(0x8FF71A0F, 0xE2C2E6DC), U64(0x47F0E785, 0xEABA72AB), /* ~= 10^-161 */ + U64(0xB3F4E093, 0xDB73A093), U64(0x59ED2167, 0x65690F56), /* ~= 10^-160 */ + U64(0xE0F218B8, 0xD25088B8), U64(0x306869C1, 0x3EC3532C), /* ~= 10^-159 */ + U64(0x8C974F73, 0x83725573), U64(0x1E414218, 0xC73A13FB), /* ~= 10^-158 */ + U64(0xAFBD2350, 0x644EEACF), U64(0xE5D1929E, 0xF90898FA), /* ~= 10^-157 */ + U64(0xDBAC6C24, 0x7D62A583), U64(0xDF45F746, 0xB74ABF39), /* ~= 10^-156 */ + U64(0x894BC396, 0xCE5DA772), U64(0x6B8BBA8C, 0x328EB783), /* ~= 10^-155 */ + U64(0xAB9EB47C, 0x81F5114F), U64(0x066EA92F, 0x3F326564), /* ~= 10^-154 */ + U64(0xD686619B, 0xA27255A2), U64(0xC80A537B, 0x0EFEFEBD), /* ~= 10^-153 */ + U64(0x8613FD01, 0x45877585), U64(0xBD06742C, 0xE95F5F36), /* ~= 10^-152 */ + U64(0xA798FC41, 0x96E952E7), U64(0x2C481138, 0x23B73704), /* ~= 10^-151 */ + U64(0xD17F3B51, 0xFCA3A7A0), U64(0xF75A1586, 0x2CA504C5), /* ~= 10^-150 */ + U64(0x82EF8513, 0x3DE648C4), U64(0x9A984D73, 0xDBE722FB), /* ~= 10^-149 */ + U64(0xA3AB6658, 0x0D5FDAF5), U64(0xC13E60D0, 0xD2E0EBBA), /* ~= 10^-148 */ + U64(0xCC963FEE, 0x10B7D1B3), U64(0x318DF905, 0x079926A8), /* ~= 10^-147 */ + U64(0xFFBBCFE9, 0x94E5C61F), U64(0xFDF17746, 0x497F7052), /* ~= 10^-146 */ + U64(0x9FD561F1, 0xFD0F9BD3), U64(0xFEB6EA8B, 0xEDEFA633), /* ~= 10^-145 */ + U64(0xC7CABA6E, 0x7C5382C8), U64(0xFE64A52E, 0xE96B8FC0), /* ~= 10^-144 */ + U64(0xF9BD690A, 0x1B68637B), U64(0x3DFDCE7A, 0xA3C673B0), /* ~= 10^-143 */ + U64(0x9C1661A6, 0x51213E2D), U64(0x06BEA10C, 0xA65C084E), /* ~= 10^-142 */ + U64(0xC31BFA0F, 0xE5698DB8), U64(0x486E494F, 0xCFF30A62), /* ~= 10^-141 */ + U64(0xF3E2F893, 0xDEC3F126), U64(0x5A89DBA3, 0xC3EFCCFA), /* ~= 10^-140 */ + U64(0x986DDB5C, 0x6B3A76B7), U64(0xF8962946, 0x5A75E01C), /* ~= 10^-139 */ + U64(0xBE895233, 0x86091465), U64(0xF6BBB397, 0xF1135823), /* ~= 10^-138 */ + U64(0xEE2BA6C0, 0x678B597F), U64(0x746AA07D, 0xED582E2C), /* ~= 10^-137 */ + U64(0x94DB4838, 0x40B717EF), U64(0xA8C2A44E, 0xB4571CDC), /* ~= 10^-136 */ + U64(0xBA121A46, 0x50E4DDEB), U64(0x92F34D62, 0x616CE413), /* ~= 10^-135 */ + U64(0xE896A0D7, 0xE51E1566), U64(0x77B020BA, 0xF9C81D17), /* ~= 10^-134 */ + U64(0x915E2486, 0xEF32CD60), U64(0x0ACE1474, 0xDC1D122E), /* ~= 10^-133 */ + U64(0xB5B5ADA8, 0xAAFF80B8), U64(0x0D819992, 0x132456BA), /* ~= 10^-132 */ + U64(0xE3231912, 0xD5BF60E6), U64(0x10E1FFF6, 0x97ED6C69), /* ~= 10^-131 */ + U64(0x8DF5EFAB, 0xC5979C8F), U64(0xCA8D3FFA, 0x1EF463C1), /* ~= 10^-130 */ + U64(0xB1736B96, 0xB6FD83B3), U64(0xBD308FF8, 0xA6B17CB2), /* ~= 10^-129 */ + U64(0xDDD0467C, 0x64BCE4A0), U64(0xAC7CB3F6, 0xD05DDBDE), /* ~= 10^-128 */ + U64(0x8AA22C0D, 0xBEF60EE4), U64(0x6BCDF07A, 0x423AA96B), /* ~= 10^-127 */ + U64(0xAD4AB711, 0x2EB3929D), U64(0x86C16C98, 0xD2C953C6), /* ~= 10^-126 */ + U64(0xD89D64D5, 0x7A607744), U64(0xE871C7BF, 0x077BA8B7), /* ~= 10^-125 */ + U64(0x87625F05, 0x6C7C4A8B), U64(0x11471CD7, 0x64AD4972), /* ~= 10^-124 */ + U64(0xA93AF6C6, 0xC79B5D2D), U64(0xD598E40D, 0x3DD89BCF), /* ~= 10^-123 */ + U64(0xD389B478, 0x79823479), U64(0x4AFF1D10, 0x8D4EC2C3), /* ~= 10^-122 */ + U64(0x843610CB, 0x4BF160CB), U64(0xCEDF722A, 0x585139BA), /* ~= 10^-121 */ + U64(0xA54394FE, 0x1EEDB8FE), U64(0xC2974EB4, 0xEE658828), /* ~= 10^-120 */ + U64(0xCE947A3D, 0xA6A9273E), U64(0x733D2262, 0x29FEEA32), /* ~= 10^-119 */ + U64(0x811CCC66, 0x8829B887), U64(0x0806357D, 0x5A3F525F), /* ~= 10^-118 */ + U64(0xA163FF80, 0x2A3426A8), U64(0xCA07C2DC, 0xB0CF26F7), /* ~= 10^-117 */ + U64(0xC9BCFF60, 0x34C13052), U64(0xFC89B393, 0xDD02F0B5), /* ~= 10^-116 */ + U64(0xFC2C3F38, 0x41F17C67), U64(0xBBAC2078, 0xD443ACE2), /* ~= 10^-115 */ + U64(0x9D9BA783, 0x2936EDC0), U64(0xD54B944B, 0x84AA4C0D), /* ~= 10^-114 */ + U64(0xC5029163, 0xF384A931), U64(0x0A9E795E, 0x65D4DF11), /* ~= 10^-113 */ + U64(0xF64335BC, 0xF065D37D), U64(0x4D4617B5, 0xFF4A16D5), /* ~= 10^-112 */ + U64(0x99EA0196, 0x163FA42E), U64(0x504BCED1, 0xBF8E4E45), /* ~= 10^-111 */ + U64(0xC06481FB, 0x9BCF8D39), U64(0xE45EC286, 0x2F71E1D6), /* ~= 10^-110 */ + U64(0xF07DA27A, 0x82C37088), U64(0x5D767327, 0xBB4E5A4C), /* ~= 10^-109 */ + U64(0x964E858C, 0x91BA2655), U64(0x3A6A07F8, 0xD510F86F), /* ~= 10^-108 */ + U64(0xBBE226EF, 0xB628AFEA), U64(0x890489F7, 0x0A55368B), /* ~= 10^-107 */ + U64(0xEADAB0AB, 0xA3B2DBE5), U64(0x2B45AC74, 0xCCEA842E), /* ~= 10^-106 */ + U64(0x92C8AE6B, 0x464FC96F), U64(0x3B0B8BC9, 0x0012929D), /* ~= 10^-105 */ + U64(0xB77ADA06, 0x17E3BBCB), U64(0x09CE6EBB, 0x40173744), /* ~= 10^-104 */ + U64(0xE5599087, 0x9DDCAABD), U64(0xCC420A6A, 0x101D0515), /* ~= 10^-103 */ + U64(0x8F57FA54, 0xC2A9EAB6), U64(0x9FA94682, 0x4A12232D), /* ~= 10^-102 */ + U64(0xB32DF8E9, 0xF3546564), U64(0x47939822, 0xDC96ABF9), /* ~= 10^-101 */ + U64(0xDFF97724, 0x70297EBD), U64(0x59787E2B, 0x93BC56F7), /* ~= 10^-100 */ + U64(0x8BFBEA76, 0xC619EF36), U64(0x57EB4EDB, 0x3C55B65A), /* ~= 10^-99 */ + U64(0xAEFAE514, 0x77A06B03), U64(0xEDE62292, 0x0B6B23F1), /* ~= 10^-98 */ + U64(0xDAB99E59, 0x958885C4), U64(0xE95FAB36, 0x8E45ECED), /* ~= 10^-97 */ + U64(0x88B402F7, 0xFD75539B), U64(0x11DBCB02, 0x18EBB414), /* ~= 10^-96 */ + U64(0xAAE103B5, 0xFCD2A881), U64(0xD652BDC2, 0x9F26A119), /* ~= 10^-95 */ + U64(0xD59944A3, 0x7C0752A2), U64(0x4BE76D33, 0x46F0495F), /* ~= 10^-94 */ + U64(0x857FCAE6, 0x2D8493A5), U64(0x6F70A440, 0x0C562DDB), /* ~= 10^-93 */ + U64(0xA6DFBD9F, 0xB8E5B88E), U64(0xCB4CCD50, 0x0F6BB952), /* ~= 10^-92 */ + U64(0xD097AD07, 0xA71F26B2), U64(0x7E2000A4, 0x1346A7A7), /* ~= 10^-91 */ + U64(0x825ECC24, 0xC873782F), U64(0x8ED40066, 0x8C0C28C8), /* ~= 10^-90 */ + U64(0xA2F67F2D, 0xFA90563B), U64(0x72890080, 0x2F0F32FA), /* ~= 10^-89 */ + U64(0xCBB41EF9, 0x79346BCA), U64(0x4F2B40A0, 0x3AD2FFB9), /* ~= 10^-88 */ + U64(0xFEA126B7, 0xD78186BC), U64(0xE2F610C8, 0x4987BFA8), /* ~= 10^-87 */ + U64(0x9F24B832, 0xE6B0F436), U64(0x0DD9CA7D, 0x2DF4D7C9), /* ~= 10^-86 */ + U64(0xC6EDE63F, 0xA05D3143), U64(0x91503D1C, 0x79720DBB), /* ~= 10^-85 */ + U64(0xF8A95FCF, 0x88747D94), U64(0x75A44C63, 0x97CE912A), /* ~= 10^-84 */ + U64(0x9B69DBE1, 0xB548CE7C), U64(0xC986AFBE, 0x3EE11ABA), /* ~= 10^-83 */ + U64(0xC24452DA, 0x229B021B), U64(0xFBE85BAD, 0xCE996168), /* ~= 10^-82 */ + U64(0xF2D56790, 0xAB41C2A2), U64(0xFAE27299, 0x423FB9C3), /* ~= 10^-81 */ + U64(0x97C560BA, 0x6B0919A5), U64(0xDCCD879F, 0xC967D41A), /* ~= 10^-80 */ + U64(0xBDB6B8E9, 0x05CB600F), U64(0x5400E987, 0xBBC1C920), /* ~= 10^-79 */ + U64(0xED246723, 0x473E3813), U64(0x290123E9, 0xAAB23B68), /* ~= 10^-78 */ + U64(0x9436C076, 0x0C86E30B), U64(0xF9A0B672, 0x0AAF6521), /* ~= 10^-77 */ + U64(0xB9447093, 0x8FA89BCE), U64(0xF808E40E, 0x8D5B3E69), /* ~= 10^-76 */ + U64(0xE7958CB8, 0x7392C2C2), U64(0xB60B1D12, 0x30B20E04), /* ~= 10^-75 */ + U64(0x90BD77F3, 0x483BB9B9), U64(0xB1C6F22B, 0x5E6F48C2), /* ~= 10^-74 */ + U64(0xB4ECD5F0, 0x1A4AA828), U64(0x1E38AEB6, 0x360B1AF3), /* ~= 10^-73 */ + U64(0xE2280B6C, 0x20DD5232), U64(0x25C6DA63, 0xC38DE1B0), /* ~= 10^-72 */ + U64(0x8D590723, 0x948A535F), U64(0x579C487E, 0x5A38AD0E), /* ~= 10^-71 */ + U64(0xB0AF48EC, 0x79ACE837), U64(0x2D835A9D, 0xF0C6D851), /* ~= 10^-70 */ + U64(0xDCDB1B27, 0x98182244), U64(0xF8E43145, 0x6CF88E65), /* ~= 10^-69 */ + U64(0x8A08F0F8, 0xBF0F156B), U64(0x1B8E9ECB, 0x641B58FF), /* ~= 10^-68 */ + U64(0xAC8B2D36, 0xEED2DAC5), U64(0xE272467E, 0x3D222F3F), /* ~= 10^-67 */ + U64(0xD7ADF884, 0xAA879177), U64(0x5B0ED81D, 0xCC6ABB0F), /* ~= 10^-66 */ + U64(0x86CCBB52, 0xEA94BAEA), U64(0x98E94712, 0x9FC2B4E9), /* ~= 10^-65 */ + U64(0xA87FEA27, 0xA539E9A5), U64(0x3F2398D7, 0x47B36224), /* ~= 10^-64 */ + U64(0xD29FE4B1, 0x8E88640E), U64(0x8EEC7F0D, 0x19A03AAD), /* ~= 10^-63 */ + U64(0x83A3EEEE, 0xF9153E89), U64(0x1953CF68, 0x300424AC), /* ~= 10^-62 */ + U64(0xA48CEAAA, 0xB75A8E2B), U64(0x5FA8C342, 0x3C052DD7), /* ~= 10^-61 */ + U64(0xCDB02555, 0x653131B6), U64(0x3792F412, 0xCB06794D), /* ~= 10^-60 */ + U64(0x808E1755, 0x5F3EBF11), U64(0xE2BBD88B, 0xBEE40BD0), /* ~= 10^-59 */ + U64(0xA0B19D2A, 0xB70E6ED6), U64(0x5B6ACEAE, 0xAE9D0EC4), /* ~= 10^-58 */ + U64(0xC8DE0475, 0x64D20A8B), U64(0xF245825A, 0x5A445275), /* ~= 10^-57 */ + U64(0xFB158592, 0xBE068D2E), U64(0xEED6E2F0, 0xF0D56712), /* ~= 10^-56 */ + U64(0x9CED737B, 0xB6C4183D), U64(0x55464DD6, 0x9685606B), /* ~= 10^-55 */ + U64(0xC428D05A, 0xA4751E4C), U64(0xAA97E14C, 0x3C26B886), /* ~= 10^-54 */ + U64(0xF5330471, 0x4D9265DF), U64(0xD53DD99F, 0x4B3066A8), /* ~= 10^-53 */ + U64(0x993FE2C6, 0xD07B7FAB), U64(0xE546A803, 0x8EFE4029), /* ~= 10^-52 */ + U64(0xBF8FDB78, 0x849A5F96), U64(0xDE985204, 0x72BDD033), /* ~= 10^-51 */ + U64(0xEF73D256, 0xA5C0F77C), U64(0x963E6685, 0x8F6D4440), /* ~= 10^-50 */ + U64(0x95A86376, 0x27989AAD), U64(0xDDE70013, 0x79A44AA8), /* ~= 10^-49 */ + U64(0xBB127C53, 0xB17EC159), U64(0x5560C018, 0x580D5D52), /* ~= 10^-48 */ + U64(0xE9D71B68, 0x9DDE71AF), U64(0xAAB8F01E, 0x6E10B4A6), /* ~= 10^-47 */ + U64(0x92267121, 0x62AB070D), U64(0xCAB39613, 0x04CA70E8), /* ~= 10^-46 */ + U64(0xB6B00D69, 0xBB55C8D1), U64(0x3D607B97, 0xC5FD0D22), /* ~= 10^-45 */ + U64(0xE45C10C4, 0x2A2B3B05), U64(0x8CB89A7D, 0xB77C506A), /* ~= 10^-44 */ + U64(0x8EB98A7A, 0x9A5B04E3), U64(0x77F3608E, 0x92ADB242), /* ~= 10^-43 */ + U64(0xB267ED19, 0x40F1C61C), U64(0x55F038B2, 0x37591ED3), /* ~= 10^-42 */ + U64(0xDF01E85F, 0x912E37A3), U64(0x6B6C46DE, 0xC52F6688), /* ~= 10^-41 */ + U64(0x8B61313B, 0xBABCE2C6), U64(0x2323AC4B, 0x3B3DA015), /* ~= 10^-40 */ + U64(0xAE397D8A, 0xA96C1B77), U64(0xABEC975E, 0x0A0D081A), /* ~= 10^-39 */ + U64(0xD9C7DCED, 0x53C72255), U64(0x96E7BD35, 0x8C904A21), /* ~= 10^-38 */ + U64(0x881CEA14, 0x545C7575), U64(0x7E50D641, 0x77DA2E54), /* ~= 10^-37 */ + U64(0xAA242499, 0x697392D2), U64(0xDDE50BD1, 0xD5D0B9E9), /* ~= 10^-36 */ + U64(0xD4AD2DBF, 0xC3D07787), U64(0x955E4EC6, 0x4B44E864), /* ~= 10^-35 */ + U64(0x84EC3C97, 0xDA624AB4), U64(0xBD5AF13B, 0xEF0B113E), /* ~= 10^-34 */ + U64(0xA6274BBD, 0xD0FADD61), U64(0xECB1AD8A, 0xEACDD58E), /* ~= 10^-33 */ + U64(0xCFB11EAD, 0x453994BA), U64(0x67DE18ED, 0xA5814AF2), /* ~= 10^-32 */ + U64(0x81CEB32C, 0x4B43FCF4), U64(0x80EACF94, 0x8770CED7), /* ~= 10^-31 */ + U64(0xA2425FF7, 0x5E14FC31), U64(0xA1258379, 0xA94D028D), /* ~= 10^-30 */ + U64(0xCAD2F7F5, 0x359A3B3E), U64(0x096EE458, 0x13A04330), /* ~= 10^-29 */ + U64(0xFD87B5F2, 0x8300CA0D), U64(0x8BCA9D6E, 0x188853FC), /* ~= 10^-28 */ + U64(0x9E74D1B7, 0x91E07E48), U64(0x775EA264, 0xCF55347D), /* ~= 10^-27 */ + U64(0xC6120625, 0x76589DDA), U64(0x95364AFE, 0x032A819D), /* ~= 10^-26 */ + U64(0xF79687AE, 0xD3EEC551), U64(0x3A83DDBD, 0x83F52204), /* ~= 10^-25 */ + U64(0x9ABE14CD, 0x44753B52), U64(0xC4926A96, 0x72793542), /* ~= 10^-24 */ + U64(0xC16D9A00, 0x95928A27), U64(0x75B7053C, 0x0F178293), /* ~= 10^-23 */ + U64(0xF1C90080, 0xBAF72CB1), U64(0x5324C68B, 0x12DD6338), /* ~= 10^-22 */ + U64(0x971DA050, 0x74DA7BEE), U64(0xD3F6FC16, 0xEBCA5E03), /* ~= 10^-21 */ + U64(0xBCE50864, 0x92111AEA), U64(0x88F4BB1C, 0xA6BCF584), /* ~= 10^-20 */ + U64(0xEC1E4A7D, 0xB69561A5), U64(0x2B31E9E3, 0xD06C32E5), /* ~= 10^-19 */ + U64(0x9392EE8E, 0x921D5D07), U64(0x3AFF322E, 0x62439FCF), /* ~= 10^-18 */ + U64(0xB877AA32, 0x36A4B449), U64(0x09BEFEB9, 0xFAD487C2), /* ~= 10^-17 */ + U64(0xE69594BE, 0xC44DE15B), U64(0x4C2EBE68, 0x7989A9B3), /* ~= 10^-16 */ + U64(0x901D7CF7, 0x3AB0ACD9), U64(0x0F9D3701, 0x4BF60A10), /* ~= 10^-15 */ + U64(0xB424DC35, 0x095CD80F), U64(0x538484C1, 0x9EF38C94), /* ~= 10^-14 */ + U64(0xE12E1342, 0x4BB40E13), U64(0x2865A5F2, 0x06B06FB9), /* ~= 10^-13 */ + U64(0x8CBCCC09, 0x6F5088CB), U64(0xF93F87B7, 0x442E45D3), /* ~= 10^-12 */ + U64(0xAFEBFF0B, 0xCB24AAFE), U64(0xF78F69A5, 0x1539D748), /* ~= 10^-11 */ + U64(0xDBE6FECE, 0xBDEDD5BE), U64(0xB573440E, 0x5A884D1B), /* ~= 10^-10 */ + U64(0x89705F41, 0x36B4A597), U64(0x31680A88, 0xF8953030), /* ~= 10^-9 */ + U64(0xABCC7711, 0x8461CEFC), U64(0xFDC20D2B, 0x36BA7C3D), /* ~= 10^-8 */ + U64(0xD6BF94D5, 0xE57A42BC), U64(0x3D329076, 0x04691B4C), /* ~= 10^-7 */ + U64(0x8637BD05, 0xAF6C69B5), U64(0xA63F9A49, 0xC2C1B10F), /* ~= 10^-6 */ + U64(0xA7C5AC47, 0x1B478423), U64(0x0FCF80DC, 0x33721D53), /* ~= 10^-5 */ + U64(0xD1B71758, 0xE219652B), U64(0xD3C36113, 0x404EA4A8), /* ~= 10^-4 */ + U64(0x83126E97, 0x8D4FDF3B), U64(0x645A1CAC, 0x083126E9), /* ~= 10^-3 */ + U64(0xA3D70A3D, 0x70A3D70A), U64(0x3D70A3D7, 0x0A3D70A3), /* ~= 10^-2 */ + U64(0xCCCCCCCC, 0xCCCCCCCC), U64(0xCCCCCCCC, 0xCCCCCCCC), /* ~= 10^-1 */ + U64(0x80000000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^0 */ + U64(0xA0000000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^1 */ + U64(0xC8000000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^2 */ + U64(0xFA000000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^3 */ + U64(0x9C400000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^4 */ + U64(0xC3500000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^5 */ + U64(0xF4240000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^6 */ + U64(0x98968000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^7 */ + U64(0xBEBC2000, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^8 */ + U64(0xEE6B2800, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^9 */ + U64(0x9502F900, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^10 */ + U64(0xBA43B740, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^11 */ + U64(0xE8D4A510, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^12 */ + U64(0x9184E72A, 0x00000000), U64(0x00000000, 0x00000000), /* == 10^13 */ + U64(0xB5E620F4, 0x80000000), U64(0x00000000, 0x00000000), /* == 10^14 */ + U64(0xE35FA931, 0xA0000000), U64(0x00000000, 0x00000000), /* == 10^15 */ + U64(0x8E1BC9BF, 0x04000000), U64(0x00000000, 0x00000000), /* == 10^16 */ + U64(0xB1A2BC2E, 0xC5000000), U64(0x00000000, 0x00000000), /* == 10^17 */ + U64(0xDE0B6B3A, 0x76400000), U64(0x00000000, 0x00000000), /* == 10^18 */ + U64(0x8AC72304, 0x89E80000), U64(0x00000000, 0x00000000), /* == 10^19 */ + U64(0xAD78EBC5, 0xAC620000), U64(0x00000000, 0x00000000), /* == 10^20 */ + U64(0xD8D726B7, 0x177A8000), U64(0x00000000, 0x00000000), /* == 10^21 */ + U64(0x87867832, 0x6EAC9000), U64(0x00000000, 0x00000000), /* == 10^22 */ + U64(0xA968163F, 0x0A57B400), U64(0x00000000, 0x00000000), /* == 10^23 */ + U64(0xD3C21BCE, 0xCCEDA100), U64(0x00000000, 0x00000000), /* == 10^24 */ + U64(0x84595161, 0x401484A0), U64(0x00000000, 0x00000000), /* == 10^25 */ + U64(0xA56FA5B9, 0x9019A5C8), U64(0x00000000, 0x00000000), /* == 10^26 */ + U64(0xCECB8F27, 0xF4200F3A), U64(0x00000000, 0x00000000), /* == 10^27 */ + U64(0x813F3978, 0xF8940984), U64(0x40000000, 0x00000000), /* == 10^28 */ + U64(0xA18F07D7, 0x36B90BE5), U64(0x50000000, 0x00000000), /* == 10^29 */ + U64(0xC9F2C9CD, 0x04674EDE), U64(0xA4000000, 0x00000000), /* == 10^30 */ + U64(0xFC6F7C40, 0x45812296), U64(0x4D000000, 0x00000000), /* == 10^31 */ + U64(0x9DC5ADA8, 0x2B70B59D), U64(0xF0200000, 0x00000000), /* == 10^32 */ + U64(0xC5371912, 0x364CE305), U64(0x6C280000, 0x00000000), /* == 10^33 */ + U64(0xF684DF56, 0xC3E01BC6), U64(0xC7320000, 0x00000000), /* == 10^34 */ + U64(0x9A130B96, 0x3A6C115C), U64(0x3C7F4000, 0x00000000), /* == 10^35 */ + U64(0xC097CE7B, 0xC90715B3), U64(0x4B9F1000, 0x00000000), /* == 10^36 */ + U64(0xF0BDC21A, 0xBB48DB20), U64(0x1E86D400, 0x00000000), /* == 10^37 */ + U64(0x96769950, 0xB50D88F4), U64(0x13144480, 0x00000000), /* == 10^38 */ + U64(0xBC143FA4, 0xE250EB31), U64(0x17D955A0, 0x00000000), /* == 10^39 */ + U64(0xEB194F8E, 0x1AE525FD), U64(0x5DCFAB08, 0x00000000), /* == 10^40 */ + U64(0x92EFD1B8, 0xD0CF37BE), U64(0x5AA1CAE5, 0x00000000), /* == 10^41 */ + U64(0xB7ABC627, 0x050305AD), U64(0xF14A3D9E, 0x40000000), /* == 10^42 */ + U64(0xE596B7B0, 0xC643C719), U64(0x6D9CCD05, 0xD0000000), /* == 10^43 */ + U64(0x8F7E32CE, 0x7BEA5C6F), U64(0xE4820023, 0xA2000000), /* == 10^44 */ + U64(0xB35DBF82, 0x1AE4F38B), U64(0xDDA2802C, 0x8A800000), /* == 10^45 */ + U64(0xE0352F62, 0xA19E306E), U64(0xD50B2037, 0xAD200000), /* == 10^46 */ + U64(0x8C213D9D, 0xA502DE45), U64(0x4526F422, 0xCC340000), /* == 10^47 */ + U64(0xAF298D05, 0x0E4395D6), U64(0x9670B12B, 0x7F410000), /* == 10^48 */ + U64(0xDAF3F046, 0x51D47B4C), U64(0x3C0CDD76, 0x5F114000), /* == 10^49 */ + U64(0x88D8762B, 0xF324CD0F), U64(0xA5880A69, 0xFB6AC800), /* == 10^50 */ + U64(0xAB0E93B6, 0xEFEE0053), U64(0x8EEA0D04, 0x7A457A00), /* == 10^51 */ + U64(0xD5D238A4, 0xABE98068), U64(0x72A49045, 0x98D6D880), /* == 10^52 */ + U64(0x85A36366, 0xEB71F041), U64(0x47A6DA2B, 0x7F864750), /* == 10^53 */ + U64(0xA70C3C40, 0xA64E6C51), U64(0x999090B6, 0x5F67D924), /* == 10^54 */ + U64(0xD0CF4B50, 0xCFE20765), U64(0xFFF4B4E3, 0xF741CF6D), /* == 10^55 */ + U64(0x82818F12, 0x81ED449F), U64(0xBFF8F10E, 0x7A8921A4), /* ~= 10^56 */ + U64(0xA321F2D7, 0x226895C7), U64(0xAFF72D52, 0x192B6A0D), /* ~= 10^57 */ + U64(0xCBEA6F8C, 0xEB02BB39), U64(0x9BF4F8A6, 0x9F764490), /* ~= 10^58 */ + U64(0xFEE50B70, 0x25C36A08), U64(0x02F236D0, 0x4753D5B4), /* ~= 10^59 */ + U64(0x9F4F2726, 0x179A2245), U64(0x01D76242, 0x2C946590), /* ~= 10^60 */ + U64(0xC722F0EF, 0x9D80AAD6), U64(0x424D3AD2, 0xB7B97EF5), /* ~= 10^61 */ + U64(0xF8EBAD2B, 0x84E0D58B), U64(0xD2E08987, 0x65A7DEB2), /* ~= 10^62 */ + U64(0x9B934C3B, 0x330C8577), U64(0x63CC55F4, 0x9F88EB2F), /* ~= 10^63 */ + U64(0xC2781F49, 0xFFCFA6D5), U64(0x3CBF6B71, 0xC76B25FB), /* ~= 10^64 */ + U64(0xF316271C, 0x7FC3908A), U64(0x8BEF464E, 0x3945EF7A), /* ~= 10^65 */ + U64(0x97EDD871, 0xCFDA3A56), U64(0x97758BF0, 0xE3CBB5AC), /* ~= 10^66 */ + U64(0xBDE94E8E, 0x43D0C8EC), U64(0x3D52EEED, 0x1CBEA317), /* ~= 10^67 */ + U64(0xED63A231, 0xD4C4FB27), U64(0x4CA7AAA8, 0x63EE4BDD), /* ~= 10^68 */ + U64(0x945E455F, 0x24FB1CF8), U64(0x8FE8CAA9, 0x3E74EF6A), /* ~= 10^69 */ + U64(0xB975D6B6, 0xEE39E436), U64(0xB3E2FD53, 0x8E122B44), /* ~= 10^70 */ + U64(0xE7D34C64, 0xA9C85D44), U64(0x60DBBCA8, 0x7196B616), /* ~= 10^71 */ + U64(0x90E40FBE, 0xEA1D3A4A), U64(0xBC8955E9, 0x46FE31CD), /* ~= 10^72 */ + U64(0xB51D13AE, 0xA4A488DD), U64(0x6BABAB63, 0x98BDBE41), /* ~= 10^73 */ + U64(0xE264589A, 0x4DCDAB14), U64(0xC696963C, 0x7EED2DD1), /* ~= 10^74 */ + U64(0x8D7EB760, 0x70A08AEC), U64(0xFC1E1DE5, 0xCF543CA2), /* ~= 10^75 */ + U64(0xB0DE6538, 0x8CC8ADA8), U64(0x3B25A55F, 0x43294BCB), /* ~= 10^76 */ + U64(0xDD15FE86, 0xAFFAD912), U64(0x49EF0EB7, 0x13F39EBE), /* ~= 10^77 */ + U64(0x8A2DBF14, 0x2DFCC7AB), U64(0x6E356932, 0x6C784337), /* ~= 10^78 */ + U64(0xACB92ED9, 0x397BF996), U64(0x49C2C37F, 0x07965404), /* ~= 10^79 */ + U64(0xD7E77A8F, 0x87DAF7FB), U64(0xDC33745E, 0xC97BE906), /* ~= 10^80 */ + U64(0x86F0AC99, 0xB4E8DAFD), U64(0x69A028BB, 0x3DED71A3), /* ~= 10^81 */ + U64(0xA8ACD7C0, 0x222311BC), U64(0xC40832EA, 0x0D68CE0C), /* ~= 10^82 */ + U64(0xD2D80DB0, 0x2AABD62B), U64(0xF50A3FA4, 0x90C30190), /* ~= 10^83 */ + U64(0x83C7088E, 0x1AAB65DB), U64(0x792667C6, 0xDA79E0FA), /* ~= 10^84 */ + U64(0xA4B8CAB1, 0xA1563F52), U64(0x577001B8, 0x91185938), /* ~= 10^85 */ + U64(0xCDE6FD5E, 0x09ABCF26), U64(0xED4C0226, 0xB55E6F86), /* ~= 10^86 */ + U64(0x80B05E5A, 0xC60B6178), U64(0x544F8158, 0x315B05B4), /* ~= 10^87 */ + U64(0xA0DC75F1, 0x778E39D6), U64(0x696361AE, 0x3DB1C721), /* ~= 10^88 */ + U64(0xC913936D, 0xD571C84C), U64(0x03BC3A19, 0xCD1E38E9), /* ~= 10^89 */ + U64(0xFB587849, 0x4ACE3A5F), U64(0x04AB48A0, 0x4065C723), /* ~= 10^90 */ + U64(0x9D174B2D, 0xCEC0E47B), U64(0x62EB0D64, 0x283F9C76), /* ~= 10^91 */ + U64(0xC45D1DF9, 0x42711D9A), U64(0x3BA5D0BD, 0x324F8394), /* ~= 10^92 */ + U64(0xF5746577, 0x930D6500), U64(0xCA8F44EC, 0x7EE36479), /* ~= 10^93 */ + U64(0x9968BF6A, 0xBBE85F20), U64(0x7E998B13, 0xCF4E1ECB), /* ~= 10^94 */ + U64(0xBFC2EF45, 0x6AE276E8), U64(0x9E3FEDD8, 0xC321A67E), /* ~= 10^95 */ + U64(0xEFB3AB16, 0xC59B14A2), U64(0xC5CFE94E, 0xF3EA101E), /* ~= 10^96 */ + U64(0x95D04AEE, 0x3B80ECE5), U64(0xBBA1F1D1, 0x58724A12), /* ~= 10^97 */ + U64(0xBB445DA9, 0xCA61281F), U64(0x2A8A6E45, 0xAE8EDC97), /* ~= 10^98 */ + U64(0xEA157514, 0x3CF97226), U64(0xF52D09D7, 0x1A3293BD), /* ~= 10^99 */ + U64(0x924D692C, 0xA61BE758), U64(0x593C2626, 0x705F9C56), /* ~= 10^100 */ + U64(0xB6E0C377, 0xCFA2E12E), U64(0x6F8B2FB0, 0x0C77836C), /* ~= 10^101 */ + U64(0xE498F455, 0xC38B997A), U64(0x0B6DFB9C, 0x0F956447), /* ~= 10^102 */ + U64(0x8EDF98B5, 0x9A373FEC), U64(0x4724BD41, 0x89BD5EAC), /* ~= 10^103 */ + U64(0xB2977EE3, 0x00C50FE7), U64(0x58EDEC91, 0xEC2CB657), /* ~= 10^104 */ + U64(0xDF3D5E9B, 0xC0F653E1), U64(0x2F2967B6, 0x6737E3ED), /* ~= 10^105 */ + U64(0x8B865B21, 0x5899F46C), U64(0xBD79E0D2, 0x0082EE74), /* ~= 10^106 */ + U64(0xAE67F1E9, 0xAEC07187), U64(0xECD85906, 0x80A3AA11), /* ~= 10^107 */ + U64(0xDA01EE64, 0x1A708DE9), U64(0xE80E6F48, 0x20CC9495), /* ~= 10^108 */ + U64(0x884134FE, 0x908658B2), U64(0x3109058D, 0x147FDCDD), /* ~= 10^109 */ + U64(0xAA51823E, 0x34A7EEDE), U64(0xBD4B46F0, 0x599FD415), /* ~= 10^110 */ + U64(0xD4E5E2CD, 0xC1D1EA96), U64(0x6C9E18AC, 0x7007C91A), /* ~= 10^111 */ + U64(0x850FADC0, 0x9923329E), U64(0x03E2CF6B, 0xC604DDB0), /* ~= 10^112 */ + U64(0xA6539930, 0xBF6BFF45), U64(0x84DB8346, 0xB786151C), /* ~= 10^113 */ + U64(0xCFE87F7C, 0xEF46FF16), U64(0xE6126418, 0x65679A63), /* ~= 10^114 */ + U64(0x81F14FAE, 0x158C5F6E), U64(0x4FCB7E8F, 0x3F60C07E), /* ~= 10^115 */ + U64(0xA26DA399, 0x9AEF7749), U64(0xE3BE5E33, 0x0F38F09D), /* ~= 10^116 */ + U64(0xCB090C80, 0x01AB551C), U64(0x5CADF5BF, 0xD3072CC5), /* ~= 10^117 */ + U64(0xFDCB4FA0, 0x02162A63), U64(0x73D9732F, 0xC7C8F7F6), /* ~= 10^118 */ + U64(0x9E9F11C4, 0x014DDA7E), U64(0x2867E7FD, 0xDCDD9AFA), /* ~= 10^119 */ + U64(0xC646D635, 0x01A1511D), U64(0xB281E1FD, 0x541501B8), /* ~= 10^120 */ + U64(0xF7D88BC2, 0x4209A565), U64(0x1F225A7C, 0xA91A4226), /* ~= 10^121 */ + U64(0x9AE75759, 0x6946075F), U64(0x3375788D, 0xE9B06958), /* ~= 10^122 */ + U64(0xC1A12D2F, 0xC3978937), U64(0x0052D6B1, 0x641C83AE), /* ~= 10^123 */ + U64(0xF209787B, 0xB47D6B84), U64(0xC0678C5D, 0xBD23A49A), /* ~= 10^124 */ + U64(0x9745EB4D, 0x50CE6332), U64(0xF840B7BA, 0x963646E0), /* ~= 10^125 */ + U64(0xBD176620, 0xA501FBFF), U64(0xB650E5A9, 0x3BC3D898), /* ~= 10^126 */ + U64(0xEC5D3FA8, 0xCE427AFF), U64(0xA3E51F13, 0x8AB4CEBE), /* ~= 10^127 */ + U64(0x93BA47C9, 0x80E98CDF), U64(0xC66F336C, 0x36B10137), /* ~= 10^128 */ + U64(0xB8A8D9BB, 0xE123F017), U64(0xB80B0047, 0x445D4184), /* ~= 10^129 */ + U64(0xE6D3102A, 0xD96CEC1D), U64(0xA60DC059, 0x157491E5), /* ~= 10^130 */ + U64(0x9043EA1A, 0xC7E41392), U64(0x87C89837, 0xAD68DB2F), /* ~= 10^131 */ + U64(0xB454E4A1, 0x79DD1877), U64(0x29BABE45, 0x98C311FB), /* ~= 10^132 */ + U64(0xE16A1DC9, 0xD8545E94), U64(0xF4296DD6, 0xFEF3D67A), /* ~= 10^133 */ + U64(0x8CE2529E, 0x2734BB1D), U64(0x1899E4A6, 0x5F58660C), /* ~= 10^134 */ + U64(0xB01AE745, 0xB101E9E4), U64(0x5EC05DCF, 0xF72E7F8F), /* ~= 10^135 */ + U64(0xDC21A117, 0x1D42645D), U64(0x76707543, 0xF4FA1F73), /* ~= 10^136 */ + U64(0x899504AE, 0x72497EBA), U64(0x6A06494A, 0x791C53A8), /* ~= 10^137 */ + U64(0xABFA45DA, 0x0EDBDE69), U64(0x0487DB9D, 0x17636892), /* ~= 10^138 */ + U64(0xD6F8D750, 0x9292D603), U64(0x45A9D284, 0x5D3C42B6), /* ~= 10^139 */ + U64(0x865B8692, 0x5B9BC5C2), U64(0x0B8A2392, 0xBA45A9B2), /* ~= 10^140 */ + U64(0xA7F26836, 0xF282B732), U64(0x8E6CAC77, 0x68D7141E), /* ~= 10^141 */ + U64(0xD1EF0244, 0xAF2364FF), U64(0x3207D795, 0x430CD926), /* ~= 10^142 */ + U64(0x8335616A, 0xED761F1F), U64(0x7F44E6BD, 0x49E807B8), /* ~= 10^143 */ + U64(0xA402B9C5, 0xA8D3A6E7), U64(0x5F16206C, 0x9C6209A6), /* ~= 10^144 */ + U64(0xCD036837, 0x130890A1), U64(0x36DBA887, 0xC37A8C0F), /* ~= 10^145 */ + U64(0x80222122, 0x6BE55A64), U64(0xC2494954, 0xDA2C9789), /* ~= 10^146 */ + U64(0xA02AA96B, 0x06DEB0FD), U64(0xF2DB9BAA, 0x10B7BD6C), /* ~= 10^147 */ + U64(0xC83553C5, 0xC8965D3D), U64(0x6F928294, 0x94E5ACC7), /* ~= 10^148 */ + U64(0xFA42A8B7, 0x3ABBF48C), U64(0xCB772339, 0xBA1F17F9), /* ~= 10^149 */ + U64(0x9C69A972, 0x84B578D7), U64(0xFF2A7604, 0x14536EFB), /* ~= 10^150 */ + U64(0xC38413CF, 0x25E2D70D), U64(0xFEF51385, 0x19684ABA), /* ~= 10^151 */ + U64(0xF46518C2, 0xEF5B8CD1), U64(0x7EB25866, 0x5FC25D69), /* ~= 10^152 */ + U64(0x98BF2F79, 0xD5993802), U64(0xEF2F773F, 0xFBD97A61), /* ~= 10^153 */ + U64(0xBEEEFB58, 0x4AFF8603), U64(0xAAFB550F, 0xFACFD8FA), /* ~= 10^154 */ + U64(0xEEAABA2E, 0x5DBF6784), U64(0x95BA2A53, 0xF983CF38), /* ~= 10^155 */ + U64(0x952AB45C, 0xFA97A0B2), U64(0xDD945A74, 0x7BF26183), /* ~= 10^156 */ + U64(0xBA756174, 0x393D88DF), U64(0x94F97111, 0x9AEEF9E4), /* ~= 10^157 */ + U64(0xE912B9D1, 0x478CEB17), U64(0x7A37CD56, 0x01AAB85D), /* ~= 10^158 */ + U64(0x91ABB422, 0xCCB812EE), U64(0xAC62E055, 0xC10AB33A), /* ~= 10^159 */ + U64(0xB616A12B, 0x7FE617AA), U64(0x577B986B, 0x314D6009), /* ~= 10^160 */ + U64(0xE39C4976, 0x5FDF9D94), U64(0xED5A7E85, 0xFDA0B80B), /* ~= 10^161 */ + U64(0x8E41ADE9, 0xFBEBC27D), U64(0x14588F13, 0xBE847307), /* ~= 10^162 */ + U64(0xB1D21964, 0x7AE6B31C), U64(0x596EB2D8, 0xAE258FC8), /* ~= 10^163 */ + U64(0xDE469FBD, 0x99A05FE3), U64(0x6FCA5F8E, 0xD9AEF3BB), /* ~= 10^164 */ + U64(0x8AEC23D6, 0x80043BEE), U64(0x25DE7BB9, 0x480D5854), /* ~= 10^165 */ + U64(0xADA72CCC, 0x20054AE9), U64(0xAF561AA7, 0x9A10AE6A), /* ~= 10^166 */ + U64(0xD910F7FF, 0x28069DA4), U64(0x1B2BA151, 0x8094DA04), /* ~= 10^167 */ + U64(0x87AA9AFF, 0x79042286), U64(0x90FB44D2, 0xF05D0842), /* ~= 10^168 */ + U64(0xA99541BF, 0x57452B28), U64(0x353A1607, 0xAC744A53), /* ~= 10^169 */ + U64(0xD3FA922F, 0x2D1675F2), U64(0x42889B89, 0x97915CE8), /* ~= 10^170 */ + U64(0x847C9B5D, 0x7C2E09B7), U64(0x69956135, 0xFEBADA11), /* ~= 10^171 */ + U64(0xA59BC234, 0xDB398C25), U64(0x43FAB983, 0x7E699095), /* ~= 10^172 */ + U64(0xCF02B2C2, 0x1207EF2E), U64(0x94F967E4, 0x5E03F4BB), /* ~= 10^173 */ + U64(0x8161AFB9, 0x4B44F57D), U64(0x1D1BE0EE, 0xBAC278F5), /* ~= 10^174 */ + U64(0xA1BA1BA7, 0x9E1632DC), U64(0x6462D92A, 0x69731732), /* ~= 10^175 */ + U64(0xCA28A291, 0x859BBF93), U64(0x7D7B8F75, 0x03CFDCFE), /* ~= 10^176 */ + U64(0xFCB2CB35, 0xE702AF78), U64(0x5CDA7352, 0x44C3D43E), /* ~= 10^177 */ + U64(0x9DEFBF01, 0xB061ADAB), U64(0x3A088813, 0x6AFA64A7), /* ~= 10^178 */ + U64(0xC56BAEC2, 0x1C7A1916), U64(0x088AAA18, 0x45B8FDD0), /* ~= 10^179 */ + U64(0xF6C69A72, 0xA3989F5B), U64(0x8AAD549E, 0x57273D45), /* ~= 10^180 */ + U64(0x9A3C2087, 0xA63F6399), U64(0x36AC54E2, 0xF678864B), /* ~= 10^181 */ + U64(0xC0CB28A9, 0x8FCF3C7F), U64(0x84576A1B, 0xB416A7DD), /* ~= 10^182 */ + U64(0xF0FDF2D3, 0xF3C30B9F), U64(0x656D44A2, 0xA11C51D5), /* ~= 10^183 */ + U64(0x969EB7C4, 0x7859E743), U64(0x9F644AE5, 0xA4B1B325), /* ~= 10^184 */ + U64(0xBC4665B5, 0x96706114), U64(0x873D5D9F, 0x0DDE1FEE), /* ~= 10^185 */ + U64(0xEB57FF22, 0xFC0C7959), U64(0xA90CB506, 0xD155A7EA), /* ~= 10^186 */ + U64(0x9316FF75, 0xDD87CBD8), U64(0x09A7F124, 0x42D588F2), /* ~= 10^187 */ + U64(0xB7DCBF53, 0x54E9BECE), U64(0x0C11ED6D, 0x538AEB2F), /* ~= 10^188 */ + U64(0xE5D3EF28, 0x2A242E81), U64(0x8F1668C8, 0xA86DA5FA), /* ~= 10^189 */ + U64(0x8FA47579, 0x1A569D10), U64(0xF96E017D, 0x694487BC), /* ~= 10^190 */ + U64(0xB38D92D7, 0x60EC4455), U64(0x37C981DC, 0xC395A9AC), /* ~= 10^191 */ + U64(0xE070F78D, 0x3927556A), U64(0x85BBE253, 0xF47B1417), /* ~= 10^192 */ + U64(0x8C469AB8, 0x43B89562), U64(0x93956D74, 0x78CCEC8E), /* ~= 10^193 */ + U64(0xAF584166, 0x54A6BABB), U64(0x387AC8D1, 0x970027B2), /* ~= 10^194 */ + U64(0xDB2E51BF, 0xE9D0696A), U64(0x06997B05, 0xFCC0319E), /* ~= 10^195 */ + U64(0x88FCF317, 0xF22241E2), U64(0x441FECE3, 0xBDF81F03), /* ~= 10^196 */ + U64(0xAB3C2FDD, 0xEEAAD25A), U64(0xD527E81C, 0xAD7626C3), /* ~= 10^197 */ + U64(0xD60B3BD5, 0x6A5586F1), U64(0x8A71E223, 0xD8D3B074), /* ~= 10^198 */ + U64(0x85C70565, 0x62757456), U64(0xF6872D56, 0x67844E49), /* ~= 10^199 */ + U64(0xA738C6BE, 0xBB12D16C), U64(0xB428F8AC, 0x016561DB), /* ~= 10^200 */ + U64(0xD106F86E, 0x69D785C7), U64(0xE13336D7, 0x01BEBA52), /* ~= 10^201 */ + U64(0x82A45B45, 0x0226B39C), U64(0xECC00246, 0x61173473), /* ~= 10^202 */ + U64(0xA34D7216, 0x42B06084), U64(0x27F002D7, 0xF95D0190), /* ~= 10^203 */ + U64(0xCC20CE9B, 0xD35C78A5), U64(0x31EC038D, 0xF7B441F4), /* ~= 10^204 */ + U64(0xFF290242, 0xC83396CE), U64(0x7E670471, 0x75A15271), /* ~= 10^205 */ + U64(0x9F79A169, 0xBD203E41), U64(0x0F0062C6, 0xE984D386), /* ~= 10^206 */ + U64(0xC75809C4, 0x2C684DD1), U64(0x52C07B78, 0xA3E60868), /* ~= 10^207 */ + U64(0xF92E0C35, 0x37826145), U64(0xA7709A56, 0xCCDF8A82), /* ~= 10^208 */ + U64(0x9BBCC7A1, 0x42B17CCB), U64(0x88A66076, 0x400BB691), /* ~= 10^209 */ + U64(0xC2ABF989, 0x935DDBFE), U64(0x6ACFF893, 0xD00EA435), /* ~= 10^210 */ + U64(0xF356F7EB, 0xF83552FE), U64(0x0583F6B8, 0xC4124D43), /* ~= 10^211 */ + U64(0x98165AF3, 0x7B2153DE), U64(0xC3727A33, 0x7A8B704A), /* ~= 10^212 */ + U64(0xBE1BF1B0, 0x59E9A8D6), U64(0x744F18C0, 0x592E4C5C), /* ~= 10^213 */ + U64(0xEDA2EE1C, 0x7064130C), U64(0x1162DEF0, 0x6F79DF73), /* ~= 10^214 */ + U64(0x9485D4D1, 0xC63E8BE7), U64(0x8ADDCB56, 0x45AC2BA8), /* ~= 10^215 */ + U64(0xB9A74A06, 0x37CE2EE1), U64(0x6D953E2B, 0xD7173692), /* ~= 10^216 */ + U64(0xE8111C87, 0xC5C1BA99), U64(0xC8FA8DB6, 0xCCDD0437), /* ~= 10^217 */ + U64(0x910AB1D4, 0xDB9914A0), U64(0x1D9C9892, 0x400A22A2), /* ~= 10^218 */ + U64(0xB54D5E4A, 0x127F59C8), U64(0x2503BEB6, 0xD00CAB4B), /* ~= 10^219 */ + U64(0xE2A0B5DC, 0x971F303A), U64(0x2E44AE64, 0x840FD61D), /* ~= 10^220 */ + U64(0x8DA471A9, 0xDE737E24), U64(0x5CEAECFE, 0xD289E5D2), /* ~= 10^221 */ + U64(0xB10D8E14, 0x56105DAD), U64(0x7425A83E, 0x872C5F47), /* ~= 10^222 */ + U64(0xDD50F199, 0x6B947518), U64(0xD12F124E, 0x28F77719), /* ~= 10^223 */ + U64(0x8A5296FF, 0xE33CC92F), U64(0x82BD6B70, 0xD99AAA6F), /* ~= 10^224 */ + U64(0xACE73CBF, 0xDC0BFB7B), U64(0x636CC64D, 0x1001550B), /* ~= 10^225 */ + U64(0xD8210BEF, 0xD30EFA5A), U64(0x3C47F7E0, 0x5401AA4E), /* ~= 10^226 */ + U64(0x8714A775, 0xE3E95C78), U64(0x65ACFAEC, 0x34810A71), /* ~= 10^227 */ + U64(0xA8D9D153, 0x5CE3B396), U64(0x7F1839A7, 0x41A14D0D), /* ~= 10^228 */ + U64(0xD31045A8, 0x341CA07C), U64(0x1EDE4811, 0x1209A050), /* ~= 10^229 */ + U64(0x83EA2B89, 0x2091E44D), U64(0x934AED0A, 0xAB460432), /* ~= 10^230 */ + U64(0xA4E4B66B, 0x68B65D60), U64(0xF81DA84D, 0x5617853F), /* ~= 10^231 */ + U64(0xCE1DE406, 0x42E3F4B9), U64(0x36251260, 0xAB9D668E), /* ~= 10^232 */ + U64(0x80D2AE83, 0xE9CE78F3), U64(0xC1D72B7C, 0x6B426019), /* ~= 10^233 */ + U64(0xA1075A24, 0xE4421730), U64(0xB24CF65B, 0x8612F81F), /* ~= 10^234 */ + U64(0xC94930AE, 0x1D529CFC), U64(0xDEE033F2, 0x6797B627), /* ~= 10^235 */ + U64(0xFB9B7CD9, 0xA4A7443C), U64(0x169840EF, 0x017DA3B1), /* ~= 10^236 */ + U64(0x9D412E08, 0x06E88AA5), U64(0x8E1F2895, 0x60EE864E), /* ~= 10^237 */ + U64(0xC491798A, 0x08A2AD4E), U64(0xF1A6F2BA, 0xB92A27E2), /* ~= 10^238 */ + U64(0xF5B5D7EC, 0x8ACB58A2), U64(0xAE10AF69, 0x6774B1DB), /* ~= 10^239 */ + U64(0x9991A6F3, 0xD6BF1765), U64(0xACCA6DA1, 0xE0A8EF29), /* ~= 10^240 */ + U64(0xBFF610B0, 0xCC6EDD3F), U64(0x17FD090A, 0x58D32AF3), /* ~= 10^241 */ + U64(0xEFF394DC, 0xFF8A948E), U64(0xDDFC4B4C, 0xEF07F5B0), /* ~= 10^242 */ + U64(0x95F83D0A, 0x1FB69CD9), U64(0x4ABDAF10, 0x1564F98E), /* ~= 10^243 */ + U64(0xBB764C4C, 0xA7A4440F), U64(0x9D6D1AD4, 0x1ABE37F1), /* ~= 10^244 */ + U64(0xEA53DF5F, 0xD18D5513), U64(0x84C86189, 0x216DC5ED), /* ~= 10^245 */ + U64(0x92746B9B, 0xE2F8552C), U64(0x32FD3CF5, 0xB4E49BB4), /* ~= 10^246 */ + U64(0xB7118682, 0xDBB66A77), U64(0x3FBC8C33, 0x221DC2A1), /* ~= 10^247 */ + U64(0xE4D5E823, 0x92A40515), U64(0x0FABAF3F, 0xEAA5334A), /* ~= 10^248 */ + U64(0x8F05B116, 0x3BA6832D), U64(0x29CB4D87, 0xF2A7400E), /* ~= 10^249 */ + U64(0xB2C71D5B, 0xCA9023F8), U64(0x743E20E9, 0xEF511012), /* ~= 10^250 */ + U64(0xDF78E4B2, 0xBD342CF6), U64(0x914DA924, 0x6B255416), /* ~= 10^251 */ + U64(0x8BAB8EEF, 0xB6409C1A), U64(0x1AD089B6, 0xC2F7548E), /* ~= 10^252 */ + U64(0xAE9672AB, 0xA3D0C320), U64(0xA184AC24, 0x73B529B1), /* ~= 10^253 */ + U64(0xDA3C0F56, 0x8CC4F3E8), U64(0xC9E5D72D, 0x90A2741E), /* ~= 10^254 */ + U64(0x88658996, 0x17FB1871), U64(0x7E2FA67C, 0x7A658892), /* ~= 10^255 */ + U64(0xAA7EEBFB, 0x9DF9DE8D), U64(0xDDBB901B, 0x98FEEAB7), /* ~= 10^256 */ + U64(0xD51EA6FA, 0x85785631), U64(0x552A7422, 0x7F3EA565), /* ~= 10^257 */ + U64(0x8533285C, 0x936B35DE), U64(0xD53A8895, 0x8F87275F), /* ~= 10^258 */ + U64(0xA67FF273, 0xB8460356), U64(0x8A892ABA, 0xF368F137), /* ~= 10^259 */ + U64(0xD01FEF10, 0xA657842C), U64(0x2D2B7569, 0xB0432D85), /* ~= 10^260 */ + U64(0x8213F56A, 0x67F6B29B), U64(0x9C3B2962, 0x0E29FC73), /* ~= 10^261 */ + U64(0xA298F2C5, 0x01F45F42), U64(0x8349F3BA, 0x91B47B8F), /* ~= 10^262 */ + U64(0xCB3F2F76, 0x42717713), U64(0x241C70A9, 0x36219A73), /* ~= 10^263 */ + U64(0xFE0EFB53, 0xD30DD4D7), U64(0xED238CD3, 0x83AA0110), /* ~= 10^264 */ + U64(0x9EC95D14, 0x63E8A506), U64(0xF4363804, 0x324A40AA), /* ~= 10^265 */ + U64(0xC67BB459, 0x7CE2CE48), U64(0xB143C605, 0x3EDCD0D5), /* ~= 10^266 */ + U64(0xF81AA16F, 0xDC1B81DA), U64(0xDD94B786, 0x8E94050A), /* ~= 10^267 */ + U64(0x9B10A4E5, 0xE9913128), U64(0xCA7CF2B4, 0x191C8326), /* ~= 10^268 */ + U64(0xC1D4CE1F, 0x63F57D72), U64(0xFD1C2F61, 0x1F63A3F0), /* ~= 10^269 */ + U64(0xF24A01A7, 0x3CF2DCCF), U64(0xBC633B39, 0x673C8CEC), /* ~= 10^270 */ + U64(0x976E4108, 0x8617CA01), U64(0xD5BE0503, 0xE085D813), /* ~= 10^271 */ + U64(0xBD49D14A, 0xA79DBC82), U64(0x4B2D8644, 0xD8A74E18), /* ~= 10^272 */ + U64(0xEC9C459D, 0x51852BA2), U64(0xDDF8E7D6, 0x0ED1219E), /* ~= 10^273 */ + U64(0x93E1AB82, 0x52F33B45), U64(0xCABB90E5, 0xC942B503), /* ~= 10^274 */ + U64(0xB8DA1662, 0xE7B00A17), U64(0x3D6A751F, 0x3B936243), /* ~= 10^275 */ + U64(0xE7109BFB, 0xA19C0C9D), U64(0x0CC51267, 0x0A783AD4), /* ~= 10^276 */ + U64(0x906A617D, 0x450187E2), U64(0x27FB2B80, 0x668B24C5), /* ~= 10^277 */ + U64(0xB484F9DC, 0x9641E9DA), U64(0xB1F9F660, 0x802DEDF6), /* ~= 10^278 */ + U64(0xE1A63853, 0xBBD26451), U64(0x5E7873F8, 0xA0396973), /* ~= 10^279 */ + U64(0x8D07E334, 0x55637EB2), U64(0xDB0B487B, 0x6423E1E8), /* ~= 10^280 */ + U64(0xB049DC01, 0x6ABC5E5F), U64(0x91CE1A9A, 0x3D2CDA62), /* ~= 10^281 */ + U64(0xDC5C5301, 0xC56B75F7), U64(0x7641A140, 0xCC7810FB), /* ~= 10^282 */ + U64(0x89B9B3E1, 0x1B6329BA), U64(0xA9E904C8, 0x7FCB0A9D), /* ~= 10^283 */ + U64(0xAC2820D9, 0x623BF429), U64(0x546345FA, 0x9FBDCD44), /* ~= 10^284 */ + U64(0xD732290F, 0xBACAF133), U64(0xA97C1779, 0x47AD4095), /* ~= 10^285 */ + U64(0x867F59A9, 0xD4BED6C0), U64(0x49ED8EAB, 0xCCCC485D), /* ~= 10^286 */ + U64(0xA81F3014, 0x49EE8C70), U64(0x5C68F256, 0xBFFF5A74), /* ~= 10^287 */ + U64(0xD226FC19, 0x5C6A2F8C), U64(0x73832EEC, 0x6FFF3111), /* ~= 10^288 */ + U64(0x83585D8F, 0xD9C25DB7), U64(0xC831FD53, 0xC5FF7EAB), /* ~= 10^289 */ + U64(0xA42E74F3, 0xD032F525), U64(0xBA3E7CA8, 0xB77F5E55), /* ~= 10^290 */ + U64(0xCD3A1230, 0xC43FB26F), U64(0x28CE1BD2, 0xE55F35EB), /* ~= 10^291 */ + U64(0x80444B5E, 0x7AA7CF85), U64(0x7980D163, 0xCF5B81B3), /* ~= 10^292 */ + U64(0xA0555E36, 0x1951C366), U64(0xD7E105BC, 0xC332621F), /* ~= 10^293 */ + U64(0xC86AB5C3, 0x9FA63440), U64(0x8DD9472B, 0xF3FEFAA7), /* ~= 10^294 */ + U64(0xFA856334, 0x878FC150), U64(0xB14F98F6, 0xF0FEB951), /* ~= 10^295 */ + U64(0x9C935E00, 0xD4B9D8D2), U64(0x6ED1BF9A, 0x569F33D3), /* ~= 10^296 */ + U64(0xC3B83581, 0x09E84F07), U64(0x0A862F80, 0xEC4700C8), /* ~= 10^297 */ + U64(0xF4A642E1, 0x4C6262C8), U64(0xCD27BB61, 0x2758C0FA), /* ~= 10^298 */ + U64(0x98E7E9CC, 0xCFBD7DBD), U64(0x8038D51C, 0xB897789C), /* ~= 10^299 */ + U64(0xBF21E440, 0x03ACDD2C), U64(0xE0470A63, 0xE6BD56C3), /* ~= 10^300 */ + U64(0xEEEA5D50, 0x04981478), U64(0x1858CCFC, 0xE06CAC74), /* ~= 10^301 */ + U64(0x95527A52, 0x02DF0CCB), U64(0x0F37801E, 0x0C43EBC8), /* ~= 10^302 */ + U64(0xBAA718E6, 0x8396CFFD), U64(0xD3056025, 0x8F54E6BA), /* ~= 10^303 */ + U64(0xE950DF20, 0x247C83FD), U64(0x47C6B82E, 0xF32A2069), /* ~= 10^304 */ + U64(0x91D28B74, 0x16CDD27E), U64(0x4CDC331D, 0x57FA5441), /* ~= 10^305 */ + U64(0xB6472E51, 0x1C81471D), U64(0xE0133FE4, 0xADF8E952), /* ~= 10^306 */ + U64(0xE3D8F9E5, 0x63A198E5), U64(0x58180FDD, 0xD97723A6), /* ~= 10^307 */ + U64(0x8E679C2F, 0x5E44FF8F), U64(0x570F09EA, 0xA7EA7648), /* ~= 10^308 */ + U64(0xB201833B, 0x35D63F73), U64(0x2CD2CC65, 0x51E513DA), /* ~= 10^309 */ + U64(0xDE81E40A, 0x034BCF4F), U64(0xF8077F7E, 0xA65E58D1), /* ~= 10^310 */ + U64(0x8B112E86, 0x420F6191), U64(0xFB04AFAF, 0x27FAF782), /* ~= 10^311 */ + U64(0xADD57A27, 0xD29339F6), U64(0x79C5DB9A, 0xF1F9B563), /* ~= 10^312 */ + U64(0xD94AD8B1, 0xC7380874), U64(0x18375281, 0xAE7822BC), /* ~= 10^313 */ + U64(0x87CEC76F, 0x1C830548), U64(0x8F229391, 0x0D0B15B5), /* ~= 10^314 */ + U64(0xA9C2794A, 0xE3A3C69A), U64(0xB2EB3875, 0x504DDB22), /* ~= 10^315 */ + U64(0xD433179D, 0x9C8CB841), U64(0x5FA60692, 0xA46151EB), /* ~= 10^316 */ + U64(0x849FEEC2, 0x81D7F328), U64(0xDBC7C41B, 0xA6BCD333), /* ~= 10^317 */ + U64(0xA5C7EA73, 0x224DEFF3), U64(0x12B9B522, 0x906C0800), /* ~= 10^318 */ + U64(0xCF39E50F, 0xEAE16BEF), U64(0xD768226B, 0x34870A00), /* ~= 10^319 */ + U64(0x81842F29, 0xF2CCE375), U64(0xE6A11583, 0x00D46640), /* ~= 10^320 */ + U64(0xA1E53AF4, 0x6F801C53), U64(0x60495AE3, 0xC1097FD0), /* ~= 10^321 */ + U64(0xCA5E89B1, 0x8B602368), U64(0x385BB19C, 0xB14BDFC4), /* ~= 10^322 */ + U64(0xFCF62C1D, 0xEE382C42), U64(0x46729E03, 0xDD9ED7B5), /* ~= 10^323 */ + U64(0x9E19DB92, 0xB4E31BA9), U64(0x6C07A2C2, 0x6A8346D1) /* ~= 10^324 */ +}; + +/** + Get the cached pow10 value from pow10_sig_table. + @param exp10 The exponent of pow(10, e). This value must in range + POW10_SIG_TABLE_MIN_EXP to POW10_SIG_TABLE_MAX_EXP. + @param hi The highest 64 bits of pow(10, e). + @param lo The lower 64 bits after `hi`. + */ +static_inline void pow10_table_get_sig(i32 exp10, u64 *hi, u64 *lo) { + i32 idx = exp10 - (POW10_SIG_TABLE_MIN_EXP); + *hi = pow10_sig_table[idx * 2]; + *lo = pow10_sig_table[idx * 2 + 1]; +} + +/** + Get the exponent (base 2) for highest 64 bits significand in pow10_sig_table. + */ +static_inline void pow10_table_get_exp(i32 exp10, i32 *exp2) { + /* e2 = floor(log2(pow(10, e))) - 64 + 1 */ + /* = floor(e * log2(10) - 63) */ + *exp2 = (exp10 * 217706 - 4128768) >> 16; +} + +#endif + + + +#if !YYJSON_DISABLE_READER + +/*============================================================================== + * JSON Character Matcher + *============================================================================*/ + +/** Character type */ +typedef u8 char_type; + +/** Whitespace character: ' ', '\\t', '\\n', '\\r'. */ +static const char_type CHAR_TYPE_SPACE = 1 << 0; + +/** Number character: '-', [0-9]. */ +static const char_type CHAR_TYPE_NUMBER = 1 << 1; + +/** JSON Escaped character: '"', '\', [0x00-0x1F]. */ +static const char_type CHAR_TYPE_ESC_ASCII = 1 << 2; + +/** Non-ASCII character: [0x80-0xFF]. */ +static const char_type CHAR_TYPE_NON_ASCII = 1 << 3; + +/** JSON container character: '{', '['. */ +static const char_type CHAR_TYPE_CONTAINER = 1 << 4; + +/** Comment character: '/'. */ +static const char_type CHAR_TYPE_COMMENT = 1 << 5; + +/** Line end character: '\\n', '\\r', '\0'. */ +static const char_type CHAR_TYPE_LINE_END = 1 << 6; + +/** Hexadecimal numeric character: [0-9a-fA-F]. */ +static const char_type CHAR_TYPE_HEX = 1 << 7; + +/** Character type table (generate with misc/make_tables.c) */ +static const char_type char_table[256] = { + 0x44, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, + 0x04, 0x05, 0x45, 0x04, 0x04, 0x45, 0x04, 0x04, + 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, + 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, 0x04, + 0x01, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x20, + 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, 0x82, + 0x82, 0x82, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x10, 0x04, 0x00, 0x00, 0x00, + 0x00, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00, 0x00, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, + 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08, 0x08 +}; + +/** Match a character with specified type. */ +static_inline bool char_is_type(u8 c, char_type type) { + return (char_table[c] & type) != 0; +} + +/** Match a whitespace: ' ', '\\t', '\\n', '\\r'. */ +static_inline bool char_is_space(u8 c) { + return char_is_type(c, (char_type)CHAR_TYPE_SPACE); +} + +/** Match a whitespace or comment: ' ', '\\t', '\\n', '\\r', '/'. */ +static_inline bool char_is_space_or_comment(u8 c) { + return char_is_type(c, (char_type)(CHAR_TYPE_SPACE | CHAR_TYPE_COMMENT)); +} + +/** Match a JSON number: '-', [0-9]. */ +static_inline bool char_is_number(u8 c) { + return char_is_type(c, (char_type)CHAR_TYPE_NUMBER); +} + +/** Match a JSON container: '{', '['. */ +static_inline bool char_is_container(u8 c) { + return char_is_type(c, (char_type)CHAR_TYPE_CONTAINER); +} + +/** Match a stop character in ASCII string: '"', '\', [0x00-0x1F,0x80-0xFF]. */ +static_inline bool char_is_ascii_stop(u8 c) { + return char_is_type(c, (char_type)(CHAR_TYPE_ESC_ASCII | + CHAR_TYPE_NON_ASCII)); +} + +/** Match a line end character: '\\n', '\\r', '\0'. */ +static_inline bool char_is_line_end(u8 c) { + return char_is_type(c, (char_type)CHAR_TYPE_LINE_END); +} + +/** Match a hexadecimal numeric character: [0-9a-fA-F]. */ +static_inline bool char_is_hex(u8 c) { + return char_is_type(c, (char_type)CHAR_TYPE_HEX); +} + + + +/*============================================================================== + * Digit Character Matcher + *============================================================================*/ + +/** Digit type */ +typedef u8 digi_type; + +/** Digit: '0'. */ +static const digi_type DIGI_TYPE_ZERO = 1 << 0; + +/** Digit: [1-9]. */ +static const digi_type DIGI_TYPE_NONZERO = 1 << 1; + +/** Plus sign (positive): '+'. */ +static const digi_type DIGI_TYPE_POS = 1 << 2; + +/** Minus sign (negative): '-'. */ +static const digi_type DIGI_TYPE_NEG = 1 << 3; + +/** Decimal point: '.' */ +static const digi_type DIGI_TYPE_DOT = 1 << 4; + +/** Exponent sign: 'e, 'E'. */ +static const digi_type DIGI_TYPE_EXP = 1 << 5; + +/** Digit type table (generate with misc/make_tables.c) */ +static const digi_type digi_table[256] = { + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x04, 0x00, 0x08, 0x10, 0x00, + 0x01, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, + 0x02, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 +}; + +/** Match a character with specified type. */ +static_inline bool digi_is_type(u8 d, digi_type type) { + return (digi_table[d] & type) != 0; +} + +/** Match a sign: '+', '-' */ +static_inline bool digi_is_sign(u8 d) { + return digi_is_type(d, (digi_type)(DIGI_TYPE_POS | DIGI_TYPE_NEG)); +} + +/** Match a none zero digit: [1-9] */ +static_inline bool digi_is_nonzero(u8 d) { + return digi_is_type(d, (digi_type)DIGI_TYPE_NONZERO); +} + +/** Match a digit: [0-9] */ +static_inline bool digi_is_digit(u8 d) { + return digi_is_type(d, (digi_type)(DIGI_TYPE_ZERO | DIGI_TYPE_NONZERO)); +} + +/** Match an exponent sign: 'e', 'E'. */ +static_inline bool digi_is_exp(u8 d) { + return digi_is_type(d, (digi_type)DIGI_TYPE_EXP); +} + +/** Match a floating point indicator: '.', 'e', 'E'. */ +static_inline bool digi_is_fp(u8 d) { + return digi_is_type(d, (digi_type)(DIGI_TYPE_DOT | DIGI_TYPE_EXP)); +} + +/** Match a digit or floating point indicator: [0-9], '.', 'e', 'E'. */ +static_inline bool digi_is_digit_or_fp(u8 d) { + return digi_is_type(d, (digi_type)(DIGI_TYPE_ZERO | DIGI_TYPE_NONZERO | + DIGI_TYPE_DOT | DIGI_TYPE_EXP)); +} + + + +/*============================================================================== + * Hex Character Reader + * This function is used by JSON reader to read escaped characters. + *============================================================================*/ + +/** + This table is used to convert 4 hex character sequence to a number. + A valid hex character [0-9A-Fa-f] will mapped to it's raw number [0x00, 0x0F], + an invalid hex character will mapped to [0xF0]. + (generate with misc/make_tables.c) + */ +static const u8 hex_conv_table[256] = { + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, + 0x08, 0x09, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0x0A, 0x0B, 0x0C, 0x0D, 0x0E, 0x0F, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, + 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0 +}; + +/** + Scans an escaped character sequence as a UTF-16 code unit (branchless). + e.g. "\\u005C" should pass "005C" as `cur`. + + This requires the string has 4-byte zero padding. + */ +static_inline bool read_hex_u16(const u8 *cur, u16 *val) { + u16 c0, c1, c2, c3, t0, t1; + c0 = hex_conv_table[cur[0]]; + c1 = hex_conv_table[cur[1]]; + c2 = hex_conv_table[cur[2]]; + c3 = hex_conv_table[cur[3]]; + t0 = (u16)((c0 << 8) | c2); + t1 = (u16)((c1 << 8) | c3); + *val = (u16)((t0 << 4) | t1); + return ((t0 | t1) & (u16)0xF0F0) == 0; +} + + + +/*============================================================================== + * JSON Reader Utils + * These functions are used by JSON reader to read literals and comments. + *============================================================================*/ + +/** Read 'true' literal, '*cur' should be 't'. */ +static_inline bool read_true(u8 **ptr, yyjson_val *val) { + u8 *cur = *ptr; + u8 **end = ptr; + if (likely(byte_match_4(cur, "true"))) { + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_TRUE; + *end = cur + 4; + return true; + } + return false; +} + +/** Read 'false' literal, '*cur' should be 'f'. */ +static_inline bool read_false(u8 **ptr, yyjson_val *val) { + u8 *cur = *ptr; + u8 **end = ptr; + if (likely(byte_match_4(cur + 1, "alse"))) { + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_FALSE; + *end = cur + 5; + return true; + } + return false; +} + +/** Read 'null' literal, '*cur' should be 'n'. */ +static_inline bool read_null(u8 **ptr, yyjson_val *val) { + u8 *cur = *ptr; + u8 **end = ptr; + if (likely(byte_match_4(cur, "null"))) { + val->tag = YYJSON_TYPE_NULL; + *end = cur + 4; + return true; + } + return false; +} + +/** Read 'Inf' or 'Infinity' literal (ignoring case). */ +static_inline bool read_inf(bool sign, u8 **ptr, u8 **pre, yyjson_val *val) { +#if !YYJSON_DISABLE_NON_STANDARD + u8 *hdr = *ptr - sign; + u8 *cur = *ptr; + u8 **end = ptr; + if ((cur[0] == 'I' || cur[0] == 'i') && + (cur[1] == 'N' || cur[1] == 'n') && + (cur[2] == 'F' || cur[2] == 'f')) { + if ((cur[3] == 'I' || cur[3] == 'i') && + (cur[4] == 'N' || cur[4] == 'n') && + (cur[5] == 'I' || cur[5] == 'i') && + (cur[6] == 'T' || cur[6] == 't') && + (cur[7] == 'Y' || cur[7] == 'y')) { + cur += 8; + } else { + cur += 3; + } + *end = cur; + if (pre) { + /* add null-terminator for previous raw string */ + if (*pre) **pre = '\0'; + *pre = cur; + val->tag = ((u64)(cur - hdr) << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; + val->uni.str = (const char *)hdr; + } else { + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.u64 = f64_raw_get_inf(sign); + } + return true; + } +#endif + return false; +} + +/** Read 'NaN' literal (ignoring case). */ +static_inline bool read_nan(bool sign, u8 **ptr, u8 **pre, yyjson_val *val) { +#if !YYJSON_DISABLE_NON_STANDARD + u8 *hdr = *ptr - sign; + u8 *cur = *ptr; + u8 **end = ptr; + if ((cur[0] == 'N' || cur[0] == 'n') && + (cur[1] == 'A' || cur[1] == 'a') && + (cur[2] == 'N' || cur[2] == 'n')) { + cur += 3; + *end = cur; + if (pre) { + /* add null-terminator for previous raw string */ + if (*pre) **pre = '\0'; + *pre = cur; + val->tag = ((u64)(cur - hdr) << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; + val->uni.str = (const char *)hdr; + } else { + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.u64 = f64_raw_get_nan(sign); + } + return true; + } +#endif + return false; +} + +/** Read 'Inf', 'Infinity' or 'NaN' literal (ignoring case). */ +static_inline bool read_inf_or_nan(bool sign, u8 **ptr, u8 **pre, + yyjson_val *val) { + if (read_inf(sign, ptr, pre, val)) return true; + if (read_nan(sign, ptr, pre, val)) return true; + return false; +} + +/** Read a JSON number as raw string. */ +static_noinline bool read_number_raw(u8 **ptr, + u8 **pre, + yyjson_read_flag flg, + yyjson_val *val, + const char **msg) { + +#define return_err(_pos, _msg) do { \ + *msg = _msg; \ + *end = _pos; \ + return false; \ +} while (false) + +#define return_raw() do { \ + val->tag = ((u64)(cur - hdr) << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; \ + val->uni.str = (const char *)hdr; \ + *pre = cur; *end = cur; return true; \ +} while (false) + + u8 *hdr = *ptr; + u8 *cur = *ptr; + u8 **end = ptr; + + /* add null-terminator for previous raw string */ + if (*pre) **pre = '\0'; + + /* skip sign */ + cur += (*cur == '-'); + + /* read first digit, check leading zero */ + if (unlikely(!digi_is_digit(*cur))) { + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) { + if (read_inf_or_nan(*hdr == '-', &cur, pre, val)) return_raw(); + } + return_err(cur, "no digit after minus sign"); + } + + /* read integral part */ + if (*cur == '0') { + cur++; + if (unlikely(digi_is_digit(*cur))) { + return_err(cur - 1, "number with leading zero is not allowed"); + } + if (!digi_is_fp(*cur)) return_raw(); + } else { + while (digi_is_digit(*cur)) cur++; + if (!digi_is_fp(*cur)) return_raw(); + } + + /* read fraction part */ + if (*cur == '.') { + cur++; + if (!digi_is_digit(*cur++)) { + return_err(cur, "no digit after decimal point"); + } + while (digi_is_digit(*cur)) cur++; + } + + /* read exponent part */ + if (digi_is_exp(*cur)) { + cur += 1 + digi_is_sign(cur[1]); + if (!digi_is_digit(*cur++)) { + return_err(cur, "no digit after exponent sign"); + } + while (digi_is_digit(*cur)) cur++; + } + + return_raw(); + +#undef return_err +#undef return_raw +} + +/** + Skips spaces and comments as many as possible. + + It will return false in these cases: + 1. No character is skipped. The 'end' pointer is set as input cursor. + 2. A multiline comment is not closed. The 'end' pointer is set as the head + of this comment block. + */ +static_noinline bool skip_spaces_and_comments(u8 **ptr) { + u8 *hdr = *ptr; + u8 *cur = *ptr; + u8 **end = ptr; + while (true) { + if (byte_match_2(cur, "/*")) { + hdr = cur; + cur += 2; + while (true) { + if (byte_match_2(cur, "*/")) { + cur += 2; + break; + } + if (*cur == 0) { + *end = hdr; + return false; + } + cur++; + } + continue; + } + if (byte_match_2(cur, "//")) { + cur += 2; + while (!char_is_line_end(*cur)) cur++; + continue; + } + if (char_is_space(*cur)) { + cur += 1; + while (char_is_space(*cur)) cur++; + continue; + } + break; + } + *end = cur; + return hdr != cur; +} + +/** + Check truncated string. + Returns true if `cur` match `str` but is truncated. + */ +static_inline bool is_truncated_str(u8 *cur, u8 *end, + const char *str, + bool case_sensitive) { + usize len = strlen(str); + if (cur + len <= end || end <= cur) return false; + if (case_sensitive) { + return memcmp(cur, str, (usize)(end - cur)) == 0; + } + for (; cur < end; cur++, str++) { + if ((*cur != (u8)*str) && (*cur != (u8)*str - 'a' + 'A')) { + return false; + } + } + return true; +} + +/** + Check truncated JSON on parsing errors. + Returns true if the input is valid but truncated. + */ +static_noinline bool is_truncated_end(u8 *hdr, u8 *cur, u8 *end, + yyjson_read_code code, + yyjson_read_flag flg) { + if (cur >= end) return true; + if (code == YYJSON_READ_ERROR_LITERAL) { + if (is_truncated_str(cur, end, "true", true) || + is_truncated_str(cur, end, "false", true) || + is_truncated_str(cur, end, "null", true)) { + return true; + } + } + if (code == YYJSON_READ_ERROR_UNEXPECTED_CHARACTER || + code == YYJSON_READ_ERROR_INVALID_NUMBER || + code == YYJSON_READ_ERROR_LITERAL) { + if ((flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (*cur == '-') cur++; + if (is_truncated_str(cur, end, "infinity", false) || + is_truncated_str(cur, end, "nan", false)) { + return true; + } + } + } + if (code == YYJSON_READ_ERROR_UNEXPECTED_CONTENT) { + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) { + if (hdr + 3 <= cur && + is_truncated_str(cur - 3, end, "infinity", false)) { + return true; /* e.g. infin would be read as inf + in */ + } + } + } + if (code == YYJSON_READ_ERROR_INVALID_STRING) { + usize len = (usize)(end - cur); + + /* unicode escape sequence */ + if (*cur == '\\') { + if (len == 1) return true; + if (len <= 5) { + if (*++cur != 'u') return false; + for (++cur; cur < end; cur++) { + if (!char_is_hex(*cur)) return false; + } + return true; + } + return false; + } + + /* 2 to 4 bytes UTF-8, see `read_string()` for details. */ + if (*cur & 0x80) { + u8 c0 = cur[0], c1 = cur[1], c2 = cur[2]; + if (len == 1) { + /* 2 bytes UTF-8, truncated */ + if ((c0 & 0xE0) == 0xC0 && (c0 & 0x1E) != 0x00) return true; + /* 3 bytes UTF-8, truncated */ + if ((c0 & 0xF0) == 0xE0) return true; + /* 4 bytes UTF-8, truncated */ + if ((c0 & 0xF8) == 0xF0 && (c0 & 0x07) <= 0x04) return true; + } + if (len == 2) { + /* 3 bytes UTF-8, truncated */ + if ((c0 & 0xF0) == 0xE0 && + (c1 & 0xC0) == 0x80) { + u8 pat = (u8)(((c0 & 0x0F) << 1) | ((c1 & 0x20) >> 5)); + return 0x01 <= pat && pat != 0x1B; + } + /* 4 bytes UTF-8, truncated */ + if ((c0 & 0xF8) == 0xF0 && + (c1 & 0xC0) == 0x80) { + u8 pat = (u8)(((c0 & 0x07) << 2) | ((c1 & 0x30) >> 4)); + return 0x01 <= pat && pat <= 0x10; + } + } + if (len == 3) { + /* 4 bytes UTF-8, truncated */ + if ((c0 & 0xF8) == 0xF0 && + (c1 & 0xC0) == 0x80 && + (c2 & 0xC0) == 0x80) { + u8 pat = (u8)(((c0 & 0x07) << 2) | ((c1 & 0x30) >> 4)); + return 0x01 <= pat && pat <= 0x10; + } + } + } + } + return false; +} + + + +#if YYJSON_HAS_IEEE_754 && !YYJSON_DISABLE_FAST_FP_CONV /* FP_READER */ + +/*============================================================================== + * BigInt For Floating Point Number Reader + * + * The bigint algorithm is used by floating-point number reader to get correctly + * rounded result for numbers with lots of digits. This part of code is rarely + * used for common numbers. + *============================================================================*/ + +/** Maximum exponent of exact pow10 */ +#define U64_POW10_MAX_EXP 19 + +/** Table: [ 10^0, ..., 10^19 ] (generate with misc/make_tables.c) */ +static const u64 u64_pow10_table[U64_POW10_MAX_EXP + 1] = { + U64(0x00000000, 0x00000001), U64(0x00000000, 0x0000000A), + U64(0x00000000, 0x00000064), U64(0x00000000, 0x000003E8), + U64(0x00000000, 0x00002710), U64(0x00000000, 0x000186A0), + U64(0x00000000, 0x000F4240), U64(0x00000000, 0x00989680), + U64(0x00000000, 0x05F5E100), U64(0x00000000, 0x3B9ACA00), + U64(0x00000002, 0x540BE400), U64(0x00000017, 0x4876E800), + U64(0x000000E8, 0xD4A51000), U64(0x00000918, 0x4E72A000), + U64(0x00005AF3, 0x107A4000), U64(0x00038D7E, 0xA4C68000), + U64(0x002386F2, 0x6FC10000), U64(0x01634578, 0x5D8A0000), + U64(0x0DE0B6B3, 0xA7640000), U64(0x8AC72304, 0x89E80000) +}; + +/** Maximum numbers of chunks used by a bigint (58 is enough here). */ +#define BIGINT_MAX_CHUNKS 64 + +/** Unsigned arbitrarily large integer */ +typedef struct bigint { + u32 used; /* used chunks count, should not be 0 */ + u64 bits[BIGINT_MAX_CHUNKS]; /* chunks */ +} bigint; + +/** + Evaluate 'big += val'. + @param big A big number (can be 0). + @param val An unsigned integer (can be 0). + */ +static_inline void bigint_add_u64(bigint *big, u64 val) { + u32 idx, max; + u64 num = big->bits[0]; + u64 add = num + val; + big->bits[0] = add; + if (likely((add >= num) || (add >= val))) return; + for ((void)(idx = 1), max = big->used; idx < max; idx++) { + if (likely(big->bits[idx] != U64_MAX)) { + big->bits[idx] += 1; + return; + } + big->bits[idx] = 0; + } + big->bits[big->used++] = 1; +} + +/** + Evaluate 'big *= val'. + @param big A big number (can be 0). + @param val An unsigned integer (cannot be 0). + */ +static_inline void bigint_mul_u64(bigint *big, u64 val) { + u32 idx = 0, max = big->used; + u64 hi, lo, carry = 0; + for (; idx < max; idx++) { + if (big->bits[idx]) break; + } + for (; idx < max; idx++) { + u128_mul_add(big->bits[idx], val, carry, &hi, &lo); + big->bits[idx] = lo; + carry = hi; + } + if (carry) big->bits[big->used++] = carry; +} + +/** + Evaluate 'big *= 2^exp'. + @param big A big number (can be 0). + @param exp An exponent integer (can be 0). + */ +static_inline void bigint_mul_pow2(bigint *big, u32 exp) { + u32 shft = exp % 64; + u32 move = exp / 64; + u32 idx = big->used; + if (unlikely(shft == 0)) { + for (; idx > 0; idx--) { + big->bits[idx + move - 1] = big->bits[idx - 1]; + } + big->used += move; + while (move) big->bits[--move] = 0; + } else { + big->bits[idx] = 0; + for (; idx > 0; idx--) { + u64 num = big->bits[idx] << shft; + num |= big->bits[idx - 1] >> (64 - shft); + big->bits[idx + move] = num; + } + big->bits[move] = big->bits[0] << shft; + big->used += move + (big->bits[big->used + move] > 0); + while (move) big->bits[--move] = 0; + } +} + +/** + Evaluate 'big *= 10^exp'. + @param big A big number (can be 0). + @param exp An exponent integer (cannot be 0). + */ +static_inline void bigint_mul_pow10(bigint *big, i32 exp) { + for (; exp >= U64_POW10_MAX_EXP; exp -= U64_POW10_MAX_EXP) { + bigint_mul_u64(big, u64_pow10_table[U64_POW10_MAX_EXP]); + } + if (exp) { + bigint_mul_u64(big, u64_pow10_table[exp]); + } +} + +/** + Compare two bigint. + @return -1 if 'a < b', +1 if 'a > b', 0 if 'a == b'. + */ +static_inline i32 bigint_cmp(bigint *a, bigint *b) { + u32 idx = a->used; + if (a->used < b->used) return -1; + if (a->used > b->used) return +1; + while (idx-- > 0) { + u64 av = a->bits[idx]; + u64 bv = b->bits[idx]; + if (av < bv) return -1; + if (av > bv) return +1; + } + return 0; +} + +/** + Evaluate 'big = val'. + @param big A big number (can be 0). + @param val An unsigned integer (can be 0). + */ +static_inline void bigint_set_u64(bigint *big, u64 val) { + big->used = 1; + big->bits[0] = val; +} + +/** Set a bigint with floating point number string. */ +static_noinline void bigint_set_buf(bigint *big, u64 sig, i32 *exp, + u8 *sig_cut, u8 *sig_end, u8 *dot_pos) { + + if (unlikely(!sig_cut)) { + /* no digit cut, set significant part only */ + bigint_set_u64(big, sig); + return; + + } else { + /* some digits were cut, read them from 'sig_cut' to 'sig_end' */ + u8 *hdr = sig_cut; + u8 *cur = hdr; + u32 len = 0; + u64 val = 0; + bool dig_big_cut = false; + bool has_dot = (hdr < dot_pos) & (dot_pos < sig_end); + u32 dig_len_total = U64_SAFE_DIG + (u32)(sig_end - hdr) - has_dot; + + sig -= (*sig_cut >= '5'); /* sig was rounded before */ + if (dig_len_total > F64_MAX_DEC_DIG) { + dig_big_cut = true; + sig_end -= dig_len_total - (F64_MAX_DEC_DIG + 1); + sig_end -= (dot_pos + 1 == sig_end); + dig_len_total = (F64_MAX_DEC_DIG + 1); + } + *exp -= (i32)dig_len_total - U64_SAFE_DIG; + + big->used = 1; + big->bits[0] = sig; + while (cur < sig_end) { + if (likely(cur != dot_pos)) { + val = val * 10 + (u8)(*cur++ - '0'); + len++; + if (unlikely(cur == sig_end && dig_big_cut)) { + /* The last digit must be non-zero, */ + /* set it to '1' for correct rounding. */ + val = val - (val % 10) + 1; + } + if (len == U64_SAFE_DIG || cur == sig_end) { + bigint_mul_pow10(big, (i32)len); + bigint_add_u64(big, val); + val = 0; + len = 0; + } + } else { + cur++; + } + } + } +} + + + +/*============================================================================== + * Diy Floating Point + *============================================================================*/ + +/** "Do It Yourself Floating Point" struct. */ +typedef struct diy_fp { + u64 sig; /* significand */ + i32 exp; /* exponent, base 2 */ + i32 pad; /* padding, useless */ +} diy_fp; + +/** Get cached rounded diy_fp with pow(10, e) The input value must in range + [POW10_SIG_TABLE_MIN_EXP, POW10_SIG_TABLE_MAX_EXP]. */ +static_inline diy_fp diy_fp_get_cached_pow10(i32 exp10) { + diy_fp fp; + u64 sig_ext; + pow10_table_get_sig(exp10, &fp.sig, &sig_ext); + pow10_table_get_exp(exp10, &fp.exp); + fp.sig += (sig_ext >> 63); + return fp; +} + +/** Returns fp * fp2. */ +static_inline diy_fp diy_fp_mul(diy_fp fp, diy_fp fp2) { + u64 hi, lo; + u128_mul(fp.sig, fp2.sig, &hi, &lo); + fp.sig = hi + (lo >> 63); + fp.exp += fp2.exp + 64; + return fp; +} + +/** Convert diy_fp to IEEE-754 raw value. */ +static_inline u64 diy_fp_to_ieee_raw(diy_fp fp) { + u64 sig = fp.sig; + i32 exp = fp.exp; + u32 lz_bits; + if (unlikely(fp.sig == 0)) return 0; + + lz_bits = u64_lz_bits(sig); + sig <<= lz_bits; + sig >>= F64_BITS - F64_SIG_FULL_BITS; + exp -= (i32)lz_bits; + exp += F64_BITS - F64_SIG_FULL_BITS; + exp += F64_SIG_BITS; + + if (unlikely(exp >= F64_MAX_BIN_EXP)) { + /* overflow */ + return F64_RAW_INF; + } else if (likely(exp >= F64_MIN_BIN_EXP - 1)) { + /* normal */ + exp += F64_EXP_BIAS; + return ((u64)exp << F64_SIG_BITS) | (sig & F64_SIG_MASK); + } else if (likely(exp >= F64_MIN_BIN_EXP - F64_SIG_FULL_BITS)) { + /* subnormal */ + return sig >> (F64_MIN_BIN_EXP - exp - 1); + } else { + /* underflow */ + return 0; + } +} + + + +/*============================================================================== + * JSON Number Reader (IEEE-754) + *============================================================================*/ + +/** Maximum exact pow10 exponent for double value. */ +#define F64_POW10_EXP_MAX_EXACT 22 + +/** Cached pow10 table. */ +static const f64 f64_pow10_table[] = { + 1e0, 1e1, 1e2, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, + 1e13, 1e14, 1e15, 1e16, 1e17, 1e18, 1e19, 1e20, 1e21, 1e22 +}; + +/** + Read a JSON number. + + 1. This function assume that the floating-point number is in IEEE-754 format. + 2. This function support uint64/int64/double number. If an integer number + cannot fit in uint64/int64, it will returns as a double number. If a double + number is infinite, the return value is based on flag. + 3. This function (with inline attribute) may generate a lot of instructions. + */ +static_inline bool read_number(u8 **ptr, + u8 **pre, + yyjson_read_flag flg, + yyjson_val *val, + const char **msg) { + +#define return_err(_pos, _msg) do { \ + *msg = _msg; \ + *end = _pos; \ + return false; \ +} while (false) + +#define return_0() do { \ + val->tag = YYJSON_TYPE_NUM | (u8)((u8)sign << 3); \ + val->uni.u64 = 0; \ + *end = cur; return true; \ +} while (false) + +#define return_i64(_v) do { \ + val->tag = YYJSON_TYPE_NUM | (u8)((u8)sign << 3); \ + val->uni.u64 = (u64)(sign ? (u64)(~(_v) + 1) : (u64)(_v)); \ + *end = cur; return true; \ +} while (false) + +#define return_f64(_v) do { \ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; \ + val->uni.f64 = sign ? -(f64)(_v) : (f64)(_v); \ + *end = cur; return true; \ +} while (false) + +#define return_f64_bin(_v) do { \ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; \ + val->uni.u64 = ((u64)sign << 63) | (u64)(_v); \ + *end = cur; return true; \ +} while (false) + +#define return_inf() do { \ + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); \ + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) return_f64_bin(F64_RAW_INF); \ + else return_err(hdr, "number is infinity when parsed as double"); \ +} while (false) + +#define return_raw() do { \ + if (*pre) **pre = '\0'; /* add null-terminator for previous raw string */ \ + val->tag = ((u64)(cur - hdr) << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; \ + val->uni.str = (const char *)hdr; \ + *pre = cur; *end = cur; return true; \ +} while (false) + + u8 *sig_cut = NULL; /* significant part cutting position for long number */ + u8 *sig_end = NULL; /* significant part ending position */ + u8 *dot_pos = NULL; /* decimal point position */ + + u64 sig = 0; /* significant part of the number */ + i32 exp = 0; /* exponent part of the number */ + + bool exp_sign; /* temporary exponent sign from literal part */ + i64 exp_sig = 0; /* temporary exponent number from significant part */ + i64 exp_lit = 0; /* temporary exponent number from exponent literal part */ + u64 num; /* temporary number for reading */ + u8 *tmp; /* temporary cursor for reading */ + + u8 *hdr = *ptr; + u8 *cur = *ptr; + u8 **end = ptr; + bool sign; + + /* read number as raw string if has `YYJSON_READ_NUMBER_AS_RAW` flag */ + if (unlikely(pre && !(flg & YYJSON_READ_BIGNUM_AS_RAW))) { + return read_number_raw(ptr, pre, flg, val, msg); + } + + sign = (*hdr == '-'); + cur += sign; + + /* begin with a leading zero or non-digit */ + if (unlikely(!digi_is_nonzero(*cur))) { /* 0 or non-digit char */ + if (unlikely(*cur != '0')) { /* non-digit char */ + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) { + if (read_inf_or_nan(sign, &cur, pre, val)) { + *end = cur; + return true; + } + } + return_err(cur, "no digit after minus sign"); + } + /* begin with 0 */ + if (likely(!digi_is_digit_or_fp(*++cur))) return_0(); + if (likely(*cur == '.')) { + dot_pos = cur++; + if (unlikely(!digi_is_digit(*cur))) { + return_err(cur, "no digit after decimal point"); + } + while (unlikely(*cur == '0')) cur++; + if (likely(digi_is_digit(*cur))) { + /* first non-zero digit after decimal point */ + sig = (u64)(*cur - '0'); /* read first digit */ + cur--; + goto digi_frac_1; /* continue read fraction part */ + } + } + if (unlikely(digi_is_digit(*cur))) { + return_err(cur - 1, "number with leading zero is not allowed"); + } + if (unlikely(digi_is_exp(*cur))) { /* 0 with any exponent is still 0 */ + cur += (usize)1 + digi_is_sign(cur[1]); + if (unlikely(!digi_is_digit(*cur))) { + return_err(cur, "no digit after exponent sign"); + } + while (digi_is_digit(*++cur)); + } + return_f64_bin(0); + } + + /* begin with non-zero digit */ + sig = (u64)(*cur - '0'); + + /* + Read integral part, same as the following code. + + for (int i = 1; i <= 18; i++) { + num = cur[i] - '0'; + if (num <= 9) sig = num + sig * 10; + else goto digi_sepr_i; + } + */ +#define expr_intg(i) \ + if (likely((num = (u64)(cur[i] - (u8)'0')) <= 9)) sig = num + sig * 10; \ + else { goto digi_sepr_##i; } + repeat_in_1_18(expr_intg) +#undef expr_intg + + + cur += 19; /* skip continuous 19 digits */ + if (!digi_is_digit_or_fp(*cur)) { + /* this number is an integer consisting of 19 digits */ + if (sign && (sig > ((u64)1 << 63))) { /* overflow */ + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); + return_f64(normalized_u64_to_f64(sig)); + } + return_i64(sig); + } + goto digi_intg_more; /* read more digits in integral part */ + + + /* process first non-digit character */ +#define expr_sepr(i) \ + digi_sepr_##i: \ + if (likely(!digi_is_fp(cur[i]))) { cur += i; return_i64(sig); } \ + dot_pos = cur + i; \ + if (likely(cur[i] == '.')) goto digi_frac_##i; \ + cur += i; sig_end = cur; goto digi_exp_more; + repeat_in_1_18(expr_sepr) +#undef expr_sepr + + + /* read fraction part */ +#define expr_frac(i) \ + digi_frac_##i: \ + if (likely((num = (u64)(cur[i + 1] - (u8)'0')) <= 9)) \ + sig = num + sig * 10; \ + else { goto digi_stop_##i; } + repeat_in_1_18(expr_frac) +#undef expr_frac + + cur += 20; /* skip 19 digits and 1 decimal point */ + if (!digi_is_digit(*cur)) goto digi_frac_end; /* fraction part end */ + goto digi_frac_more; /* read more digits in fraction part */ + + + /* significant part end */ +#define expr_stop(i) \ + digi_stop_##i: \ + cur += i + 1; \ + goto digi_frac_end; + repeat_in_1_18(expr_stop) +#undef expr_stop + + + /* read more digits in integral part */ +digi_intg_more: + if (digi_is_digit(*cur)) { + if (!digi_is_digit_or_fp(cur[1])) { + /* this number is an integer consisting of 20 digits */ + num = (u64)(*cur - '0'); + if ((sig < (U64_MAX / 10)) || + (sig == (U64_MAX / 10) && num <= (U64_MAX % 10))) { + sig = num + sig * 10; + cur++; + /* convert to double if overflow */ + if (sign) { + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); + return_f64(normalized_u64_to_f64(sig)); + } + return_i64(sig); + } + } + } + + if (digi_is_exp(*cur)) { + dot_pos = cur; + goto digi_exp_more; + } + + if (*cur == '.') { + dot_pos = cur++; + if (!digi_is_digit(*cur)) { + return_err(cur, "no digit after decimal point"); + } + } + + + /* read more digits in fraction part */ +digi_frac_more: + sig_cut = cur; /* too large to fit in u64, excess digits need to be cut */ + sig += (*cur >= '5'); /* round */ + while (digi_is_digit(*++cur)); + if (!dot_pos) { + if (!digi_is_fp(*cur) && (flg & YYJSON_READ_BIGNUM_AS_RAW)) { + return_raw(); /* it's a large integer */ + } + dot_pos = cur; + if (*cur == '.') { + if (!digi_is_digit(*++cur)) { + return_err(cur, "no digit after decimal point"); + } + while (digi_is_digit(*cur)) cur++; + } + } + exp_sig = (i64)(dot_pos - sig_cut); + exp_sig += (dot_pos < sig_cut); + + /* ignore trailing zeros */ + tmp = cur - 1; + while (*tmp == '0' || *tmp == '.') tmp--; + if (tmp < sig_cut) { + sig_cut = NULL; + } else { + sig_end = cur; + } + + if (digi_is_exp(*cur)) goto digi_exp_more; + goto digi_exp_finish; + + + /* fraction part end */ +digi_frac_end: + if (unlikely(dot_pos + 1 == cur)) { + return_err(cur, "no digit after decimal point"); + } + sig_end = cur; + exp_sig = -(i64)((u64)(cur - dot_pos) - 1); + if (likely(!digi_is_exp(*cur))) { + if (unlikely(exp_sig < F64_MIN_DEC_EXP - 19)) { + return_f64_bin(0); /* underflow */ + } + exp = (i32)exp_sig; + goto digi_finish; + } else { + goto digi_exp_more; + } + + + /* read exponent part */ +digi_exp_more: + exp_sign = (*++cur == '-'); + cur += digi_is_sign(*cur); + if (unlikely(!digi_is_digit(*cur))) { + return_err(cur, "no digit after exponent sign"); + } + while (*cur == '0') cur++; + + /* read exponent literal */ + tmp = cur; + while (digi_is_digit(*cur)) { + exp_lit = (i64)((u8)(*cur++ - '0') + (u64)exp_lit * 10); + } + if (unlikely(cur - tmp >= U64_SAFE_DIG)) { + if (exp_sign) { + return_f64_bin(0); /* underflow */ + } else { + return_inf(); /* overflow */ + } + } + exp_sig += exp_sign ? -exp_lit : exp_lit; + + + /* validate exponent value */ +digi_exp_finish: + if (unlikely(exp_sig < F64_MIN_DEC_EXP - 19)) { + return_f64_bin(0); /* underflow */ + } + if (unlikely(exp_sig > F64_MAX_DEC_EXP)) { + return_inf(); /* overflow */ + } + exp = (i32)exp_sig; + + + /* all digit read finished */ +digi_finish: + + /* + Fast path 1: + + 1. The floating-point number calculation should be accurate, see the + comments of macro `YYJSON_DOUBLE_MATH_CORRECT`. + 2. Correct rounding should be performed (fegetround() == FE_TONEAREST). + 3. The input of floating point number calculation does not lose precision, + which means: 64 - leading_zero(input) - trailing_zero(input) < 53. + + We don't check all available inputs here, because that would make the code + more complicated, and not friendly to branch predictor. + */ +#if YYJSON_DOUBLE_MATH_CORRECT + if (sig < ((u64)1 << 53) && + exp >= -F64_POW10_EXP_MAX_EXACT && + exp <= +F64_POW10_EXP_MAX_EXACT) { + f64 dbl = (f64)sig; + if (exp < 0) { + dbl /= f64_pow10_table[-exp]; + } else { + dbl *= f64_pow10_table[+exp]; + } + return_f64(dbl); + } +#endif + + /* + Fast path 2: + + To keep it simple, we only accept normal number here, + let the slow path to handle subnormal and infinity number. + */ + if (likely(!sig_cut && + exp > -F64_MAX_DEC_EXP + 1 && + exp < +F64_MAX_DEC_EXP - 20)) { + /* + The result value is exactly equal to (sig * 10^exp), + the exponent part (10^exp) can be converted to (sig2 * 2^exp2). + + The sig2 can be an infinite length number, only the highest 128 bits + is cached in the pow10_sig_table. + + Now we have these bits: + sig1 (normalized 64bit) : aaaaaaaa + sig2 (higher 64bit) : bbbbbbbb + sig2_ext (lower 64bit) : cccccccc + sig2_cut (extra unknown bits) : dddddddddddd.... + + And the calculation process is: + ---------------------------------------- + aaaaaaaa * + bbbbbbbbccccccccdddddddddddd.... + ---------------------------------------- + abababababababab + + acacacacacacacac + + adadadadadadadadadad.... + ---------------------------------------- + [hi____][lo____] + + [hi2___][lo2___] + + [unknown___________....] + ---------------------------------------- + + The addition with carry may affect higher bits, but if there is a 0 + in higher bits, the bits higher than 0 will not be affected. + + `lo2` + `unknown` may get a carry bit and may affect `hi2`, the max + value of `hi2` is 0xFFFFFFFFFFFFFFFE, so `hi2` will not overflow. + + `lo` + `hi2` may also get a carry bit and may affect `hi`, but only + the highest significant 53 bits of `hi` is needed. If there is a 0 + in the lower bits of `hi`, then all the following bits can be dropped. + + To convert the result to IEEE-754 double number, we need to perform + correct rounding: + 1. if bit 54 is 0, round down, + 2. if bit 54 is 1 and any bit beyond bit 54 is 1, round up, + 3. if bit 54 is 1 and all bits beyond bit 54 are 0, round to even, + as the extra bits is unknown, this case will not be handled here. + */ + + u64 raw; + u64 sig1, sig2, sig2_ext, hi, lo, hi2, lo2, add, bits; + i32 exp2; + u32 lz; + bool exact = false, carry, round_up; + + /* convert (10^exp) to (sig2 * 2^exp2) */ + pow10_table_get_sig(exp, &sig2, &sig2_ext); + pow10_table_get_exp(exp, &exp2); + + /* normalize and multiply */ + lz = u64_lz_bits(sig); + sig1 = sig << lz; + exp2 -= (i32)lz; + u128_mul(sig1, sig2, &hi, &lo); + + /* + The `hi` is in range [0x4000000000000000, 0xFFFFFFFFFFFFFFFE], + To get normalized value, `hi` should be shifted to the left by 0 or 1. + + The highest significant 53 bits is used by IEEE-754 double number, + and the bit 54 is used to detect rounding direction. + + The lowest (64 - 54 - 1) bits is used to check whether it contains 0. + */ + bits = hi & (((u64)1 << (64 - 54 - 1)) - 1); + if (bits - 1 < (((u64)1 << (64 - 54 - 1)) - 2)) { + /* + (bits != 0 && bits != 0x1FF) => (bits - 1 < 0x1FF - 1) + The `bits` is not zero, so we don't need to check `round to even` + case. The `bits` contains bit `0`, so we can drop the extra bits + after `0`. + */ + exact = true; + + } else { + /* + (bits == 0 || bits == 0x1FF) + The `bits` is filled with all `0` or all `1`, so we need to check + lower bits with another 64-bit multiplication. + */ + u128_mul(sig1, sig2_ext, &hi2, &lo2); + + add = lo + hi2; + if (add + 1 > (u64)1) { + /* + (add != 0 && add != U64_MAX) => (add + 1 > 1) + The `add` is not zero, so we don't need to check `round to + even` case. The `add` contains bit `0`, so we can drop the + extra bits after `0`. The `hi` cannot be U64_MAX, so it will + not overflow. + */ + carry = add < lo || add < hi2; + hi += carry; + exact = true; + } + } + + if (exact) { + /* normalize */ + lz = hi < ((u64)1 << 63); + hi <<= lz; + exp2 -= (i32)lz; + exp2 += 64; + + /* test the bit 54 and get rounding direction */ + round_up = (hi & ((u64)1 << (64 - 54))) > (u64)0; + hi += (round_up ? ((u64)1 << (64 - 54)) : (u64)0); + + /* test overflow */ + if (hi < ((u64)1 << (64 - 54))) { + hi = ((u64)1 << 63); + exp2 += 1; + } + + /* This is a normal number, convert it to IEEE-754 format. */ + hi >>= F64_BITS - F64_SIG_FULL_BITS; + exp2 += F64_BITS - F64_SIG_FULL_BITS + F64_SIG_BITS; + exp2 += F64_EXP_BIAS; + raw = ((u64)exp2 << F64_SIG_BITS) | (hi & F64_SIG_MASK); + return_f64_bin(raw); + } + } + + /* + Slow path: read double number exactly with diyfp. + 1. Use cached diyfp to get an approximation value. + 2. Use bigcomp to check the approximation value if needed. + + This algorithm refers to google's double-conversion project: + https://github.com/google/double-conversion + */ + { + const i32 ERR_ULP_LOG = 3; + const i32 ERR_ULP = 1 << ERR_ULP_LOG; + const i32 ERR_CACHED_POW = ERR_ULP / 2; + const i32 ERR_MUL_FIXED = ERR_ULP / 2; + const i32 DIY_SIG_BITS = 64; + const i32 EXP_BIAS = F64_EXP_BIAS + F64_SIG_BITS; + const i32 EXP_SUBNORMAL = -EXP_BIAS + 1; + + u64 fp_err; + u32 bits; + i32 order_of_magnitude; + i32 effective_significand_size; + i32 precision_digits_count; + u64 precision_bits; + u64 half_way; + + u64 raw; + diy_fp fp, fp_upper; + bigint big_full, big_comp; + i32 cmp; + + fp.sig = sig; + fp.exp = 0; + fp_err = sig_cut ? (u64)(ERR_ULP / 2) : (u64)0; + + /* normalize */ + bits = u64_lz_bits(fp.sig); + fp.sig <<= bits; + fp.exp -= (i32)bits; + fp_err <<= bits; + + /* multiply and add error */ + fp = diy_fp_mul(fp, diy_fp_get_cached_pow10(exp)); + fp_err += (u64)ERR_CACHED_POW + (fp_err != 0) + (u64)ERR_MUL_FIXED; + + /* normalize */ + bits = u64_lz_bits(fp.sig); + fp.sig <<= bits; + fp.exp -= (i32)bits; + fp_err <<= bits; + + /* effective significand */ + order_of_magnitude = DIY_SIG_BITS + fp.exp; + if (likely(order_of_magnitude >= EXP_SUBNORMAL + F64_SIG_FULL_BITS)) { + effective_significand_size = F64_SIG_FULL_BITS; + } else if (order_of_magnitude <= EXP_SUBNORMAL) { + effective_significand_size = 0; + } else { + effective_significand_size = order_of_magnitude - EXP_SUBNORMAL; + } + + /* precision digits count */ + precision_digits_count = DIY_SIG_BITS - effective_significand_size; + if (unlikely(precision_digits_count + ERR_ULP_LOG >= DIY_SIG_BITS)) { + i32 shr = (precision_digits_count + ERR_ULP_LOG) - DIY_SIG_BITS + 1; + fp.sig >>= shr; + fp.exp += shr; + fp_err = (fp_err >> shr) + 1 + (u32)ERR_ULP; + precision_digits_count -= shr; + } + + /* half way */ + precision_bits = fp.sig & (((u64)1 << precision_digits_count) - 1); + precision_bits *= (u32)ERR_ULP; + half_way = (u64)1 << (precision_digits_count - 1); + half_way *= (u32)ERR_ULP; + + /* rounding */ + fp.sig >>= precision_digits_count; + fp.sig += (precision_bits >= half_way + fp_err); + fp.exp += precision_digits_count; + + /* get IEEE double raw value */ + raw = diy_fp_to_ieee_raw(fp); + if (unlikely(raw == F64_RAW_INF)) return_inf(); + if (likely(precision_bits <= half_way - fp_err || + precision_bits >= half_way + fp_err)) { + return_f64_bin(raw); /* number is accurate */ + } + /* now the number is the correct value, or the next lower value */ + + /* upper boundary */ + if (raw & F64_EXP_MASK) { + fp_upper.sig = (raw & F64_SIG_MASK) + ((u64)1 << F64_SIG_BITS); + fp_upper.exp = (i32)((raw & F64_EXP_MASK) >> F64_SIG_BITS); + } else { + fp_upper.sig = (raw & F64_SIG_MASK); + fp_upper.exp = 1; + } + fp_upper.exp -= F64_EXP_BIAS + F64_SIG_BITS; + fp_upper.sig <<= 1; + fp_upper.exp -= 1; + fp_upper.sig += 1; /* add half ulp */ + + /* compare with bigint */ + bigint_set_buf(&big_full, sig, &exp, sig_cut, sig_end, dot_pos); + bigint_set_u64(&big_comp, fp_upper.sig); + if (exp >= 0) { + bigint_mul_pow10(&big_full, +exp); + } else { + bigint_mul_pow10(&big_comp, -exp); + } + if (fp_upper.exp > 0) { + bigint_mul_pow2(&big_comp, (u32)+fp_upper.exp); + } else { + bigint_mul_pow2(&big_full, (u32)-fp_upper.exp); + } + cmp = bigint_cmp(&big_full, &big_comp); + if (likely(cmp != 0)) { + /* round down or round up */ + raw += (cmp > 0); + } else { + /* falls midway, round to even */ + raw += (raw & 1); + } + + if (unlikely(raw == F64_RAW_INF)) return_inf(); + return_f64_bin(raw); + } + +#undef return_err +#undef return_inf +#undef return_0 +#undef return_i64 +#undef return_f64 +#undef return_f64_bin +#undef return_raw +} + + + +#else /* FP_READER */ + +/** + Read a JSON number. + This is a fallback function if the custom number reader is disabled. + This function use libc's strtod() to read floating-point number. + */ +static_noinline bool read_number(u8 **ptr, + u8 **pre, + yyjson_read_flag flg, + yyjson_val *val, + const char **msg) { + +#define return_err(_pos, _msg) do { \ + *msg = _msg; \ + *end = _pos; \ + return false; \ +} while (false) + +#define return_0() do { \ + val->tag = YYJSON_TYPE_NUM | (u64)((u8)sign << 3); \ + val->uni.u64 = 0; \ + *end = cur; return true; \ +} while (false) + +#define return_i64(_v) do { \ + val->tag = YYJSON_TYPE_NUM | (u64)((u8)sign << 3); \ + val->uni.u64 = (u64)(sign ? (u64)(~(_v) + 1) : (u64)(_v)); \ + *end = cur; return true; \ +} while (false) + +#define return_f64(_v) do { \ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; \ + val->uni.f64 = sign ? -(f64)(_v) : (f64)(_v); \ + *end = cur; return true; \ +} while (false) + +#define return_f64_bin(_v) do { \ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; \ + val->uni.u64 = ((u64)sign << 63) | (u64)(_v); \ + *end = cur; return true; \ +} while (false) + +#define return_inf() do { \ + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); \ + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) return_f64_bin(F64_RAW_INF); \ + else return_err(hdr, "number is infinity when parsed as double"); \ +} while (false) + +#define return_raw() do { \ + if (*pre) **pre = '\0'; /* add null-terminator for previous raw string */ \ + val->tag = ((u64)(cur - hdr) << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; \ + val->uni.str = (const char *)hdr; \ + *pre = cur; *end = cur; return true; \ +} while (false) + + u64 sig, num; + u8 *hdr = *ptr; + u8 *cur = *ptr; + u8 **end = ptr; + u8 *dot = NULL; + u8 *f64_end = NULL; + bool sign; + + /* read number as raw string if has `YYJSON_READ_NUMBER_AS_RAW` flag */ + if (unlikely(pre && !(flg & YYJSON_READ_BIGNUM_AS_RAW))) { + return read_number_raw(ptr, pre, flg, val, msg); + } + + sign = (*hdr == '-'); + cur += sign; + sig = (u8)(*cur - '0'); + + /* read first digit, check leading zero */ + if (unlikely(!digi_is_digit(*cur))) { + if (flg & YYJSON_READ_ALLOW_INF_AND_NAN) { + if (read_inf_or_nan(sign, &cur, pre, val)) { + *end = cur; + return true; + } + } + return_err(cur, "no digit after minus sign"); + } + if (*cur == '0') { + cur++; + if (unlikely(digi_is_digit(*cur))) { + return_err(cur - 1, "number with leading zero is not allowed"); + } + if (!digi_is_fp(*cur)) return_0(); + goto read_double; + } + + /* read continuous digits, up to 19 characters */ +#define expr_intg(i) \ + if (likely((num = (u64)(cur[i] - (u8)'0')) <= 9)) sig = num + sig * 10; \ + else { cur += i; goto intg_end; } + repeat_in_1_18(expr_intg) +#undef expr_intg + + /* here are 19 continuous digits, skip them */ + cur += 19; + if (digi_is_digit(cur[0]) && !digi_is_digit_or_fp(cur[1])) { + /* this number is an integer consisting of 20 digits */ + num = (u8)(*cur - '0'); + if ((sig < (U64_MAX / 10)) || + (sig == (U64_MAX / 10) && num <= (U64_MAX % 10))) { + sig = num + sig * 10; + cur++; + if (sign) { + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); + return_f64(normalized_u64_to_f64(sig)); + } + return_i64(sig); + } + } + +intg_end: + /* continuous digits ended */ + if (!digi_is_digit_or_fp(*cur)) { + /* this number is an integer consisting of 1 to 19 digits */ + if (sign && (sig > ((u64)1 << 63))) { + if (flg & YYJSON_READ_BIGNUM_AS_RAW) return_raw(); + return_f64(normalized_u64_to_f64(sig)); + } + return_i64(sig); + } + +read_double: + /* this number should be read as double */ + while (digi_is_digit(*cur)) cur++; + if (!digi_is_fp(*cur) && (flg & YYJSON_READ_BIGNUM_AS_RAW)) { + return_raw(); /* it's a large integer */ + } + if (*cur == '.') { + /* skip fraction part */ + dot = cur; + cur++; + if (!digi_is_digit(*cur)) { + return_err(cur, "no digit after decimal point"); + } + cur++; + while (digi_is_digit(*cur)) cur++; + } + if (digi_is_exp(*cur)) { + /* skip exponent part */ + cur += 1 + digi_is_sign(cur[1]); + if (!digi_is_digit(*cur)) { + return_err(cur, "no digit after exponent sign"); + } + cur++; + while (digi_is_digit(*cur)) cur++; + } + + /* + libc's strtod() is used to parse the floating-point number. + + Note that the decimal point character used by strtod() is locale-dependent, + and the rounding direction may affected by fesetround(). + + For currently known locales, (en, zh, ja, ko, am, he, hi) use '.' as the + decimal point, while other locales use ',' as the decimal point. + + Here strtod() is called twice for different locales, but if another thread + happens calls setlocale() between two strtod(), parsing may still fail. + */ + val->uni.f64 = strtod((const char *)hdr, (char **)&f64_end); + if (unlikely(f64_end != cur)) { + /* replace '.' with ',' for locale */ + bool cut = (*cur == ','); + if (cut) *cur = ' '; + if (dot) *dot = ','; + val->uni.f64 = strtod((const char *)hdr, (char **)&f64_end); + /* restore ',' to '.' */ + if (cut) *cur = ','; + if (dot) *dot = '.'; + if (unlikely(f64_end != cur)) { + return_err(hdr, "strtod() failed to parse the number"); + } + } + if (unlikely(val->uni.f64 >= HUGE_VAL || val->uni.f64 <= -HUGE_VAL)) { + return_inf(); + } + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + *end = cur; + return true; + +#undef return_err +#undef return_0 +#undef return_i64 +#undef return_f64 +#undef return_f64_bin +#undef return_inf +#undef return_raw +} + +#endif /* FP_READER */ + + + +/*============================================================================== + * JSON String Reader + *============================================================================*/ + +/** + Read a JSON string. + @param ptr The head pointer of string before '"' prefix (inout). + @param lst JSON last position. + @param inv Allow invalid unicode. + @param val The string value to be written. + @param msg The error message pointer. + @return Whether success. + */ +static_inline bool read_string(u8 **ptr, + u8 *lst, + bool inv, + yyjson_val *val, + const char **msg) { + /* + Each unicode code point is encoded as 1 to 4 bytes in UTF-8 encoding, + we use 4-byte mask and pattern value to validate UTF-8 byte sequence, + this requires the input data to have 4-byte zero padding. + --------------------------------------------------- + 1 byte + unicode range [U+0000, U+007F] + unicode min [.......0] + unicode max [.1111111] + bit pattern [0.......] + --------------------------------------------------- + 2 byte + unicode range [U+0080, U+07FF] + unicode min [......10 ..000000] + unicode max [...11111 ..111111] + bit require [...xxxx. ........] (1E 00) + bit mask [xxx..... xx......] (E0 C0) + bit pattern [110..... 10......] (C0 80) + --------------------------------------------------- + 3 byte + unicode range [U+0800, U+FFFF] + unicode min [........ ..100000 ..000000] + unicode max [....1111 ..111111 ..111111] + bit require [....xxxx ..x..... ........] (0F 20 00) + bit mask [xxxx.... xx...... xx......] (F0 C0 C0) + bit pattern [1110.... 10...... 10......] (E0 80 80) + --------------------------------------------------- + 3 byte invalid (reserved for surrogate halves) + unicode range [U+D800, U+DFFF] + unicode min [....1101 ..100000 ..000000] + unicode max [....1101 ..111111 ..111111] + bit mask [....xxxx ..x..... ........] (0F 20 00) + bit pattern [....1101 ..1..... ........] (0D 20 00) + --------------------------------------------------- + 4 byte + unicode range [U+10000, U+10FFFF] + unicode min [........ ...10000 ..000000 ..000000] + unicode max [.....100 ..001111 ..111111 ..111111] + bit require [.....xxx ..xx.... ........ ........] (07 30 00 00) + bit mask [xxxxx... xx...... xx...... xx......] (F8 C0 C0 C0) + bit pattern [11110... 10...... 10...... 10......] (F0 80 80 80) + --------------------------------------------------- + */ +#if YYJSON_ENDIAN == YYJSON_BIG_ENDIAN + const u32 b1_mask = 0x80000000UL; + const u32 b1_patt = 0x00000000UL; + const u32 b2_mask = 0xE0C00000UL; + const u32 b2_patt = 0xC0800000UL; + const u32 b2_requ = 0x1E000000UL; + const u32 b3_mask = 0xF0C0C000UL; + const u32 b3_patt = 0xE0808000UL; + const u32 b3_requ = 0x0F200000UL; + const u32 b3_erro = 0x0D200000UL; + const u32 b4_mask = 0xF8C0C0C0UL; + const u32 b4_patt = 0xF0808080UL; + const u32 b4_requ = 0x07300000UL; + const u32 b4_err0 = 0x04000000UL; + const u32 b4_err1 = 0x03300000UL; +#elif YYJSON_ENDIAN == YYJSON_LITTLE_ENDIAN + const u32 b1_mask = 0x00000080UL; + const u32 b1_patt = 0x00000000UL; + const u32 b2_mask = 0x0000C0E0UL; + const u32 b2_patt = 0x000080C0UL; + const u32 b2_requ = 0x0000001EUL; + const u32 b3_mask = 0x00C0C0F0UL; + const u32 b3_patt = 0x008080E0UL; + const u32 b3_requ = 0x0000200FUL; + const u32 b3_erro = 0x0000200DUL; + const u32 b4_mask = 0xC0C0C0F8UL; + const u32 b4_patt = 0x808080F0UL; + const u32 b4_requ = 0x00003007UL; + const u32 b4_err0 = 0x00000004UL; + const u32 b4_err1 = 0x00003003UL; +#else + v32_uni b1_mask_uni = {{ 0x80, 0x00, 0x00, 0x00 }}; + v32_uni b1_patt_uni = {{ 0x00, 0x00, 0x00, 0x00 }}; + v32_uni b2_mask_uni = {{ 0xE0, 0xC0, 0x00, 0x00 }}; + v32_uni b2_patt_uni = {{ 0xC0, 0x80, 0x00, 0x00 }}; + v32_uni b2_requ_uni = {{ 0x1E, 0x00, 0x00, 0x00 }}; + v32_uni b3_mask_uni = {{ 0xF0, 0xC0, 0xC0, 0x00 }}; + v32_uni b3_patt_uni = {{ 0xE0, 0x80, 0x80, 0x00 }}; + v32_uni b3_requ_uni = {{ 0x0F, 0x20, 0x00, 0x00 }}; + v32_uni b3_erro_uni = {{ 0x0D, 0x20, 0x00, 0x00 }}; + v32_uni b4_mask_uni = {{ 0xF8, 0xC0, 0xC0, 0xC0 }}; + v32_uni b4_patt_uni = {{ 0xF0, 0x80, 0x80, 0x80 }}; + v32_uni b4_requ_uni = {{ 0x07, 0x30, 0x00, 0x00 }}; + v32_uni b4_err0_uni = {{ 0x04, 0x00, 0x00, 0x00 }}; + v32_uni b4_err1_uni = {{ 0x03, 0x30, 0x00, 0x00 }}; + u32 b1_mask = b1_mask_uni.u; + u32 b1_patt = b1_patt_uni.u; + u32 b2_mask = b2_mask_uni.u; + u32 b2_patt = b2_patt_uni.u; + u32 b2_requ = b2_requ_uni.u; + u32 b3_mask = b3_mask_uni.u; + u32 b3_patt = b3_patt_uni.u; + u32 b3_requ = b3_requ_uni.u; + u32 b3_erro = b3_erro_uni.u; + u32 b4_mask = b4_mask_uni.u; + u32 b4_patt = b4_patt_uni.u; + u32 b4_requ = b4_requ_uni.u; + u32 b4_err0 = b4_err0_uni.u; + u32 b4_err1 = b4_err1_uni.u; +#endif + +#define is_valid_seq_1(uni) ( \ + ((uni & b1_mask) == b1_patt) \ +) + +#define is_valid_seq_2(uni) ( \ + ((uni & b2_mask) == b2_patt) && \ + ((uni & b2_requ)) \ +) + +#define is_valid_seq_3(uni) ( \ + ((uni & b3_mask) == b3_patt) && \ + ((tmp = (uni & b3_requ))) && \ + ((tmp != b3_erro)) \ +) + +#define is_valid_seq_4(uni) ( \ + ((uni & b4_mask) == b4_patt) && \ + ((tmp = (uni & b4_requ))) && \ + ((tmp & b4_err0) == 0 || (tmp & b4_err1) == 0) \ +) + +#define return_err(_end, _msg) do { \ + *msg = _msg; \ + *end = _end; \ + return false; \ +} while (false) + + u8 *cur = *ptr; + u8 **end = ptr; + u8 *src = ++cur, *dst, *pos; + u16 hi, lo; + u32 uni, tmp; + +skip_ascii: + /* Most strings have no escaped characters, so we can jump them quickly. */ + +skip_ascii_begin: + /* + We want to make loop unrolling, as shown in the following code. Some + compiler may not generate instructions as expected, so we rewrite it with + explicit goto statements. We hope the compiler can generate instructions + like this: https://godbolt.org/z/8vjsYq + + while (true) repeat16({ + if (likely(!(char_is_ascii_stop(*src)))) src++; + else break; + }) + */ +#define expr_jump(i) \ + if (likely(!char_is_ascii_stop(src[i]))) {} \ + else goto skip_ascii_stop##i; + +#define expr_stop(i) \ + skip_ascii_stop##i: \ + src += i; \ + goto skip_ascii_end; + + repeat16_incr(expr_jump) + src += 16; + goto skip_ascii_begin; + repeat16_incr(expr_stop) + +#undef expr_jump +#undef expr_stop + +skip_ascii_end: + + /* + GCC may store src[i] in a register at each line of expr_jump(i) above. + These instructions are useless and will degrade performance. + This inline asm is a hint for gcc: "the memory has been modified, + do not cache it". + + MSVC, Clang, ICC can generate expected instructions without this hint. + */ +#if YYJSON_IS_REAL_GCC + __asm__ volatile("":"=m"(*src)); +#endif + if (likely(*src == '"')) { + val->tag = ((u64)(src - cur) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = (const char *)cur; + *src = '\0'; + *end = src + 1; + return true; + } + +skip_utf8: + if (*src & 0x80) { /* non-ASCII character */ + /* + Non-ASCII character appears here, which means that the text is likely + to be written in non-English or emoticons. According to some common + data set statistics, byte sequences of the same length may appear + consecutively. We process the byte sequences of the same length in each + loop, which is more friendly to branch prediction. + */ + pos = src; + uni = byte_load_4(src); + while (is_valid_seq_3(uni)) { + src += 3; + uni = byte_load_4(src); + } + if (is_valid_seq_1(uni)) goto skip_ascii; + while (is_valid_seq_2(uni)) { + src += 2; + uni = byte_load_4(src); + } + while (is_valid_seq_4(uni)) { + src += 4; + uni = byte_load_4(src); + } + if (unlikely(pos == src)) { + if (!inv) return_err(src, "invalid UTF-8 encoding in string"); + ++src; + } + goto skip_ascii; + } + + /* The escape character appears, we need to copy it. */ + dst = src; +copy_escape: + if (likely(*src == '\\')) { + switch (*++src) { + case '"': *dst++ = '"'; src++; break; + case '\\': *dst++ = '\\'; src++; break; + case '/': *dst++ = '/'; src++; break; + case 'b': *dst++ = '\b'; src++; break; + case 'f': *dst++ = '\f'; src++; break; + case 'n': *dst++ = '\n'; src++; break; + case 'r': *dst++ = '\r'; src++; break; + case 't': *dst++ = '\t'; src++; break; + case 'u': + if (unlikely(!read_hex_u16(++src, &hi))) { + return_err(src - 2, "invalid escaped sequence in string"); + } + src += 4; + if (likely((hi & 0xF800) != 0xD800)) { + /* a BMP character */ + if (hi >= 0x800) { + *dst++ = (u8)(0xE0 | (hi >> 12)); + *dst++ = (u8)(0x80 | ((hi >> 6) & 0x3F)); + *dst++ = (u8)(0x80 | (hi & 0x3F)); + } else if (hi >= 0x80) { + *dst++ = (u8)(0xC0 | (hi >> 6)); + *dst++ = (u8)(0x80 | (hi & 0x3F)); + } else { + *dst++ = (u8)hi; + } + } else { + /* a non-BMP character, represented as a surrogate pair */ + if (unlikely((hi & 0xFC00) != 0xD800)) { + return_err(src - 6, "invalid high surrogate in string"); + } + if (unlikely(!byte_match_2(src, "\\u"))) { + return_err(src, "no low surrogate in string"); + } + if (unlikely(!read_hex_u16(src + 2, &lo))) { + return_err(src, "invalid escaped sequence in string"); + } + if (unlikely((lo & 0xFC00) != 0xDC00)) { + return_err(src, "invalid low surrogate in string"); + } + uni = ((((u32)hi - 0xD800) << 10) | + ((u32)lo - 0xDC00)) + 0x10000; + *dst++ = (u8)(0xF0 | (uni >> 18)); + *dst++ = (u8)(0x80 | ((uni >> 12) & 0x3F)); + *dst++ = (u8)(0x80 | ((uni >> 6) & 0x3F)); + *dst++ = (u8)(0x80 | (uni & 0x3F)); + src += 6; + } + break; + default: return_err(src, "invalid escaped character in string"); + } + } else if (likely(*src == '"')) { + val->tag = ((u64)(dst - cur) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = (const char *)cur; + *dst = '\0'; + *end = src + 1; + return true; + } else { + if (!inv) return_err(src, "unexpected control character in string"); + if (src >= lst) return_err(src, "unclosed string"); + *dst++ = *src++; + } + +copy_ascii: + /* + Copy continuous ASCII, loop unrolling, same as the following code: + + while (true) repeat16({ + if (unlikely(char_is_ascii_stop(*src))) break; + *dst++ = *src++; + }) + */ +#if YYJSON_IS_REAL_GCC +# define expr_jump(i) \ + if (likely(!(char_is_ascii_stop(src[i])))) {} \ + else { __asm__ volatile("":"=m"(src[i])); goto copy_ascii_stop_##i; } +#else +# define expr_jump(i) \ + if (likely(!(char_is_ascii_stop(src[i])))) {} \ + else { goto copy_ascii_stop_##i; } +#endif + repeat16_incr(expr_jump) +#undef expr_jump + + byte_move_16(dst, src); + src += 16; + dst += 16; + goto copy_ascii; + +copy_ascii_stop_0: + goto copy_utf8; +copy_ascii_stop_1: + byte_move_2(dst, src); + src += 1; + dst += 1; + goto copy_utf8; +copy_ascii_stop_2: + byte_move_2(dst, src); + src += 2; + dst += 2; + goto copy_utf8; +copy_ascii_stop_3: + byte_move_4(dst, src); + src += 3; + dst += 3; + goto copy_utf8; +copy_ascii_stop_4: + byte_move_4(dst, src); + src += 4; + dst += 4; + goto copy_utf8; +copy_ascii_stop_5: + byte_move_4(dst, src); + byte_move_2(dst + 4, src + 4); + src += 5; + dst += 5; + goto copy_utf8; +copy_ascii_stop_6: + byte_move_4(dst, src); + byte_move_2(dst + 4, src + 4); + src += 6; + dst += 6; + goto copy_utf8; +copy_ascii_stop_7: + byte_move_8(dst, src); + src += 7; + dst += 7; + goto copy_utf8; +copy_ascii_stop_8: + byte_move_8(dst, src); + src += 8; + dst += 8; + goto copy_utf8; +copy_ascii_stop_9: + byte_move_8(dst, src); + byte_move_2(dst + 8, src + 8); + src += 9; + dst += 9; + goto copy_utf8; +copy_ascii_stop_10: + byte_move_8(dst, src); + byte_move_2(dst + 8, src + 8); + src += 10; + dst += 10; + goto copy_utf8; +copy_ascii_stop_11: + byte_move_8(dst, src); + byte_move_4(dst + 8, src + 8); + src += 11; + dst += 11; + goto copy_utf8; +copy_ascii_stop_12: + byte_move_8(dst, src); + byte_move_4(dst + 8, src + 8); + src += 12; + dst += 12; + goto copy_utf8; +copy_ascii_stop_13: + byte_move_8(dst, src); + byte_move_4(dst + 8, src + 8); + byte_move_2(dst + 12, src + 12); + src += 13; + dst += 13; + goto copy_utf8; +copy_ascii_stop_14: + byte_move_8(dst, src); + byte_move_4(dst + 8, src + 8); + byte_move_2(dst + 12, src + 12); + src += 14; + dst += 14; + goto copy_utf8; +copy_ascii_stop_15: + byte_move_16(dst, src); + src += 15; + dst += 15; + goto copy_utf8; + +copy_utf8: + if (*src & 0x80) { /* non-ASCII character */ + pos = src; + uni = byte_load_4(src); + while (is_valid_seq_3(uni)) { + byte_move_4(dst, &uni); + dst += 3; + src += 3; + uni = byte_load_4(src); + } + if (is_valid_seq_1(uni)) goto copy_ascii; + while (is_valid_seq_2(uni)) { + byte_move_2(dst, &uni); + dst += 2; + src += 2; + uni = byte_load_4(src); + } + while (is_valid_seq_4(uni)) { + byte_move_4(dst, &uni); + dst += 4; + src += 4; + uni = byte_load_4(src); + } + if (unlikely(pos == src)) { + if (!inv) return_err(src, "invalid UTF-8 encoding in string"); + goto copy_ascii_stop_1; + } + goto copy_ascii; + } + goto copy_escape; + +#undef return_err +#undef is_valid_seq_1 +#undef is_valid_seq_2 +#undef is_valid_seq_3 +#undef is_valid_seq_4 +} + + + +/*============================================================================== + * JSON Reader Implementation + * + * We use goto statements to build the finite state machine (FSM). + * The FSM's state was held by program counter (PC) and the 'goto' make the + * state transitions. + *============================================================================*/ + +/** Read single value JSON document. */ +static_noinline yyjson_doc *read_root_single(u8 *hdr, + u8 *cur, + u8 *end, + yyjson_alc alc, + yyjson_read_flag flg, + yyjson_read_err *err) { + +#define has_flag(_flag) unlikely((flg & YYJSON_READ_##_flag) != 0) + +#define return_err(_pos, _code, _msg) do { \ + if (is_truncated_end(hdr, _pos, end, YYJSON_READ_ERROR_##_code, flg)) { \ + err->pos = (usize)(end - hdr); \ + err->code = YYJSON_READ_ERROR_UNEXPECTED_END; \ + err->msg = "unexpected end of data"; \ + } else { \ + err->pos = (usize)(_pos - hdr); \ + err->code = YYJSON_READ_ERROR_##_code; \ + err->msg = _msg; \ + } \ + if (val_hdr) alc.free(alc.ctx, (void *)val_hdr); \ + return NULL; \ +} while (false) + + usize hdr_len; /* value count used by doc */ + usize alc_num; /* value count capacity */ + yyjson_val *val_hdr; /* the head of allocated values */ + yyjson_val *val; /* current value */ + yyjson_doc *doc; /* the JSON document, equals to val_hdr */ + const char *msg; /* error message */ + + bool raw; /* read number as raw */ + bool inv; /* allow invalid unicode */ + u8 *raw_end; /* raw end for null-terminator */ + u8 **pre; /* previous raw end pointer */ + + hdr_len = sizeof(yyjson_doc) / sizeof(yyjson_val); + hdr_len += (sizeof(yyjson_doc) % sizeof(yyjson_val)) > 0; + alc_num = hdr_len + 1; /* single value */ + + val_hdr = (yyjson_val *)alc.malloc(alc.ctx, alc_num * sizeof(yyjson_val)); + if (unlikely(!val_hdr)) goto fail_alloc; + val = val_hdr + hdr_len; + raw = (flg & (YYJSON_READ_NUMBER_AS_RAW | YYJSON_READ_BIGNUM_AS_RAW)) != 0; + inv = (flg & YYJSON_READ_ALLOW_INVALID_UNICODE) != 0; + raw_end = NULL; + pre = raw ? &raw_end : NULL; + + if (char_is_number(*cur)) { + if (likely(read_number(&cur, pre, flg, val, &msg))) goto doc_end; + goto fail_number; + } + if (*cur == '"') { + if (likely(read_string(&cur, end, inv, val, &msg))) goto doc_end; + goto fail_string; + } + if (*cur == 't') { + if (likely(read_true(&cur, val))) goto doc_end; + goto fail_literal; + } + if (*cur == 'f') { + if (likely(read_false(&cur, val))) goto doc_end; + goto fail_literal; + } + if (*cur == 'n') { + if (likely(read_null(&cur, val))) goto doc_end; + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_nan(false, &cur, pre, val)) goto doc_end; + } + goto fail_literal; + } + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_inf_or_nan(false, &cur, pre, val)) goto doc_end; + } + goto fail_character; + +doc_end: + /* check invalid contents after json document */ + if (unlikely(cur < end) && !has_flag(STOP_WHEN_DONE)) { + if (has_flag(ALLOW_COMMENTS)) { + if (!skip_spaces_and_comments(&cur)) { + if (byte_match_2(cur, "/*")) goto fail_comment; + } + } else { + while (char_is_space(*cur)) cur++; + } + if (unlikely(cur < end)) goto fail_garbage; + } + + if (pre && *pre) **pre = '\0'; + doc = (yyjson_doc *)val_hdr; + doc->root = val_hdr + hdr_len; + doc->alc = alc; + doc->dat_read = (usize)(cur - hdr); + doc->val_read = 1; + doc->str_pool = has_flag(INSITU) ? NULL : (char *)hdr; + return doc; + +fail_string: + return_err(cur, INVALID_STRING, msg); +fail_number: + return_err(cur, INVALID_NUMBER, msg); +fail_alloc: + return_err(cur, MEMORY_ALLOCATION, "memory allocation failed"); +fail_literal: + return_err(cur, LITERAL, "invalid literal"); +fail_comment: + return_err(cur, INVALID_COMMENT, "unclosed multiline comment"); +fail_character: + return_err(cur, UNEXPECTED_CHARACTER, "unexpected character"); +fail_garbage: + return_err(cur, UNEXPECTED_CONTENT, "unexpected content after document"); + +#undef has_flag +#undef return_err +} + +/** Read JSON document (accept all style, but optimized for minify). */ +static_inline yyjson_doc *read_root_minify(u8 *hdr, + u8 *cur, + u8 *end, + yyjson_alc alc, + yyjson_read_flag flg, + yyjson_read_err *err) { + +#define has_flag(_flag) unlikely((flg & YYJSON_READ_##_flag) != 0) + +#define return_err(_pos, _code, _msg) do { \ + if (is_truncated_end(hdr, _pos, end, YYJSON_READ_ERROR_##_code, flg)) { \ + err->pos = (usize)(end - hdr); \ + err->code = YYJSON_READ_ERROR_UNEXPECTED_END; \ + err->msg = "unexpected end of data"; \ + } else { \ + err->pos = (usize)(_pos - hdr); \ + err->code = YYJSON_READ_ERROR_##_code; \ + err->msg = _msg; \ + } \ + if (val_hdr) alc.free(alc.ctx, (void *)val_hdr); \ + return NULL; \ +} while (false) + +#define val_incr() do { \ + val++; \ + if (unlikely(val >= val_end)) { \ + usize alc_old = alc_len; \ + alc_len += alc_len / 2; \ + if ((alc_len >= alc_max)) goto fail_alloc; \ + val_tmp = (yyjson_val *)alc.realloc(alc.ctx, (void *)val_hdr, \ + alc_old * sizeof(yyjson_val), \ + alc_len * sizeof(yyjson_val)); \ + if ((!val_tmp)) goto fail_alloc; \ + val = val_tmp + (usize)(val - val_hdr); \ + ctn = val_tmp + (usize)(ctn - val_hdr); \ + val_hdr = val_tmp; \ + val_end = val_tmp + (alc_len - 2); \ + } \ +} while (false) + + usize dat_len; /* data length in bytes, hint for allocator */ + usize hdr_len; /* value count used by yyjson_doc */ + usize alc_len; /* value count allocated */ + usize alc_max; /* maximum value count for allocator */ + usize ctn_len; /* the number of elements in current container */ + yyjson_val *val_hdr; /* the head of allocated values */ + yyjson_val *val_end; /* the end of allocated values */ + yyjson_val *val_tmp; /* temporary pointer for realloc */ + yyjson_val *val; /* current JSON value */ + yyjson_val *ctn; /* current container */ + yyjson_val *ctn_parent; /* parent of current container */ + yyjson_doc *doc; /* the JSON document, equals to val_hdr */ + const char *msg; /* error message */ + + bool raw; /* read number as raw */ + bool inv; /* allow invalid unicode */ + u8 *raw_end; /* raw end for null-terminator */ + u8 **pre; /* previous raw end pointer */ + + dat_len = has_flag(STOP_WHEN_DONE) ? 256 : (usize)(end - cur); + hdr_len = sizeof(yyjson_doc) / sizeof(yyjson_val); + hdr_len += (sizeof(yyjson_doc) % sizeof(yyjson_val)) > 0; + alc_max = USIZE_MAX / sizeof(yyjson_val); + alc_len = hdr_len + (dat_len / YYJSON_READER_ESTIMATED_MINIFY_RATIO) + 4; + alc_len = yyjson_min(alc_len, alc_max); + + val_hdr = (yyjson_val *)alc.malloc(alc.ctx, alc_len * sizeof(yyjson_val)); + if (unlikely(!val_hdr)) goto fail_alloc; + val_end = val_hdr + (alc_len - 2); /* padding for key-value pair reading */ + val = val_hdr + hdr_len; + ctn = val; + ctn_len = 0; + raw = (flg & (YYJSON_READ_NUMBER_AS_RAW | YYJSON_READ_BIGNUM_AS_RAW)) != 0; + inv = (flg & YYJSON_READ_ALLOW_INVALID_UNICODE) != 0; + raw_end = NULL; + pre = raw ? &raw_end : NULL; + + if (*cur++ == '{') { + ctn->tag = YYJSON_TYPE_OBJ; + ctn->uni.ofs = 0; + goto obj_key_begin; + } else { + ctn->tag = YYJSON_TYPE_ARR; + ctn->uni.ofs = 0; + goto arr_val_begin; + } + +arr_begin: + /* save current container */ + ctn->tag = (((u64)ctn_len + 1) << YYJSON_TAG_BIT) | + (ctn->tag & YYJSON_TAG_MASK); + + /* create a new array value, save parent container offset */ + val_incr(); + val->tag = YYJSON_TYPE_ARR; + val->uni.ofs = (usize)((u8 *)val - (u8 *)ctn); + + /* push the new array value as current container */ + ctn = val; + ctn_len = 0; + +arr_val_begin: + if (*cur == '{') { + cur++; + goto obj_begin; + } + if (*cur == '[') { + cur++; + goto arr_begin; + } + if (char_is_number(*cur)) { + val_incr(); + ctn_len++; + if (likely(read_number(&cur, pre, flg, val, &msg))) goto arr_val_end; + goto fail_number; + } + if (*cur == '"') { + val_incr(); + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto arr_val_end; + goto fail_string; + } + if (*cur == 't') { + val_incr(); + ctn_len++; + if (likely(read_true(&cur, val))) goto arr_val_end; + goto fail_literal; + } + if (*cur == 'f') { + val_incr(); + ctn_len++; + if (likely(read_false(&cur, val))) goto arr_val_end; + goto fail_literal; + } + if (*cur == 'n') { + val_incr(); + ctn_len++; + if (likely(read_null(&cur, val))) goto arr_val_end; + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_nan(false, &cur, pre, val)) goto arr_val_end; + } + goto fail_literal; + } + if (*cur == ']') { + cur++; + if (likely(ctn_len == 0)) goto arr_end; + if (has_flag(ALLOW_TRAILING_COMMAS)) goto arr_end; + while (*cur != ',') cur--; + goto fail_trailing_comma; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto arr_val_begin; + } + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN) && + (*cur == 'i' || *cur == 'I' || *cur == 'N')) { + val_incr(); + ctn_len++; + if (read_inf_or_nan(false, &cur, pre, val)) goto arr_val_end; + goto fail_character; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto arr_val_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +arr_val_end: + if (*cur == ',') { + cur++; + goto arr_val_begin; + } + if (*cur == ']') { + cur++; + goto arr_end; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto arr_val_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto arr_val_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +arr_end: + /* get parent container */ + ctn_parent = (yyjson_val *)(void *)((u8 *)ctn - ctn->uni.ofs); + + /* save the next sibling value offset */ + ctn->uni.ofs = (usize)((u8 *)val - (u8 *)ctn) + sizeof(yyjson_val); + ctn->tag = ((ctn_len) << YYJSON_TAG_BIT) | YYJSON_TYPE_ARR; + if (unlikely(ctn == ctn_parent)) goto doc_end; + + /* pop parent as current container */ + ctn = ctn_parent; + ctn_len = (usize)(ctn->tag >> YYJSON_TAG_BIT); + if ((ctn->tag & YYJSON_TYPE_MASK) == YYJSON_TYPE_OBJ) { + goto obj_val_end; + } else { + goto arr_val_end; + } + +obj_begin: + /* push container */ + ctn->tag = (((u64)ctn_len + 1) << YYJSON_TAG_BIT) | + (ctn->tag & YYJSON_TAG_MASK); + val_incr(); + val->tag = YYJSON_TYPE_OBJ; + /* offset to the parent */ + val->uni.ofs = (usize)((u8 *)val - (u8 *)ctn); + ctn = val; + ctn_len = 0; + +obj_key_begin: + if (likely(*cur == '"')) { + val_incr(); + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto obj_key_end; + goto fail_string; + } + if (likely(*cur == '}')) { + cur++; + if (likely(ctn_len == 0)) goto obj_end; + if (has_flag(ALLOW_TRAILING_COMMAS)) goto obj_end; + while (*cur != ',') cur--; + goto fail_trailing_comma; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_key_begin; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_key_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_key_end: + if (*cur == ':') { + cur++; + goto obj_val_begin; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_key_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_key_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_val_begin: + if (*cur == '"') { + val++; + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto obj_val_end; + goto fail_string; + } + if (char_is_number(*cur)) { + val++; + ctn_len++; + if (likely(read_number(&cur, pre, flg, val, &msg))) goto obj_val_end; + goto fail_number; + } + if (*cur == '{') { + cur++; + goto obj_begin; + } + if (*cur == '[') { + cur++; + goto arr_begin; + } + if (*cur == 't') { + val++; + ctn_len++; + if (likely(read_true(&cur, val))) goto obj_val_end; + goto fail_literal; + } + if (*cur == 'f') { + val++; + ctn_len++; + if (likely(read_false(&cur, val))) goto obj_val_end; + goto fail_literal; + } + if (*cur == 'n') { + val++; + ctn_len++; + if (likely(read_null(&cur, val))) goto obj_val_end; + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_nan(false, &cur, pre, val)) goto obj_val_end; + } + goto fail_literal; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_val_begin; + } + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN) && + (*cur == 'i' || *cur == 'I' || *cur == 'N')) { + val++; + ctn_len++; + if (read_inf_or_nan(false, &cur, pre, val)) goto obj_val_end; + goto fail_character; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_val_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_val_end: + if (likely(*cur == ',')) { + cur++; + goto obj_key_begin; + } + if (likely(*cur == '}')) { + cur++; + goto obj_end; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_val_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_val_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_end: + /* pop container */ + ctn_parent = (yyjson_val *)(void *)((u8 *)ctn - ctn->uni.ofs); + /* point to the next value */ + ctn->uni.ofs = (usize)((u8 *)val - (u8 *)ctn) + sizeof(yyjson_val); + ctn->tag = (ctn_len << (YYJSON_TAG_BIT - 1)) | YYJSON_TYPE_OBJ; + if (unlikely(ctn == ctn_parent)) goto doc_end; + ctn = ctn_parent; + ctn_len = (usize)(ctn->tag >> YYJSON_TAG_BIT); + if ((ctn->tag & YYJSON_TYPE_MASK) == YYJSON_TYPE_OBJ) { + goto obj_val_end; + } else { + goto arr_val_end; + } + +doc_end: + /* check invalid contents after json document */ + if (unlikely(cur < end) && !has_flag(STOP_WHEN_DONE)) { + if (has_flag(ALLOW_COMMENTS)) { + skip_spaces_and_comments(&cur); + if (byte_match_2(cur, "/*")) goto fail_comment; + } + else while (char_is_space(*cur)) cur++; + if (unlikely(cur < end)) goto fail_garbage; + } + + if (pre && *pre) **pre = '\0'; + doc = (yyjson_doc *)val_hdr; + doc->root = val_hdr + hdr_len; + doc->alc = alc; + doc->dat_read = (usize)(cur - hdr); + doc->val_read = (usize)((val - doc->root) + 1); + doc->str_pool = has_flag(INSITU) ? NULL : (char *)hdr; + return doc; + +fail_string: + return_err(cur, INVALID_STRING, msg); +fail_number: + return_err(cur, INVALID_NUMBER, msg); +fail_alloc: + return_err(cur, MEMORY_ALLOCATION, "memory allocation failed"); +fail_trailing_comma: + return_err(cur, JSON_STRUCTURE, "trailing comma is not allowed"); +fail_literal: + return_err(cur, LITERAL, "invalid literal"); +fail_comment: + return_err(cur, INVALID_COMMENT, "unclosed multiline comment"); +fail_character: + return_err(cur, UNEXPECTED_CHARACTER, "unexpected character"); +fail_garbage: + return_err(cur, UNEXPECTED_CONTENT, "unexpected content after document"); + +#undef has_flag +#undef val_incr +#undef return_err +} + +/** Read JSON document (accept all style, but optimized for pretty). */ +static_inline yyjson_doc *read_root_pretty(u8 *hdr, + u8 *cur, + u8 *end, + yyjson_alc alc, + yyjson_read_flag flg, + yyjson_read_err *err) { + +#define has_flag(_flag) unlikely((flg & YYJSON_READ_##_flag) != 0) + +#define return_err(_pos, _code, _msg) do { \ + if (is_truncated_end(hdr, _pos, end, YYJSON_READ_ERROR_##_code, flg)) { \ + err->pos = (usize)(end - hdr); \ + err->code = YYJSON_READ_ERROR_UNEXPECTED_END; \ + err->msg = "unexpected end of data"; \ + } else { \ + err->pos = (usize)(_pos - hdr); \ + err->code = YYJSON_READ_ERROR_##_code; \ + err->msg = _msg; \ + } \ + if (val_hdr) alc.free(alc.ctx, (void *)val_hdr); \ + return NULL; \ +} while (false) + +#define val_incr() do { \ + val++; \ + if (unlikely(val >= val_end)) { \ + usize alc_old = alc_len; \ + alc_len += alc_len / 2; \ + if ((alc_len >= alc_max)) goto fail_alloc; \ + val_tmp = (yyjson_val *)alc.realloc(alc.ctx, (void *)val_hdr, \ + alc_old * sizeof(yyjson_val), \ + alc_len * sizeof(yyjson_val)); \ + if ((!val_tmp)) goto fail_alloc; \ + val = val_tmp + (usize)(val - val_hdr); \ + ctn = val_tmp + (usize)(ctn - val_hdr); \ + val_hdr = val_tmp; \ + val_end = val_tmp + (alc_len - 2); \ + } \ +} while (false) + + usize dat_len; /* data length in bytes, hint for allocator */ + usize hdr_len; /* value count used by yyjson_doc */ + usize alc_len; /* value count allocated */ + usize alc_max; /* maximum value count for allocator */ + usize ctn_len; /* the number of elements in current container */ + yyjson_val *val_hdr; /* the head of allocated values */ + yyjson_val *val_end; /* the end of allocated values */ + yyjson_val *val_tmp; /* temporary pointer for realloc */ + yyjson_val *val; /* current JSON value */ + yyjson_val *ctn; /* current container */ + yyjson_val *ctn_parent; /* parent of current container */ + yyjson_doc *doc; /* the JSON document, equals to val_hdr */ + const char *msg; /* error message */ + + bool raw; /* read number as raw */ + bool inv; /* allow invalid unicode */ + u8 *raw_end; /* raw end for null-terminator */ + u8 **pre; /* previous raw end pointer */ + + dat_len = has_flag(STOP_WHEN_DONE) ? 256 : (usize)(end - cur); + hdr_len = sizeof(yyjson_doc) / sizeof(yyjson_val); + hdr_len += (sizeof(yyjson_doc) % sizeof(yyjson_val)) > 0; + alc_max = USIZE_MAX / sizeof(yyjson_val); + alc_len = hdr_len + (dat_len / YYJSON_READER_ESTIMATED_PRETTY_RATIO) + 4; + alc_len = yyjson_min(alc_len, alc_max); + + val_hdr = (yyjson_val *)alc.malloc(alc.ctx, alc_len * sizeof(yyjson_val)); + if (unlikely(!val_hdr)) goto fail_alloc; + val_end = val_hdr + (alc_len - 2); /* padding for key-value pair reading */ + val = val_hdr + hdr_len; + ctn = val; + ctn_len = 0; + raw = (flg & (YYJSON_READ_NUMBER_AS_RAW | YYJSON_READ_BIGNUM_AS_RAW)) != 0; + inv = (flg & YYJSON_READ_ALLOW_INVALID_UNICODE) != 0; + raw_end = NULL; + pre = raw ? &raw_end : NULL; + + if (*cur++ == '{') { + ctn->tag = YYJSON_TYPE_OBJ; + ctn->uni.ofs = 0; + if (*cur == '\n') cur++; + goto obj_key_begin; + } else { + ctn->tag = YYJSON_TYPE_ARR; + ctn->uni.ofs = 0; + if (*cur == '\n') cur++; + goto arr_val_begin; + } + +arr_begin: + /* save current container */ + ctn->tag = (((u64)ctn_len + 1) << YYJSON_TAG_BIT) | + (ctn->tag & YYJSON_TAG_MASK); + + /* create a new array value, save parent container offset */ + val_incr(); + val->tag = YYJSON_TYPE_ARR; + val->uni.ofs = (usize)((u8 *)val - (u8 *)ctn); + + /* push the new array value as current container */ + ctn = val; + ctn_len = 0; + if (*cur == '\n') cur++; + +arr_val_begin: +#if YYJSON_IS_REAL_GCC + while (true) repeat16({ + if (byte_match_2(cur, " ")) cur += 2; + else break; + }) +#else + while (true) repeat16({ + if (likely(byte_match_2(cur, " "))) cur += 2; + else break; + }) +#endif + + if (*cur == '{') { + cur++; + goto obj_begin; + } + if (*cur == '[') { + cur++; + goto arr_begin; + } + if (char_is_number(*cur)) { + val_incr(); + ctn_len++; + if (likely(read_number(&cur, pre, flg, val, &msg))) goto arr_val_end; + goto fail_number; + } + if (*cur == '"') { + val_incr(); + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto arr_val_end; + goto fail_string; + } + if (*cur == 't') { + val_incr(); + ctn_len++; + if (likely(read_true(&cur, val))) goto arr_val_end; + goto fail_literal; + } + if (*cur == 'f') { + val_incr(); + ctn_len++; + if (likely(read_false(&cur, val))) goto arr_val_end; + goto fail_literal; + } + if (*cur == 'n') { + val_incr(); + ctn_len++; + if (likely(read_null(&cur, val))) goto arr_val_end; + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_nan(false, &cur, pre, val)) goto arr_val_end; + } + goto fail_literal; + } + if (*cur == ']') { + cur++; + if (likely(ctn_len == 0)) goto arr_end; + if (has_flag(ALLOW_TRAILING_COMMAS)) goto arr_end; + while (*cur != ',') cur--; + goto fail_trailing_comma; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto arr_val_begin; + } + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN) && + (*cur == 'i' || *cur == 'I' || *cur == 'N')) { + val_incr(); + ctn_len++; + if (read_inf_or_nan(false, &cur, pre, val)) goto arr_val_end; + goto fail_character; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto arr_val_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +arr_val_end: + if (byte_match_2(cur, ",\n")) { + cur += 2; + goto arr_val_begin; + } + if (*cur == ',') { + cur++; + goto arr_val_begin; + } + if (*cur == ']') { + cur++; + goto arr_end; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto arr_val_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto arr_val_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +arr_end: + /* get parent container */ + ctn_parent = (yyjson_val *)(void *)((u8 *)ctn - ctn->uni.ofs); + + /* save the next sibling value offset */ + ctn->uni.ofs = (usize)((u8 *)val - (u8 *)ctn) + sizeof(yyjson_val); + ctn->tag = ((ctn_len) << YYJSON_TAG_BIT) | YYJSON_TYPE_ARR; + if (unlikely(ctn == ctn_parent)) goto doc_end; + + /* pop parent as current container */ + ctn = ctn_parent; + ctn_len = (usize)(ctn->tag >> YYJSON_TAG_BIT); + if (*cur == '\n') cur++; + if ((ctn->tag & YYJSON_TYPE_MASK) == YYJSON_TYPE_OBJ) { + goto obj_val_end; + } else { + goto arr_val_end; + } + +obj_begin: + /* push container */ + ctn->tag = (((u64)ctn_len + 1) << YYJSON_TAG_BIT) | + (ctn->tag & YYJSON_TAG_MASK); + val_incr(); + val->tag = YYJSON_TYPE_OBJ; + /* offset to the parent */ + val->uni.ofs = (usize)((u8 *)val - (u8 *)ctn); + ctn = val; + ctn_len = 0; + if (*cur == '\n') cur++; + +obj_key_begin: +#if YYJSON_IS_REAL_GCC + while (true) repeat16({ + if (byte_match_2(cur, " ")) cur += 2; + else break; + }) +#else + while (true) repeat16({ + if (likely(byte_match_2(cur, " "))) cur += 2; + else break; + }) +#endif + if (likely(*cur == '"')) { + val_incr(); + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto obj_key_end; + goto fail_string; + } + if (likely(*cur == '}')) { + cur++; + if (likely(ctn_len == 0)) goto obj_end; + if (has_flag(ALLOW_TRAILING_COMMAS)) goto obj_end; + while (*cur != ',') cur--; + goto fail_trailing_comma; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_key_begin; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_key_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_key_end: + if (byte_match_2(cur, ": ")) { + cur += 2; + goto obj_val_begin; + } + if (*cur == ':') { + cur++; + goto obj_val_begin; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_key_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_key_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_val_begin: + if (*cur == '"') { + val++; + ctn_len++; + if (likely(read_string(&cur, end, inv, val, &msg))) goto obj_val_end; + goto fail_string; + } + if (char_is_number(*cur)) { + val++; + ctn_len++; + if (likely(read_number(&cur, pre, flg, val, &msg))) goto obj_val_end; + goto fail_number; + } + if (*cur == '{') { + cur++; + goto obj_begin; + } + if (*cur == '[') { + cur++; + goto arr_begin; + } + if (*cur == 't') { + val++; + ctn_len++; + if (likely(read_true(&cur, val))) goto obj_val_end; + goto fail_literal; + } + if (*cur == 'f') { + val++; + ctn_len++; + if (likely(read_false(&cur, val))) goto obj_val_end; + goto fail_literal; + } + if (*cur == 'n') { + val++; + ctn_len++; + if (likely(read_null(&cur, val))) goto obj_val_end; + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN)) { + if (read_nan(false, &cur, pre, val)) goto obj_val_end; + } + goto fail_literal; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_val_begin; + } + if (unlikely(flg & YYJSON_READ_ALLOW_INF_AND_NAN) && + (*cur == 'i' || *cur == 'I' || *cur == 'N')) { + val++; + ctn_len++; + if (read_inf_or_nan(false, &cur, pre, val)) goto obj_val_end; + goto fail_character; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_val_begin; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_val_end: + if (byte_match_2(cur, ",\n")) { + cur += 2; + goto obj_key_begin; + } + if (likely(*cur == ',')) { + cur++; + goto obj_key_begin; + } + if (likely(*cur == '}')) { + cur++; + goto obj_end; + } + if (char_is_space(*cur)) { + while (char_is_space(*++cur)); + goto obj_val_end; + } + if (has_flag(ALLOW_COMMENTS)) { + if (skip_spaces_and_comments(&cur)) goto obj_val_end; + if (byte_match_2(cur, "/*")) goto fail_comment; + } + goto fail_character; + +obj_end: + /* pop container */ + ctn_parent = (yyjson_val *)(void *)((u8 *)ctn - ctn->uni.ofs); + /* point to the next value */ + ctn->uni.ofs = (usize)((u8 *)val - (u8 *)ctn) + sizeof(yyjson_val); + ctn->tag = (ctn_len << (YYJSON_TAG_BIT - 1)) | YYJSON_TYPE_OBJ; + if (unlikely(ctn == ctn_parent)) goto doc_end; + ctn = ctn_parent; + ctn_len = (usize)(ctn->tag >> YYJSON_TAG_BIT); + if (*cur == '\n') cur++; + if ((ctn->tag & YYJSON_TYPE_MASK) == YYJSON_TYPE_OBJ) { + goto obj_val_end; + } else { + goto arr_val_end; + } + +doc_end: + /* check invalid contents after json document */ + if (unlikely(cur < end) && !has_flag(STOP_WHEN_DONE)) { + if (has_flag(ALLOW_COMMENTS)) { + skip_spaces_and_comments(&cur); + if (byte_match_2(cur, "/*")) goto fail_comment; + } + else while (char_is_space(*cur)) cur++; + if (unlikely(cur < end)) goto fail_garbage; + } + + if (pre && *pre) **pre = '\0'; + doc = (yyjson_doc *)val_hdr; + doc->root = val_hdr + hdr_len; + doc->alc = alc; + doc->dat_read = (usize)(cur - hdr); + doc->val_read = (usize)((val - val_hdr)) - hdr_len + 1; + doc->str_pool = has_flag(INSITU) ? NULL : (char *)hdr; + return doc; + +fail_string: + return_err(cur, INVALID_STRING, msg); +fail_number: + return_err(cur, INVALID_NUMBER, msg); +fail_alloc: + return_err(cur, MEMORY_ALLOCATION, "memory allocation failed"); +fail_trailing_comma: + return_err(cur, JSON_STRUCTURE, "trailing comma is not allowed"); +fail_literal: + return_err(cur, LITERAL, "invalid literal"); +fail_comment: + return_err(cur, INVALID_COMMENT, "unclosed multiline comment"); +fail_character: + return_err(cur, UNEXPECTED_CHARACTER, "unexpected character"); +fail_garbage: + return_err(cur, UNEXPECTED_CONTENT, "unexpected content after document"); + +#undef has_flag +#undef val_incr +#undef return_err +} + + + +/*============================================================================== + * JSON Reader Entrance + *============================================================================*/ + +yyjson_doc *yyjson_read_opts(char *dat, + usize len, + yyjson_read_flag flg, + const yyjson_alc *alc_ptr, + yyjson_read_err *err) { + +#define has_flag(_flag) unlikely((flg & YYJSON_READ_##_flag) != 0) + +#define return_err(_pos, _code, _msg) do { \ + err->pos = (usize)(_pos); \ + err->msg = _msg; \ + err->code = YYJSON_READ_ERROR_##_code; \ + if (!has_flag(INSITU) && hdr) alc.free(alc.ctx, (void *)hdr); \ + return NULL; \ +} while (false) + + yyjson_read_err dummy_err; + yyjson_alc alc; + yyjson_doc *doc; + u8 *hdr = NULL, *end, *cur; + +#if YYJSON_DISABLE_NON_STANDARD + flg &= ~YYJSON_READ_ALLOW_TRAILING_COMMAS; + flg &= ~YYJSON_READ_ALLOW_COMMENTS; + flg &= ~YYJSON_READ_ALLOW_INF_AND_NAN; + flg &= ~YYJSON_READ_ALLOW_INVALID_UNICODE; +#endif + + /* validate input parameters */ + if (!err) err = &dummy_err; + if (likely(!alc_ptr)) { + alc = YYJSON_DEFAULT_ALC; + } else { + alc = *alc_ptr; + } + if (unlikely(!dat)) { + return_err(0, INVALID_PARAMETER, "input data is NULL"); + } + if (unlikely(!len)) { + return_err(0, INVALID_PARAMETER, "input length is 0"); + } + + /* add 4-byte zero padding for input data if necessary */ + if (has_flag(INSITU)) { + hdr = (u8 *)dat; + end = (u8 *)dat + len; + cur = (u8 *)dat; + } else { + if (unlikely(len >= USIZE_MAX - YYJSON_PADDING_SIZE)) { + return_err(0, MEMORY_ALLOCATION, "memory allocation failed"); + } + hdr = (u8 *)alc.malloc(alc.ctx, len + YYJSON_PADDING_SIZE); + if (unlikely(!hdr)) { + return_err(0, MEMORY_ALLOCATION, "memory allocation failed"); + } + end = hdr + len; + cur = hdr; + memcpy(hdr, dat, len); + memset(end, 0, YYJSON_PADDING_SIZE); + } + + /* skip empty contents before json document */ + if (unlikely(char_is_space_or_comment(*cur))) { + if (has_flag(ALLOW_COMMENTS)) { + if (!skip_spaces_and_comments(&cur)) { + return_err(cur - hdr, INVALID_COMMENT, + "unclosed multiline comment"); + } + } else { + if (likely(char_is_space(*cur))) { + while (char_is_space(*++cur)); + } + } + if (unlikely(cur >= end)) { + return_err(0, EMPTY_CONTENT, "input data is empty"); + } + } + + /* read json document */ + if (likely(char_is_container(*cur))) { + if (char_is_space(cur[1]) && char_is_space(cur[2])) { + doc = read_root_pretty(hdr, cur, end, alc, flg, err); + } else { + doc = read_root_minify(hdr, cur, end, alc, flg, err); + } + } else { + doc = read_root_single(hdr, cur, end, alc, flg, err); + } + + /* check result */ + if (likely(doc)) { + memset(err, 0, sizeof(yyjson_read_err)); + } else { + /* RFC 8259: JSON text MUST be encoded using UTF-8 */ + if (err->pos == 0 && err->code != YYJSON_READ_ERROR_MEMORY_ALLOCATION) { + if ((hdr[0] == 0xEF && hdr[1] == 0xBB && hdr[2] == 0xBF)) { + err->msg = "byte order mark (BOM) is not supported"; + } else if (len >= 4 && + ((hdr[0] == 0x00 && hdr[1] == 0x00 && + hdr[2] == 0xFE && hdr[3] == 0xFF) || + (hdr[0] == 0xFF && hdr[1] == 0xFE && + hdr[2] == 0x00 && hdr[3] == 0x00))) { + err->msg = "UTF-32 encoding is not supported"; + } else if (len >= 2 && + ((hdr[0] == 0xFE && hdr[1] == 0xFF) || + (hdr[0] == 0xFF && hdr[1] == 0xFE))) { + err->msg = "UTF-16 encoding is not supported"; + } + } + if (!has_flag(INSITU)) alc.free(alc.ctx, (void *)hdr); + } + return doc; + +#undef has_flag +#undef return_err +} + +yyjson_doc *yyjson_read_file(const char *path, + yyjson_read_flag flg, + const yyjson_alc *alc_ptr, + yyjson_read_err *err) { +#define return_err(_code, _msg) do { \ + err->pos = 0; \ + err->msg = _msg; \ + err->code = YYJSON_READ_ERROR_##_code; \ + return NULL; \ +} while (false) + + yyjson_read_err dummy_err; + yyjson_doc *doc; + FILE *file; + + if (!err) err = &dummy_err; + if (unlikely(!path)) return_err(INVALID_PARAMETER, "input path is NULL"); + + file = fopen_readonly(path); + if (unlikely(!file)) return_err(FILE_OPEN, "file opening failed"); + + doc = yyjson_read_fp(file, flg, alc_ptr, err); + fclose(file); + return doc; + +#undef return_err +} + +yyjson_doc *yyjson_read_fp(FILE *file, + yyjson_read_flag flg, + const yyjson_alc *alc_ptr, + yyjson_read_err *err) { +#define return_err(_code, _msg) do { \ + err->pos = 0; \ + err->msg = _msg; \ + err->code = YYJSON_READ_ERROR_##_code; \ + if (buf) alc.free(alc.ctx, buf); \ + return NULL; \ +} while (false) + + yyjson_read_err dummy_err; + yyjson_alc alc = alc_ptr ? *alc_ptr : YYJSON_DEFAULT_ALC; + yyjson_doc *doc; + + long file_size = 0, file_pos; + void *buf = NULL; + usize buf_size = 0; + + /* validate input parameters */ + if (!err) err = &dummy_err; + if (unlikely(!file)) return_err(INVALID_PARAMETER, "input file is NULL"); + + /* get current position */ + file_pos = ftell(file); + if (file_pos != -1) { + /* get total file size, may fail */ + if (fseek(file, 0, SEEK_END) == 0) file_size = ftell(file); + /* reset to original position, may fail */ + if (fseek(file, file_pos, SEEK_SET) != 0) file_size = 0; + /* get file size from current postion to end */ + if (file_size > 0) file_size -= file_pos; + } + + /* read file */ + if (file_size > 0) { + /* read the entire file in one call */ + buf_size = (usize)file_size + YYJSON_PADDING_SIZE; + buf = alc.malloc(alc.ctx, buf_size); + if (buf == NULL) { + return_err(MEMORY_ALLOCATION, "fail to alloc memory"); + } + if (fread_safe(buf, (usize)file_size, file) != (usize)file_size) { + return_err(FILE_READ, "file reading failed"); + } + } else { + /* failed to get file size, read it as a stream */ + usize chunk_min = (usize)64; + usize chunk_max = (usize)512 * 1024 * 1024; + usize chunk_now = chunk_min; + usize read_size; + void *tmp; + + buf_size = YYJSON_PADDING_SIZE; + while (true) { + if (buf_size + chunk_now < buf_size) { /* overflow */ + return_err(MEMORY_ALLOCATION, "fail to alloc memory"); + } + buf_size += chunk_now; + if (!buf) { + buf = alc.malloc(alc.ctx, buf_size); + if (!buf) return_err(MEMORY_ALLOCATION, "fail to alloc memory"); + } else { + tmp = alc.realloc(alc.ctx, buf, buf_size - chunk_now, buf_size); + if (!tmp) return_err(MEMORY_ALLOCATION, "fail to alloc memory"); + buf = tmp; + } + tmp = ((u8 *)buf) + buf_size - YYJSON_PADDING_SIZE - chunk_now; + read_size = fread_safe(tmp, chunk_now, file); + file_size += (long)read_size; + if (read_size != chunk_now) break; + + chunk_now *= 2; + if (chunk_now > chunk_max) chunk_now = chunk_max; + } + } + + /* read JSON */ + memset((u8 *)buf + file_size, 0, YYJSON_PADDING_SIZE); + flg |= YYJSON_READ_INSITU; + doc = yyjson_read_opts((char *)buf, (usize)file_size, flg, &alc, err); + if (doc) { + doc->str_pool = (char *)buf; + return doc; + } else { + alc.free(alc.ctx, buf); + return NULL; + } + +#undef return_err +} + + + +const char *yyjson_read_number(const char *dat, + yyjson_val *val, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err) { +#define return_err(_pos, _code, _msg) do { \ + err->pos = _pos > hdr ? (usize)(_pos - hdr) : 0; \ + err->msg = _msg; \ + err->code = YYJSON_READ_ERROR_##_code; \ + return NULL; \ +} while (false) + + u8 *hdr = constcast(u8 *)dat, *cur = hdr; + bool raw; /* read number as raw */ + u8 *raw_end; /* raw end for null-terminator */ + u8 **pre; /* previous raw end pointer */ + const char *msg; + yyjson_read_err dummy_err; + +#if !YYJSON_HAS_IEEE_754 || YYJSON_DISABLE_FAST_FP_CONV + u8 buf[128]; + usize dat_len; +#endif + + if (!err) err = &dummy_err; + if (unlikely(!dat)) { + return_err(cur, INVALID_PARAMETER, "input data is NULL"); + } + if (unlikely(!val)) { + return_err(cur, INVALID_PARAMETER, "output value is NULL"); + } + +#if !YYJSON_HAS_IEEE_754 || YYJSON_DISABLE_FAST_FP_CONV + if (!alc) alc = &YYJSON_DEFAULT_ALC; + dat_len = strlen(dat); + if (dat_len < sizeof(buf)) { + memcpy(buf, dat, dat_len + 1); + hdr = buf; + cur = hdr; + } else { + hdr = (u8 *)alc->malloc(alc->ctx, dat_len + 1); + cur = hdr; + if (unlikely(!hdr)) { + return_err(cur, MEMORY_ALLOCATION, "memory allocation failed"); + } + memcpy(hdr, dat, dat_len + 1); + } + hdr[dat_len] = 0; +#endif + +#if YYJSON_DISABLE_NON_STANDARD + flg &= ~YYJSON_READ_ALLOW_INF_AND_NAN; +#endif + + raw = (flg & (YYJSON_READ_NUMBER_AS_RAW | YYJSON_READ_BIGNUM_AS_RAW)) != 0; + raw_end = NULL; + pre = raw ? &raw_end : NULL; + +#if !YYJSON_HAS_IEEE_754 || YYJSON_DISABLE_FAST_FP_CONV + if (!read_number(&cur, pre, flg, val, &msg)) { + if (dat_len >= sizeof(buf)) alc->free(alc->ctx, hdr); + return_err(cur, INVALID_NUMBER, msg); + } + if (dat_len >= sizeof(buf)) alc->free(alc->ctx, hdr); + if (yyjson_is_raw(val)) val->uni.str = dat; + return dat + (cur - hdr); +#else + if (!read_number(&cur, pre, flg, val, &msg)) { + return_err(cur, INVALID_NUMBER, msg); + } + return (const char *)cur; +#endif + +#undef return_err +} + +#endif /* YYJSON_DISABLE_READER */ + + + +#if !YYJSON_DISABLE_WRITER + +/*============================================================================== + * Integer Writer + * + * The maximum value of uint32_t is 4294967295 (10 digits), + * these digits are named as 'aabbccddee' here. + * + * Although most compilers may convert the "division by constant value" into + * "multiply and shift", manual conversion can still help some compilers + * generate fewer and better instructions. + * + * Reference: + * Division by Invariant Integers using Multiplication, 1994. + * https://gmplib.org/~tege/divcnst-pldi94.pdf + * Improved division by invariant integers, 2011. + * https://gmplib.org/~tege/division-paper.pdf + *============================================================================*/ + +/** Digit table from 00 to 99. */ +yyjson_align(2) +static const char digit_table[200] = { + '0', '0', '0', '1', '0', '2', '0', '3', '0', '4', + '0', '5', '0', '6', '0', '7', '0', '8', '0', '9', + '1', '0', '1', '1', '1', '2', '1', '3', '1', '4', + '1', '5', '1', '6', '1', '7', '1', '8', '1', '9', + '2', '0', '2', '1', '2', '2', '2', '3', '2', '4', + '2', '5', '2', '6', '2', '7', '2', '8', '2', '9', + '3', '0', '3', '1', '3', '2', '3', '3', '3', '4', + '3', '5', '3', '6', '3', '7', '3', '8', '3', '9', + '4', '0', '4', '1', '4', '2', '4', '3', '4', '4', + '4', '5', '4', '6', '4', '7', '4', '8', '4', '9', + '5', '0', '5', '1', '5', '2', '5', '3', '5', '4', + '5', '5', '5', '6', '5', '7', '5', '8', '5', '9', + '6', '0', '6', '1', '6', '2', '6', '3', '6', '4', + '6', '5', '6', '6', '6', '7', '6', '8', '6', '9', + '7', '0', '7', '1', '7', '2', '7', '3', '7', '4', + '7', '5', '7', '6', '7', '7', '7', '8', '7', '9', + '8', '0', '8', '1', '8', '2', '8', '3', '8', '4', + '8', '5', '8', '6', '8', '7', '8', '8', '8', '9', + '9', '0', '9', '1', '9', '2', '9', '3', '9', '4', + '9', '5', '9', '6', '9', '7', '9', '8', '9', '9' +}; + +static_inline u8 *write_u32_len_8(u32 val, u8 *buf) { + u32 aa, bb, cc, dd, aabb, ccdd; /* 8 digits: aabbccdd */ + aabb = (u32)(((u64)val * 109951163) >> 40); /* (val / 10000) */ + ccdd = val - aabb * 10000; /* (val % 10000) */ + aa = (aabb * 5243) >> 19; /* (aabb / 100) */ + cc = (ccdd * 5243) >> 19; /* (ccdd / 100) */ + bb = aabb - aa * 100; /* (aabb % 100) */ + dd = ccdd - cc * 100; /* (ccdd % 100) */ + ((v16 *)buf)[0] = ((const v16 *)digit_table)[aa]; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + ((v16 *)buf)[2] = ((const v16 *)digit_table)[cc]; + ((v16 *)buf)[3] = ((const v16 *)digit_table)[dd]; + return buf + 8; +} + +static_inline u8 *write_u32_len_4(u32 val, u8 *buf) { + u32 aa, bb; /* 4 digits: aabb */ + aa = (val * 5243) >> 19; /* (val / 100) */ + bb = val - aa * 100; /* (val % 100) */ + ((v16 *)buf)[0] = ((const v16 *)digit_table)[aa]; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + return buf + 4; +} + +static_inline u8 *write_u32_len_1_8(u32 val, u8 *buf) { + u32 aa, bb, cc, dd, aabb, bbcc, ccdd, lz; + + if (val < 100) { /* 1-2 digits: aa */ + lz = val < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (val * 2 + lz)); + buf -= lz; + return buf + 2; + + } else if (val < 10000) { /* 3-4 digits: aabb */ + aa = (val * 5243) >> 19; /* (val / 100) */ + bb = val - aa * 100; /* (val % 100) */ + lz = aa < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (aa * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + return buf + 4; + + } else if (val < 1000000) { /* 5-6 digits: aabbcc */ + aa = (u32)(((u64)val * 429497) >> 32); /* (val / 10000) */ + bbcc = val - aa * 10000; /* (val % 10000) */ + bb = (bbcc * 5243) >> 19; /* (bbcc / 100) */ + cc = bbcc - bb * 100; /* (bbcc % 100) */ + lz = aa < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (aa * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + ((v16 *)buf)[2] = ((const v16 *)digit_table)[cc]; + return buf + 6; + + } else { /* 7-8 digits: aabbccdd */ + aabb = (u32)(((u64)val * 109951163) >> 40); /* (val / 10000) */ + ccdd = val - aabb * 10000; /* (val % 10000) */ + aa = (aabb * 5243) >> 19; /* (aabb / 100) */ + cc = (ccdd * 5243) >> 19; /* (ccdd / 100) */ + bb = aabb - aa * 100; /* (aabb % 100) */ + dd = ccdd - cc * 100; /* (ccdd % 100) */ + lz = aa < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (aa * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + ((v16 *)buf)[2] = ((const v16 *)digit_table)[cc]; + ((v16 *)buf)[3] = ((const v16 *)digit_table)[dd]; + return buf + 8; + } +} + +static_inline u8 *write_u64_len_5_8(u32 val, u8 *buf) { + u32 aa, bb, cc, dd, aabb, bbcc, ccdd, lz; + + if (val < 1000000) { /* 5-6 digits: aabbcc */ + aa = (u32)(((u64)val * 429497) >> 32); /* (val / 10000) */ + bbcc = val - aa * 10000; /* (val % 10000) */ + bb = (bbcc * 5243) >> 19; /* (bbcc / 100) */ + cc = bbcc - bb * 100; /* (bbcc % 100) */ + lz = aa < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (aa * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + ((v16 *)buf)[2] = ((const v16 *)digit_table)[cc]; + return buf + 6; + + } else { /* 7-8 digits: aabbccdd */ + aabb = (u32)(((u64)val * 109951163) >> 40); /* (val / 10000) */ + ccdd = val - aabb * 10000; /* (val % 10000) */ + aa = (aabb * 5243) >> 19; /* (aabb / 100) */ + cc = (ccdd * 5243) >> 19; /* (ccdd / 100) */ + bb = aabb - aa * 100; /* (aabb % 100) */ + dd = ccdd - cc * 100; /* (ccdd % 100) */ + lz = aa < 10; /* leading zero: 0 or 1 */ + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (aa * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[bb]; + ((v16 *)buf)[2] = ((const v16 *)digit_table)[cc]; + ((v16 *)buf)[3] = ((const v16 *)digit_table)[dd]; + return buf + 8; + } +} + +static_inline u8 *write_u64(u64 val, u8 *buf) { + u64 tmp, hgh; + u32 mid, low; + + if (val < 100000000) { /* 1-8 digits */ + buf = write_u32_len_1_8((u32)val, buf); + return buf; + + } else if (val < (u64)100000000 * 100000000) { /* 9-16 digits */ + hgh = val / 100000000; /* (val / 100000000) */ + low = (u32)(val - hgh * 100000000); /* (val % 100000000) */ + buf = write_u32_len_1_8((u32)hgh, buf); + buf = write_u32_len_8(low, buf); + return buf; + + } else { /* 17-20 digits */ + tmp = val / 100000000; /* (val / 100000000) */ + low = (u32)(val - tmp * 100000000); /* (val % 100000000) */ + hgh = (u32)(tmp / 10000); /* (tmp / 10000) */ + mid = (u32)(tmp - hgh * 10000); /* (tmp % 10000) */ + buf = write_u64_len_5_8((u32)hgh, buf); + buf = write_u32_len_4(mid, buf); + buf = write_u32_len_8(low, buf); + return buf; + } +} + + + +/*============================================================================== + * Number Writer + *============================================================================*/ + +#if YYJSON_HAS_IEEE_754 && !YYJSON_DISABLE_FAST_FP_CONV /* FP_WRITER */ + +/** Trailing zero count table for number 0 to 99. + (generate with misc/make_tables.c) */ +static const u8 dec_trailing_zero_table[] = { + 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 0, 0, 0, 0, 0, 0, 0, 0, 0 +}; + +/** Write an unsigned integer with a length of 1 to 16. */ +static_inline u8 *write_u64_len_1_to_16(u64 val, u8 *buf) { + u64 hgh; + u32 low; + if (val < 100000000) { /* 1-8 digits */ + buf = write_u32_len_1_8((u32)val, buf); + return buf; + } else { /* 9-16 digits */ + hgh = val / 100000000; /* (val / 100000000) */ + low = (u32)(val - hgh * 100000000); /* (val % 100000000) */ + buf = write_u32_len_1_8((u32)hgh, buf); + buf = write_u32_len_8(low, buf); + return buf; + } +} + +/** Write an unsigned integer with a length of 1 to 17. */ +static_inline u8 *write_u64_len_1_to_17(u64 val, u8 *buf) { + u64 hgh; + u32 mid, low, one; + if (val >= (u64)100000000 * 10000000) { /* len: 16 to 17 */ + hgh = val / 100000000; /* (val / 100000000) */ + low = (u32)(val - hgh * 100000000); /* (val % 100000000) */ + one = (u32)(hgh / 100000000); /* (hgh / 100000000) */ + mid = (u32)(hgh - (u64)one * 100000000); /* (hgh % 100000000) */ + *buf = (u8)((u8)one + (u8)'0'); + buf += one > 0; + buf = write_u32_len_8(mid, buf); + buf = write_u32_len_8(low, buf); + return buf; + } else if (val >= (u64)100000000){ /* len: 9 to 15 */ + hgh = val / 100000000; /* (val / 100000000) */ + low = (u32)(val - hgh * 100000000); /* (val % 100000000) */ + buf = write_u32_len_1_8((u32)hgh, buf); + buf = write_u32_len_8(low, buf); + return buf; + } else { /* len: 1 to 8 */ + buf = write_u32_len_1_8((u32)val, buf); + return buf; + } +} + +/** + Write an unsigned integer with a length of 15 to 17 with trailing zero trimmed. + These digits are named as "aabbccddeeffgghhii" here. + For example, input 1234567890123000, output "1234567890123". + */ +static_inline u8 *write_u64_len_15_to_17_trim(u8 *buf, u64 sig) { + bool lz; /* leading zero */ + u32 tz1, tz2, tz; /* trailing zero */ + + u32 abbccddee = (u32)(sig / 100000000); + u32 ffgghhii = (u32)(sig - (u64)abbccddee * 100000000); + u32 abbcc = abbccddee / 10000; /* (abbccddee / 10000) */ + u32 ddee = abbccddee - abbcc * 10000; /* (abbccddee % 10000) */ + u32 abb = (u32)(((u64)abbcc * 167773) >> 24); /* (abbcc / 100) */ + u32 a = (abb * 41) >> 12; /* (abb / 100) */ + u32 bb = abb - a * 100; /* (abb % 100) */ + u32 cc = abbcc - abb * 100; /* (abbcc % 100) */ + + /* write abbcc */ + buf[0] = (u8)(a + '0'); + buf += a > 0; + lz = bb < 10 && a == 0; + ((v16 *)buf)[0] = *(const v16 *)(digit_table + (bb * 2 + lz)); + buf -= lz; + ((v16 *)buf)[1] = ((const v16 *)digit_table)[cc]; + + if (ffgghhii) { + u32 dd = (ddee * 5243) >> 19; /* (ddee / 100) */ + u32 ee = ddee - dd * 100; /* (ddee % 100) */ + u32 ffgg = (u32)(((u64)ffgghhii * 109951163) >> 40); /* (val / 10000) */ + u32 hhii = ffgghhii - ffgg * 10000; /* (val % 10000) */ + u32 ff = (ffgg * 5243) >> 19; /* (aabb / 100) */ + u32 gg = ffgg - ff * 100; /* (aabb % 100) */ + ((v16 *)buf)[2] = ((const v16 *)digit_table)[dd]; + ((v16 *)buf)[3] = ((const v16 *)digit_table)[ee]; + ((v16 *)buf)[4] = ((const v16 *)digit_table)[ff]; + ((v16 *)buf)[5] = ((const v16 *)digit_table)[gg]; + if (hhii) { + u32 hh = (hhii * 5243) >> 19; /* (ccdd / 100) */ + u32 ii = hhii - hh * 100; /* (ccdd % 100) */ + ((v16 *)buf)[6] = ((const v16 *)digit_table)[hh]; + ((v16 *)buf)[7] = ((const v16 *)digit_table)[ii]; + tz1 = dec_trailing_zero_table[hh]; + tz2 = dec_trailing_zero_table[ii]; + tz = ii ? tz2 : (tz1 + 2); + buf += 16 - tz; + return buf; + } else { + tz1 = dec_trailing_zero_table[ff]; + tz2 = dec_trailing_zero_table[gg]; + tz = gg ? tz2 : (tz1 + 2); + buf += 12 - tz; + return buf; + } + } else { + if (ddee) { + u32 dd = (ddee * 5243) >> 19; /* (ddee / 100) */ + u32 ee = ddee - dd * 100; /* (ddee % 100) */ + ((v16 *)buf)[2] = ((const v16 *)digit_table)[dd]; + ((v16 *)buf)[3] = ((const v16 *)digit_table)[ee]; + tz1 = dec_trailing_zero_table[dd]; + tz2 = dec_trailing_zero_table[ee]; + tz = ee ? tz2 : (tz1 + 2); + buf += 8 - tz; + return buf; + } else { + tz1 = dec_trailing_zero_table[bb]; + tz2 = dec_trailing_zero_table[cc]; + tz = cc ? tz2 : (tz1 + tz2); + buf += 4 - tz; + return buf; + } + } +} + +/** Write a signed integer in the range -324 to 308. */ +static_inline u8 *write_f64_exp(i32 exp, u8 *buf) { + buf[0] = '-'; + buf += exp < 0; + exp = exp < 0 ? -exp : exp; + if (exp < 100) { + u32 lz = exp < 10; + *(v16 *)&buf[0] = *(const v16 *)(digit_table + ((u32)exp * 2 + lz)); + return buf + 2 - lz; + } else { + u32 hi = ((u32)exp * 656) >> 16; /* exp / 100 */ + u32 lo = (u32)exp - hi * 100; /* exp % 100 */ + buf[0] = (u8)((u8)hi + (u8)'0'); + *(v16 *)&buf[1] = *(const v16 *)(digit_table + (lo * 2)); + return buf + 3; + } +} + +/** Multiplies 128-bit integer and returns highest 64-bit rounded value. */ +static_inline u64 round_to_odd(u64 hi, u64 lo, u64 cp) { + u64 x_hi, x_lo, y_hi, y_lo; + u128_mul(cp, lo, &x_hi, &x_lo); + u128_mul_add(cp, hi, x_hi, &y_hi, &y_lo); + return y_hi | (y_lo > 1); +} + +/** + Convert double number from binary to decimal. + The output significand is shortest decimal but may have trailing zeros. + + This function use the Schubfach algorithm: + Raffaello Giulietti, The Schubfach way to render doubles (5th version), 2022. + https://drive.google.com/file/d/1gp5xv4CAa78SVgCeWfGqqI4FfYYYuNFb + https://mail.openjdk.java.net/pipermail/core-libs-dev/2021-November/083536.html + https://github.com/openjdk/jdk/pull/3402 (Java implementation) + https://github.com/abolz/Drachennest (C++ implementation) + + See also: + Dragonbox: A New Floating-Point Binary-to-Decimal Conversion Algorithm, 2022. + https://github.com/jk-jeon/dragonbox/blob/master/other_files/Dragonbox.pdf + https://github.com/jk-jeon/dragonbox + + @param sig_raw The raw value of significand in IEEE 754 format. + @param exp_raw The raw value of exponent in IEEE 754 format. + @param sig_bin The decoded value of significand in binary. + @param exp_bin The decoded value of exponent in binary. + @param sig_dec The output value of significand in decimal. + @param exp_dec The output value of exponent in decimal. + @warning The input double number should not be 0, inf, nan. + */ +static_inline void f64_bin_to_dec(u64 sig_raw, u32 exp_raw, + u64 sig_bin, i32 exp_bin, + u64 *sig_dec, i32 *exp_dec) { + + bool is_even, regular_spacing, u_inside, w_inside, round_up; + u64 s, sp, cb, cbl, cbr, vb, vbl, vbr, pow10hi, pow10lo, upper, lower, mid; + i32 k, h, exp10; + + is_even = !(sig_bin & 1); + regular_spacing = (sig_raw == 0 && exp_raw > 1); + + cbl = 4 * sig_bin - 2 + regular_spacing; + cb = 4 * sig_bin; + cbr = 4 * sig_bin + 2; + + /* exp_bin: [-1074, 971] */ + /* k = regular_spacing ? floor(log10(pow(2, exp_bin))) */ + /* : floor(log10(pow(2, exp_bin) * 3.0 / 4.0)) */ + /* = regular_spacing ? floor(exp_bin * log10(2)) */ + /* : floor(exp_bin * log10(2) + log10(3.0 / 4.0)) */ + k = (i32)(exp_bin * 315653 - (regular_spacing ? 131237 : 0)) >> 20; + + /* k: [-324, 292] */ + /* h = exp_bin + floor(log2(pow(10, e))) */ + /* = exp_bin + floor(log2(10) * e) */ + exp10 = -k; + h = exp_bin + ((exp10 * 217707) >> 16) + 1; + + pow10_table_get_sig(exp10, &pow10hi, &pow10lo); + pow10lo += (exp10 < POW10_SIG_TABLE_MIN_EXACT_EXP || + exp10 > POW10_SIG_TABLE_MAX_EXACT_EXP); + vbl = round_to_odd(pow10hi, pow10lo, cbl << h); + vb = round_to_odd(pow10hi, pow10lo, cb << h); + vbr = round_to_odd(pow10hi, pow10lo, cbr << h); + + lower = vbl + !is_even; + upper = vbr - !is_even; + + s = vb / 4; + if (s >= 10) { + sp = s / 10; + u_inside = (lower <= 40 * sp); + w_inside = (upper >= 40 * sp + 40); + if (u_inside != w_inside) { + *sig_dec = sp + w_inside; + *exp_dec = k + 1; + return; + } + } + + u_inside = (lower <= 4 * s); + w_inside = (upper >= 4 * s + 4); + + mid = 4 * s + 2; + round_up = (vb > mid) || (vb == mid && (s & 1) != 0); + + *sig_dec = s + ((u_inside != w_inside) ? w_inside : round_up); + *exp_dec = k; +} + +/** + Write a double number (requires 32 bytes buffer). + + We follows the ECMAScript specification to print floating point numbers, + but with the following changes: + 1. Keep the negative sign of 0.0 to preserve input information. + 2. Keep decimal point to indicate the number is floating point. + 3. Remove positive sign of exponent part. + */ +static_noinline u8 *write_f64_raw(u8 *buf, u64 raw, yyjson_write_flag flg) { + u64 sig_bin, sig_dec, sig_raw; + i32 exp_bin, exp_dec, sig_len, dot_pos, i, max; + u32 exp_raw, hi, lo; + u8 *hdr, *num_hdr, *num_end, *dot_end; + bool sign; + + /* decode raw bytes from IEEE-754 double format. */ + sign = (bool)(raw >> (F64_BITS - 1)); + sig_raw = raw & F64_SIG_MASK; + exp_raw = (u32)((raw & F64_EXP_MASK) >> F64_SIG_BITS); + + /* return inf and nan */ + if (unlikely(exp_raw == ((u32)1 << F64_EXP_BITS) - 1)) { + if (flg & YYJSON_WRITE_INF_AND_NAN_AS_NULL) { + byte_copy_4(buf, "null"); + return buf + 4; + } else if (flg & YYJSON_WRITE_ALLOW_INF_AND_NAN) { + if (sig_raw == 0) { + buf[0] = '-'; + buf += sign; + byte_copy_8(buf, "Infinity"); + buf += 8; + return buf; + } else { + byte_copy_4(buf, "NaN"); + return buf + 3; + } + } else { + return NULL; + } + } + + /* add sign for all finite double value, including 0.0 and inf */ + buf[0] = '-'; + buf += sign; + hdr = buf; + + /* return zero */ + if ((raw << 1) == 0) { + byte_copy_4(buf, "0.0"); + buf += 3; + return buf; + } + + if (likely(exp_raw != 0)) { + /* normal number */ + sig_bin = sig_raw | ((u64)1 << F64_SIG_BITS); + exp_bin = (i32)exp_raw - F64_EXP_BIAS - F64_SIG_BITS; + + /* fast path for small integer number without fraction */ + if (-F64_SIG_BITS <= exp_bin && exp_bin <= 0) { + if (u64_tz_bits(sig_bin) >= (u32)-exp_bin) { + /* number is integer in range 1 to 0x1FFFFFFFFFFFFF */ + sig_dec = sig_bin >> -exp_bin; + buf = write_u64_len_1_to_16(sig_dec, buf); + byte_copy_2(buf, ".0"); + buf += 2; + return buf; + } + } + + /* binary to decimal */ + f64_bin_to_dec(sig_raw, exp_raw, sig_bin, exp_bin, &sig_dec, &exp_dec); + + /* the sig length is 15 to 17 */ + sig_len = 17; + sig_len -= (sig_dec < (u64)100000000 * 100000000); + sig_len -= (sig_dec < (u64)100000000 * 10000000); + + /* the decimal point position relative to the first digit */ + dot_pos = sig_len + exp_dec; + + if (-6 < dot_pos && dot_pos <= 21) { + /* no need to write exponent part */ + if (dot_pos <= 0) { + /* dot before first digit */ + /* such as 0.1234, 0.000001234 */ + num_hdr = hdr + (2 - dot_pos); + num_end = write_u64_len_15_to_17_trim(num_hdr, sig_dec); + hdr[0] = '0'; + hdr[1] = '.'; + hdr += 2; + max = -dot_pos; + for (i = 0; i < max; i++) hdr[i] = '0'; + return num_end; + } else { + /* dot after first digit */ + /* such as 1.234, 1234.0, 123400000000000000000.0 */ + memset(hdr + 0, '0', 8); + memset(hdr + 8, '0', 8); + memset(hdr + 16, '0', 8); + num_hdr = hdr + 1; + num_end = write_u64_len_15_to_17_trim(num_hdr, sig_dec); + for (i = 0; i < dot_pos; i++) hdr[i] = hdr[i + 1]; + hdr[dot_pos] = '.'; + dot_end = hdr + dot_pos + 2; + return dot_end < num_end ? num_end : dot_end; + } + } else { + /* write with scientific notation */ + /* such as 1.234e56 */ + u8 *end = write_u64_len_15_to_17_trim(buf + 1, sig_dec); + end -= (end == buf + 2); /* remove '.0', e.g. 2.0e34 -> 2e34 */ + exp_dec += sig_len - 1; + hdr[0] = hdr[1]; + hdr[1] = '.'; + end[0] = 'e'; + buf = write_f64_exp(exp_dec, end + 1); + return buf; + } + + } else { + /* subnormal number */ + sig_bin = sig_raw; + exp_bin = 1 - F64_EXP_BIAS - F64_SIG_BITS; + + /* binary to decimal */ + f64_bin_to_dec(sig_raw, exp_raw, sig_bin, exp_bin, &sig_dec, &exp_dec); + + /* write significand part */ + buf = write_u64_len_1_to_17(sig_dec, buf + 1); + hdr[0] = hdr[1]; + hdr[1] = '.'; + do { + buf--; + exp_dec++; + } while (*buf == '0'); + exp_dec += (i32)(buf - hdr - 2); + buf += (*buf != '.'); + buf[0] = 'e'; + buf++; + + /* write exponent part */ + buf[0] = '-'; + buf++; + exp_dec = -exp_dec; + hi = ((u32)exp_dec * 656) >> 16; /* exp / 100 */ + lo = (u32)exp_dec - hi * 100; /* exp % 100 */ + buf[0] = (u8)((u8)hi + (u8)'0'); + *(v16 *)&buf[1] = *(const v16 *)(digit_table + (lo * 2)); + buf += 3; + return buf; + } +} + +#else /* FP_WRITER */ + +/** Write a double number (requires 32 bytes buffer). */ +static_noinline u8 *write_f64_raw(u8 *buf, u64 raw, yyjson_write_flag flg) { + /* + For IEEE 754, `DBL_DECIMAL_DIG` is 17 for round-trip. + For non-IEEE formats, 17 is used to avoid buffer overflow, + round-trip is not guaranteed. + */ +#if defined(DBL_DECIMAL_DIG) && DBL_DECIMAL_DIG != 17 + int dig = DBL_DECIMAL_DIG > 17 ? 17 : DBL_DECIMAL_DIG; +#else + int dig = 17; +#endif + + /* + The snprintf() function is locale-dependent. For currently known locales, + (en, zh, ja, ko, am, he, hi) use '.' as the decimal point, while other + locales use ',' as the decimal point. we need to replace ',' with '.' + to avoid the locale setting. + */ + f64 val = f64_from_raw(raw); +#if YYJSON_MSC_VER >= 1400 + int len = sprintf_s((char *)buf, 32, "%.*g", dig, val); +#elif defined(snprintf) || (YYJSON_STDC_VER >= 199901L) + int len = snprintf((char *)buf, 32, "%.*g", dig, val); +#else + int len = sprintf((char *)buf, "%.*g", dig, val); +#endif + + u8 *cur = buf; + if (unlikely(len < 1)) return NULL; + cur += (*cur == '-'); + if (unlikely(!digi_is_digit(*cur))) { + /* nan, inf, or bad output */ + if (flg & YYJSON_WRITE_INF_AND_NAN_AS_NULL) { + byte_copy_4(buf, "null"); + return buf + 4; + } else if (flg & YYJSON_WRITE_ALLOW_INF_AND_NAN) { + if (*cur == 'i') { + byte_copy_8(cur, "Infinity"); + cur += 8; + return cur; + } else if (*cur == 'n') { + byte_copy_4(buf, "NaN"); + return buf + 3; + } + } + return NULL; + } else { + /* finite number */ + int i = 0; + bool fp = false; + for (; i < len; i++) { + if (buf[i] == ',') buf[i] = '.'; + if (digi_is_fp((u8)buf[i])) fp = true; + } + if (!fp) { + buf[len++] = '.'; + buf[len++] = '0'; + } + } + return buf + len; +} + +#endif /* FP_WRITER */ + +/** Write a JSON number (requires 32 bytes buffer). */ +static_inline u8 *write_number(u8 *cur, yyjson_val *val, + yyjson_write_flag flg) { + if (val->tag & YYJSON_SUBTYPE_REAL) { + u64 raw = val->uni.u64; + return write_f64_raw(cur, raw, flg); + } else { + u64 pos = val->uni.u64; + u64 neg = ~pos + 1; + usize sgn = ((val->tag & YYJSON_SUBTYPE_SINT) > 0) & ((i64)pos < 0); + *cur = '-'; + return write_u64(sgn ? neg : pos, cur + sgn); + } +} + + + +/*============================================================================== + * String Writer + *============================================================================*/ + +/** Character encode type, if (type > CHAR_ENC_ERR_1) bytes = type / 2; */ +typedef u8 char_enc_type; +#define CHAR_ENC_CPY_1 0 /* 1-byte UTF-8, copy. */ +#define CHAR_ENC_ERR_1 1 /* 1-byte UTF-8, error. */ +#define CHAR_ENC_ESC_A 2 /* 1-byte ASCII, escaped as '\x'. */ +#define CHAR_ENC_ESC_1 3 /* 1-byte UTF-8, escaped as '\uXXXX'. */ +#define CHAR_ENC_CPY_2 4 /* 2-byte UTF-8, copy. */ +#define CHAR_ENC_ESC_2 5 /* 2-byte UTF-8, escaped as '\uXXXX'. */ +#define CHAR_ENC_CPY_3 6 /* 3-byte UTF-8, copy. */ +#define CHAR_ENC_ESC_3 7 /* 3-byte UTF-8, escaped as '\uXXXX'. */ +#define CHAR_ENC_CPY_4 8 /* 4-byte UTF-8, copy. */ +#define CHAR_ENC_ESC_4 9 /* 4-byte UTF-8, escaped as '\uXXXX\uXXXX'. */ + +/** Character encode type table: don't escape unicode, don't escape '/'. + (generate with misc/make_tables.c) */ +static const char_enc_type enc_table_cpy[256] = { + 3, 3, 3, 3, 3, 3, 3, 3, 2, 2, 2, 3, 2, 2, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, + 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, + 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, + 8, 8, 8, 8, 8, 8, 8, 8, 1, 1, 1, 1, 1, 1, 1, 1 +}; + +/** Character encode type table: don't escape unicode, escape '/'. + (generate with misc/make_tables.c) */ +static const char_enc_type enc_table_cpy_slash[256] = { + 3, 3, 3, 3, 3, 3, 3, 3, 2, 2, 2, 3, 2, 2, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, + 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, + 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, 6, + 8, 8, 8, 8, 8, 8, 8, 8, 1, 1, 1, 1, 1, 1, 1, 1 +}; + +/** Character encode type table: escape unicode, don't escape '/'. + (generate with misc/make_tables.c) */ +static const char_enc_type enc_table_esc[256] = { + 3, 3, 3, 3, 3, 3, 3, 3, 2, 2, 2, 3, 2, 2, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, + 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, + 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, + 9, 9, 9, 9, 9, 9, 9, 9, 1, 1, 1, 1, 1, 1, 1, 1 +}; + +/** Character encode type table: escape unicode, escape '/'. + (generate with misc/make_tables.c) */ +static const char_enc_type enc_table_esc_slash[256] = { + 3, 3, 3, 3, 3, 3, 3, 3, 2, 2, 2, 3, 2, 2, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, + 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, + 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, + 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, 7, + 9, 9, 9, 9, 9, 9, 9, 9, 1, 1, 1, 1, 1, 1, 1, 1 +}; + +/** Escaped hex character table: ["00" "01" "02" ... "FD" "FE" "FF"]. + (generate with misc/make_tables.c) */ +yyjson_align(2) +static const u8 esc_hex_char_table[512] = { + '0', '0', '0', '1', '0', '2', '0', '3', + '0', '4', '0', '5', '0', '6', '0', '7', + '0', '8', '0', '9', '0', 'A', '0', 'B', + '0', 'C', '0', 'D', '0', 'E', '0', 'F', + '1', '0', '1', '1', '1', '2', '1', '3', + '1', '4', '1', '5', '1', '6', '1', '7', + '1', '8', '1', '9', '1', 'A', '1', 'B', + '1', 'C', '1', 'D', '1', 'E', '1', 'F', + '2', '0', '2', '1', '2', '2', '2', '3', + '2', '4', '2', '5', '2', '6', '2', '7', + '2', '8', '2', '9', '2', 'A', '2', 'B', + '2', 'C', '2', 'D', '2', 'E', '2', 'F', + '3', '0', '3', '1', '3', '2', '3', '3', + '3', '4', '3', '5', '3', '6', '3', '7', + '3', '8', '3', '9', '3', 'A', '3', 'B', + '3', 'C', '3', 'D', '3', 'E', '3', 'F', + '4', '0', '4', '1', '4', '2', '4', '3', + '4', '4', '4', '5', '4', '6', '4', '7', + '4', '8', '4', '9', '4', 'A', '4', 'B', + '4', 'C', '4', 'D', '4', 'E', '4', 'F', + '5', '0', '5', '1', '5', '2', '5', '3', + '5', '4', '5', '5', '5', '6', '5', '7', + '5', '8', '5', '9', '5', 'A', '5', 'B', + '5', 'C', '5', 'D', '5', 'E', '5', 'F', + '6', '0', '6', '1', '6', '2', '6', '3', + '6', '4', '6', '5', '6', '6', '6', '7', + '6', '8', '6', '9', '6', 'A', '6', 'B', + '6', 'C', '6', 'D', '6', 'E', '6', 'F', + '7', '0', '7', '1', '7', '2', '7', '3', + '7', '4', '7', '5', '7', '6', '7', '7', + '7', '8', '7', '9', '7', 'A', '7', 'B', + '7', 'C', '7', 'D', '7', 'E', '7', 'F', + '8', '0', '8', '1', '8', '2', '8', '3', + '8', '4', '8', '5', '8', '6', '8', '7', + '8', '8', '8', '9', '8', 'A', '8', 'B', + '8', 'C', '8', 'D', '8', 'E', '8', 'F', + '9', '0', '9', '1', '9', '2', '9', '3', + '9', '4', '9', '5', '9', '6', '9', '7', + '9', '8', '9', '9', '9', 'A', '9', 'B', + '9', 'C', '9', 'D', '9', 'E', '9', 'F', + 'A', '0', 'A', '1', 'A', '2', 'A', '3', + 'A', '4', 'A', '5', 'A', '6', 'A', '7', + 'A', '8', 'A', '9', 'A', 'A', 'A', 'B', + 'A', 'C', 'A', 'D', 'A', 'E', 'A', 'F', + 'B', '0', 'B', '1', 'B', '2', 'B', '3', + 'B', '4', 'B', '5', 'B', '6', 'B', '7', + 'B', '8', 'B', '9', 'B', 'A', 'B', 'B', + 'B', 'C', 'B', 'D', 'B', 'E', 'B', 'F', + 'C', '0', 'C', '1', 'C', '2', 'C', '3', + 'C', '4', 'C', '5', 'C', '6', 'C', '7', + 'C', '8', 'C', '9', 'C', 'A', 'C', 'B', + 'C', 'C', 'C', 'D', 'C', 'E', 'C', 'F', + 'D', '0', 'D', '1', 'D', '2', 'D', '3', + 'D', '4', 'D', '5', 'D', '6', 'D', '7', + 'D', '8', 'D', '9', 'D', 'A', 'D', 'B', + 'D', 'C', 'D', 'D', 'D', 'E', 'D', 'F', + 'E', '0', 'E', '1', 'E', '2', 'E', '3', + 'E', '4', 'E', '5', 'E', '6', 'E', '7', + 'E', '8', 'E', '9', 'E', 'A', 'E', 'B', + 'E', 'C', 'E', 'D', 'E', 'E', 'E', 'F', + 'F', '0', 'F', '1', 'F', '2', 'F', '3', + 'F', '4', 'F', '5', 'F', '6', 'F', '7', + 'F', '8', 'F', '9', 'F', 'A', 'F', 'B', + 'F', 'C', 'F', 'D', 'F', 'E', 'F', 'F' +}; + +/** Escaped single character table. (generate with misc/make_tables.c) */ +yyjson_align(2) +static const u8 esc_single_char_table[512] = { + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + '\\', 'b', '\\', 't', '\\', 'n', ' ', ' ', + '\\', 'f', '\\', 'r', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', '\\', '"', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', '\\', '/', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + '\\', '\\', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', + ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ' +}; + +/** Returns the encode table with options. */ +static_inline const char_enc_type *get_enc_table_with_flag( + yyjson_read_flag flg) { + if (unlikely(flg & YYJSON_WRITE_ESCAPE_UNICODE)) { + if (unlikely(flg & YYJSON_WRITE_ESCAPE_SLASHES)) { + return enc_table_esc_slash; + } else { + return enc_table_esc; + } + } else { + if (unlikely(flg & YYJSON_WRITE_ESCAPE_SLASHES)) { + return enc_table_cpy_slash; + } else { + return enc_table_cpy; + } + } +} + +/** Write raw string. */ +static_inline u8 *write_raw(u8 *cur, const u8 *raw, usize raw_len) { + memcpy(cur, raw, raw_len); + return cur + raw_len; +} + +/** + Write UTF-8 string (requires len * 6 + 2 bytes buffer). + @param cur Buffer cursor. + @param esc Escape unicode. + @param inv Allow invalid unicode. + @param str A UTF-8 string, null-terminator is not required. + @param str_len Length of string in bytes. + @param enc_table Encode type table for character. + @return The buffer cursor after string, or NULL on invalid unicode. + */ +static_inline u8 *write_string(u8 *cur, bool esc, bool inv, + const u8 *str, usize str_len, + const char_enc_type *enc_table) { + + /* UTF-8 character mask and pattern, see `read_string()` for details. */ +#if YYJSON_ENDIAN == YYJSON_BIG_ENDIAN + const u16 b2_mask = 0xE0C0UL; + const u16 b2_patt = 0xC080UL; + const u16 b2_requ = 0x1E00UL; + const u32 b3_mask = 0xF0C0C000UL; + const u32 b3_patt = 0xE0808000UL; + const u32 b3_requ = 0x0F200000UL; + const u32 b3_erro = 0x0D200000UL; + const u32 b4_mask = 0xF8C0C0C0UL; + const u32 b4_patt = 0xF0808080UL; + const u32 b4_requ = 0x07300000UL; + const u32 b4_err0 = 0x04000000UL; + const u32 b4_err1 = 0x03300000UL; +#elif YYJSON_ENDIAN == YYJSON_LITTLE_ENDIAN + const u16 b2_mask = 0xC0E0UL; + const u16 b2_patt = 0x80C0UL; + const u16 b2_requ = 0x001EUL; + const u32 b3_mask = 0x00C0C0F0UL; + const u32 b3_patt = 0x008080E0UL; + const u32 b3_requ = 0x0000200FUL; + const u32 b3_erro = 0x0000200DUL; + const u32 b4_mask = 0xC0C0C0F8UL; + const u32 b4_patt = 0x808080F0UL; + const u32 b4_requ = 0x00003007UL; + const u32 b4_err0 = 0x00000004UL; + const u32 b4_err1 = 0x00003003UL; +#else + v16_uni b2_mask_uni = {{ 0xE0, 0xC0 }}; + v16_uni b2_patt_uni = {{ 0xC0, 0x80 }}; + v16_uni b2_requ_uni = {{ 0x1E, 0x00 }}; + v32_uni b3_mask_uni = {{ 0xF0, 0xC0, 0xC0, 0x00 }}; + v32_uni b3_patt_uni = {{ 0xE0, 0x80, 0x80, 0x00 }}; + v32_uni b3_requ_uni = {{ 0x0F, 0x20, 0x00, 0x00 }}; + v32_uni b3_erro_uni = {{ 0x0D, 0x20, 0x00, 0x00 }}; + v32_uni b4_mask_uni = {{ 0xF8, 0xC0, 0xC0, 0xC0 }}; + v32_uni b4_patt_uni = {{ 0xF0, 0x80, 0x80, 0x80 }}; + v32_uni b4_requ_uni = {{ 0x07, 0x30, 0x00, 0x00 }}; + v32_uni b4_err0_uni = {{ 0x04, 0x00, 0x00, 0x00 }}; + v32_uni b4_err1_uni = {{ 0x03, 0x30, 0x00, 0x00 }}; + u16 b2_mask = b2_mask_uni.u; + u16 b2_patt = b2_patt_uni.u; + u16 b2_requ = b2_requ_uni.u; + u32 b3_mask = b3_mask_uni.u; + u32 b3_patt = b3_patt_uni.u; + u32 b3_requ = b3_requ_uni.u; + u32 b3_erro = b3_erro_uni.u; + u32 b4_mask = b4_mask_uni.u; + u32 b4_patt = b4_patt_uni.u; + u32 b4_requ = b4_requ_uni.u; + u32 b4_err0 = b4_err0_uni.u; + u32 b4_err1 = b4_err1_uni.u; +#endif + +#define is_valid_seq_2(uni) ( \ + ((uni & b2_mask) == b2_patt) && \ + ((uni & b2_requ)) \ +) + +#define is_valid_seq_3(uni) ( \ + ((uni & b3_mask) == b3_patt) && \ + ((tmp = (uni & b3_requ))) && \ + ((tmp != b3_erro)) \ +) + +#define is_valid_seq_4(uni) ( \ + ((uni & b4_mask) == b4_patt) && \ + ((tmp = (uni & b4_requ))) && \ + ((tmp & b4_err0) == 0 || (tmp & b4_err1) == 0) \ +) + + /* The replacement character U+FFFD, used to indicate invalid character. */ + const v32 rep = { 'F', 'F', 'F', 'D' }; + const v32 pre = { '\\', 'u', '0', '0' }; + + const u8 *src = str; + const u8 *end = str + str_len; + *cur++ = '"'; + +copy_ascii: + /* + Copy continuous ASCII, loop unrolling, same as the following code: + + while (end > src) ( + if (unlikely(enc_table[*src])) break; + *cur++ = *src++; + ); + */ +#define expr_jump(i) \ + if (unlikely(enc_table[src[i]])) goto stop_char_##i; + +#define expr_stop(i) \ + stop_char_##i: \ + memcpy(cur, src, i); \ + cur += i; src += i; goto copy_utf8; + + while (end - src >= 16) { + repeat16_incr(expr_jump) + byte_copy_16(cur, src); + cur += 16; src += 16; + } + + while (end - src >= 4) { + repeat4_incr(expr_jump) + byte_copy_4(cur, src); + cur += 4; src += 4; + } + + while (end > src) { + expr_jump(0) + *cur++ = *src++; + } + + *cur++ = '"'; + return cur; + + repeat16_incr(expr_stop) + +#undef expr_jump +#undef expr_stop + +copy_utf8: + if (unlikely(src + 4 > end)) { + if (end == src) goto copy_end; + if (end - src < enc_table[*src] / 2) goto err_one; + } + switch (enc_table[*src]) { + case CHAR_ENC_CPY_1: { + *cur++ = *src++; + goto copy_ascii; + } + case CHAR_ENC_CPY_2: { + u16 v; + v = byte_load_2(src); + if (unlikely(!is_valid_seq_2(v))) goto err_cpy; + + byte_copy_2(cur, src); + cur += 2; + src += 2; + goto copy_utf8; + } + case CHAR_ENC_CPY_3: { + u32 v, tmp; + if (likely(src + 4 <= end)) { + v = byte_load_4(src); + if (unlikely(!is_valid_seq_3(v))) goto err_cpy; + byte_copy_4(cur, src); + } else { + v = byte_load_3(src); + if (unlikely(!is_valid_seq_3(v))) goto err_cpy; + byte_copy_4(cur, &v); + } + cur += 3; + src += 3; + goto copy_utf8; + } + case CHAR_ENC_CPY_4: { + u32 v, tmp; + v = byte_load_4(src); + if (unlikely(!is_valid_seq_4(v))) goto err_cpy; + + byte_copy_4(cur, src); + cur += 4; + src += 4; + goto copy_utf8; + } + case CHAR_ENC_ESC_A: { + byte_move_2(cur, &esc_single_char_table[*src * 2]); + cur += 2; + src += 1; + goto copy_utf8; + } + case CHAR_ENC_ESC_1: { + byte_copy_4(cur + 0, &pre); + byte_copy_2(cur + 4, &esc_hex_char_table[*src * 2]); + cur += 6; + src += 1; + goto copy_utf8; + } + case CHAR_ENC_ESC_2: { + u16 u, v; + v = byte_load_2(src); + if (unlikely(!is_valid_seq_2(v))) goto err_esc; + + u = (u16)(((u16)(src[0] & 0x1F) << 6) | + ((u16)(src[1] & 0x3F) << 0)); + byte_copy_2(cur + 0, &pre); + byte_copy_2(cur + 2, &esc_hex_char_table[(u >> 8) * 2]); + byte_copy_2(cur + 4, &esc_hex_char_table[(u & 0xFF) * 2]); + cur += 6; + src += 2; + goto copy_utf8; + } + case CHAR_ENC_ESC_3: { + u16 u; + u32 v, tmp; + v = byte_load_3(src); + if (unlikely(!is_valid_seq_3(v))) goto err_esc; + + u = (u16)(((u16)(src[0] & 0x0F) << 12) | + ((u16)(src[1] & 0x3F) << 6) | + ((u16)(src[2] & 0x3F) << 0)); + byte_copy_2(cur + 0, &pre); + byte_copy_2(cur + 2, &esc_hex_char_table[(u >> 8) * 2]); + byte_copy_2(cur + 4, &esc_hex_char_table[(u & 0xFF) * 2]); + cur += 6; + src += 3; + goto copy_utf8; + } + case CHAR_ENC_ESC_4: { + u32 hi, lo, u, v, tmp; + v = byte_load_4(src); + if (unlikely(!is_valid_seq_4(v))) goto err_esc; + + u = ((u32)(src[0] & 0x07) << 18) | + ((u32)(src[1] & 0x3F) << 12) | + ((u32)(src[2] & 0x3F) << 6) | + ((u32)(src[3] & 0x3F) << 0); + u -= 0x10000; + hi = (u >> 10) + 0xD800; + lo = (u & 0x3FF) + 0xDC00; + byte_copy_2(cur + 0, &pre); + byte_copy_2(cur + 2, &esc_hex_char_table[(hi >> 8) * 2]); + byte_copy_2(cur + 4, &esc_hex_char_table[(hi & 0xFF) * 2]); + byte_copy_2(cur + 6, &pre); + byte_copy_2(cur + 8, &esc_hex_char_table[(lo >> 8) * 2]); + byte_copy_2(cur + 10, &esc_hex_char_table[(lo & 0xFF) * 2]); + cur += 12; + src += 4; + goto copy_utf8; + } + case CHAR_ENC_ERR_1: { + goto err_one; + } + default: break; + } + +copy_end: + *cur++ = '"'; + return cur; + +err_one: + if (esc) goto err_esc; + else goto err_cpy; + +err_cpy: + if (!inv) return NULL; + *cur++ = *src++; + goto copy_utf8; + +err_esc: + if (!inv) return NULL; + byte_copy_2(cur + 0, &pre); + byte_copy_4(cur + 2, &rep); + cur += 6; + src += 1; + goto copy_utf8; + +#undef is_valid_seq_2 +#undef is_valid_seq_3 +#undef is_valid_seq_4 +} + + + +/*============================================================================== + * Writer Utilities + *============================================================================*/ + +/** Write null (requires 8 bytes buffer). */ +static_inline u8 *write_null(u8 *cur) { + v64 v = { 'n', 'u', 'l', 'l', ',', '\n', 0, 0 }; + byte_copy_8(cur, &v); + return cur + 4; +} + +/** Write bool (requires 8 bytes buffer). */ +static_inline u8 *write_bool(u8 *cur, bool val) { + v64 v0 = { 'f', 'a', 'l', 's', 'e', ',', '\n', 0 }; + v64 v1 = { 't', 'r', 'u', 'e', ',', '\n', 0, 0 }; + if (val) { + byte_copy_8(cur, &v1); + } else { + byte_copy_8(cur, &v0); + } + return cur + 5 - val; +} + +/** Write indent (requires level x 4 bytes buffer). + Param spaces should not larger than 4. */ +static_inline u8 *write_indent(u8 *cur, usize level, usize spaces) { + while (level-- > 0) { + byte_copy_4(cur, " "); + cur += spaces; + } + return cur; +} + +/** Write data to file pointer. */ +static bool write_dat_to_fp(FILE *fp, u8 *dat, usize len, + yyjson_write_err *err) { + if (fwrite(dat, len, 1, fp) != 1) { + err->msg = "file writing failed"; + err->code = YYJSON_WRITE_ERROR_FILE_WRITE; + return false; + } + return true; +} + +/** Write data to file. */ +static bool write_dat_to_file(const char *path, u8 *dat, usize len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + err->msg = _msg; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + if (file) fclose(file); \ + return false; \ +} while (false) + + FILE *file = fopen_writeonly(path); + if (file == NULL) { + return_err(FILE_OPEN, "file opening failed"); + } + if (fwrite(dat, len, 1, file) != 1) { + return_err(FILE_WRITE, "file writing failed"); + } + if (fclose(file) != 0) { + file = NULL; + return_err(FILE_WRITE, "file closing failed"); + } + return true; + +#undef return_err +} + + + +/*============================================================================== + * JSON Writer Implementation + *============================================================================*/ + +typedef struct yyjson_write_ctx { + usize tag; +} yyjson_write_ctx; + +static_inline void yyjson_write_ctx_set(yyjson_write_ctx *ctx, + usize size, bool is_obj) { + ctx->tag = (size << 1) | (usize)is_obj; +} + +static_inline void yyjson_write_ctx_get(yyjson_write_ctx *ctx, + usize *size, bool *is_obj) { + usize tag = ctx->tag; + *size = tag >> 1; + *is_obj = (bool)(tag & 1); +} + +/** Write single JSON value. */ +static_inline u8 *yyjson_write_single(yyjson_val *val, + yyjson_write_flag flg, + yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + if (hdr) alc.free(alc.ctx, (void *)hdr); \ + *dat_len = 0; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + err->msg = _msg; \ + return NULL; \ +} while (false) + +#define incr_len(_len) do { \ + hdr = (u8 *)alc.malloc(alc.ctx, _len); \ + if (!hdr) goto fail_alloc; \ + cur = hdr; \ +} while (false) + +#define check_str_len(_len) do { \ + if ((USIZE_MAX < U64_MAX) && (_len >= (USIZE_MAX - 16) / 6)) \ + goto fail_alloc; \ +} while (false) + + u8 *hdr = NULL, *cur; + usize str_len; + const u8 *str_ptr; + const char_enc_type *enc_table = get_enc_table_with_flag(flg); + bool esc = (flg & YYJSON_WRITE_ESCAPE_UNICODE) != 0; + bool inv = (flg & YYJSON_WRITE_ALLOW_INVALID_UNICODE) != 0; + + switch (unsafe_yyjson_get_type(val)) { + case YYJSON_TYPE_RAW: + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len + 1); + cur = write_raw(cur, str_ptr, str_len); + break; + + case YYJSON_TYPE_STR: + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len * 6 + 4); + cur = write_string(cur, esc, inv, str_ptr, str_len, enc_table); + if (unlikely(!cur)) goto fail_str; + break; + + case YYJSON_TYPE_NUM: + incr_len(32); + cur = write_number(cur, val, flg); + if (unlikely(!cur)) goto fail_num; + break; + + case YYJSON_TYPE_BOOL: + incr_len(8); + cur = write_bool(cur, unsafe_yyjson_get_bool(val)); + break; + + case YYJSON_TYPE_NULL: + incr_len(8); + cur = write_null(cur); + break; + + case YYJSON_TYPE_ARR: + incr_len(4); + byte_copy_2(cur, "[]"); + cur += 2; + break; + + case YYJSON_TYPE_OBJ: + incr_len(4); + byte_copy_2(cur, "{}"); + cur += 2; + break; + + default: + goto fail_type; + } + + *cur = '\0'; + *dat_len = (usize)(cur - hdr); + memset(err, 0, sizeof(yyjson_write_err)); + return hdr; + +fail_alloc: + return_err(MEMORY_ALLOCATION, "memory allocation failed"); +fail_type: + return_err(INVALID_VALUE_TYPE, "invalid JSON value type"); +fail_num: + return_err(NAN_OR_INF, "nan or inf number is not allowed"); +fail_str: + return_err(INVALID_STRING, "invalid utf-8 encoding in string"); + +#undef return_err +#undef check_str_len +#undef incr_len +} + +/** Write JSON document minify. + The root of this document should be a non-empty container. */ +static_inline u8 *yyjson_write_minify(const yyjson_val *root, + const yyjson_write_flag flg, + const yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + *dat_len = 0; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + err->msg = _msg; \ + if (hdr) alc.free(alc.ctx, hdr); \ + return NULL; \ +} while (false) + +#define incr_len(_len) do { \ + ext_len = (usize)(_len); \ + if (unlikely((u8 *)(cur + ext_len) >= (u8 *)ctx)) { \ + alc_inc = yyjson_max(alc_len / 2, ext_len); \ + alc_inc = size_align_up(alc_inc, sizeof(yyjson_write_ctx)); \ + if (size_add_is_overflow(alc_len, alc_inc)) goto fail_alloc; \ + alc_len += alc_inc; \ + tmp = (u8 *)alc.realloc(alc.ctx, hdr, alc_len - alc_inc, alc_len); \ + if (unlikely(!tmp)) goto fail_alloc; \ + ctx_len = (usize)(end - (u8 *)ctx); \ + ctx_tmp = (yyjson_write_ctx *)(void *)(tmp + (alc_len - ctx_len)); \ + memmove((void *)ctx_tmp, (void *)(tmp + ((u8 *)ctx - hdr)), ctx_len); \ + ctx = ctx_tmp; \ + cur = tmp + (cur - hdr); \ + end = tmp + alc_len; \ + hdr = tmp; \ + } \ +} while (false) + +#define check_str_len(_len) do { \ + if ((USIZE_MAX < U64_MAX) && (_len >= (USIZE_MAX - 16) / 6)) \ + goto fail_alloc; \ +} while (false) + + yyjson_val *val; + yyjson_type val_type; + usize ctn_len, ctn_len_tmp; + bool ctn_obj, ctn_obj_tmp, is_key; + u8 *hdr, *cur, *end, *tmp; + yyjson_write_ctx *ctx, *ctx_tmp; + usize alc_len, alc_inc, ctx_len, ext_len, str_len; + const u8 *str_ptr; + const char_enc_type *enc_table = get_enc_table_with_flag(flg); + bool esc = (flg & YYJSON_WRITE_ESCAPE_UNICODE) != 0; + bool inv = (flg & YYJSON_WRITE_ALLOW_INVALID_UNICODE) != 0; + + alc_len = root->uni.ofs / sizeof(yyjson_val); + alc_len = alc_len * YYJSON_WRITER_ESTIMATED_MINIFY_RATIO + 64; + alc_len = size_align_up(alc_len, sizeof(yyjson_write_ctx)); + hdr = (u8 *)alc.malloc(alc.ctx, alc_len); + if (!hdr) goto fail_alloc; + cur = hdr; + end = hdr + alc_len; + ctx = (yyjson_write_ctx *)(void *)end; + +doc_begin: + val = constcast(yyjson_val *)root; + val_type = unsafe_yyjson_get_type(val); + ctn_obj = (val_type == YYJSON_TYPE_OBJ); + ctn_len = unsafe_yyjson_get_len(val) << (u8)ctn_obj; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + val++; + +val_begin: + val_type = unsafe_yyjson_get_type(val); + if (val_type == YYJSON_TYPE_STR) { + is_key = ((u8)ctn_obj & (u8)~ctn_len); + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len * 6 + 16); + cur = write_string(cur, esc, inv, str_ptr, str_len, enc_table); + if (unlikely(!cur)) goto fail_str; + *cur++ = is_key ? ':' : ','; + goto val_end; + } + if (val_type == YYJSON_TYPE_NUM) { + incr_len(32); + cur = write_number(cur, val, flg); + if (unlikely(!cur)) goto fail_num; + *cur++ = ','; + goto val_end; + } + if ((val_type & (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) == + (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) { + ctn_len_tmp = unsafe_yyjson_get_len(val); + ctn_obj_tmp = (val_type == YYJSON_TYPE_OBJ); + incr_len(16); + if (unlikely(ctn_len_tmp == 0)) { + /* write empty container */ + *cur++ = (u8)('[' | ((u8)ctn_obj_tmp << 5)); + *cur++ = (u8)(']' | ((u8)ctn_obj_tmp << 5)); + *cur++ = ','; + goto val_end; + } else { + /* push context, setup new container */ + yyjson_write_ctx_set(--ctx, ctn_len, ctn_obj); + ctn_len = ctn_len_tmp << (u8)ctn_obj_tmp; + ctn_obj = ctn_obj_tmp; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + val++; + goto val_begin; + } + } + if (val_type == YYJSON_TYPE_BOOL) { + incr_len(16); + cur = write_bool(cur, unsafe_yyjson_get_bool(val)); + cur++; + goto val_end; + } + if (val_type == YYJSON_TYPE_NULL) { + incr_len(16); + cur = write_null(cur); + cur++; + goto val_end; + } + if (val_type == YYJSON_TYPE_RAW) { + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len + 2); + cur = write_raw(cur, str_ptr, str_len); + *cur++ = ','; + goto val_end; + } + goto fail_type; + +val_end: + val++; + ctn_len--; + if (unlikely(ctn_len == 0)) goto ctn_end; + goto val_begin; + +ctn_end: + cur--; + *cur++ = (u8)(']' | ((u8)ctn_obj << 5)); + *cur++ = ','; + if (unlikely((u8 *)ctx >= end)) goto doc_end; + yyjson_write_ctx_get(ctx++, &ctn_len, &ctn_obj); + ctn_len--; + if (likely(ctn_len > 0)) { + goto val_begin; + } else { + goto ctn_end; + } + +doc_end: + *--cur = '\0'; + *dat_len = (usize)(cur - hdr); + memset(err, 0, sizeof(yyjson_write_err)); + return hdr; + +fail_alloc: + return_err(MEMORY_ALLOCATION, "memory allocation failed"); +fail_type: + return_err(INVALID_VALUE_TYPE, "invalid JSON value type"); +fail_num: + return_err(NAN_OR_INF, "nan or inf number is not allowed"); +fail_str: + return_err(INVALID_STRING, "invalid utf-8 encoding in string"); + +#undef return_err +#undef incr_len +#undef check_str_len +} + +/** Write JSON document pretty. + The root of this document should be a non-empty container. */ +static_inline u8 *yyjson_write_pretty(const yyjson_val *root, + const yyjson_write_flag flg, + const yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + *dat_len = 0; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + err->msg = _msg; \ + if (hdr) alc.free(alc.ctx, hdr); \ + return NULL; \ +} while (false) + +#define incr_len(_len) do { \ + ext_len = (usize)(_len); \ + if (unlikely((u8 *)(cur + ext_len) >= (u8 *)ctx)) { \ + alc_inc = yyjson_max(alc_len / 2, ext_len); \ + alc_inc = size_align_up(alc_inc, sizeof(yyjson_write_ctx)); \ + if (size_add_is_overflow(alc_len, alc_inc)) goto fail_alloc; \ + alc_len += alc_inc; \ + tmp = (u8 *)alc.realloc(alc.ctx, hdr, alc_len - alc_inc, alc_len); \ + if (unlikely(!tmp)) goto fail_alloc; \ + ctx_len = (usize)(end - (u8 *)ctx); \ + ctx_tmp = (yyjson_write_ctx *)(void *)(tmp + (alc_len - ctx_len)); \ + memmove((void *)ctx_tmp, (void *)(tmp + ((u8 *)ctx - hdr)), ctx_len); \ + ctx = ctx_tmp; \ + cur = tmp + (cur - hdr); \ + end = tmp + alc_len; \ + hdr = tmp; \ + } \ +} while (false) + +#define check_str_len(_len) do { \ + if ((USIZE_MAX < U64_MAX) && (_len >= (USIZE_MAX - 16) / 6)) \ + goto fail_alloc; \ +} while (false) + + yyjson_val *val; + yyjson_type val_type; + usize ctn_len, ctn_len_tmp; + bool ctn_obj, ctn_obj_tmp, is_key, no_indent; + u8 *hdr, *cur, *end, *tmp; + yyjson_write_ctx *ctx, *ctx_tmp; + usize alc_len, alc_inc, ctx_len, ext_len, str_len, level; + const u8 *str_ptr; + const char_enc_type *enc_table = get_enc_table_with_flag(flg); + bool esc = (flg & YYJSON_WRITE_ESCAPE_UNICODE) != 0; + bool inv = (flg & YYJSON_WRITE_ALLOW_INVALID_UNICODE) != 0; + usize spaces = (flg & YYJSON_WRITE_PRETTY_TWO_SPACES) ? 2 : 4; + + alc_len = root->uni.ofs / sizeof(yyjson_val); + alc_len = alc_len * YYJSON_WRITER_ESTIMATED_PRETTY_RATIO + 64; + alc_len = size_align_up(alc_len, sizeof(yyjson_write_ctx)); + hdr = (u8 *)alc.malloc(alc.ctx, alc_len); + if (!hdr) goto fail_alloc; + cur = hdr; + end = hdr + alc_len; + ctx = (yyjson_write_ctx *)(void *)end; + +doc_begin: + val = constcast(yyjson_val *)root; + val_type = unsafe_yyjson_get_type(val); + ctn_obj = (val_type == YYJSON_TYPE_OBJ); + ctn_len = unsafe_yyjson_get_len(val) << (u8)ctn_obj; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + *cur++ = '\n'; + val++; + level = 1; + +val_begin: + val_type = unsafe_yyjson_get_type(val); + if (val_type == YYJSON_TYPE_STR) { + is_key = (bool)((u8)ctn_obj & (u8)~ctn_len); + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len * 6 + 16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_string(cur, esc, inv, str_ptr, str_len, enc_table); + if (unlikely(!cur)) goto fail_str; + *cur++ = is_key ? ':' : ','; + *cur++ = is_key ? ' ' : '\n'; + goto val_end; + } + if (val_type == YYJSON_TYPE_NUM) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(32 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_number(cur, val, flg); + if (unlikely(!cur)) goto fail_num; + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } + if ((val_type & (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) == + (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + ctn_len_tmp = unsafe_yyjson_get_len(val); + ctn_obj_tmp = (val_type == YYJSON_TYPE_OBJ); + if (unlikely(ctn_len_tmp == 0)) { + /* write empty container */ + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + *cur++ = (u8)('[' | ((u8)ctn_obj_tmp << 5)); + *cur++ = (u8)(']' | ((u8)ctn_obj_tmp << 5)); + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } else { + /* push context, setup new container */ + incr_len(32 + (no_indent ? 0 : level * 4)); + yyjson_write_ctx_set(--ctx, ctn_len, ctn_obj); + ctn_len = ctn_len_tmp << (u8)ctn_obj_tmp; + ctn_obj = ctn_obj_tmp; + cur = write_indent(cur, no_indent ? 0 : level, spaces); + level++; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + *cur++ = '\n'; + val++; + goto val_begin; + } + } + if (val_type == YYJSON_TYPE_BOOL) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_bool(cur, unsafe_yyjson_get_bool(val)); + cur += 2; + goto val_end; + } + if (val_type == YYJSON_TYPE_NULL) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_null(cur); + cur += 2; + goto val_end; + } + if (val_type == YYJSON_TYPE_RAW) { + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len + 3); + cur = write_raw(cur, str_ptr, str_len); + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } + goto fail_type; + +val_end: + val++; + ctn_len--; + if (unlikely(ctn_len == 0)) goto ctn_end; + goto val_begin; + +ctn_end: + cur -= 2; + *cur++ = '\n'; + incr_len(level * 4); + cur = write_indent(cur, --level, spaces); + *cur++ = (u8)(']' | ((u8)ctn_obj << 5)); + if (unlikely((u8 *)ctx >= end)) goto doc_end; + yyjson_write_ctx_get(ctx++, &ctn_len, &ctn_obj); + ctn_len--; + *cur++ = ','; + *cur++ = '\n'; + if (likely(ctn_len > 0)) { + goto val_begin; + } else { + goto ctn_end; + } + +doc_end: + *cur = '\0'; + *dat_len = (usize)(cur - hdr); + memset(err, 0, sizeof(yyjson_write_err)); + return hdr; + +fail_alloc: + return_err(MEMORY_ALLOCATION, "memory allocation failed"); +fail_type: + return_err(INVALID_VALUE_TYPE, "invalid JSON value type"); +fail_num: + return_err(NAN_OR_INF, "nan or inf number is not allowed"); +fail_str: + return_err(INVALID_STRING, "invalid utf-8 encoding in string"); + +#undef return_err +#undef incr_len +#undef check_str_len +} + +char *yyjson_val_write_opts(const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + usize *dat_len, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + usize dummy_dat_len; + yyjson_alc alc = alc_ptr ? *alc_ptr : YYJSON_DEFAULT_ALC; + yyjson_val *root = constcast(yyjson_val *)val; + + err = err ? err : &dummy_err; + dat_len = dat_len ? dat_len : &dummy_dat_len; + +#if YYJSON_DISABLE_NON_STANDARD + flg &= ~YYJSON_WRITE_ALLOW_INF_AND_NAN; + flg &= ~YYJSON_WRITE_ALLOW_INVALID_UNICODE; +#endif + + if (unlikely(!root)) { + *dat_len = 0; + err->msg = "input JSON is NULL"; + err->code = YYJSON_READ_ERROR_INVALID_PARAMETER; + return NULL; + } + + if (!unsafe_yyjson_is_ctn(root) || unsafe_yyjson_get_len(root) == 0) { + return (char *)yyjson_write_single(root, flg, alc, dat_len, err); + } else if (flg & (YYJSON_WRITE_PRETTY | YYJSON_WRITE_PRETTY_TWO_SPACES)) { + return (char *)yyjson_write_pretty(root, flg, alc, dat_len, err); + } else { + return (char *)yyjson_write_minify(root, flg, alc, dat_len, err); + } +} + +char *yyjson_write_opts(const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + usize *dat_len, + yyjson_write_err *err) { + yyjson_val *root = doc ? doc->root : NULL; + return yyjson_val_write_opts(root, flg, alc_ptr, dat_len, err); +} + +bool yyjson_val_write_file(const char *path, + const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + u8 *dat; + usize dat_len = 0; + yyjson_val *root = constcast(yyjson_val *)val; + bool suc; + + alc_ptr = alc_ptr ? alc_ptr : &YYJSON_DEFAULT_ALC; + err = err ? err : &dummy_err; + if (unlikely(!path || !*path)) { + err->msg = "input path is invalid"; + err->code = YYJSON_READ_ERROR_INVALID_PARAMETER; + return false; + } + + dat = (u8 *)yyjson_val_write_opts(root, flg, alc_ptr, &dat_len, err); + if (unlikely(!dat)) return false; + suc = write_dat_to_file(path, dat, dat_len, err); + alc_ptr->free(alc_ptr->ctx, dat); + return suc; +} + +bool yyjson_val_write_fp(FILE *fp, + const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + u8 *dat; + usize dat_len = 0; + yyjson_val *root = constcast(yyjson_val *)val; + bool suc; + + alc_ptr = alc_ptr ? alc_ptr : &YYJSON_DEFAULT_ALC; + err = err ? err : &dummy_err; + if (unlikely(!fp)) { + err->msg = "input fp is invalid"; + err->code = YYJSON_READ_ERROR_INVALID_PARAMETER; + return false; + } + + dat = (u8 *)yyjson_val_write_opts(root, flg, alc_ptr, &dat_len, err); + if (unlikely(!dat)) return false; + suc = write_dat_to_fp(fp, dat, dat_len, err); + alc_ptr->free(alc_ptr->ctx, dat); + return suc; +} + +bool yyjson_write_file(const char *path, + const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_val *root = doc ? doc->root : NULL; + return yyjson_val_write_file(path, root, flg, alc_ptr, err); +} + +bool yyjson_write_fp(FILE *fp, + const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_val *root = doc ? doc->root : NULL; + return yyjson_val_write_fp(fp, root, flg, alc_ptr, err); +} + + + +/*============================================================================== + * Mutable JSON Writer Implementation + *============================================================================*/ + +typedef struct yyjson_mut_write_ctx { + usize tag; + yyjson_mut_val *ctn; +} yyjson_mut_write_ctx; + +static_inline void yyjson_mut_write_ctx_set(yyjson_mut_write_ctx *ctx, + yyjson_mut_val *ctn, + usize size, bool is_obj) { + ctx->tag = (size << 1) | (usize)is_obj; + ctx->ctn = ctn; +} + +static_inline void yyjson_mut_write_ctx_get(yyjson_mut_write_ctx *ctx, + yyjson_mut_val **ctn, + usize *size, bool *is_obj) { + usize tag = ctx->tag; + *size = tag >> 1; + *is_obj = (bool)(tag & 1); + *ctn = ctx->ctn; +} + +/** Get the estimated number of values for the mutable JSON document. */ +static_inline usize yyjson_mut_doc_estimated_val_num( + const yyjson_mut_doc *doc) { + usize sum = 0; + yyjson_val_chunk *chunk = doc->val_pool.chunks; + while (chunk) { + sum += chunk->chunk_size / sizeof(yyjson_mut_val) - 1; + if (chunk == doc->val_pool.chunks) { + sum -= (usize)(doc->val_pool.end - doc->val_pool.cur); + } + chunk = chunk->next; + } + return sum; +} + +/** Write single JSON value. */ +static_inline u8 *yyjson_mut_write_single(yyjson_mut_val *val, + yyjson_write_flag flg, + yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + return yyjson_write_single((yyjson_val *)val, flg, alc, dat_len, err); +} + +/** Write JSON document minify. + The root of this document should be a non-empty container. */ +static_inline u8 *yyjson_mut_write_minify(const yyjson_mut_val *root, + usize estimated_val_num, + yyjson_write_flag flg, + yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + *dat_len = 0; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + err->msg = _msg; \ + if (hdr) alc.free(alc.ctx, hdr); \ + return NULL; \ +} while (false) + +#define incr_len(_len) do { \ + ext_len = (usize)(_len); \ + if (unlikely((u8 *)(cur + ext_len) >= (u8 *)ctx)) { \ + alc_inc = yyjson_max(alc_len / 2, ext_len); \ + alc_inc = size_align_up(alc_inc, sizeof(yyjson_mut_write_ctx)); \ + if (size_add_is_overflow(alc_len, alc_inc)) goto fail_alloc; \ + alc_len += alc_inc; \ + tmp = (u8 *)alc.realloc(alc.ctx, hdr, alc_len - alc_inc, alc_len); \ + if (unlikely(!tmp)) goto fail_alloc; \ + ctx_len = (usize)(end - (u8 *)ctx); \ + ctx_tmp = (yyjson_mut_write_ctx *)(void *)(tmp + (alc_len - ctx_len)); \ + memmove((void *)ctx_tmp, (void *)(tmp + ((u8 *)ctx - hdr)), ctx_len); \ + ctx = ctx_tmp; \ + cur = tmp + (cur - hdr); \ + end = tmp + alc_len; \ + hdr = tmp; \ + } \ +} while (false) + +#define check_str_len(_len) do { \ + if ((USIZE_MAX < U64_MAX) && (_len >= (USIZE_MAX - 16) / 6)) \ + goto fail_alloc; \ +} while (false) + + yyjson_mut_val *val, *ctn; + yyjson_type val_type; + usize ctn_len, ctn_len_tmp; + bool ctn_obj, ctn_obj_tmp, is_key; + u8 *hdr, *cur, *end, *tmp; + yyjson_mut_write_ctx *ctx, *ctx_tmp; + usize alc_len, alc_inc, ctx_len, ext_len, str_len; + const u8 *str_ptr; + const char_enc_type *enc_table = get_enc_table_with_flag(flg); + bool esc = (flg & YYJSON_WRITE_ESCAPE_UNICODE) != 0; + bool inv = (flg & YYJSON_WRITE_ALLOW_INVALID_UNICODE) != 0; + + alc_len = estimated_val_num * YYJSON_WRITER_ESTIMATED_MINIFY_RATIO + 64; + alc_len = size_align_up(alc_len, sizeof(yyjson_mut_write_ctx)); + hdr = (u8 *)alc.malloc(alc.ctx, alc_len); + if (!hdr) goto fail_alloc; + cur = hdr; + end = hdr + alc_len; + ctx = (yyjson_mut_write_ctx *)(void *)end; + +doc_begin: + val = constcast(yyjson_mut_val *)root; + val_type = unsafe_yyjson_get_type(val); + ctn_obj = (val_type == YYJSON_TYPE_OBJ); + ctn_len = unsafe_yyjson_get_len(val) << (u8)ctn_obj; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + ctn = val; + val = (yyjson_mut_val *)val->uni.ptr; /* tail */ + val = ctn_obj ? val->next->next : val->next; + +val_begin: + val_type = unsafe_yyjson_get_type(val); + if (val_type == YYJSON_TYPE_STR) { + is_key = ((u8)ctn_obj & (u8)~ctn_len); + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len * 6 + 16); + cur = write_string(cur, esc, inv, str_ptr, str_len, enc_table); + if (unlikely(!cur)) goto fail_str; + *cur++ = is_key ? ':' : ','; + goto val_end; + } + if (val_type == YYJSON_TYPE_NUM) { + incr_len(32); + cur = write_number(cur, (yyjson_val *)val, flg); + if (unlikely(!cur)) goto fail_num; + *cur++ = ','; + goto val_end; + } + if ((val_type & (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) == + (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) { + ctn_len_tmp = unsafe_yyjson_get_len(val); + ctn_obj_tmp = (val_type == YYJSON_TYPE_OBJ); + incr_len(16); + if (unlikely(ctn_len_tmp == 0)) { + /* write empty container */ + *cur++ = (u8)('[' | ((u8)ctn_obj_tmp << 5)); + *cur++ = (u8)(']' | ((u8)ctn_obj_tmp << 5)); + *cur++ = ','; + goto val_end; + } else { + /* push context, setup new container */ + yyjson_mut_write_ctx_set(--ctx, ctn, ctn_len, ctn_obj); + ctn_len = ctn_len_tmp << (u8)ctn_obj_tmp; + ctn_obj = ctn_obj_tmp; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + ctn = val; + val = (yyjson_mut_val *)ctn->uni.ptr; /* tail */ + val = ctn_obj ? val->next->next : val->next; + goto val_begin; + } + } + if (val_type == YYJSON_TYPE_BOOL) { + incr_len(16); + cur = write_bool(cur, unsafe_yyjson_get_bool(val)); + cur++; + goto val_end; + } + if (val_type == YYJSON_TYPE_NULL) { + incr_len(16); + cur = write_null(cur); + cur++; + goto val_end; + } + if (val_type == YYJSON_TYPE_RAW) { + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len + 2); + cur = write_raw(cur, str_ptr, str_len); + *cur++ = ','; + goto val_end; + } + goto fail_type; + +val_end: + ctn_len--; + if (unlikely(ctn_len == 0)) goto ctn_end; + val = val->next; + goto val_begin; + +ctn_end: + cur--; + *cur++ = (u8)(']' | ((u8)ctn_obj << 5)); + *cur++ = ','; + if (unlikely((u8 *)ctx >= end)) goto doc_end; + val = ctn->next; + yyjson_mut_write_ctx_get(ctx++, &ctn, &ctn_len, &ctn_obj); + ctn_len--; + if (likely(ctn_len > 0)) { + goto val_begin; + } else { + goto ctn_end; + } + +doc_end: + *--cur = '\0'; + *dat_len = (usize)(cur - hdr); + err->code = YYJSON_WRITE_SUCCESS; + err->msg = "success"; + return hdr; + +fail_alloc: + return_err(MEMORY_ALLOCATION, "memory allocation failed"); +fail_type: + return_err(INVALID_VALUE_TYPE, "invalid JSON value type"); +fail_num: + return_err(NAN_OR_INF, "nan or inf number is not allowed"); +fail_str: + return_err(INVALID_STRING, "invalid utf-8 encoding in string"); + +#undef return_err +#undef incr_len +#undef check_str_len +} + +/** Write JSON document pretty. + The root of this document should be a non-empty container. */ +static_inline u8 *yyjson_mut_write_pretty(const yyjson_mut_val *root, + usize estimated_val_num, + yyjson_write_flag flg, + yyjson_alc alc, + usize *dat_len, + yyjson_write_err *err) { + +#define return_err(_code, _msg) do { \ + *dat_len = 0; \ + err->code = YYJSON_WRITE_ERROR_##_code; \ + err->msg = _msg; \ + if (hdr) alc.free(alc.ctx, hdr); \ + return NULL; \ +} while (false) + +#define incr_len(_len) do { \ + ext_len = (usize)(_len); \ + if (unlikely((u8 *)(cur + ext_len) >= (u8 *)ctx)) { \ + alc_inc = yyjson_max(alc_len / 2, ext_len); \ + alc_inc = size_align_up(alc_inc, sizeof(yyjson_mut_write_ctx)); \ + if (size_add_is_overflow(alc_len, alc_inc)) goto fail_alloc; \ + alc_len += alc_inc; \ + tmp = (u8 *)alc.realloc(alc.ctx, hdr, alc_len - alc_inc, alc_len); \ + if (unlikely(!tmp)) goto fail_alloc; \ + ctx_len = (usize)(end - (u8 *)ctx); \ + ctx_tmp = (yyjson_mut_write_ctx *)(void *)(tmp + (alc_len - ctx_len)); \ + memmove((void *)ctx_tmp, (void *)(tmp + ((u8 *)ctx - hdr)), ctx_len); \ + ctx = ctx_tmp; \ + cur = tmp + (cur - hdr); \ + end = tmp + alc_len; \ + hdr = tmp; \ + } \ +} while (false) + +#define check_str_len(_len) do { \ + if ((USIZE_MAX < U64_MAX) && (_len >= (USIZE_MAX - 16) / 6)) \ + goto fail_alloc; \ +} while (false) + + yyjson_mut_val *val, *ctn; + yyjson_type val_type; + usize ctn_len, ctn_len_tmp; + bool ctn_obj, ctn_obj_tmp, is_key, no_indent; + u8 *hdr, *cur, *end, *tmp; + yyjson_mut_write_ctx *ctx, *ctx_tmp; + usize alc_len, alc_inc, ctx_len, ext_len, str_len, level; + const u8 *str_ptr; + const char_enc_type *enc_table = get_enc_table_with_flag(flg); + bool esc = (flg & YYJSON_WRITE_ESCAPE_UNICODE) != 0; + bool inv = (flg & YYJSON_WRITE_ALLOW_INVALID_UNICODE) != 0; + usize spaces = (flg & YYJSON_WRITE_PRETTY_TWO_SPACES) ? 2 : 4; + + alc_len = estimated_val_num * YYJSON_WRITER_ESTIMATED_PRETTY_RATIO + 64; + alc_len = size_align_up(alc_len, sizeof(yyjson_mut_write_ctx)); + hdr = (u8 *)alc.malloc(alc.ctx, alc_len); + if (!hdr) goto fail_alloc; + cur = hdr; + end = hdr + alc_len; + ctx = (yyjson_mut_write_ctx *)(void *)end; + +doc_begin: + val = constcast(yyjson_mut_val *)root; + val_type = unsafe_yyjson_get_type(val); + ctn_obj = (val_type == YYJSON_TYPE_OBJ); + ctn_len = unsafe_yyjson_get_len(val) << (u8)ctn_obj; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + *cur++ = '\n'; + ctn = val; + val = (yyjson_mut_val *)val->uni.ptr; /* tail */ + val = ctn_obj ? val->next->next : val->next; + level = 1; + +val_begin: + val_type = unsafe_yyjson_get_type(val); + if (val_type == YYJSON_TYPE_STR) { + is_key = (bool)((u8)ctn_obj & (u8)~ctn_len); + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len * 6 + 16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_string(cur, esc, inv, str_ptr, str_len, enc_table); + if (unlikely(!cur)) goto fail_str; + *cur++ = is_key ? ':' : ','; + *cur++ = is_key ? ' ' : '\n'; + goto val_end; + } + if (val_type == YYJSON_TYPE_NUM) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(32 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_number(cur, (yyjson_val *)val, flg); + if (unlikely(!cur)) goto fail_num; + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } + if ((val_type & (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) == + (YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ)) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + ctn_len_tmp = unsafe_yyjson_get_len(val); + ctn_obj_tmp = (val_type == YYJSON_TYPE_OBJ); + if (unlikely(ctn_len_tmp == 0)) { + /* write empty container */ + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + *cur++ = (u8)('[' | ((u8)ctn_obj_tmp << 5)); + *cur++ = (u8)(']' | ((u8)ctn_obj_tmp << 5)); + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } else { + /* push context, setup new container */ + incr_len(32 + (no_indent ? 0 : level * 4)); + yyjson_mut_write_ctx_set(--ctx, ctn, ctn_len, ctn_obj); + ctn_len = ctn_len_tmp << (u8)ctn_obj_tmp; + ctn_obj = ctn_obj_tmp; + cur = write_indent(cur, no_indent ? 0 : level, spaces); + level++; + *cur++ = (u8)('[' | ((u8)ctn_obj << 5)); + *cur++ = '\n'; + ctn = val; + val = (yyjson_mut_val *)ctn->uni.ptr; /* tail */ + val = ctn_obj ? val->next->next : val->next; + goto val_begin; + } + } + if (val_type == YYJSON_TYPE_BOOL) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_bool(cur, unsafe_yyjson_get_bool(val)); + cur += 2; + goto val_end; + } + if (val_type == YYJSON_TYPE_NULL) { + no_indent = (bool)((u8)ctn_obj & (u8)ctn_len); + incr_len(16 + (no_indent ? 0 : level * 4)); + cur = write_indent(cur, no_indent ? 0 : level, spaces); + cur = write_null(cur); + cur += 2; + goto val_end; + } + if (val_type == YYJSON_TYPE_RAW) { + str_len = unsafe_yyjson_get_len(val); + str_ptr = (const u8 *)unsafe_yyjson_get_str(val); + check_str_len(str_len); + incr_len(str_len + 3); + cur = write_raw(cur, str_ptr, str_len); + *cur++ = ','; + *cur++ = '\n'; + goto val_end; + } + goto fail_type; + +val_end: + ctn_len--; + if (unlikely(ctn_len == 0)) goto ctn_end; + val = val->next; + goto val_begin; + +ctn_end: + cur -= 2; + *cur++ = '\n'; + incr_len(level * 4); + cur = write_indent(cur, --level, spaces); + *cur++ = (u8)(']' | ((u8)ctn_obj << 5)); + if (unlikely((u8 *)ctx >= end)) goto doc_end; + val = ctn->next; + yyjson_mut_write_ctx_get(ctx++, &ctn, &ctn_len, &ctn_obj); + ctn_len--; + *cur++ = ','; + *cur++ = '\n'; + if (likely(ctn_len > 0)) { + goto val_begin; + } else { + goto ctn_end; + } + +doc_end: + *cur = '\0'; + *dat_len = (usize)(cur - hdr); + err->code = YYJSON_WRITE_SUCCESS; + err->msg = "success"; + return hdr; + +fail_alloc: + return_err(MEMORY_ALLOCATION, "memory allocation failed"); +fail_type: + return_err(INVALID_VALUE_TYPE, "invalid JSON value type"); +fail_num: + return_err(NAN_OR_INF, "nan or inf number is not allowed"); +fail_str: + return_err(INVALID_STRING, "invalid utf-8 encoding in string"); + +#undef return_err +#undef incr_len +#undef check_str_len +} + +static char *yyjson_mut_write_opts_impl(const yyjson_mut_val *val, + usize estimated_val_num, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + usize *dat_len, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + usize dummy_dat_len; + yyjson_alc alc = alc_ptr ? *alc_ptr : YYJSON_DEFAULT_ALC; + yyjson_mut_val *root = constcast(yyjson_mut_val *)val; + + err = err ? err : &dummy_err; + dat_len = dat_len ? dat_len : &dummy_dat_len; + +#if YYJSON_DISABLE_NON_STANDARD + flg &= ~YYJSON_WRITE_ALLOW_INF_AND_NAN; + flg &= ~YYJSON_WRITE_ALLOW_INVALID_UNICODE; +#endif + + if (unlikely(!root)) { + *dat_len = 0; + err->msg = "input JSON is NULL"; + err->code = YYJSON_WRITE_ERROR_INVALID_PARAMETER; + return NULL; + } + + if (!unsafe_yyjson_is_ctn(root) || unsafe_yyjson_get_len(root) == 0) { + return (char *)yyjson_mut_write_single(root, flg, alc, dat_len, err); + } else if (flg & (YYJSON_WRITE_PRETTY | YYJSON_WRITE_PRETTY_TWO_SPACES)) { + return (char *)yyjson_mut_write_pretty(root, estimated_val_num, + flg, alc, dat_len, err); + } else { + return (char *)yyjson_mut_write_minify(root, estimated_val_num, + flg, alc, dat_len, err); + } +} + +char *yyjson_mut_val_write_opts(const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + usize *dat_len, + yyjson_write_err *err) { + return yyjson_mut_write_opts_impl(val, 0, flg, alc_ptr, dat_len, err); +} + +char *yyjson_mut_write_opts(const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + usize *dat_len, + yyjson_write_err *err) { + yyjson_mut_val *root; + usize estimated_val_num; + if (likely(doc)) { + root = doc->root; + estimated_val_num = yyjson_mut_doc_estimated_val_num(doc); + } else { + root = NULL; + estimated_val_num = 0; + } + return yyjson_mut_write_opts_impl(root, estimated_val_num, + flg, alc_ptr, dat_len, err); +} + +bool yyjson_mut_val_write_file(const char *path, + const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + u8 *dat; + usize dat_len = 0; + yyjson_mut_val *root = constcast(yyjson_mut_val *)val; + bool suc; + + alc_ptr = alc_ptr ? alc_ptr : &YYJSON_DEFAULT_ALC; + err = err ? err : &dummy_err; + if (unlikely(!path || !*path)) { + err->msg = "input path is invalid"; + err->code = YYJSON_WRITE_ERROR_INVALID_PARAMETER; + return false; + } + + dat = (u8 *)yyjson_mut_val_write_opts(root, flg, alc_ptr, &dat_len, err); + if (unlikely(!dat)) return false; + suc = write_dat_to_file(path, dat, dat_len, err); + alc_ptr->free(alc_ptr->ctx, dat); + return suc; +} + +bool yyjson_mut_val_write_fp(FILE *fp, + const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_write_err dummy_err; + u8 *dat; + usize dat_len = 0; + yyjson_mut_val *root = constcast(yyjson_mut_val *)val; + bool suc; + + alc_ptr = alc_ptr ? alc_ptr : &YYJSON_DEFAULT_ALC; + err = err ? err : &dummy_err; + if (unlikely(!fp)) { + err->msg = "input fp is invalid"; + err->code = YYJSON_WRITE_ERROR_INVALID_PARAMETER; + return false; + } + + dat = (u8 *)yyjson_mut_val_write_opts(root, flg, alc_ptr, &dat_len, err); + if (unlikely(!dat)) return false; + suc = write_dat_to_fp(fp, dat, dat_len, err); + alc_ptr->free(alc_ptr->ctx, dat); + return suc; +} + +bool yyjson_mut_write_file(const char *path, + const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_mut_val *root = doc ? doc->root : NULL; + return yyjson_mut_val_write_file(path, root, flg, alc_ptr, err); +} + +bool yyjson_mut_write_fp(FILE *fp, + const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc_ptr, + yyjson_write_err *err) { + yyjson_mut_val *root = doc ? doc->root : NULL; + return yyjson_mut_val_write_fp(fp, root, flg, alc_ptr, err); +} + +#endif /* YYJSON_DISABLE_WRITER */ + + + +/*============================================================================== + * Compiler Hint End + *============================================================================*/ + +#if defined(__clang__) +# pragma clang diagnostic pop +#elif defined(__GNUC__) +# if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) +# pragma GCC diagnostic pop +# endif +#elif defined(_MSC_VER) +# pragma warning(pop) +#endif /* warning suppress end */ diff --git a/Lib/MJson/yyjson.h b/Lib/MJson/yyjson.h new file mode 100644 index 0000000..7b3a5b7 --- /dev/null +++ b/Lib/MJson/yyjson.h @@ -0,0 +1,7690 @@ +/*============================================================================== + * Created by Yaoyuan on 2019/3/9. + * Copyright (C) 2019 Yaoyuan . + * + * Released under the MIT License: + * https://github.com/ibireme/yyjson/blob/master/LICENSE + *============================================================================*/ + +/** @file yyjson.h */ + +#ifndef YYJSON_H +#define YYJSON_H + + + +/*============================================================================== + * Header Files + *============================================================================*/ + +#include +#include +#include +#include +#include +#include + + + +/*============================================================================== + * Compile-time Options + *============================================================================*/ + +/* + Define as 1 to disable JSON reader if JSON parsing is not required. + + This will disable these functions at compile-time: + - yyjson_read_opts() + - yyjson_read_file() + - yyjson_read() + - yyjson_read_number() + - yyjson_mut_read_number() + + This will reduce the binary size by about 60%. + */ +#ifndef YYJSON_DISABLE_READER +#endif + +/* + Define as 1 to disable JSON writer if JSON serialization is not required. + + This will disable these functions at compile-time: + - yyjson_write() + - yyjson_write_file() + - yyjson_write_opts() + - yyjson_val_write() + - yyjson_val_write_file() + - yyjson_val_write_opts() + - yyjson_mut_write() + - yyjson_mut_write_file() + - yyjson_mut_write_opts() + - yyjson_mut_val_write() + - yyjson_mut_val_write_file() + - yyjson_mut_val_write_opts() + + This will reduce the binary size by about 30%. + */ +#ifndef YYJSON_DISABLE_WRITER +#endif + +/* + Define as 1 to disable JSON Pointer, JSON Patch and JSON Merge Patch supports. + + This will disable these functions at compile-time: + - yyjson_ptr_xxx() + - yyjson_mut_ptr_xxx() + - yyjson_doc_ptr_xxx() + - yyjson_mut_doc_ptr_xxx() + - yyjson_patch() + - yyjson_mut_patch() + - yyjson_merge_patch() + - yyjson_mut_merge_patch() + */ +#ifndef YYJSON_DISABLE_UTILS +#endif + +/* + Define as 1 to disable the fast floating-point number conversion in yyjson, + and use libc's `strtod/snprintf` instead. + + This will reduce the binary size by about 30%, but significantly slow down the + floating-point read/write speed. + */ +#ifndef YYJSON_DISABLE_FAST_FP_CONV +#endif + +/* + Define as 1 to disable non-standard JSON support at compile-time: + - Reading and writing inf/nan literal, such as `NaN`, `-Infinity`. + - Single line and multiple line comments. + - Single trailing comma at the end of an object or array. + - Invalid unicode in string value. + + This will also invalidate these run-time options: + - YYJSON_READ_ALLOW_INF_AND_NAN + - YYJSON_READ_ALLOW_COMMENTS + - YYJSON_READ_ALLOW_TRAILING_COMMAS + - YYJSON_READ_ALLOW_INVALID_UNICODE + - YYJSON_WRITE_ALLOW_INF_AND_NAN + - YYJSON_WRITE_ALLOW_INVALID_UNICODE + + This will reduce the binary size by about 10%, and slightly improve the JSON + read/write speed. + */ +#ifndef YYJSON_DISABLE_NON_STANDARD +#endif + +/* + Define as 1 to disable unaligned memory access if target architecture does not + support unaligned memory access (such as some embedded processors). + + If this value is not defined, yyjson will perform some automatic detection. + The wrong definition of this option may cause some performance degradation, + but will not cause any run-time errors. + */ +#ifndef YYJSON_DISABLE_UNALIGNED_MEMORY_ACCESS +#endif + +/* Define as 1 to export symbols when building this library as Windows DLL. */ +#ifndef YYJSON_EXPORTS +#endif + +/* Define as 1 to import symbols when using this library as Windows DLL. */ +#ifndef YYJSON_IMPORTS +#endif + +/* Define as 1 to include for compiler which doesn't support C99. */ +#ifndef YYJSON_HAS_STDINT_H +#endif + +/* Define as 1 to include for compiler which doesn't support C99. */ +#ifndef YYJSON_HAS_STDBOOL_H +#endif + + + +/*============================================================================== + * Compiler Macros + *============================================================================*/ + +/** compiler version (MSVC) */ +#ifdef _MSC_VER +# define YYJSON_MSC_VER _MSC_VER +#else +# define YYJSON_MSC_VER 0 +#endif + +/** compiler version (GCC) */ +#ifdef __GNUC__ +# define YYJSON_GCC_VER __GNUC__ +#else +# define YYJSON_GCC_VER 0 +#endif + +/** C version (STDC) */ +#if defined(__STDC__) && (__STDC__ >= 1) && defined(__STDC_VERSION__) +# define YYJSON_STDC_VER __STDC_VERSION__ +#else +# define YYJSON_STDC_VER 0 +#endif + +/** C++ version */ +#if defined(__cplusplus) +# define YYJSON_CPP_VER __cplusplus +#else +# define YYJSON_CPP_VER 0 +#endif + +/** compiler builtin check (since gcc 10.0, clang 2.6, icc 2021) */ +#ifndef yyjson_has_builtin +# ifdef __has_builtin +# define yyjson_has_builtin(x) __has_builtin(x) +# else +# define yyjson_has_builtin(x) 0 +# endif +#endif + +/** compiler attribute check (since gcc 5.0, clang 2.9, icc 17) */ +#ifndef yyjson_has_attribute +# ifdef __has_attribute +# define yyjson_has_attribute(x) __has_attribute(x) +# else +# define yyjson_has_attribute(x) 0 +# endif +#endif + +/** compiler feature check (since clang 2.6, icc 17) */ +#ifndef yyjson_has_feature +# ifdef __has_feature +# define yyjson_has_feature(x) __has_feature(x) +# else +# define yyjson_has_feature(x) 0 +# endif +#endif + +/** include check (since gcc 5.0, clang 2.7, icc 16, msvc 2017 15.3) */ +#ifndef yyjson_has_include +# ifdef __has_include +# define yyjson_has_include(x) __has_include(x) +# else +# define yyjson_has_include(x) 0 +# endif +#endif + +/** inline for compiler */ +#ifndef yyjson_inline +# if YYJSON_MSC_VER >= 1200 +# define yyjson_inline __forceinline +# elif defined(_MSC_VER) +# define yyjson_inline __inline +# elif yyjson_has_attribute(always_inline) || YYJSON_GCC_VER >= 4 +# define yyjson_inline __inline__ __attribute__((always_inline)) +# elif defined(__clang__) || defined(__GNUC__) +# define yyjson_inline __inline__ +# elif defined(__cplusplus) || YYJSON_STDC_VER >= 199901L +# define yyjson_inline inline +# else +# define yyjson_inline +# endif +#endif + +/** noinline for compiler */ +#ifndef yyjson_noinline +# if YYJSON_MSC_VER >= 1400 +# define yyjson_noinline __declspec(noinline) +# elif yyjson_has_attribute(noinline) || YYJSON_GCC_VER >= 4 +# define yyjson_noinline __attribute__((noinline)) +# else +# define yyjson_noinline +# endif +#endif + +/** align for compiler */ +#ifndef yyjson_align +# if YYJSON_MSC_VER >= 1300 +# define yyjson_align(x) __declspec(align(x)) +# elif yyjson_has_attribute(aligned) || defined(__GNUC__) +# define yyjson_align(x) __attribute__((aligned(x))) +# elif YYJSON_CPP_VER >= 201103L +# define yyjson_align(x) alignas(x) +# else +# define yyjson_align(x) +# endif +#endif + +/** likely for compiler */ +#ifndef yyjson_likely +# if yyjson_has_builtin(__builtin_expect) || \ + (YYJSON_GCC_VER >= 4 && YYJSON_GCC_VER != 5) +# define yyjson_likely(expr) __builtin_expect(!!(expr), 1) +# else +# define yyjson_likely(expr) (expr) +# endif +#endif + +/** unlikely for compiler */ +#ifndef yyjson_unlikely +# if yyjson_has_builtin(__builtin_expect) || \ + (YYJSON_GCC_VER >= 4 && YYJSON_GCC_VER != 5) +# define yyjson_unlikely(expr) __builtin_expect(!!(expr), 0) +# else +# define yyjson_unlikely(expr) (expr) +# endif +#endif + +/** deprecate warning */ +#ifndef yyjson_deprecated +# if YYJSON_MSC_VER >= 1400 +# define yyjson_deprecated(msg) __declspec(deprecated(msg)) +# elif yyjson_has_feature(attribute_deprecated_with_message) || \ + (YYJSON_GCC_VER > 4 || (YYJSON_GCC_VER == 4 && __GNUC_MINOR__ >= 5)) +# define yyjson_deprecated(msg) __attribute__((deprecated(msg))) +# elif YYJSON_GCC_VER >= 3 +# define yyjson_deprecated(msg) __attribute__((deprecated)) +# else +# define yyjson_deprecated(msg) +# endif +#endif + +/** function export */ +#ifndef yyjson_api +# if defined(_WIN32) +# if defined(YYJSON_EXPORTS) && YYJSON_EXPORTS +# define yyjson_api __declspec(dllexport) +# elif defined(YYJSON_IMPORTS) && YYJSON_IMPORTS +# define yyjson_api __declspec(dllimport) +# else +# define yyjson_api +# endif +# elif yyjson_has_attribute(visibility) || YYJSON_GCC_VER >= 4 +# define yyjson_api __attribute__((visibility("default"))) +# else +# define yyjson_api +# endif +#endif + +/** inline function export */ +#ifndef yyjson_api_inline +# define yyjson_api_inline static yyjson_inline +#endif + +/** stdint (C89 compatible) */ +#if (defined(YYJSON_HAS_STDINT_H) && YYJSON_HAS_STDINT_H) || \ + YYJSON_MSC_VER >= 1600 || YYJSON_STDC_VER >= 199901L || \ + defined(_STDINT_H) || defined(_STDINT_H_) || \ + defined(__CLANG_STDINT_H) || defined(_STDINT_H_INCLUDED) || \ + yyjson_has_include() +# include +#elif defined(_MSC_VER) +# if _MSC_VER < 1300 + typedef signed char int8_t; + typedef signed short int16_t; + typedef signed int int32_t; + typedef unsigned char uint8_t; + typedef unsigned short uint16_t; + typedef unsigned int uint32_t; + typedef signed __int64 int64_t; + typedef unsigned __int64 uint64_t; +# else + typedef signed __int8 int8_t; + typedef signed __int16 int16_t; + typedef signed __int32 int32_t; + typedef unsigned __int8 uint8_t; + typedef unsigned __int16 uint16_t; + typedef unsigned __int32 uint32_t; + typedef signed __int64 int64_t; + typedef unsigned __int64 uint64_t; +# endif +#else +# if UCHAR_MAX == 0xFFU + typedef signed char int8_t; + typedef unsigned char uint8_t; +# else +# error cannot find 8-bit integer type +# endif +# if USHRT_MAX == 0xFFFFU + typedef unsigned short uint16_t; + typedef signed short int16_t; +# elif UINT_MAX == 0xFFFFU + typedef unsigned int uint16_t; + typedef signed int int16_t; +# else +# error cannot find 16-bit integer type +# endif +# if UINT_MAX == 0xFFFFFFFFUL + typedef unsigned int uint32_t; + typedef signed int int32_t; +# elif ULONG_MAX == 0xFFFFFFFFUL + typedef unsigned long uint32_t; + typedef signed long int32_t; +# elif USHRT_MAX == 0xFFFFFFFFUL + typedef unsigned short uint32_t; + typedef signed short int32_t; +# else +# error cannot find 32-bit integer type +# endif +# if defined(__INT64_TYPE__) && defined(__UINT64_TYPE__) + typedef __INT64_TYPE__ int64_t; + typedef __UINT64_TYPE__ uint64_t; +# elif defined(__GNUC__) || defined(__clang__) +# if !defined(_SYS_TYPES_H) && !defined(__int8_t_defined) + __extension__ typedef long long int64_t; +# endif + __extension__ typedef unsigned long long uint64_t; +# elif defined(_LONG_LONG) || defined(__MWERKS__) || defined(_CRAYC) || \ + defined(__SUNPRO_C) || defined(__SUNPRO_CC) + typedef long long int64_t; + typedef unsigned long long uint64_t; +# elif (defined(__BORLANDC__) && __BORLANDC__ > 0x460) || \ + defined(__WATCOM_INT64__) || defined (__alpha) || defined (__DECC) + typedef __int64 int64_t; + typedef unsigned __int64 uint64_t; +# else +# error cannot find 64-bit integer type +# endif +#endif + +/** stdbool (C89 compatible) */ +#if (defined(YYJSON_HAS_STDBOOL_H) && YYJSON_HAS_STDBOOL_H) || \ + (yyjson_has_include() && !defined(__STRICT_ANSI__)) || \ + YYJSON_MSC_VER >= 1800 || YYJSON_STDC_VER >= 199901L +# include +#elif !defined(__bool_true_false_are_defined) +# define __bool_true_false_are_defined 1 +# if defined(__cplusplus) +# if defined(__GNUC__) && !defined(__STRICT_ANSI__) +# define _Bool bool +# if __cplusplus < 201103L +# define bool bool +# define false false +# define true true +# endif +# endif +# else +# define bool unsigned char +# define true 1 +# define false 0 +# endif +#endif + +/** char bit check */ +#if defined(CHAR_BIT) +# if CHAR_BIT != 8 +# error non 8-bit char is not supported +# endif +#endif + +/** + Microsoft Visual C++ 6.0 doesn't support converting number from u64 to f64: + error C2520: conversion from unsigned __int64 to double not implemented. + */ +#ifndef YYJSON_U64_TO_F64_NO_IMPL +# if (0 < YYJSON_MSC_VER) && (YYJSON_MSC_VER <= 1200) +# define YYJSON_U64_TO_F64_NO_IMPL 1 +# else +# define YYJSON_U64_TO_F64_NO_IMPL 0 +# endif +#endif + + + +/*============================================================================== + * Compile Hint Begin + *============================================================================*/ + +/* extern "C" begin */ +#ifdef __cplusplus +extern "C" { +#endif + +/* warning suppress begin */ +#if defined(__clang__) +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +# pragma clang diagnostic ignored "-Wunused-parameter" +#elif defined(__GNUC__) +# if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) +# pragma GCC diagnostic push +# endif +# pragma GCC diagnostic ignored "-Wunused-function" +# pragma GCC diagnostic ignored "-Wunused-parameter" +#elif defined(_MSC_VER) +# pragma warning(push) +# pragma warning(disable:4800) /* 'int': forcing value to 'true' or 'false' */ +#endif + + + +/*============================================================================== + * Version + *============================================================================*/ + +/** The major version of yyjson. */ +#define YYJSON_VERSION_MAJOR 0 + +/** The minor version of yyjson. */ +#define YYJSON_VERSION_MINOR 7 + +/** The patch version of yyjson. */ +#define YYJSON_VERSION_PATCH 0 + +/** The version of yyjson in hex: `(major << 16) | (minor << 8) | (patch)`. */ +#define YYJSON_VERSION_HEX 0x000700 + +/** The version string of yyjson. */ +#define YYJSON_VERSION_STRING "0.7.0" + +/** The version of yyjson in hex, same as `YYJSON_VERSION_HEX`. */ +yyjson_api uint32_t yyjson_version(void); + + + +/*============================================================================== + * JSON Types + *============================================================================*/ + +/** Type of JSON value (3 bit). */ +typedef uint8_t yyjson_type; +#define YYJSON_TYPE_NONE ((uint8_t)0) /* _____000 */ +#define YYJSON_TYPE_RAW ((uint8_t)1) /* _____001 */ +#define YYJSON_TYPE_NULL ((uint8_t)2) /* _____010 */ +#define YYJSON_TYPE_BOOL ((uint8_t)3) /* _____011 */ +#define YYJSON_TYPE_NUM ((uint8_t)4) /* _____100 */ +#define YYJSON_TYPE_STR ((uint8_t)5) /* _____101 */ +#define YYJSON_TYPE_ARR ((uint8_t)6) /* _____110 */ +#define YYJSON_TYPE_OBJ ((uint8_t)7) /* _____111 */ + +/** Subtype of JSON value (2 bit). */ +typedef uint8_t yyjson_subtype; +#define YYJSON_SUBTYPE_NONE ((uint8_t)(0 << 3)) /* ___00___ */ +#define YYJSON_SUBTYPE_FALSE ((uint8_t)(0 << 3)) /* ___00___ */ +#define YYJSON_SUBTYPE_TRUE ((uint8_t)(1 << 3)) /* ___01___ */ +#define YYJSON_SUBTYPE_UINT ((uint8_t)(0 << 3)) /* ___00___ */ +#define YYJSON_SUBTYPE_SINT ((uint8_t)(1 << 3)) /* ___01___ */ +#define YYJSON_SUBTYPE_REAL ((uint8_t)(2 << 3)) /* ___10___ */ + +/** Mask and bits of JSON value tag. */ +#define YYJSON_TYPE_MASK ((uint8_t)0x07) /* _____111 */ +#define YYJSON_TYPE_BIT ((uint8_t)3) +#define YYJSON_SUBTYPE_MASK ((uint8_t)0x18) /* ___11___ */ +#define YYJSON_SUBTYPE_BIT ((uint8_t)2) +#define YYJSON_RESERVED_MASK ((uint8_t)0xE0) /* 111_____ */ +#define YYJSON_RESERVED_BIT ((uint8_t)3) +#define YYJSON_TAG_MASK ((uint8_t)0xFF) /* 11111111 */ +#define YYJSON_TAG_BIT ((uint8_t)8) + +/** Padding size for JSON reader. */ +#define YYJSON_PADDING_SIZE 4 + + + +/*============================================================================== + * Allocator + *============================================================================*/ + +/** + A memory allocator. + + Typically you don't need to use it, unless you want to customize your own + memory allocator. + */ +typedef struct yyjson_alc { + /** Same as libc's malloc(size), should not be NULL. */ + void *(*malloc)(void *ctx, size_t size); + /** Same as libc's realloc(ptr, size), should not be NULL. */ + void *(*realloc)(void *ctx, void *ptr, size_t old_size, size_t size); + /** Same as libc's free(ptr), should not be NULL. */ + void (*free)(void *ctx, void *ptr); + /** A context for malloc/realloc/free, can be NULL. */ + void *ctx; +} yyjson_alc; + +/** + A pool allocator uses fixed length pre-allocated memory. + + This allocator may be used to avoid malloc/realloc calls. The pre-allocated + memory should be held by the caller. The maximum amount of memory required to + read a JSON can be calculated using the `yyjson_read_max_memory_usage()` + function, but the amount of memory required to write a JSON cannot be directly + calculated. + + This is not a general-purpose allocator. If used to read multiple JSON + documents and only some of them are released, it may cause memory + fragmentation, leading to performance degradation and memory waste. Therefore, + it is recommended to use this allocator only for reading or writing a single + JSON document. + + @param alc The allocator to be initialized. + If this parameter is NULL, the function will fail and return false. + If `buf` or `size` is invalid, this will be set to an empty allocator. + @param buf The buffer memory for this allocator. + If this parameter is NULL, the function will fail and return false. + @param size The size of `buf`, in bytes. + If this parameter is less than 8 words (32/64 bytes on 32/64-bit OS), the + function will fail and return false. + @return true if the `alc` has been successfully initialized. + + @par Example + @code + // parse JSON with stack memory + char buf[1024]; + yyjson_alc alc; + yyjson_alc_pool_init(&alc, buf, 1024); + + const char *json = "{\"name\":\"Helvetica\",\"size\":16}" + yyjson_doc *doc = yyjson_read_opts(json, strlen(json), 0, &alc, NULL); + // the memory of `doc` is on the stack + @endcode + */ +yyjson_api bool yyjson_alc_pool_init(yyjson_alc *alc, void *buf, size_t size); + + + +/*============================================================================== + * JSON Structure + *============================================================================*/ + +/** + An immutable document for reading JSON. + This document holds memory for all its JSON values and strings. When it is no + longer used, the user should call `yyjson_doc_free()` to free its memory. + */ +typedef struct yyjson_doc yyjson_doc; + +/** + An immutable value for reading JSON. + A JSON Value has the same lifetime as its document. The memory is held by its + document and and cannot be freed alone. + */ +typedef struct yyjson_val yyjson_val; + +/** + A mutable document for building JSON. + This document holds memory for all its JSON values and strings. When it is no + longer used, the user should call `yyjson_mut_doc_free()` to free its memory. + */ +typedef struct yyjson_mut_doc yyjson_mut_doc; + +/** + A mutable value for building JSON. + A JSON Value has the same lifetime as its document. The memory is held by its + document and and cannot be freed alone. + */ +typedef struct yyjson_mut_val yyjson_mut_val; + + + +/*============================================================================== + * JSON Reader API + *============================================================================*/ + +/** Run-time options for JSON reader. */ +typedef uint32_t yyjson_read_flag; + +/** Default option (RFC 8259 compliant): + - Read positive integer as uint64_t. + - Read negative integer as int64_t. + - Read floating-point number as double with round-to-nearest mode. + - Read integer which cannot fit in uint64_t or int64_t as double. + - Report error if double number is infinity. + - Report error if string contains invalid UTF-8 character or BOM. + - Report error on trailing commas, comments, inf and nan literals. */ +static const yyjson_read_flag YYJSON_READ_NOFLAG = 0 << 0; + +/** Read the input data in-situ. + This option allows the reader to modify and use input data to store string + values, which can increase reading speed slightly. + The caller should hold the input data before free the document. + The input data must be padded by at least `YYJSON_PADDING_SIZE` bytes. + For example: `[1,2]` should be `[1,2]\0\0\0\0`, input length should be 5. */ +static const yyjson_read_flag YYJSON_READ_INSITU = 1 << 0; + +/** Stop when done instead of issuing an error if there's additional content + after a JSON document. This option may be used to parse small pieces of JSON + in larger data, such as `NDJSON`. */ +static const yyjson_read_flag YYJSON_READ_STOP_WHEN_DONE = 1 << 1; + +/** Allow single trailing comma at the end of an object or array, + such as `[1,2,3,]`, `{"a":1,"b":2,}` (non-standard). */ +static const yyjson_read_flag YYJSON_READ_ALLOW_TRAILING_COMMAS = 1 << 2; + +/** Allow C-style single line and multiple line comments (non-standard). */ +static const yyjson_read_flag YYJSON_READ_ALLOW_COMMENTS = 1 << 3; + +/** Allow inf/nan number and literal, case-insensitive, + such as 1e999, NaN, inf, -Infinity (non-standard). */ +static const yyjson_read_flag YYJSON_READ_ALLOW_INF_AND_NAN = 1 << 4; + +/** Read all numbers as raw strings (value with `YYJSON_TYPE_RAW` type), + inf/nan literal is also read as raw with `ALLOW_INF_AND_NAN` flag. */ +static const yyjson_read_flag YYJSON_READ_NUMBER_AS_RAW = 1 << 5; + +/** Allow reading invalid unicode when parsing string values (non-standard). + Invalid characters will be allowed to appear in the string values, but + invalid escape sequences will still be reported as errors. + This flag does not affect the performance of correctly encoded strings. + + @warning Strings in JSON values may contain incorrect encoding when this + option is used, you need to handle these strings carefully to avoid security + risks. */ +static const yyjson_read_flag YYJSON_READ_ALLOW_INVALID_UNICODE = 1 << 6; + +/** Read big numbers as raw strings. These big numbers include integers that + cannot be represented by `int64_t` and `uint64_t`, and floating-point + numbers that cannot be represented by finite `double`. + The flag will be overridden by `YYJSON_READ_NUMBER_AS_RAW` flag. */ +static const yyjson_read_flag YYJSON_READ_BIGNUM_AS_RAW = 1 << 7; + + + +/** Result code for JSON reader. */ +typedef uint32_t yyjson_read_code; + +/** Success, no error. */ +static const yyjson_read_code YYJSON_READ_SUCCESS = 0; + +/** Invalid parameter, such as NULL input string or 0 input length. */ +static const yyjson_read_code YYJSON_READ_ERROR_INVALID_PARAMETER = 1; + +/** Memory allocation failure occurs. */ +static const yyjson_read_code YYJSON_READ_ERROR_MEMORY_ALLOCATION = 2; + +/** Input JSON string is empty. */ +static const yyjson_read_code YYJSON_READ_ERROR_EMPTY_CONTENT = 3; + +/** Unexpected content after document, such as `[123]abc`. */ +static const yyjson_read_code YYJSON_READ_ERROR_UNEXPECTED_CONTENT = 4; + +/** Unexpected ending, such as `[123`. */ +static const yyjson_read_code YYJSON_READ_ERROR_UNEXPECTED_END = 5; + +/** Unexpected character inside the document, such as `[abc]`. */ +static const yyjson_read_code YYJSON_READ_ERROR_UNEXPECTED_CHARACTER = 6; + +/** Invalid JSON structure, such as `[1,]`. */ +static const yyjson_read_code YYJSON_READ_ERROR_JSON_STRUCTURE = 7; + +/** Invalid comment, such as unclosed multi-line comment. */ +static const yyjson_read_code YYJSON_READ_ERROR_INVALID_COMMENT = 8; + +/** Invalid number, such as `123.e12`, `000`. */ +static const yyjson_read_code YYJSON_READ_ERROR_INVALID_NUMBER = 9; + +/** Invalid string, such as invalid escaped character inside a string. */ +static const yyjson_read_code YYJSON_READ_ERROR_INVALID_STRING = 10; + +/** Invalid JSON literal, such as `truu`. */ +static const yyjson_read_code YYJSON_READ_ERROR_LITERAL = 11; + +/** Failed to open a file. */ +static const yyjson_read_code YYJSON_READ_ERROR_FILE_OPEN = 12; + +/** Failed to read a file. */ +static const yyjson_read_code YYJSON_READ_ERROR_FILE_READ = 13; + +/** Error information for JSON reader. */ +typedef struct yyjson_read_err { + /** Error code, see `yyjson_read_code` for all possible values. */ + yyjson_read_code code; + /** Error message, constant, no need to free (NULL if success). */ + const char *msg; + /** Error byte position for input data (0 if success). */ + size_t pos; +} yyjson_read_err; + + + +/** + Read JSON with options. + + This function is thread-safe when: + 1. The `dat` is not modified by other threads. + 2. The `alc` is thread-safe or NULL. + + @param dat The JSON data (UTF-8 without BOM), null-terminator is not required. + If this parameter is NULL, the function will fail and return NULL. + The `dat` will not be modified without the flag `YYJSON_READ_INSITU`, so you + can pass a `const char *` string and case it to `char *` if you don't use + the `YYJSON_READ_INSITU` flag. + @param len The length of JSON data in bytes. + If this parameter is 0, the function will fail and return NULL. + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON reader. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON document, or NULL if an error occurs. + When it's no longer needed, it should be freed with `yyjson_doc_free()`. + */ +yyjson_api yyjson_doc *yyjson_read_opts(char *dat, + size_t len, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err); + +/** + Read a JSON file. + + This function is thread-safe when: + 1. The file is not modified by other threads. + 2. The `alc` is thread-safe or NULL. + + @param path The JSON file's path. + If this path is NULL or invalid, the function will fail and return NULL. + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON reader. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON document, or NULL if an error occurs. + When it's no longer needed, it should be freed with `yyjson_doc_free()`. + + @warning On 32-bit operating system, files larger than 2GB may fail to read. + */ +yyjson_api yyjson_doc *yyjson_read_file(const char *path, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err); + +/** + Read JSON from a file pointer. + + @param fp The file pointer. + The data will be read from the current position of the FILE to the end. + If this fp is NULL or invalid, the function will fail and return NULL. + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON reader. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON document, or NULL if an error occurs. + When it's no longer needed, it should be freed with `yyjson_doc_free()`. + + @warning On 32-bit operating system, files larger than 2GB may fail to read. + */ +yyjson_api yyjson_doc *yyjson_read_fp(FILE *fp, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err); + +/** + Read a JSON string. + + This function is thread-safe. + + @param dat The JSON data (UTF-8 without BOM), null-terminator is not required. + If this parameter is NULL, the function will fail and return NULL. + @param len The length of JSON data in bytes. + If this parameter is 0, the function will fail and return NULL. + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + @return A new JSON document, or NULL if an error occurs. + When it's no longer needed, it should be freed with `yyjson_doc_free()`. + */ +yyjson_api_inline yyjson_doc *yyjson_read(const char *dat, + size_t len, + yyjson_read_flag flg) { + flg &= ~YYJSON_READ_INSITU; /* const string cannot be modified */ + return yyjson_read_opts((char *)(void *)(size_t)(const void *)dat, + len, flg, NULL, NULL); +} + +/** + Returns the size of maximum memory usage to read a JSON data. + + You may use this value to avoid malloc() or calloc() call inside the reader + to get better performance, or read multiple JSON with one piece of memory. + + @param len The length of JSON data in bytes. + @param flg The JSON read options. + @return The maximum memory size to read this JSON, or 0 if overflow. + + @par Example + @code + // read multiple JSON with same pre-allocated memory + + char *dat1, *dat2, *dat3; // JSON data + size_t len1, len2, len3; // JSON length + size_t max_len = MAX(len1, MAX(len2, len3)); + yyjson_doc *doc; + + // use one allocator for multiple JSON + size_t size = yyjson_read_max_memory_usage(max_len, 0); + void *buf = malloc(size); + yyjson_alc alc; + yyjson_alc_pool_init(&alc, buf, size); + + // no more alloc() or realloc() call during reading + doc = yyjson_read_opts(dat1, len1, 0, &alc, NULL); + yyjson_doc_free(doc); + doc = yyjson_read_opts(dat2, len2, 0, &alc, NULL); + yyjson_doc_free(doc); + doc = yyjson_read_opts(dat3, len3, 0, &alc, NULL); + yyjson_doc_free(doc); + + free(buf); + @endcode + @see yyjson_alc_pool_init() + */ +yyjson_api_inline size_t yyjson_read_max_memory_usage(size_t len, + yyjson_read_flag flg) { + /* + 1. The max value count is (json_size / 2 + 1), + for example: "[1,2,3,4]" size is 9, value count is 5. + 2. Some broken JSON may cost more memory during reading, but fail at end, + for example: "[[[[[[[[". + 3. yyjson use 16 bytes per value, see struct yyjson_val. + 4. yyjson use dynamic memory with a growth factor of 1.5. + + The max memory size is (json_size / 2 * 16 * 1.5 + padding). + */ + size_t mul = (size_t)12 + !(flg & YYJSON_READ_INSITU); + size_t pad = 256; + size_t max = (size_t)(~(size_t)0); + if (flg & YYJSON_READ_STOP_WHEN_DONE) len = len < 256 ? 256 : len; + if (len >= (max - pad - mul) / mul) return 0; + return len * mul + pad; +} + +/** + Read a JSON number. + + This function is thread-safe when data is not modified by other threads. + + @param dat The JSON data (UTF-8 without BOM), null-terminator is required. + If this parameter is NULL, the function will fail and return NULL. + @param val The output value where result is stored. + If this parameter is NULL, the function will fail and return NULL. + The value will hold either UINT or SINT or REAL number; + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + Supports `YYJSON_READ_NUMBER_AS_RAW` and `YYJSON_READ_ALLOW_INF_AND_NAN`. + @param alc The memory allocator used for long number. + It is only used when the built-in floating point reader is disabled. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return If successful, a pointer to the character after the last character + used in the conversion, NULL if an error occurs. + */ +yyjson_api const char *yyjson_read_number(const char *dat, + yyjson_val *val, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err); + +/** + Read a JSON number. + + This function is thread-safe when data is not modified by other threads. + + @param dat The JSON data (UTF-8 without BOM), null-terminator is required. + If this parameter is NULL, the function will fail and return NULL. + @param val The output value where result is stored. + If this parameter is NULL, the function will fail and return NULL. + The value will hold either UINT or SINT or REAL number; + @param flg The JSON read options. + Multiple options can be combined with `|` operator. 0 means no options. + Supports `YYJSON_READ_NUMBER_AS_RAW` and `YYJSON_READ_ALLOW_INF_AND_NAN`. + @param alc The memory allocator used for long number. + It is only used when the built-in floating point reader is disabled. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return If successful, a pointer to the character after the last character + used in the conversion, NULL if an error occurs. + */ +yyjson_api_inline const char *yyjson_mut_read_number(const char *dat, + yyjson_mut_val *val, + yyjson_read_flag flg, + const yyjson_alc *alc, + yyjson_read_err *err) { + return yyjson_read_number(dat, (yyjson_val *)val, flg, alc, err); +} + + +/*============================================================================== + * JSON Writer API + *============================================================================*/ + +/** Run-time options for JSON writer. */ +typedef uint32_t yyjson_write_flag; + +/** Default option: + - Write JSON minify. + - Report error on inf or nan number. + - Report error on invalid UTF-8 string. + - Do not escape unicode or slash. */ +static const yyjson_write_flag YYJSON_WRITE_NOFLAG = 0 << 0; + +/** Write JSON pretty with 4 space indent. */ +static const yyjson_write_flag YYJSON_WRITE_PRETTY = 1 << 0; + +/** Escape unicode as `uXXXX`, make the output ASCII only. */ +static const yyjson_write_flag YYJSON_WRITE_ESCAPE_UNICODE = 1 << 1; + +/** Escape '/' as '\/'. */ +static const yyjson_write_flag YYJSON_WRITE_ESCAPE_SLASHES = 1 << 2; + +/** Write inf and nan number as 'Infinity' and 'NaN' literal (non-standard). */ +static const yyjson_write_flag YYJSON_WRITE_ALLOW_INF_AND_NAN = 1 << 3; + +/** Write inf and nan number as null literal. + This flag will override `YYJSON_WRITE_ALLOW_INF_AND_NAN` flag. */ +static const yyjson_write_flag YYJSON_WRITE_INF_AND_NAN_AS_NULL = 1 << 4; + +/** Allow invalid unicode when encoding string values (non-standard). + Invalid characters in string value will be copied byte by byte. + If `YYJSON_WRITE_ESCAPE_UNICODE` flag is also set, invalid character will be + escaped as `U+FFFD` (replacement character). + This flag does not affect the performance of correctly encoded strings. */ +static const yyjson_write_flag YYJSON_WRITE_ALLOW_INVALID_UNICODE = 1 << 5; + +/** Write JSON pretty with 2 space indent. + This flag will override `YYJSON_WRITE_PRETTY` flag. */ +static const yyjson_write_flag YYJSON_WRITE_PRETTY_TWO_SPACES = 1 << 6; + + + +/** Result code for JSON writer */ +typedef uint32_t yyjson_write_code; + +/** Success, no error. */ +static const yyjson_write_code YYJSON_WRITE_SUCCESS = 0; + +/** Invalid parameter, such as NULL document. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_INVALID_PARAMETER = 1; + +/** Memory allocation failure occurs. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_MEMORY_ALLOCATION = 2; + +/** Invalid value type in JSON document. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_INVALID_VALUE_TYPE = 3; + +/** NaN or Infinity number occurs. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_NAN_OR_INF = 4; + +/** Failed to open a file. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_FILE_OPEN = 5; + +/** Failed to write a file. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_FILE_WRITE = 6; + +/** Invalid unicode in string. */ +static const yyjson_write_code YYJSON_WRITE_ERROR_INVALID_STRING = 7; + +/** Error information for JSON writer. */ +typedef struct yyjson_write_err { + /** Error code, see `yyjson_write_code` for all possible values. */ + yyjson_write_code code; + /** Error message, constant, no need to free (NULL if success). */ + const char *msg; +} yyjson_write_err; + + + +/*============================================================================== + * JSON Document Writer API + *============================================================================*/ + +/** + Write a document to JSON string with options. + + This function is thread-safe when: + The `alc` is thread-safe or NULL. + + @param doc The JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free() or alc->free(). + */ +yyjson_api char *yyjson_write_opts(const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + size_t *len, + yyjson_write_err *err); + +/** + Write a document to JSON file with options. + + This function is thread-safe when: + 1. The file is not accessed by other threads. + 2. The `alc` is thread-safe or NULL. + + @param path The JSON file's path. + If this path is NULL or invalid, the function will fail and return false. + If this file is not empty, the content will be discarded. + @param doc The JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_write_file(const char *path, + const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a document to file pointer with options. + + @param fp The file pointer. + The data will be written to the current position of the file. + If this fp is NULL or invalid, the function will fail and return false. + @param doc The JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_write_fp(FILE *fp, + const yyjson_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a document to JSON string. + + This function is thread-safe. + + @param doc The JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free(). + */ +yyjson_api_inline char *yyjson_write(const yyjson_doc *doc, + yyjson_write_flag flg, + size_t *len) { + return yyjson_write_opts(doc, flg, NULL, len, NULL); +} + + + +/** + Write a document to JSON string with options. + + This function is thread-safe when: + 1. The `doc` is not modified by other threads. + 2. The `alc` is thread-safe or NULL. + + @param doc The mutable JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free() or alc->free(). + */ +yyjson_api char *yyjson_mut_write_opts(const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + size_t *len, + yyjson_write_err *err); + +/** + Write a document to JSON file with options. + + This function is thread-safe when: + 1. The file is not accessed by other threads. + 2. The `doc` is not modified by other threads. + 3. The `alc` is thread-safe or NULL. + + @param path The JSON file's path. + If this path is NULL or invalid, the function will fail and return false. + If this file is not empty, the content will be discarded. + @param doc The mutable JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_mut_write_file(const char *path, + const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a document to file pointer with options. + + @param fp The file pointer. + The data will be written to the current position of the file. + If this fp is NULL or invalid, the function will fail and return false. + @param doc The mutable JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_mut_write_fp(FILE *fp, + const yyjson_mut_doc *doc, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a document to JSON string. + + This function is thread-safe when: + The `doc` is not modified by other threads. + + @param doc The JSON document. + If this doc is NULL or has no root, the function will fail and return false. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free(). + */ +yyjson_api_inline char *yyjson_mut_write(const yyjson_mut_doc *doc, + yyjson_write_flag flg, + size_t *len) { + return yyjson_mut_write_opts(doc, flg, NULL, len, NULL); +} + + + +/*============================================================================== + * JSON Value Writer API + *============================================================================*/ + +/** + Write a value to JSON string with options. + + This function is thread-safe when: + The `alc` is thread-safe or NULL. + + @param val The JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free() or alc->free(). + */ +yyjson_api char *yyjson_val_write_opts(const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + size_t *len, + yyjson_write_err *err); + +/** + Write a value to JSON file with options. + + This function is thread-safe when: + 1. The file is not accessed by other threads. + 2. The `alc` is thread-safe or NULL. + + @param path The JSON file's path. + If this path is NULL or invalid, the function will fail and return false. + If this file is not empty, the content will be discarded. + @param val The JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_val_write_file(const char *path, + const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a value to file pointer with options. + + @param fp The file pointer. + The data will be written to the current position of the file. + If this path is NULL or invalid, the function will fail and return false. + @param val The JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_val_write_fp(FILE *fp, + const yyjson_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a value to JSON string. + + This function is thread-safe. + + @param val The JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free(). + */ +yyjson_api_inline char *yyjson_val_write(const yyjson_val *val, + yyjson_write_flag flg, + size_t *len) { + return yyjson_val_write_opts(val, flg, NULL, len, NULL); +} + +/** + Write a value to JSON string with options. + + This function is thread-safe when: + 1. The `val` is not modified by other threads. + 2. The `alc` is thread-safe or NULL. + + @param val The mutable JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free() or alc->free(). + */ +yyjson_api char *yyjson_mut_val_write_opts(const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + size_t *len, + yyjson_write_err *err); + +/** + Write a value to JSON file with options. + + This function is thread-safe when: + 1. The file is not accessed by other threads. + 2. The `val` is not modified by other threads. + 3. The `alc` is thread-safe or NULL. + + @param path The JSON file's path. + If this path is NULL or invalid, the function will fail and return false. + If this file is not empty, the content will be discarded. + @param val The mutable JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_mut_val_write_file(const char *path, + const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a value to JSON file with options. + + @param fp The file pointer. + The data will be written to the current position of the file. + If this path is NULL or invalid, the function will fail and return false. + @param val The mutable JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param alc The memory allocator used by JSON writer. + Pass NULL to use the libc's default allocator. + @param err A pointer to receive error information. + Pass NULL if you don't need error information. + @return true if successful, false if an error occurs. + + @warning On 32-bit operating system, files larger than 2GB may fail to write. + */ +yyjson_api bool yyjson_mut_val_write_fp(FILE *fp, + const yyjson_mut_val *val, + yyjson_write_flag flg, + const yyjson_alc *alc, + yyjson_write_err *err); + +/** + Write a value to JSON string. + + This function is thread-safe when: + The `val` is not modified by other threads. + + @param val The JSON root value. + If this parameter is NULL, the function will fail and return NULL. + @param flg The JSON write options. + Multiple options can be combined with `|` operator. 0 means no options. + @param len A pointer to receive output length in bytes (not including the + null-terminator). Pass NULL if you don't need length information. + @return A new JSON string, or NULL if an error occurs. + This string is encoded as UTF-8 with a null-terminator. + When it's no longer needed, it should be freed with free(). + */ +yyjson_api_inline char *yyjson_mut_val_write(const yyjson_mut_val *val, + yyjson_write_flag flg, + size_t *len) { + return yyjson_mut_val_write_opts(val, flg, NULL, len, NULL); +} + + + +/*============================================================================== + * JSON Document API + *============================================================================*/ + +/** Returns the root value of this JSON document. + Returns NULL if `doc` is NULL. */ +yyjson_api_inline yyjson_val *yyjson_doc_get_root(yyjson_doc *doc); + +/** Returns read size of input JSON data. + Returns 0 if `doc` is NULL. + For example: the read size of `[1,2,3]` is 7 bytes. */ +yyjson_api_inline size_t yyjson_doc_get_read_size(yyjson_doc *doc); + +/** Returns total value count in this JSON document. + Returns 0 if `doc` is NULL. + For example: the value count of `[1,2,3]` is 4. */ +yyjson_api_inline size_t yyjson_doc_get_val_count(yyjson_doc *doc); + +/** Release the JSON document and free the memory. + After calling this function, the `doc` and all values from the `doc` are no + longer available. This function will do nothing if the `doc` is NULL. */ +yyjson_api_inline void yyjson_doc_free(yyjson_doc *doc); + + + +/*============================================================================== + * JSON Value Type API + *============================================================================*/ + +/** Returns whether the JSON value is raw. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_raw(yyjson_val *val); + +/** Returns whether the JSON value is `null`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_null(yyjson_val *val); + +/** Returns whether the JSON value is `true`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_true(yyjson_val *val); + +/** Returns whether the JSON value is `false`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_false(yyjson_val *val); + +/** Returns whether the JSON value is bool (true/false). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_bool(yyjson_val *val); + +/** Returns whether the JSON value is unsigned integer (uint64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_uint(yyjson_val *val); + +/** Returns whether the JSON value is signed integer (int64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_sint(yyjson_val *val); + +/** Returns whether the JSON value is integer (uint64_t/int64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_int(yyjson_val *val); + +/** Returns whether the JSON value is real number (double). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_real(yyjson_val *val); + +/** Returns whether the JSON value is number (uint64_t/int64_t/double). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_num(yyjson_val *val); + +/** Returns whether the JSON value is string. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_str(yyjson_val *val); + +/** Returns whether the JSON value is array. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_arr(yyjson_val *val); + +/** Returns whether the JSON value is object. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_obj(yyjson_val *val); + +/** Returns whether the JSON value is container (array/object). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_is_ctn(yyjson_val *val); + + + +/*============================================================================== + * JSON Value Content API + *============================================================================*/ + +/** Returns the JSON value's type. + Returns YYJSON_TYPE_NONE if `val` is NULL. */ +yyjson_api_inline yyjson_type yyjson_get_type(yyjson_val *val); + +/** Returns the JSON value's subtype. + Returns YYJSON_SUBTYPE_NONE if `val` is NULL. */ +yyjson_api_inline yyjson_subtype yyjson_get_subtype(yyjson_val *val); + +/** Returns the JSON value's tag. + Returns 0 if `val` is NULL. */ +yyjson_api_inline uint8_t yyjson_get_tag(yyjson_val *val); + +/** Returns the JSON value's type description. + The return value should be one of these strings: "raw", "null", "string", + "array", "object", "true", "false", "uint", "sint", "real", "unknown". */ +yyjson_api_inline const char *yyjson_get_type_desc(yyjson_val *val); + +/** Returns the content if the value is raw. + Returns NULL if `val` is NULL or type is not raw. */ +yyjson_api_inline const char *yyjson_get_raw(yyjson_val *val); + +/** Returns the content if the value is bool. + Returns NULL if `val` is NULL or type is not bool. */ +yyjson_api_inline bool yyjson_get_bool(yyjson_val *val); + +/** Returns the content and cast to uint64_t. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline uint64_t yyjson_get_uint(yyjson_val *val); + +/** Returns the content and cast to int64_t. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline int64_t yyjson_get_sint(yyjson_val *val); + +/** Returns the content and cast to int. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline int yyjson_get_int(yyjson_val *val); + +/** Returns the content if the value is real number, or 0.0 on error. + Returns 0.0 if `val` is NULL or type is not real(double). */ +yyjson_api_inline double yyjson_get_real(yyjson_val *val); + +/** Returns the content and typecast to `double` if the value is number. + Returns 0.0 if `val` is NULL or type is not number(uint/sint/real). */ +yyjson_api_inline double yyjson_get_num(yyjson_val *val); + +/** Returns the content if the value is string. + Returns NULL if `val` is NULL or type is not string. */ +yyjson_api_inline const char *yyjson_get_str(yyjson_val *val); + +/** Returns the content length (string length, array size, object size. + Returns 0 if `val` is NULL or type is not string/array/object. */ +yyjson_api_inline size_t yyjson_get_len(yyjson_val *val); + +/** Returns whether the JSON value is equals to a string. + Returns false if input is NULL or type is not string. */ +yyjson_api_inline bool yyjson_equals_str(yyjson_val *val, const char *str); + +/** Returns whether the JSON value is equals to a string. + The `str` should be a UTF-8 string, null-terminator is not required. + Returns false if input is NULL or type is not string. */ +yyjson_api_inline bool yyjson_equals_strn(yyjson_val *val, const char *str, + size_t len); + +/** Returns whether two JSON values are equal (deep compare). + Returns false if input is NULL. + @note the result may be inaccurate if object has duplicate keys. + @warning This function is recursive and may cause a stack overflow + if the object level is too deep. */ +yyjson_api_inline bool yyjson_equals(yyjson_val *lhs, yyjson_val *rhs); + +/** Set the value to raw. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_raw(yyjson_val *val, + const char *raw, size_t len); + +/** Set the value to null. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_null(yyjson_val *val); + +/** Set the value to bool. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_bool(yyjson_val *val, bool num); + +/** Set the value to uint. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_uint(yyjson_val *val, uint64_t num); + +/** Set the value to sint. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_sint(yyjson_val *val, int64_t num); + +/** Set the value to int. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_int(yyjson_val *val, int num); + +/** Set the value to real. + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_real(yyjson_val *val, double num); + +/** Set the value to string (null-terminated). + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_str(yyjson_val *val, const char *str); + +/** Set the value to string (with length). + Returns false if input is NULL or `val` is object or array. + @warning This will modify the `immutable` value, use with caution. */ +yyjson_api_inline bool yyjson_set_strn(yyjson_val *val, + const char *str, size_t len); + + + +/*============================================================================== + * JSON Array API + *============================================================================*/ + +/** Returns the number of elements in this array. + Returns 0 if `arr` is NULL or type is not array. */ +yyjson_api_inline size_t yyjson_arr_size(yyjson_val *arr); + +/** Returns the element at the specified position in this array. + Returns NULL if array is NULL/empty or the index is out of bounds. + @warning This function takes a linear search time if array is not flat. + For example: `[1,{},3]` is flat, `[1,[2],3]` is not flat. */ +yyjson_api_inline yyjson_val *yyjson_arr_get(yyjson_val *arr, size_t idx); + +/** Returns the first element of this array. + Returns NULL if `arr` is NULL/empty or type is not array. */ +yyjson_api_inline yyjson_val *yyjson_arr_get_first(yyjson_val *arr); + +/** Returns the last element of this array. + Returns NULL if `arr` is NULL/empty or type is not array. + @warning This function takes a linear search time if array is not flat. + For example: `[1,{},3]` is flat, `[1,[2],3]` is not flat.*/ +yyjson_api_inline yyjson_val *yyjson_arr_get_last(yyjson_val *arr); + + + +/*============================================================================== + * JSON Array Iterator API + *============================================================================*/ + +/** + A JSON array iterator. + + @par Example + @code + yyjson_val *val; + yyjson_arr_iter iter = yyjson_arr_iter_with(arr); + while ((val = yyjson_arr_iter_next(&iter))) { + your_func(val); + } + @endcode + */ +typedef struct yyjson_arr_iter { + size_t idx; /**< next value's index */ + size_t max; /**< maximum index (arr.size) */ + yyjson_val *cur; /**< next value */ +} yyjson_arr_iter; + +/** + Initialize an iterator for this array. + + @param arr The array to be iterated over. + If this parameter is NULL or not an array, `iter` will be set to empty. + @param iter The iterator to be initialized. + If this parameter is NULL, the function will fail and return false. + @return true if the `iter` has been successfully initialized. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline bool yyjson_arr_iter_init(yyjson_val *arr, + yyjson_arr_iter *iter); + +/** + Create an iterator with an array , same as `yyjson_arr_iter_init()`. + + @param arr The array to be iterated over. + If this parameter is NULL or not an array, an empty iterator will returned. + @return A new iterator for the array. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline yyjson_arr_iter yyjson_arr_iter_with(yyjson_val *arr); + +/** + Returns whether the iteration has more elements. + If `iter` is NULL, this function will return false. + */ +yyjson_api_inline bool yyjson_arr_iter_has_next(yyjson_arr_iter *iter); + +/** + Returns the next element in the iteration, or NULL on end. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_val *yyjson_arr_iter_next(yyjson_arr_iter *iter); + +/** + Macro for iterating over an array. + It works like iterator, but with a more intuitive API. + + @par Example + @code + size_t idx, max; + yyjson_val *val; + yyjson_arr_foreach(arr, idx, max, val) { + your_func(idx, val); + } + @endcode + */ +#define yyjson_arr_foreach(arr, idx, max, val) \ + for ((idx) = 0, \ + (max) = yyjson_arr_size(arr), \ + (val) = yyjson_arr_get_first(arr); \ + (idx) < (max); \ + (idx)++, \ + (val) = unsafe_yyjson_get_next(val)) + + + +/*============================================================================== + * JSON Object API + *============================================================================*/ + +/** Returns the number of key-value pairs in this object. + Returns 0 if `obj` is NULL or type is not object. */ +yyjson_api_inline size_t yyjson_obj_size(yyjson_val *obj); + +/** Returns the value to which the specified key is mapped. + Returns NULL if this object contains no mapping for the key. + Returns NULL if `obj/key` is NULL, or type is not object. + + The `key` should be a null-terminated UTF-8 string. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_val *yyjson_obj_get(yyjson_val *obj, const char *key); + +/** Returns the value to which the specified key is mapped. + Returns NULL if this object contains no mapping for the key. + Returns NULL if `obj/key` is NULL, or type is not object. + + The `key` should be a UTF-8 string, null-terminator is not required. + The `key_len` should be the length of the key, in bytes. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_val *yyjson_obj_getn(yyjson_val *obj, const char *key, + size_t key_len); + + + +/*============================================================================== + * JSON Object Iterator API + *============================================================================*/ + +/** + A JSON object iterator. + + @par Example + @code + yyjson_val *key, *val; + yyjson_obj_iter iter = yyjson_obj_iter_with(obj); + while ((key = yyjson_obj_iter_next(&iter))) { + val = yyjson_obj_iter_get_val(key); + your_func(key, val); + } + @endcode + + If the ordering of the keys is known at compile-time, you can use this method + to speed up value lookups: + @code + // {"k1":1, "k2": 3, "k3": 3} + yyjson_val *key, *val; + yyjson_obj_iter iter = yyjson_obj_iter_with(obj); + yyjson_val *v1 = yyjson_obj_iter_get(&iter, "k1"); + yyjson_val *v3 = yyjson_obj_iter_get(&iter, "k3"); + @endcode + @see yyjson_obj_iter_get() and yyjson_obj_iter_getn() + */ +typedef struct yyjson_obj_iter { + size_t idx; /**< next key's index */ + size_t max; /**< maximum key index (obj.size) */ + yyjson_val *cur; /**< next key */ + yyjson_val *obj; /**< the object being iterated */ +} yyjson_obj_iter; + +/** + Initialize an iterator for this object. + + @param obj The object to be iterated over. + If this parameter is NULL or not an object, `iter` will be set to empty. + @param iter The iterator to be initialized. + If this parameter is NULL, the function will fail and return false. + @return true if the `iter` has been successfully initialized. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline bool yyjson_obj_iter_init(yyjson_val *obj, + yyjson_obj_iter *iter); + +/** + Create an iterator with an object, same as `yyjson_obj_iter_init()`. + + @param obj The object to be iterated over. + If this parameter is NULL or not an object, an empty iterator will returned. + @return A new iterator for the object. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline yyjson_obj_iter yyjson_obj_iter_with(yyjson_val *obj); + +/** + Returns whether the iteration has more elements. + If `iter` is NULL, this function will return false. + */ +yyjson_api_inline bool yyjson_obj_iter_has_next(yyjson_obj_iter *iter); + +/** + Returns the next key in the iteration, or NULL on end. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_val *yyjson_obj_iter_next(yyjson_obj_iter *iter); + +/** + Returns the value for key inside the iteration. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_val *yyjson_obj_iter_get_val(yyjson_val *key); + +/** + Iterates to a specified key and returns the value. + + This function does the same thing as `yyjson_obj_get()`, but is much faster + if the ordering of the keys is known at compile-time and you are using the same + order to look up the values. If the key exists in this object, then the + iterator will stop at the next key, otherwise the iterator will not change and + NULL is returned. + + @param iter The object iterator, should not be NULL. + @param key The key, should be a UTF-8 string with null-terminator. + @return The value to which the specified key is mapped. + NULL if this object contains no mapping for the key or input is invalid. + + @warning This function takes a linear search time if the key is not nearby. + */ +yyjson_api_inline yyjson_val *yyjson_obj_iter_get(yyjson_obj_iter *iter, + const char *key); + +/** + Iterates to a specified key and returns the value. + + This function does the same thing as `yyjson_obj_getn()`, but is much faster + if the ordering of the keys is known at compile-time and you are using the same + order to look up the values. If the key exists in this object, then the + iterator will stop at the next key, otherwise the iterator will not change and + NULL is returned. + + @param iter The object iterator, should not be NULL. + @param key The key, should be a UTF-8 string, null-terminator is not required. + @param key_len The the length of `key`, in bytes. + @return The value to which the specified key is mapped. + NULL if this object contains no mapping for the key or input is invalid. + + @warning This function takes a linear search time if the key is not nearby. + */ +yyjson_api_inline yyjson_val *yyjson_obj_iter_getn(yyjson_obj_iter *iter, + const char *key, + size_t key_len); + +/** + Macro for iterating over an object. + It works like iterator, but with a more intuitive API. + + @par Example + @code + size_t idx, max; + yyjson_val *key, *val; + yyjson_obj_foreach(obj, idx, max, key, val) { + your_func(key, val); + } + @endcode + */ +#define yyjson_obj_foreach(obj, idx, max, key, val) \ + for ((idx) = 0, \ + (max) = yyjson_obj_size(obj), \ + (key) = (obj) ? unsafe_yyjson_get_first(obj) : NULL, \ + (val) = (key) + 1; \ + (idx) < (max); \ + (idx)++, \ + (key) = unsafe_yyjson_get_next(val), \ + (val) = (key) + 1) + + + +/*============================================================================== + * Mutable JSON Document API + *============================================================================*/ + +/** Returns the root value of this JSON document. + Returns NULL if `doc` is NULL. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_get_root(yyjson_mut_doc *doc); + +/** Sets the root value of this JSON document. + Pass NULL to clear root value of the document. */ +yyjson_api_inline void yyjson_mut_doc_set_root(yyjson_mut_doc *doc, + yyjson_mut_val *root); + +/** + Set the string pool size for a mutable document. + This function does not allocate memory immediately, but uses the size when + the next memory allocation is needed. + + If the caller knows the approximate bytes of strings that the document needs to + store (e.g. copy string with `yyjson_mut_strcpy` function), setting a larger + size can avoid multiple memory allocations and improve performance. + + @param doc The mutable document. + @param len The desired string pool size in bytes (total string length). + @return true if successful, false if size is 0 or overflow. + */ +yyjson_api bool yyjson_mut_doc_set_str_pool_size(yyjson_mut_doc *doc, + size_t len); + +/** + Set the value pool size for a mutable document. + This function does not allocate memory immediately, but uses the size when + the next memory allocation is needed. + + If the caller knows the approximate number of values that the document needs to + store (e.g. create new value with `yyjson_mut_xxx` functions), setting a larger + size can avoid multiple memory allocations and improve performance. + + @param doc The mutable document. + @param count The desired value pool size (number of `yyjson_mut_val`). + @return true if successful, false if size is 0 or overflow. + */ +yyjson_api bool yyjson_mut_doc_set_val_pool_size(yyjson_mut_doc *doc, + size_t count); + +/** Release the JSON document and free the memory. + After calling this function, the `doc` and all values from the `doc` are no + longer available. This function will do nothing if the `doc` is NULL. */ +yyjson_api void yyjson_mut_doc_free(yyjson_mut_doc *doc); + +/** Creates and returns a new mutable JSON document, returns NULL on error. + If allocator is NULL, the default allocator will be used. */ +yyjson_api yyjson_mut_doc *yyjson_mut_doc_new(const yyjson_alc *alc); + +/** Copies and returns a new mutable document from input, returns NULL on error. + This makes a `deep-copy` on the immutable document. + If allocator is NULL, the default allocator will be used. + @note `imut_doc` -> `mut_doc`. */ +yyjson_api yyjson_mut_doc *yyjson_doc_mut_copy(yyjson_doc *doc, + const yyjson_alc *alc); + +/** Copies and returns a new mutable document from input, returns NULL on error. + This makes a `deep-copy` on the mutable document. + If allocator is NULL, the default allocator will be used. + @note `mut_doc` -> `mut_doc`. */ +yyjson_api yyjson_mut_doc *yyjson_mut_doc_mut_copy(yyjson_mut_doc *doc, + const yyjson_alc *alc); + +/** Copies and returns a new mutable value from input, returns NULL on error. + This makes a `deep-copy` on the immutable value. + The memory was managed by mutable document. + @note `imut_val` -> `mut_val`. */ +yyjson_api yyjson_mut_val *yyjson_val_mut_copy(yyjson_mut_doc *doc, + yyjson_val *val); + +/** Copies and returns a new mutable value from input, returns NULL on error. + This makes a `deep-copy` on the mutable value. + The memory was managed by mutable document. + @note `mut_val` -> `mut_val`. + @warning This function is recursive and may cause a stack overflow + if the object level is too deep. */ +yyjson_api yyjson_mut_val *yyjson_mut_val_mut_copy(yyjson_mut_doc *doc, + yyjson_mut_val *val); + +/** Copies and returns a new immutable document from input, + returns NULL on error. This makes a `deep-copy` on the mutable document. + The returned document should be freed with `yyjson_doc_free()`. + @note `mut_doc` -> `imut_doc`. + @warning This function is recursive and may cause a stack overflow + if the object level is too deep. */ +yyjson_api yyjson_doc *yyjson_mut_doc_imut_copy(yyjson_mut_doc *doc, + const yyjson_alc *alc); + +/** Copies and returns a new immutable document from input, + returns NULL on error. This makes a `deep-copy` on the mutable value. + The returned document should be freed with `yyjson_doc_free()`. + @note `mut_val` -> `imut_doc`. + @warning This function is recursive and may cause a stack overflow + if the object level is too deep. */ +yyjson_api yyjson_doc *yyjson_mut_val_imut_copy(yyjson_mut_val *val, + const yyjson_alc *alc); + + + +/*============================================================================== + * Mutable JSON Value Type API + *============================================================================*/ + +/** Returns whether the JSON value is raw. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_raw(yyjson_mut_val *val); + +/** Returns whether the JSON value is `null`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_null(yyjson_mut_val *val); + +/** Returns whether the JSON value is `true`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_true(yyjson_mut_val *val); + +/** Returns whether the JSON value is `false`. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_false(yyjson_mut_val *val); + +/** Returns whether the JSON value is bool (true/false). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_bool(yyjson_mut_val *val); + +/** Returns whether the JSON value is unsigned integer (uint64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_uint(yyjson_mut_val *val); + +/** Returns whether the JSON value is signed integer (int64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_sint(yyjson_mut_val *val); + +/** Returns whether the JSON value is integer (uint64_t/int64_t). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_int(yyjson_mut_val *val); + +/** Returns whether the JSON value is real number (double). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_real(yyjson_mut_val *val); + +/** Returns whether the JSON value is number (uint/sint/real). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_num(yyjson_mut_val *val); + +/** Returns whether the JSON value is string. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_str(yyjson_mut_val *val); + +/** Returns whether the JSON value is array. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_arr(yyjson_mut_val *val); + +/** Returns whether the JSON value is object. + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_obj(yyjson_mut_val *val); + +/** Returns whether the JSON value is container (array/object). + Returns false if `val` is NULL. */ +yyjson_api_inline bool yyjson_mut_is_ctn(yyjson_mut_val *val); + + + +/*============================================================================== + * Mutable JSON Value Content API + *============================================================================*/ + +/** Returns the JSON value's type. + Returns `YYJSON_TYPE_NONE` if `val` is NULL. */ +yyjson_api_inline yyjson_type yyjson_mut_get_type(yyjson_mut_val *val); + +/** Returns the JSON value's subtype. + Returns `YYJSON_SUBTYPE_NONE` if `val` is NULL. */ +yyjson_api_inline yyjson_subtype yyjson_mut_get_subtype(yyjson_mut_val *val); + +/** Returns the JSON value's tag. + Returns 0 if `val` is NULL. */ +yyjson_api_inline uint8_t yyjson_mut_get_tag(yyjson_mut_val *val); + +/** Returns the JSON value's type description. + The return value should be one of these strings: "raw", "null", "string", + "array", "object", "true", "false", "uint", "sint", "real", "unknown". */ +yyjson_api_inline const char *yyjson_mut_get_type_desc(yyjson_mut_val *val); + +/** Returns the content if the value is raw. + Returns NULL if `val` is NULL or type is not raw. */ +yyjson_api_inline const char *yyjson_mut_get_raw(yyjson_mut_val *val); + +/** Returns the content if the value is bool. + Returns NULL if `val` is NULL or type is not bool. */ +yyjson_api_inline bool yyjson_mut_get_bool(yyjson_mut_val *val); + +/** Returns the content and cast to uint64_t. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline uint64_t yyjson_mut_get_uint(yyjson_mut_val *val); + +/** Returns the content and cast to int64_t. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline int64_t yyjson_mut_get_sint(yyjson_mut_val *val); + +/** Returns the content and cast to int. + Returns 0 if `val` is NULL or type is not integer(sint/uint). */ +yyjson_api_inline int yyjson_mut_get_int(yyjson_mut_val *val); + +/** Returns the content if the value is real number. + Returns 0.0 if `val` is NULL or type is not real(double). */ +yyjson_api_inline double yyjson_mut_get_real(yyjson_mut_val *val); + +/** Returns the content and typecast to `double` if the value is number. + Returns 0.0 if `val` is NULL or type is not number(uint/sint/real). */ +yyjson_api_inline double yyjson_mut_get_num(yyjson_mut_val *val); + +/** Returns the content if the value is string. + Returns NULL if `val` is NULL or type is not string. */ +yyjson_api_inline const char *yyjson_mut_get_str(yyjson_mut_val *val); + +/** Returns the content length (string length, array size, object size. + Returns 0 if `val` is NULL or type is not string/array/object. */ +yyjson_api_inline size_t yyjson_mut_get_len(yyjson_mut_val *val); + +/** Returns whether the JSON value is equals to a string. + The `str` should be a null-terminated UTF-8 string. + Returns false if input is NULL or type is not string. */ +yyjson_api_inline bool yyjson_mut_equals_str(yyjson_mut_val *val, + const char *str); + +/** Returns whether the JSON value is equals to a string. + The `str` should be a UTF-8 string, null-terminator is not required. + Returns false if input is NULL or type is not string. */ +yyjson_api_inline bool yyjson_mut_equals_strn(yyjson_mut_val *val, + const char *str, size_t len); + +/** Returns whether two JSON values are equal (deep compare). + Returns false if input is NULL. + @note the result may be inaccurate if object has duplicate keys. + @warning This function is recursive and may cause a stack overflow + if the object level is too deep. */ +yyjson_api_inline bool yyjson_mut_equals(yyjson_mut_val *lhs, + yyjson_mut_val *rhs); + +/** Set the value to raw. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_raw(yyjson_mut_val *val, + const char *raw, size_t len); + +/** Set the value to null. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_null(yyjson_mut_val *val); + +/** Set the value to bool. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_bool(yyjson_mut_val *val, bool num); + +/** Set the value to uint. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_uint(yyjson_mut_val *val, uint64_t num); + +/** Set the value to sint. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_sint(yyjson_mut_val *val, int64_t num); + +/** Set the value to int. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_int(yyjson_mut_val *val, int num); + +/** Set the value to real. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_real(yyjson_mut_val *val, double num); + +/** Set the value to string (null-terminated). + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_str(yyjson_mut_val *val, const char *str); + +/** Set the value to string (with length). + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_strn(yyjson_mut_val *val, + const char *str, size_t len); + +/** Set the value to array. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_arr(yyjson_mut_val *val); + +/** Set the value to array. + Returns false if input is NULL. + @warning This function should not be used on an existing object or array. */ +yyjson_api_inline bool yyjson_mut_set_obj(yyjson_mut_val *val); + + + +/*============================================================================== + * Mutable JSON Value Creation API + *============================================================================*/ + +/** Creates and returns a raw value, returns NULL on error. + The `str` should be a null-terminated UTF-8 string. + + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_raw(yyjson_mut_doc *doc, + const char *str); + +/** Creates and returns a raw value, returns NULL on error. + The `str` should be a UTF-8 string, null-terminator is not required. + + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawn(yyjson_mut_doc *doc, + const char *str, + size_t len); + +/** Creates and returns a raw value, returns NULL on error. + The `str` should be a null-terminated UTF-8 string. + The input string is copied and held by the document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawcpy(yyjson_mut_doc *doc, + const char *str); + +/** Creates and returns a raw value, returns NULL on error. + The `str` should be a UTF-8 string, null-terminator is not required. + The input string is copied and held by the document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawncpy(yyjson_mut_doc *doc, + const char *str, + size_t len); + +/** Creates and returns a null value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_null(yyjson_mut_doc *doc); + +/** Creates and returns a true value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_true(yyjson_mut_doc *doc); + +/** Creates and returns a false value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_false(yyjson_mut_doc *doc); + +/** Creates and returns a bool value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_bool(yyjson_mut_doc *doc, + bool val); + +/** Creates and returns an unsigned integer value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_uint(yyjson_mut_doc *doc, + uint64_t num); + +/** Creates and returns a signed integer value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_sint(yyjson_mut_doc *doc, + int64_t num); + +/** Creates and returns a signed integer value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_int(yyjson_mut_doc *doc, + int64_t num); + +/** Creates and returns an real number value, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_real(yyjson_mut_doc *doc, + double num); + +/** Creates and returns a string value, returns NULL on error. + The `str` should be a null-terminated UTF-8 string. + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_str(yyjson_mut_doc *doc, + const char *str); + +/** Creates and returns a string value, returns NULL on error. + The `str` should be a UTF-8 string, null-terminator is not required. + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_strn(yyjson_mut_doc *doc, + const char *str, + size_t len); + +/** Creates and returns a string value, returns NULL on error. + The `str` should be a null-terminated UTF-8 string. + The input string is copied and held by the document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_strcpy(yyjson_mut_doc *doc, + const char *str); + +/** Creates and returns a string value, returns NULL on error. + The `str` should be a UTF-8 string, null-terminator is not required. + The input string is copied and held by the document. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_strncpy(yyjson_mut_doc *doc, + const char *str, + size_t len); + + + +/*============================================================================== + * Mutable JSON Array API + *============================================================================*/ + +/** Returns the number of elements in this array. + Returns 0 if `arr` is NULL or type is not array. */ +yyjson_api_inline size_t yyjson_mut_arr_size(yyjson_mut_val *arr); + +/** Returns the element at the specified position in this array. + Returns NULL if array is NULL/empty or the index is out of bounds. + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get(yyjson_mut_val *arr, + size_t idx); + +/** Returns the first element of this array. + Returns NULL if `arr` is NULL/empty or type is not array. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get_first(yyjson_mut_val *arr); + +/** Returns the last element of this array. + Returns NULL if `arr` is NULL/empty or type is not array. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get_last(yyjson_mut_val *arr); + + + +/*============================================================================== + * Mutable JSON Array Iterator API + *============================================================================*/ + +/** + A mutable JSON array iterator. + + @warning You should not modify the array while iterating over it, but you can + use `yyjson_mut_arr_iter_remove()` to remove current value. + + @par Example + @code + yyjson_mut_val *val; + yyjson_mut_arr_iter iter = yyjson_mut_arr_iter_with(arr); + while ((val = yyjson_mut_arr_iter_next(&iter))) { + your_func(val); + if (your_val_is_unused(val)) { + yyjson_mut_arr_iter_remove(&iter); + } + } + @endcode + */ +typedef struct yyjson_mut_arr_iter { + size_t idx; /**< next value's index */ + size_t max; /**< maximum index (arr.size) */ + yyjson_mut_val *cur; /**< current value */ + yyjson_mut_val *pre; /**< previous value */ + yyjson_mut_val *arr; /**< the array being iterated */ +} yyjson_mut_arr_iter; + +/** + Initialize an iterator for this array. + + @param arr The array to be iterated over. + If this parameter is NULL or not an array, `iter` will be set to empty. + @param iter The iterator to be initialized. + If this parameter is NULL, the function will fail and return false. + @return true if the `iter` has been successfully initialized. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline bool yyjson_mut_arr_iter_init(yyjson_mut_val *arr, + yyjson_mut_arr_iter *iter); + +/** + Create an iterator with an array , same as `yyjson_mut_arr_iter_init()`. + + @param arr The array to be iterated over. + If this parameter is NULL or not an array, an empty iterator will returned. + @return A new iterator for the array. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline yyjson_mut_arr_iter yyjson_mut_arr_iter_with( + yyjson_mut_val *arr); + +/** + Returns whether the iteration has more elements. + If `iter` is NULL, this function will return false. + */ +yyjson_api_inline bool yyjson_mut_arr_iter_has_next( + yyjson_mut_arr_iter *iter); + +/** + Returns the next element in the iteration, or NULL on end. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_iter_next( + yyjson_mut_arr_iter *iter); + +/** + Removes and returns current element in the iteration. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_iter_remove( + yyjson_mut_arr_iter *iter); + +/** + Macro for iterating over an array. + It works like iterator, but with a more intuitive API. + + @warning You should not modify the array while iterating over it. + + @par Example + @code + size_t idx, max; + yyjson_mut_val *val; + yyjson_mut_arr_foreach(arr, idx, max, val) { + your_func(idx, val); + } + @endcode + */ +#define yyjson_mut_arr_foreach(arr, idx, max, val) \ + for ((idx) = 0, \ + (max) = yyjson_mut_arr_size(arr), \ + (val) = yyjson_mut_arr_get_first(arr); \ + (idx) < (max); \ + (idx)++, \ + (val) = (val)->next) + + + +/*============================================================================== + * Mutable JSON Array Creation API + *============================================================================*/ + +/** + Creates and returns an empty mutable array. + @param doc A mutable document, used for memory allocation only. + @return The new array. NULL if input is NULL or memory allocation failed. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr(yyjson_mut_doc *doc); + +/** + Creates and returns a new mutable array with the given boolean values. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of boolean values. + @param count The value count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const bool vals[3] = { true, false, true }; + yyjson_mut_val *arr = yyjson_mut_arr_with_bool(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_bool( + yyjson_mut_doc *doc, const bool *vals, size_t count); + +/** + Creates and returns a new mutable array with the given sint numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of sint numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const int64_t vals[3] = { -1, 0, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_sint64(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint( + yyjson_mut_doc *doc, const int64_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given uint numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of uint numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const uint64_t vals[3] = { 0, 1, 0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_uint(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint( + yyjson_mut_doc *doc, const uint64_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given real numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of real numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const double vals[3] = { 0.1, 0.2, 0.3 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_real(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_real( + yyjson_mut_doc *doc, const double *vals, size_t count); + +/** + Creates and returns a new mutable array with the given int8 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of int8 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const int8_t vals[3] = { -1, 0, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_sint8(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint8( + yyjson_mut_doc *doc, const int8_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given int16 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of int16 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const int16_t vals[3] = { -1, 0, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_sint16(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint16( + yyjson_mut_doc *doc, const int16_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given int32 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of int32 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const int32_t vals[3] = { -1, 0, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_sint32(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint32( + yyjson_mut_doc *doc, const int32_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given int64 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of int64 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const int64_t vals[3] = { -1, 0, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_sint64(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint64( + yyjson_mut_doc *doc, const int64_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given uint8 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of uint8 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const uint8_t vals[3] = { 0, 1, 0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_uint8(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint8( + yyjson_mut_doc *doc, const uint8_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given uint16 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of uint16 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const uint16_t vals[3] = { 0, 1, 0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_uint16(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint16( + yyjson_mut_doc *doc, const uint16_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given uint32 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of uint32 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const uint32_t vals[3] = { 0, 1, 0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_uint32(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint32( + yyjson_mut_doc *doc, const uint32_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given uint64 numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of uint64 numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const uint64_t vals[3] = { 0, 1, 0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_uint64(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint64( + yyjson_mut_doc *doc, const uint64_t *vals, size_t count); + +/** + Creates and returns a new mutable array with the given float numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of float numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const float vals[3] = { -1.0f, 0.0f, 1.0f }; + yyjson_mut_val *arr = yyjson_mut_arr_with_float(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_float( + yyjson_mut_doc *doc, const float *vals, size_t count); + +/** + Creates and returns a new mutable array with the given double numbers. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of double numbers. + @param count The number count. If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const double vals[3] = { -1.0, 0.0, 1.0 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_double(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_double( + yyjson_mut_doc *doc, const double *vals, size_t count); + +/** + Creates and returns a new mutable array with the given strings, these strings + will not be copied. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of UTF-8 null-terminator strings. + If this array contains NULL, the function will fail and return NULL. + @param count The number of values in `vals`. + If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @warning The input strings are not copied, you should keep these strings + unmodified for the lifetime of this JSON document. If these strings will be + modified, you should use `yyjson_mut_arr_with_strcpy()` instead. + + @par Example + @code + const char *vals[3] = { "a", "b", "c" }; + yyjson_mut_val *arr = yyjson_mut_arr_with_str(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_str( + yyjson_mut_doc *doc, const char **vals, size_t count); + +/** + Creates and returns a new mutable array with the given strings and string + lengths, these strings will not be copied. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of UTF-8 strings, null-terminator is not required. + If this array contains NULL, the function will fail and return NULL. + @param lens A C array of string lengths, in bytes. + @param count The number of strings in `vals`. + If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @warning The input strings are not copied, you should keep these strings + unmodified for the lifetime of this JSON document. If these strings will be + modified, you should use `yyjson_mut_arr_with_strncpy()` instead. + + @par Example + @code + const char *vals[3] = { "a", "bb", "c" }; + const size_t lens[3] = { 1, 2, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_strn(doc, vals, lens, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strn( + yyjson_mut_doc *doc, const char **vals, const size_t *lens, size_t count); + +/** + Creates and returns a new mutable array with the given strings, these strings + will be copied. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of UTF-8 null-terminator strings. + If this array contains NULL, the function will fail and return NULL. + @param count The number of values in `vals`. + If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const char *vals[3] = { "a", "b", "c" }; + yyjson_mut_val *arr = yyjson_mut_arr_with_strcpy(doc, vals, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strcpy( + yyjson_mut_doc *doc, const char **vals, size_t count); + +/** + Creates and returns a new mutable array with the given strings and string + lengths, these strings will be copied. + + @param doc A mutable document, used for memory allocation only. + If this parameter is NULL, the function will fail and return NULL. + @param vals A C array of UTF-8 strings, null-terminator is not required. + If this array contains NULL, the function will fail and return NULL. + @param lens A C array of string lengths, in bytes. + @param count The number of strings in `vals`. + If this value is 0, an empty array will return. + @return The new array. NULL if input is invalid or memory allocation failed. + + @par Example + @code + const char *vals[3] = { "a", "bb", "c" }; + const size_t lens[3] = { 1, 2, 1 }; + yyjson_mut_val *arr = yyjson_mut_arr_with_strn(doc, vals, lens, 3); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strncpy( + yyjson_mut_doc *doc, const char **vals, const size_t *lens, size_t count); + + + +/*============================================================================== + * Mutable JSON Array Modification API + *============================================================================*/ + +/** + Inserts a value into an array at a given index. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param val The value to be inserted. Returns false if it is NULL. + @param idx The index to which to insert the new value. + Returns false if the index is out of range. + @return Whether successful. + @warning This function takes a linear search time. + */ +yyjson_api_inline bool yyjson_mut_arr_insert(yyjson_mut_val *arr, + yyjson_mut_val *val, size_t idx); + +/** + Inserts a value at the end of the array. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param val The value to be inserted. Returns false if it is NULL. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_append(yyjson_mut_val *arr, + yyjson_mut_val *val); + +/** + Inserts a value at the head of the array. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param val The value to be inserted. Returns false if it is NULL. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_prepend(yyjson_mut_val *arr, + yyjson_mut_val *val); + +/** + Replaces a value at index and returns old value. + @param arr The array to which the value is to be replaced. + Returns false if it is NULL or not an array. + @param idx The index to which to replace the value. + Returns false if the index is out of range. + @param val The new value to replace. Returns false if it is NULL. + @return Old value, or NULL on error. + @warning This function takes a linear search time. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_replace(yyjson_mut_val *arr, + size_t idx, + yyjson_mut_val *val); + +/** + Removes and returns a value at index. + @param arr The array from which the value is to be removed. + Returns false if it is NULL or not an array. + @param idx The index from which to remove the value. + Returns false if the index is out of range. + @return Old value, or NULL on error. + @warning This function takes a linear search time. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove(yyjson_mut_val *arr, + size_t idx); + +/** + Removes and returns the first value in this array. + @param arr The array from which the value is to be removed. + Returns false if it is NULL or not an array. + @return The first value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove_first( + yyjson_mut_val *arr); + +/** + Removes and returns the last value in this array. + @param arr The array from which the value is to be removed. + Returns false if it is NULL or not an array. + @return The last value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove_last( + yyjson_mut_val *arr); + +/** + Removes all values within a specified range in the array. + @param arr The array from which the value is to be removed. + Returns false if it is NULL or not an array. + @param idx The start index of the range (0 is the first). + @param len The number of items in the range (can be 0). + @return Whether successful. + @warning This function takes a linear search time. + */ +yyjson_api_inline bool yyjson_mut_arr_remove_range(yyjson_mut_val *arr, + size_t idx, size_t len); + +/** + Removes all values in this array. + @param arr The array from which all of the values are to be removed. + Returns false if it is NULL or not an array. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_clear(yyjson_mut_val *arr); + +/** + Rotates values in this array for the given number of times. + For example: `[1,2,3,4,5]` rotate 2 is `[3,4,5,1,2]`. + @param arr The array to be rotated. + @param idx Index (or times) to rotate. + @warning This function takes a linear search time. + */ +yyjson_api_inline bool yyjson_mut_arr_rotate(yyjson_mut_val *arr, + size_t idx); + + + +/*============================================================================== + * Mutable JSON Array Modification Convenience API + *============================================================================*/ + +/** + Adds a value at the end of the array. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param val The value to be inserted. Returns false if it is NULL. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_val(yyjson_mut_val *arr, + yyjson_mut_val *val); + +/** + Adds a `null` value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_null(yyjson_mut_doc *doc, + yyjson_mut_val *arr); + +/** + Adds a `true` value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_true(yyjson_mut_doc *doc, + yyjson_mut_val *arr); + +/** + Adds a `false` value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_false(yyjson_mut_doc *doc, + yyjson_mut_val *arr); + +/** + Adds a bool value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param val The bool value to be added. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_bool(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + bool val); + +/** + Adds an unsigned integer value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param num The number to be added. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_uint(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + uint64_t num); + +/** + Adds a signed integer value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param num The number to be added. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_sint(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + int64_t num); + +/** + Adds a integer value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param num The number to be added. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_int(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + int64_t num); + +/** + Adds a double value at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param num The number to be added. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_real(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + double num); + +/** + Adds a string value at the end of the array (no copy). + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param str A null-terminated UTF-8 string. + @return Whether successful. + @warning The input string is not copied, you should keep this string unmodified + for the lifetime of this JSON document. + */ +yyjson_api_inline bool yyjson_mut_arr_add_str(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str); + +/** + Adds a string value at the end of the array (no copy). + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param str A UTF-8 string, null-terminator is not required. + @param len The length of the string, in bytes. + @return Whether successful. + @warning The input string is not copied, you should keep this string unmodified + for the lifetime of this JSON document. + */ +yyjson_api_inline bool yyjson_mut_arr_add_strn(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str, + size_t len); + +/** + Adds a string value at the end of the array (copied). + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param str A null-terminated UTF-8 string. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_strcpy(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str); + +/** + Adds a string value at the end of the array (copied). + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @param str A UTF-8 string, null-terminator is not required. + @param len The length of the string, in bytes. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_arr_add_strncpy(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str, + size_t len); + +/** + Creates and adds a new array at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @return The new array, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_add_arr(yyjson_mut_doc *doc, + yyjson_mut_val *arr); + +/** + Creates and adds a new object at the end of the array. + @param doc The `doc` is only used for memory allocation. + @param arr The array to which the value is to be inserted. + Returns false if it is NULL or not an array. + @return The new object, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_add_obj(yyjson_mut_doc *doc, + yyjson_mut_val *arr); + + + +/*============================================================================== + * Mutable JSON Object API + *============================================================================*/ + +/** Returns the number of key-value pairs in this object. + Returns 0 if `obj` is NULL or type is not object. */ +yyjson_api_inline size_t yyjson_mut_obj_size(yyjson_mut_val *obj); + +/** Returns the value to which the specified key is mapped. + Returns NULL if this object contains no mapping for the key. + Returns NULL if `obj/key` is NULL, or type is not object. + + The `key` should be a null-terminated UTF-8 string. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_get(yyjson_mut_val *obj, + const char *key); + +/** Returns the value to which the specified key is mapped. + Returns NULL if this object contains no mapping for the key. + Returns NULL if `obj/key` is NULL, or type is not object. + + The `key` should be a UTF-8 string, null-terminator is not required. + The `key_len` should be the length of the key, in bytes. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_getn(yyjson_mut_val *obj, + const char *key, + size_t key_len); + + + +/*============================================================================== + * Mutable JSON Object Iterator API + *============================================================================*/ + +/** + A mutable JSON object iterator. + + @warning You should not modify the object while iterating over it, but you can + use `yyjson_mut_obj_iter_remove()` to remove current value. + + @par Example + @code + yyjson_mut_val *key, *val; + yyjson_mut_obj_iter iter = yyjson_mut_obj_iter_with(obj); + while ((key = yyjson_mut_obj_iter_next(&iter))) { + val = yyjson_mut_obj_iter_get_val(key); + your_func(key, val); + if (your_val_is_unused(key, val)) { + yyjson_mut_obj_iter_remove(&iter); + } + } + @endcode + + If the ordering of the keys is known at compile-time, you can use this method + to speed up value lookups: + @code + // {"k1":1, "k2": 3, "k3": 3} + yyjson_mut_val *key, *val; + yyjson_mut_obj_iter iter = yyjson_mut_obj_iter_with(obj); + yyjson_mut_val *v1 = yyjson_mut_obj_iter_get(&iter, "k1"); + yyjson_mut_val *v3 = yyjson_mut_obj_iter_get(&iter, "k3"); + @endcode + @see `yyjson_mut_obj_iter_get()` and `yyjson_mut_obj_iter_getn()` + */ +typedef struct yyjson_mut_obj_iter { + size_t idx; /**< next key's index */ + size_t max; /**< maximum key index (obj.size) */ + yyjson_mut_val *cur; /**< current key */ + yyjson_mut_val *pre; /**< previous key */ + yyjson_mut_val *obj; /**< the object being iterated */ +} yyjson_mut_obj_iter; + +/** + Initialize an iterator for this object. + + @param obj The object to be iterated over. + If this parameter is NULL or not an array, `iter` will be set to empty. + @param iter The iterator to be initialized. + If this parameter is NULL, the function will fail and return false. + @return true if the `iter` has been successfully initialized. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline bool yyjson_mut_obj_iter_init(yyjson_mut_val *obj, + yyjson_mut_obj_iter *iter); + +/** + Create an iterator with an object, same as `yyjson_obj_iter_init()`. + + @param obj The object to be iterated over. + If this parameter is NULL or not an object, an empty iterator will returned. + @return A new iterator for the object. + + @note The iterator does not need to be destroyed. + */ +yyjson_api_inline yyjson_mut_obj_iter yyjson_mut_obj_iter_with( + yyjson_mut_val *obj); + +/** + Returns whether the iteration has more elements. + If `iter` is NULL, this function will return false. + */ +yyjson_api_inline bool yyjson_mut_obj_iter_has_next( + yyjson_mut_obj_iter *iter); + +/** + Returns the next key in the iteration, or NULL on end. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_next( + yyjson_mut_obj_iter *iter); + +/** + Returns the value for key inside the iteration. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_get_val( + yyjson_mut_val *key); + +/** + Removes current key-value pair in the iteration, returns the removed value. + If `iter` is NULL, this function will return NULL. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_remove( + yyjson_mut_obj_iter *iter); + +/** + Iterates to a specified key and returns the value. + + This function does the same thing as `yyjson_mut_obj_get()`, but is much faster + if the ordering of the keys is known at compile-time and you are using the same + order to look up the values. If the key exists in this object, then the + iterator will stop at the next key, otherwise the iterator will not change and + NULL is returned. + + @param iter The object iterator, should not be NULL. + @param key The key, should be a UTF-8 string with null-terminator. + @return The value to which the specified key is mapped. + NULL if this object contains no mapping for the key or input is invalid. + + @warning This function takes a linear search time if the key is not nearby. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_get( + yyjson_mut_obj_iter *iter, const char *key); + +/** + Iterates to a specified key and returns the value. + + This function does the same thing as `yyjson_mut_obj_getn()` but is much faster + if the ordering of the keys is known at compile-time and you are using the same + order to look up the values. If the key exists in this object, then the + iterator will stop at the next key, otherwise the iterator will not change and + NULL is returned. + + @param iter The object iterator, should not be NULL. + @param key The key, should be a UTF-8 string, null-terminator is not required. + @param key_len The the length of `key`, in bytes. + @return The value to which the specified key is mapped. + NULL if this object contains no mapping for the key or input is invalid. + + @warning This function takes a linear search time if the key is not nearby. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_getn( + yyjson_mut_obj_iter *iter, const char *key, size_t key_len); + +/** + Macro for iterating over an object. + It works like iterator, but with a more intuitive API. + + @warning You should not modify the object while iterating over it. + + @par Example + @code + size_t idx, max; + yyjson_val *key, *val; + yyjson_obj_foreach(obj, idx, max, key, val) { + your_func(key, val); + } + @endcode + */ +#define yyjson_mut_obj_foreach(obj, idx, max, key, val) \ + for ((idx) = 0, \ + (max) = yyjson_mut_obj_size(obj), \ + (key) = (max) ? ((yyjson_mut_val *)(obj)->uni.ptr)->next->next : NULL, \ + (val) = (key) ? (key)->next : NULL; \ + (idx) < (max); \ + (idx)++, \ + (key) = (val)->next, \ + (val) = (key)->next) + + + +/*============================================================================== + * Mutable JSON Object Creation API + *============================================================================*/ + +/** Creates and returns a mutable object, returns NULL on error. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj(yyjson_mut_doc *doc); + +/** + Creates and returns a mutable object with keys and values, returns NULL on + error. The keys and values are not copied. The strings should be a + null-terminated UTF-8 string. + + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. + + @par Example + @code + const char *keys[2] = { "id", "name" }; + const char *vals[2] = { "01", "Harry" }; + yyjson_mut_val *obj = yyjson_mut_obj_with_str(doc, keys, vals, 2); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_with_str(yyjson_mut_doc *doc, + const char **keys, + const char **vals, + size_t count); + +/** + Creates and returns a mutable object with key-value pairs and pair count, + returns NULL on error. The keys and values are not copied. The strings should + be a null-terminated UTF-8 string. + + @warning The input string is not copied, you should keep this string + unmodified for the lifetime of this JSON document. + + @par Example + @code + const char *kv_pairs[4] = { "id", "01", "name", "Harry" }; + yyjson_mut_val *obj = yyjson_mut_obj_with_kv(doc, kv_pairs, 2); + @endcode + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_with_kv(yyjson_mut_doc *doc, + const char **kv_pairs, + size_t pair_count); + + + +/*============================================================================== + * Mutable JSON Object Modification API + *============================================================================*/ + +/** + Adds a key-value pair at the end of the object. + This function allows duplicated key in one object. + @param obj The object to which the new key-value pair is to be added. + @param key The key, should be a string which is created by `yyjson_mut_str()`, + `yyjson_mut_strn()`, `yyjson_mut_strcpy()` or `yyjson_mut_strncpy()`. + @param val The value to add to the object. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_obj_add(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val); +/** + Sets a key-value pair at the end of the object. + This function may remove all key-value pairs for the given key before add. + @param obj The object to which the new key-value pair is to be added. + @param key The key, should be a string which is created by `yyjson_mut_str()`, + `yyjson_mut_strn()`, `yyjson_mut_strcpy()` or `yyjson_mut_strncpy()`. + @param val The value to add to the object. If this value is null, the behavior + is same as `yyjson_mut_obj_remove()`. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_obj_put(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val); + +/** + Inserts a key-value pair to the object at the given position. + This function allows duplicated key in one object. + @param obj The object to which the new key-value pair is to be added. + @param key The key, should be a string which is created by `yyjson_mut_str()`, + `yyjson_mut_strn()`, `yyjson_mut_strcpy()` or `yyjson_mut_strncpy()`. + @param val The value to add to the object. + @param idx The index to which to insert the new pair. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_obj_insert(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val, + size_t idx); + +/** + Removes all key-value pair from the object with given key. + @param obj The object from which the key-value pair is to be removed. + @param key The key, should be a string value. + @return The first matched value, or NULL if no matched value. + @warning This function takes a linear search time. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove(yyjson_mut_val *obj, + yyjson_mut_val *key); + +/** + Removes all key-value pair from the object with given key. + @param obj The object from which the key-value pair is to be removed. + @param key The key, should be a UTF-8 string with null-terminator. + @return The first matched value, or NULL if no matched value. + @warning This function takes a linear search time. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_key( + yyjson_mut_val *obj, const char *key); + +/** + Removes all key-value pair from the object with given key. + @param obj The object from which the key-value pair is to be removed. + @param key The key, should be a UTF-8 string, null-terminator is not required. + @param key_len The length of the key. + @return The first matched value, or NULL if no matched value. + @warning This function takes a linear search time. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_keyn( + yyjson_mut_val *obj, const char *key, size_t key_len); + +/** + Removes all key-value pairs in this object. + @param obj The object from which all of the values are to be removed. + @return Whether successful. + */ +yyjson_api_inline bool yyjson_mut_obj_clear(yyjson_mut_val *obj); + +/** + Replaces value from the object with given key. + If the key is not exist, or the value is NULL, it will fail. + @param obj The object to which the value is to be replaced. + @param key The key, should be a string value. + @param val The value to replace into the object. + @return Whether successful. + @warning This function takes a linear search time. + */ +yyjson_api_inline bool yyjson_mut_obj_replace(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val); + +/** + Rotates key-value pairs in the object for the given number of times. + For example: `{"a":1,"b":2,"c":3,"d":4}` rotate 1 is + `{"b":2,"c":3,"d":4,"a":1}`. + @param obj The object to be rotated. + @param idx Index (or times) to rotate. + @return Whether successful. + @warning This function takes a linear search time. + */ +yyjson_api_inline bool yyjson_mut_obj_rotate(yyjson_mut_val *obj, + size_t idx); + + + +/*============================================================================== + * Mutable JSON Object Modification Convenience API + *============================================================================*/ + +/** Adds a `null` value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_null(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key); + +/** Adds a `true` value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_true(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key); + +/** Adds a `false` value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_false(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key); + +/** Adds a bool value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_bool(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, bool val); + +/** Adds an unsigned integer value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_uint(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, uint64_t val); + +/** Adds a signed integer value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_sint(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, int64_t val); + +/** Adds an int value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_int(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, int64_t val); + +/** Adds a double value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_real(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, double val); + +/** Adds a string value at the end of the object. + The `key` and `val` should be null-terminated UTF-8 strings. + This function allows duplicated key in one object. + + @warning The key/value string are not copied, you should keep these strings + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_str(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, const char *val); + +/** Adds a string value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + The `val` should be a UTF-8 string, null-terminator is not required. + The `len` should be the length of the `val`, in bytes. + This function allows duplicated key in one object. + + @warning The key/value string are not copied, you should keep these strings + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_strn(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + const char *val, size_t len); + +/** Adds a string value at the end of the object. + The `key` and `val` should be null-terminated UTF-8 strings. + The value string is copied. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_strcpy(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + const char *val); + +/** Adds a string value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + The `val` should be a UTF-8 string, null-terminator is not required. + The `len` should be the length of the `val`, in bytes. + This function allows duplicated key in one object. + + @warning The key/value string are not copied, you should keep these strings + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_strncpy(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + const char *val, size_t len); + +/** Adds a JSON value at the end of the object. + The `key` should be a null-terminated UTF-8 string. + This function allows duplicated key in one object. + + @warning The key string are not copied, you should keep the string + unmodified for the lifetime of this JSON document. */ +yyjson_api_inline bool yyjson_mut_obj_add_val(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + yyjson_mut_val *val); + +/** Removes all key-value pairs for the given key. + Returns the first value to which the specified key is mapped or NULL if this + object contains no mapping for the key. + The `key` should be a null-terminated UTF-8 string. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_str( + yyjson_mut_val *obj, const char *key); + +/** Removes all key-value pairs for the given key. + Returns the first value to which the specified key is mapped or NULL if this + object contains no mapping for the key. + The `key` should be a UTF-8 string, null-terminator is not required. + The `len` should be the length of the key, in bytes. + + @warning This function takes a linear search time. */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_strn( + yyjson_mut_val *obj, const char *key, size_t len); + +/** Replaces all matching keys with the new key. + Returns true if at least one key was renamed. + The `key` and `new_key` should be a null-terminated UTF-8 string. + The `new_key` is copied and held by doc. + + @warning This function takes a linear search time. + If `new_key` already exists, it will cause duplicate keys. + */ +yyjson_api_inline bool yyjson_mut_obj_rename_key(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + const char *new_key); + +/** Replaces all matching keys with the new key. + Returns true if at least one key was renamed. + The `key` and `new_key` should be a UTF-8 string, + null-terminator is not required. The `new_key` is copied and held by doc. + + @warning This function takes a linear search time. + If `new_key` already exists, it will cause duplicate keys. + */ +yyjson_api_inline bool yyjson_mut_obj_rename_keyn(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + size_t len, + const char *new_key, + size_t new_len); + + + +/*============================================================================== + * JSON Pointer API (RFC 6901) + * https://tools.ietf.org/html/rfc6901 + *============================================================================*/ + +/** JSON Pointer error code. */ +typedef uint32_t yyjson_ptr_code; + +/** No JSON pointer error. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_NONE = 0; + +/** Invalid input parameter, such as NULL input. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_PARAMETER = 1; + +/** JSON pointer syntax error, such as invalid escape, token no prefix. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_SYNTAX = 2; + +/** JSON pointer resolve failed, such as index out of range, key not found. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_RESOLVE = 3; + +/** Document's root is NULL, but it is required for the function call. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_NULL_ROOT = 4; + +/** Cannot set root as the target is not a document. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_SET_ROOT = 5; + +/** The memory allocation failed and a new value could not be created. */ +static const yyjson_ptr_code YYJSON_PTR_ERR_MEMORY_ALLOCATION = 6; + +/** Error information for JSON pointer. */ +typedef struct yyjson_ptr_err { + /** Error code, see `yyjson_ptr_code` for all possible values. */ + yyjson_ptr_code code; + /** Error message, constant, no need to free (NULL if no error). */ + const char *msg; + /** Error byte position for input JSON pointer (0 if no error). */ + size_t pos; +} yyjson_ptr_err; + +/** + A context for JSON pointer operation. + + This struct stores the context of JSON Pointer operation result. The struct + can be used with three helper functions: `ctx_append()`, `ctx_replace()`, and + `ctx_remove()`, which perform the corresponding operations on the container + without re-parsing the JSON Pointer. + + For example: + @code + // doc before: {"a":[0,1,null]} + // ptr: "/a/2" + val = yyjson_mut_doc_ptr_getx(doc, ptr, strlen(ptr), &ctx, &err); + if (yyjson_is_null(val)) { + yyjson_ptr_ctx_remove(&ctx); + } + // doc after: {"a":[0,1]} + @endcode + */ +typedef struct yyjson_ptr_ctx { + /** + The container (parent) of the target value. It can be either an array or + an object. If the target location has no value, but all its parent + containers exist, and the target location can be used to insert a new + value, then `ctn` is the parent container of the target location. + Otherwise, `ctn` is NULL. + */ + yyjson_mut_val *ctn; + /** + The previous sibling of the target value. It can be either a value in an + array or a key in an object. As the container is a `circular linked list` + of elements, `pre` is the previous node of the target value. If the + operation is `add` or `set`, then `pre` is the previous node of the new + value, not the original target value. If the target value does not exist, + `pre` is NULL. + */ + yyjson_mut_val *pre; + /** + The removed value if the operation is `set`, `replace` or `remove`. It can + be used to restore the original state of the document if needed. + */ + yyjson_mut_val *old; +} yyjson_ptr_ctx; + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_doc_ptr_get(yyjson_doc *doc, + const char *ptr); + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_doc_ptr_getn(yyjson_doc *doc, + const char *ptr, size_t len); + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param err A pointer to store the error information, or NULL if not needed. + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_doc_ptr_getx(yyjson_doc *doc, + const char *ptr, size_t len, + yyjson_ptr_err *err); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_ptr_get(yyjson_val *val, + const char *ptr); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_ptr_getn(yyjson_val *val, + const char *ptr, size_t len); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param err A pointer to store the error information, or NULL if not needed. + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_val *yyjson_ptr_getx(yyjson_val *val, + const char *ptr, size_t len, + yyjson_ptr_err *err); + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_get(yyjson_mut_doc *doc, + const char *ptr); + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_getn(yyjson_mut_doc *doc, + const char *ptr, + size_t len); + +/** + Get value by a JSON Pointer. + @param doc The JSON document to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The value referenced by the JSON pointer. + NULL if `doc` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_getx(yyjson_mut_doc *doc, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_get(yyjson_mut_val *val, + const char *ptr); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_getn(yyjson_mut_val *val, + const char *ptr, + size_t len); + +/** + Get value by a JSON Pointer. + @param val The JSON value to be queried. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The value referenced by the JSON pointer. + NULL if `val` or `ptr` is NULL, or the JSON pointer cannot be resolved. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_getx(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Add (insert) value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param new_val The value to be added. + @return true if JSON pointer is valid and new value is added, false otherwise. + @note The parent nodes will be created if they do not exist. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_add(yyjson_mut_doc *doc, + const char *ptr, + yyjson_mut_val *new_val); + +/** + Add (insert) value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be added. + @return true if JSON pointer is valid and new value is added, false otherwise. + @note The parent nodes will be created if they do not exist. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_addn(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val); + +/** + Add (insert) value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be added. + @param create_parent Whether to create parent nodes if not exist. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return true if JSON pointer is valid and new value is added, false otherwise. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_addx(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Add (insert) value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param doc Only used to create new values when needed. + @param new_val The value to be added. + @return true if JSON pointer is valid and new value is added, false otherwise. + @note The parent nodes will be created if they do not exist. + */ +yyjson_api_inline bool yyjson_mut_ptr_add(yyjson_mut_val *val, + const char *ptr, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc); + +/** + Add (insert) value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param doc Only used to create new values when needed. + @param new_val The value to be added. + @return true if JSON pointer is valid and new value is added, false otherwise. + @note The parent nodes will be created if they do not exist. + */ +yyjson_api_inline bool yyjson_mut_ptr_addn(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc); + +/** + Add (insert) value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param doc Only used to create new values when needed. + @param new_val The value to be added. + @param create_parent Whether to create parent nodes if not exist. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return true if JSON pointer is valid and new value is added, false otherwise. + */ +yyjson_api_inline bool yyjson_mut_ptr_addx(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Set value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param new_val The value to be set, pass NULL to remove. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note The parent nodes will be created if they do not exist. + If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_set(yyjson_mut_doc *doc, + const char *ptr, + yyjson_mut_val *new_val); + +/** + Set value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be set, pass NULL to remove. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note The parent nodes will be created if they do not exist. + If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_setn(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val); + +/** + Set value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be set, pass NULL to remove. + @param create_parent Whether to create parent nodes if not exist. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_doc_ptr_setx(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Set value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param new_val The value to be set, pass NULL to remove. + @param doc Only used to create new values when needed. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note The parent nodes will be created if they do not exist. + If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_ptr_set(yyjson_mut_val *val, + const char *ptr, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc); + +/** + Set value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be set, pass NULL to remove. + @param doc Only used to create new values when needed. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note The parent nodes will be created if they do not exist. + If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_ptr_setn(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc); + +/** + Set value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The value to be set, pass NULL to remove. + @param doc Only used to create new values when needed. + @param create_parent Whether to create parent nodes if not exist. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return true if JSON pointer is valid and new value is set, false otherwise. + @note If the target value already exists, it will be replaced by the new value. + */ +yyjson_api_inline bool yyjson_mut_ptr_setx(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Replace value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param new_val The new value to replace the old one. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replace( + yyjson_mut_doc *doc, const char *ptr, yyjson_mut_val *new_val); + +/** + Replace value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The new value to replace the old one. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replacen( + yyjson_mut_doc *doc, const char *ptr, size_t len, yyjson_mut_val *new_val); + +/** + Replace value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The new value to replace the old one. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replacex( + yyjson_mut_doc *doc, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err); + +/** + Replace value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @param new_val The new value to replace the old one. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replace( + yyjson_mut_val *val, const char *ptr, yyjson_mut_val *new_val); + +/** + Replace value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The new value to replace the old one. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replacen( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val); + +/** + Replace value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param new_val The new value to replace the old one. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The old value that was replaced, or NULL if not found. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replacex( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err); + +/** + Remove value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_remove( + yyjson_mut_doc *doc, const char *ptr); + +/** + Remove value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_removen( + yyjson_mut_doc *doc, const char *ptr, size_t len); + +/** + Remove value by a JSON pointer. + @param doc The target JSON document. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_removex( + yyjson_mut_doc *doc, const char *ptr, size_t len, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err); + +/** + Remove value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8 with null-terminator). + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_remove(yyjson_mut_val *val, + const char *ptr); + +/** + Remove value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_removen(yyjson_mut_val *val, + const char *ptr, + size_t len); + +/** + Remove value by a JSON pointer. + @param val The target JSON value. + @param ptr The JSON pointer string (UTF-8, null-terminator is not required). + @param len The length of `ptr` in bytes. + @param ctx A pointer to store the result context, or NULL if not needed. + @param err A pointer to store the error information, or NULL if not needed. + @return The removed value, or NULL on error. + */ +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_removex(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/** + Append value by JSON pointer context. + @param ctx The context from the `yyjson_mut_ptr_xxx()` calls. + @param key New key if `ctx->ctn` is object, or NULL if `ctx->ctn` is array. + @param val New value to be added. + @return true on success or false on fail. + */ +yyjson_api_inline bool yyjson_ptr_ctx_append(yyjson_ptr_ctx *ctx, + yyjson_mut_val *key, + yyjson_mut_val *val); + +/** + Replace value by JSON pointer context. + @param ctx The context from the `yyjson_mut_ptr_xxx()` calls. + @param val New value to be replaced. + @return true on success or false on fail. + @note If success, the old value will be returned via `ctx->old`. + */ +yyjson_api_inline bool yyjson_ptr_ctx_replace(yyjson_ptr_ctx *ctx, + yyjson_mut_val *val); + +/** + Remove value by JSON pointer context. + @param ctx The context from the `yyjson_mut_ptr_xxx()` calls. + @return true on success or false on fail. + @note If success, the old value will be returned via `ctx->old`. + */ +yyjson_api_inline bool yyjson_ptr_ctx_remove(yyjson_ptr_ctx *ctx); + + + +/*============================================================================== + * JSON Patch API (RFC 6902) + * https://tools.ietf.org/html/rfc6902 + *============================================================================*/ + +/** Result code for JSON patch. */ +typedef uint32_t yyjson_patch_code; + +/** Success, no error. */ +static const yyjson_patch_code YYJSON_PATCH_SUCCESS = 0; + +/** Invalid parameter, such as NULL input or non-array patch. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_INVALID_PARAMETER = 1; + +/** Memory allocation failure occurs. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_MEMORY_ALLOCATION = 2; + +/** JSON patch operation is not object type. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_INVALID_OPERATION = 3; + +/** JSON patch operation is missing a required key. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_MISSING_KEY = 4; + +/** JSON patch operation member is invalid. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_INVALID_MEMBER = 5; + +/** JSON patch operation `test` not equal. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_EQUAL = 6; + +/** JSON patch operation failed on JSON pointer. */ +static const yyjson_patch_code YYJSON_PATCH_ERROR_POINTER = 7; + +/** Error information for JSON patch. */ +typedef struct yyjson_patch_err { + /** Error code, see `yyjson_patch_code` for all possible values. */ + yyjson_patch_code code; + /** Index of the error operation (0 if no error). */ + size_t idx; + /** Error message, constant, no need to free (NULL if no error). */ + const char *msg; + /** JSON pointer error if `code == YYJSON_PATCH_ERROR_POINTER`. */ + yyjson_ptr_err ptr; +} yyjson_patch_err; + +/** + Creates and returns a patched JSON value (RFC 6902). + The memory of the returned value is allocated by the `doc`. + The `err` is used to receive error information, pass NULL if not needed. + Returns NULL if the patch could not be applied. + */ +yyjson_api yyjson_mut_val *yyjson_patch(yyjson_mut_doc *doc, + yyjson_val *orig, + yyjson_val *patch, + yyjson_patch_err *err); + +/** + Creates and returns a patched JSON value (RFC 6902). + The memory of the returned value is allocated by the `doc`. + The `err` is used to receive error information, pass NULL if not needed. + Returns NULL if the patch could not be applied. + */ +yyjson_api yyjson_mut_val *yyjson_mut_patch(yyjson_mut_doc *doc, + yyjson_mut_val *orig, + yyjson_mut_val *patch, + yyjson_patch_err *err); + + + +/*============================================================================== + * JSON Merge-Patch API (RFC 7386) + * https://tools.ietf.org/html/rfc7386 + *============================================================================*/ + +/** + Creates and returns a merge-patched JSON value (RFC 7386). + The memory of the returned value is allocated by the `doc`. + Returns NULL if the patch could not be applied. + + @warning This function is recursive and may cause a stack overflow if the + object level is too deep. + */ +yyjson_api yyjson_mut_val *yyjson_merge_patch(yyjson_mut_doc *doc, + yyjson_val *orig, + yyjson_val *patch); + +/** + Creates and returns a merge-patched JSON value (RFC 7386). + The memory of the returned value is allocated by the `doc`. + Returns NULL if the patch could not be applied. + + @warning This function is recursive and may cause a stack overflow if the + object level is too deep. + */ +yyjson_api yyjson_mut_val *yyjson_mut_merge_patch(yyjson_mut_doc *doc, + yyjson_mut_val *orig, + yyjson_mut_val *patch); + + + +/*============================================================================== + * JSON Structure (Implementation) + *============================================================================*/ + +/** Payload of a JSON value (8 bytes). */ +typedef union yyjson_val_uni { + uint64_t u64; + int64_t i64; + double f64; + const char *str; + void *ptr; + size_t ofs; +} yyjson_val_uni; + +/** + Immutable JSON value, 16 bytes. + */ +struct yyjson_val { + uint64_t tag; /**< type, subtype and length */ + yyjson_val_uni uni; /**< payload */ +}; + +struct yyjson_doc { + /** Root value of the document (nonnull). */ + yyjson_val *root; + /** Allocator used by document (nonnull). */ + yyjson_alc alc; + /** The total number of bytes read when parsing JSON (nonzero). */ + size_t dat_read; + /** The total number of value read when parsing JSON (nonzero). */ + size_t val_read; + /** The string pool used by JSON values (nullable). */ + char *str_pool; +}; + + + +/*============================================================================== + * Unsafe JSON Value API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_type unsafe_yyjson_get_type(void *val) { + uint8_t tag = (uint8_t)((yyjson_val *)val)->tag; + return (yyjson_type)(tag & YYJSON_TYPE_MASK); +} + +yyjson_api_inline yyjson_subtype unsafe_yyjson_get_subtype(void *val) { + uint8_t tag = (uint8_t)((yyjson_val *)val)->tag; + return (yyjson_subtype)(tag & YYJSON_SUBTYPE_MASK); +} + +yyjson_api_inline uint8_t unsafe_yyjson_get_tag(void *val) { + uint8_t tag = (uint8_t)((yyjson_val *)val)->tag; + return (uint8_t)(tag & YYJSON_TAG_MASK); +} + +yyjson_api_inline bool unsafe_yyjson_is_raw(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_RAW; +} + +yyjson_api_inline bool unsafe_yyjson_is_null(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_NULL; +} + +yyjson_api_inline bool unsafe_yyjson_is_bool(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_BOOL; +} + +yyjson_api_inline bool unsafe_yyjson_is_num(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_NUM; +} + +yyjson_api_inline bool unsafe_yyjson_is_str(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_STR; +} + +yyjson_api_inline bool unsafe_yyjson_is_arr(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_ARR; +} + +yyjson_api_inline bool unsafe_yyjson_is_obj(void *val) { + return unsafe_yyjson_get_type(val) == YYJSON_TYPE_OBJ; +} + +yyjson_api_inline bool unsafe_yyjson_is_ctn(void *val) { + uint8_t mask = YYJSON_TYPE_ARR & YYJSON_TYPE_OBJ; + return (unsafe_yyjson_get_tag(val) & mask) == mask; +} + +yyjson_api_inline bool unsafe_yyjson_is_uint(void *val) { + const uint8_t patt = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + return unsafe_yyjson_get_tag(val) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_is_sint(void *val) { + const uint8_t patt = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + return unsafe_yyjson_get_tag(val) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_is_int(void *val) { + const uint8_t mask = YYJSON_TAG_MASK & (~YYJSON_SUBTYPE_SINT); + const uint8_t patt = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + return (unsafe_yyjson_get_tag(val) & mask) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_is_real(void *val) { + const uint8_t patt = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + return unsafe_yyjson_get_tag(val) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_is_true(void *val) { + const uint8_t patt = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_TRUE; + return unsafe_yyjson_get_tag(val) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_is_false(void *val) { + const uint8_t patt = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_FALSE; + return unsafe_yyjson_get_tag(val) == patt; +} + +yyjson_api_inline bool unsafe_yyjson_arr_is_flat(yyjson_val *val) { + size_t ofs = val->uni.ofs; + size_t len = (size_t)(val->tag >> YYJSON_TAG_BIT); + return len * sizeof(yyjson_val) + sizeof(yyjson_val) == ofs; +} + +yyjson_api_inline const char *unsafe_yyjson_get_raw(void *val) { + return ((yyjson_val *)val)->uni.str; +} + +yyjson_api_inline bool unsafe_yyjson_get_bool(void *val) { + uint8_t tag = unsafe_yyjson_get_tag(val); + return (bool)((tag & YYJSON_SUBTYPE_MASK) >> YYJSON_TYPE_BIT); +} + +yyjson_api_inline uint64_t unsafe_yyjson_get_uint(void *val) { + return ((yyjson_val *)val)->uni.u64; +} + +yyjson_api_inline int64_t unsafe_yyjson_get_sint(void *val) { + return ((yyjson_val *)val)->uni.i64; +} + +yyjson_api_inline int unsafe_yyjson_get_int(void *val) { + return (int)((yyjson_val *)val)->uni.i64; +} + +yyjson_api_inline double unsafe_yyjson_get_real(void *val) { + return ((yyjson_val *)val)->uni.f64; +} + +yyjson_api_inline double unsafe_yyjson_get_num(void *val) { + uint8_t tag = unsafe_yyjson_get_tag(val); + if (tag == (YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL)) { + return ((yyjson_val *)val)->uni.f64; + } else if (tag == (YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT)) { + return (double)((yyjson_val *)val)->uni.i64; + } else if (tag == (YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT)) { +#if YYJSON_U64_TO_F64_NO_IMPL + uint64_t msb = ((uint64_t)1) << 63; + uint64_t num = ((yyjson_val *)val)->uni.u64; + if ((num & msb) == 0) { + return (double)(int64_t)num; + } else { + return ((double)(int64_t)((num >> 1) | (num & 1))) * (double)2.0; + } +#else + return (double)((yyjson_val *)val)->uni.u64; +#endif + } + return 0.0; +} + +yyjson_api_inline const char *unsafe_yyjson_get_str(void *val) { + return ((yyjson_val *)val)->uni.str; +} + +yyjson_api_inline size_t unsafe_yyjson_get_len(void *val) { + return (size_t)(((yyjson_val *)val)->tag >> YYJSON_TAG_BIT); +} + +yyjson_api_inline yyjson_val *unsafe_yyjson_get_first(yyjson_val *ctn) { + return ctn + 1; +} + +yyjson_api_inline yyjson_val *unsafe_yyjson_get_next(yyjson_val *val) { + bool is_ctn = unsafe_yyjson_is_ctn(val); + size_t ctn_ofs = val->uni.ofs; + size_t ofs = (is_ctn ? ctn_ofs : sizeof(yyjson_val)); + return (yyjson_val *)(void *)((uint8_t *)val + ofs); +} + +yyjson_api_inline bool unsafe_yyjson_equals_strn(void *val, const char *str, + size_t len) { + uint64_t tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + return ((yyjson_val *)val)->tag == tag && + memcmp(((yyjson_val *)val)->uni.str, str, len) == 0; +} + +yyjson_api_inline bool unsafe_yyjson_equals_str(void *val, const char *str) { + return unsafe_yyjson_equals_strn(val, str, strlen(str)); +} + +yyjson_api_inline void unsafe_yyjson_set_type(void *val, yyjson_type type, + yyjson_subtype subtype) { + uint8_t tag = (type | subtype); + uint64_t new_tag = ((yyjson_val *)val)->tag; + new_tag = (new_tag & (~(uint64_t)YYJSON_TAG_MASK)) | (uint64_t)tag; + ((yyjson_val *)val)->tag = new_tag; +} + +yyjson_api_inline void unsafe_yyjson_set_len(void *val, size_t len) { + uint64_t tag = ((yyjson_val *)val)->tag & YYJSON_TAG_MASK; + tag |= (uint64_t)len << YYJSON_TAG_BIT; + ((yyjson_val *)val)->tag = tag; +} + +yyjson_api_inline void unsafe_yyjson_inc_len(void *val) { + uint64_t tag = ((yyjson_val *)val)->tag; + tag += (uint64_t)(1 << YYJSON_TAG_BIT); + ((yyjson_val *)val)->tag = tag; +} + +yyjson_api_inline void unsafe_yyjson_set_raw(void *val, const char *raw, + size_t len) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_RAW, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, len); + ((yyjson_val *)val)->uni.str = raw; +} + +yyjson_api_inline void unsafe_yyjson_set_null(void *val) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_NULL, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, 0); +} + +yyjson_api_inline void unsafe_yyjson_set_bool(void *val, bool num) { + yyjson_subtype subtype = num ? YYJSON_SUBTYPE_TRUE : YYJSON_SUBTYPE_FALSE; + unsafe_yyjson_set_type(val, YYJSON_TYPE_BOOL, subtype); + unsafe_yyjson_set_len(val, 0); +} + +yyjson_api_inline void unsafe_yyjson_set_uint(void *val, uint64_t num) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_NUM, YYJSON_SUBTYPE_UINT); + unsafe_yyjson_set_len(val, 0); + ((yyjson_val *)val)->uni.u64 = num; +} + +yyjson_api_inline void unsafe_yyjson_set_sint(void *val, int64_t num) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_NUM, YYJSON_SUBTYPE_SINT); + unsafe_yyjson_set_len(val, 0); + ((yyjson_val *)val)->uni.i64 = num; +} + +yyjson_api_inline void unsafe_yyjson_set_real(void *val, double num) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_NUM, YYJSON_SUBTYPE_REAL); + unsafe_yyjson_set_len(val, 0); + ((yyjson_val *)val)->uni.f64 = num; +} + +yyjson_api_inline void unsafe_yyjson_set_str(void *val, const char *str) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_STR, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, strlen(str)); + ((yyjson_val *)val)->uni.str = str; +} + +yyjson_api_inline void unsafe_yyjson_set_strn(void *val, const char *str, + size_t len) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_STR, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, len); + ((yyjson_val *)val)->uni.str = str; +} + +yyjson_api_inline void unsafe_yyjson_set_arr(void *val, size_t size) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_ARR, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, size); +} + +yyjson_api_inline void unsafe_yyjson_set_obj(void *val, size_t size) { + unsafe_yyjson_set_type(val, YYJSON_TYPE_OBJ, YYJSON_SUBTYPE_NONE); + unsafe_yyjson_set_len(val, size); +} + + + +/*============================================================================== + * JSON Document API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_val *yyjson_doc_get_root(yyjson_doc *doc) { + return doc ? doc->root : NULL; +} + +yyjson_api_inline size_t yyjson_doc_get_read_size(yyjson_doc *doc) { + return doc ? doc->dat_read : 0; +} + +yyjson_api_inline size_t yyjson_doc_get_val_count(yyjson_doc *doc) { + return doc ? doc->val_read : 0; +} + +yyjson_api_inline void yyjson_doc_free(yyjson_doc *doc) { + if (doc) { + yyjson_alc alc = doc->alc; + if (doc->str_pool) alc.free(alc.ctx, doc->str_pool); + alc.free(alc.ctx, doc); + } +} + + + +/*============================================================================== + * JSON Value Type API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_is_raw(yyjson_val *val) { + return val ? unsafe_yyjson_is_raw(val) : false; +} + +yyjson_api_inline bool yyjson_is_null(yyjson_val *val) { + return val ? unsafe_yyjson_is_null(val) : false; +} + +yyjson_api_inline bool yyjson_is_true(yyjson_val *val) { + return val ? unsafe_yyjson_is_true(val) : false; +} + +yyjson_api_inline bool yyjson_is_false(yyjson_val *val) { + return val ? unsafe_yyjson_is_false(val) : false; +} + +yyjson_api_inline bool yyjson_is_bool(yyjson_val *val) { + return val ? unsafe_yyjson_is_bool(val) : false; +} + +yyjson_api_inline bool yyjson_is_uint(yyjson_val *val) { + return val ? unsafe_yyjson_is_uint(val) : false; +} + +yyjson_api_inline bool yyjson_is_sint(yyjson_val *val) { + return val ? unsafe_yyjson_is_sint(val) : false; +} + +yyjson_api_inline bool yyjson_is_int(yyjson_val *val) { + return val ? unsafe_yyjson_is_int(val) : false; +} + +yyjson_api_inline bool yyjson_is_real(yyjson_val *val) { + return val ? unsafe_yyjson_is_real(val) : false; +} + +yyjson_api_inline bool yyjson_is_num(yyjson_val *val) { + return val ? unsafe_yyjson_is_num(val) : false; +} + +yyjson_api_inline bool yyjson_is_str(yyjson_val *val) { + return val ? unsafe_yyjson_is_str(val) : false; +} + +yyjson_api_inline bool yyjson_is_arr(yyjson_val *val) { + return val ? unsafe_yyjson_is_arr(val) : false; +} + +yyjson_api_inline bool yyjson_is_obj(yyjson_val *val) { + return val ? unsafe_yyjson_is_obj(val) : false; +} + +yyjson_api_inline bool yyjson_is_ctn(yyjson_val *val) { + return val ? unsafe_yyjson_is_ctn(val) : false; +} + + + +/*============================================================================== + * JSON Value Content API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_type yyjson_get_type(yyjson_val *val) { + return val ? unsafe_yyjson_get_type(val) : YYJSON_TYPE_NONE; +} + +yyjson_api_inline yyjson_subtype yyjson_get_subtype(yyjson_val *val) { + return val ? unsafe_yyjson_get_subtype(val) : YYJSON_SUBTYPE_NONE; +} + +yyjson_api_inline uint8_t yyjson_get_tag(yyjson_val *val) { + return val ? unsafe_yyjson_get_tag(val) : 0; +} + +yyjson_api_inline const char *yyjson_get_type_desc(yyjson_val *val) { + switch (yyjson_get_tag(val)) { + case YYJSON_TYPE_RAW | YYJSON_SUBTYPE_NONE: return "raw"; + case YYJSON_TYPE_NULL | YYJSON_SUBTYPE_NONE: return "null"; + case YYJSON_TYPE_STR | YYJSON_SUBTYPE_NONE: return "string"; + case YYJSON_TYPE_ARR | YYJSON_SUBTYPE_NONE: return "array"; + case YYJSON_TYPE_OBJ | YYJSON_SUBTYPE_NONE: return "object"; + case YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_TRUE: return "true"; + case YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_FALSE: return "false"; + case YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT: return "uint"; + case YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT: return "sint"; + case YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL: return "real"; + default: return "unknown"; + } +} + +yyjson_api_inline const char *yyjson_get_raw(yyjson_val *val) { + return yyjson_is_raw(val) ? unsafe_yyjson_get_raw(val) : NULL; +} + +yyjson_api_inline bool yyjson_get_bool(yyjson_val *val) { + return yyjson_is_bool(val) ? unsafe_yyjson_get_bool(val) : false; +} + +yyjson_api_inline uint64_t yyjson_get_uint(yyjson_val *val) { + return yyjson_is_int(val) ? unsafe_yyjson_get_uint(val) : 0; +} + +yyjson_api_inline int64_t yyjson_get_sint(yyjson_val *val) { + return yyjson_is_int(val) ? unsafe_yyjson_get_sint(val) : 0; +} + +yyjson_api_inline int yyjson_get_int(yyjson_val *val) { + return yyjson_is_int(val) ? unsafe_yyjson_get_int(val) : 0; +} + +yyjson_api_inline double yyjson_get_real(yyjson_val *val) { + return yyjson_is_real(val) ? unsafe_yyjson_get_real(val) : 0.0; +} + +yyjson_api_inline double yyjson_get_num(yyjson_val *val) { + return val ? unsafe_yyjson_get_num(val) : 0.0; +} + +yyjson_api_inline const char *yyjson_get_str(yyjson_val *val) { + return yyjson_is_str(val) ? unsafe_yyjson_get_str(val) : NULL; +} + +yyjson_api_inline size_t yyjson_get_len(yyjson_val *val) { + return val ? unsafe_yyjson_get_len(val) : 0; +} + +yyjson_api_inline bool yyjson_equals_str(yyjson_val *val, const char *str) { + if (yyjson_likely(val && str)) { + return unsafe_yyjson_equals_str(val, str); + } + return false; +} + +yyjson_api_inline bool yyjson_equals_strn(yyjson_val *val, const char *str, + size_t len) { + if (yyjson_likely(val && str)) { + return unsafe_yyjson_equals_strn(val, str, len); + } + return false; +} + +yyjson_api bool unsafe_yyjson_equals(yyjson_val *lhs, yyjson_val *rhs); + +yyjson_api_inline bool yyjson_equals(yyjson_val *lhs, yyjson_val *rhs) { + if (yyjson_unlikely(!lhs || !rhs)) return false; + return unsafe_yyjson_equals(lhs, rhs); +} + +yyjson_api_inline bool yyjson_set_raw(yyjson_val *val, + const char *raw, size_t len) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_raw(val, raw, len); + return true; +} + +yyjson_api_inline bool yyjson_set_null(yyjson_val *val) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_null(val); + return true; +} + +yyjson_api_inline bool yyjson_set_bool(yyjson_val *val, bool num) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_bool(val, num); + return true; +} + +yyjson_api_inline bool yyjson_set_uint(yyjson_val *val, uint64_t num) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_uint(val, num); + return true; +} + +yyjson_api_inline bool yyjson_set_sint(yyjson_val *val, int64_t num) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_sint(val, num); + return true; +} + +yyjson_api_inline bool yyjson_set_int(yyjson_val *val, int num) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_sint(val, (int64_t)num); + return true; +} + +yyjson_api_inline bool yyjson_set_real(yyjson_val *val, double num) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + unsafe_yyjson_set_real(val, num); + return true; +} + +yyjson_api_inline bool yyjson_set_str(yyjson_val *val, const char *str) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + if (yyjson_unlikely(!str)) return false; + unsafe_yyjson_set_str(val, str); + return true; +} + +yyjson_api_inline bool yyjson_set_strn(yyjson_val *val, + const char *str, size_t len) { + if (yyjson_unlikely(!val || unsafe_yyjson_is_ctn(val))) return false; + if (yyjson_unlikely(!str)) return false; + unsafe_yyjson_set_strn(val, str, len); + return true; +} + + + +/*============================================================================== + * JSON Array API (Implementation) + *============================================================================*/ + +yyjson_api_inline size_t yyjson_arr_size(yyjson_val *arr) { + return yyjson_is_arr(arr) ? unsafe_yyjson_get_len(arr) : 0; +} + +yyjson_api_inline yyjson_val *yyjson_arr_get(yyjson_val *arr, size_t idx) { + if (yyjson_likely(yyjson_is_arr(arr))) { + if (yyjson_likely(unsafe_yyjson_get_len(arr) > idx)) { + yyjson_val *val = unsafe_yyjson_get_first(arr); + if (unsafe_yyjson_arr_is_flat(arr)) { + return val + idx; + } else { + while (idx-- > 0) val = unsafe_yyjson_get_next(val); + return val; + } + } + } + return NULL; +} + +yyjson_api_inline yyjson_val *yyjson_arr_get_first(yyjson_val *arr) { + if (yyjson_likely(yyjson_is_arr(arr))) { + if (yyjson_likely(unsafe_yyjson_get_len(arr) > 0)) { + return unsafe_yyjson_get_first(arr); + } + } + return NULL; +} + +yyjson_api_inline yyjson_val *yyjson_arr_get_last(yyjson_val *arr) { + if (yyjson_likely(yyjson_is_arr(arr))) { + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_likely(len > 0)) { + yyjson_val *val = unsafe_yyjson_get_first(arr); + if (unsafe_yyjson_arr_is_flat(arr)) { + return val + (len - 1); + } else { + while (len-- > 1) val = unsafe_yyjson_get_next(val); + return val; + } + } + } + return NULL; +} + + + +/*============================================================================== + * JSON Array Iterator API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_arr_iter_init(yyjson_val *arr, + yyjson_arr_iter *iter) { + if (yyjson_likely(yyjson_is_arr(arr) && iter)) { + iter->idx = 0; + iter->max = unsafe_yyjson_get_len(arr); + iter->cur = unsafe_yyjson_get_first(arr); + return true; + } + if (iter) memset(iter, 0, sizeof(yyjson_arr_iter)); + return false; +} + +yyjson_api_inline yyjson_arr_iter yyjson_arr_iter_with(yyjson_val *arr) { + yyjson_arr_iter iter; + yyjson_arr_iter_init(arr, &iter); + return iter; +} + +yyjson_api_inline bool yyjson_arr_iter_has_next(yyjson_arr_iter *iter) { + return iter ? iter->idx < iter->max : false; +} + +yyjson_api_inline yyjson_val *yyjson_arr_iter_next(yyjson_arr_iter *iter) { + yyjson_val *val; + if (iter && iter->idx < iter->max) { + val = iter->cur; + iter->cur = unsafe_yyjson_get_next(val); + iter->idx++; + return val; + } + return NULL; +} + + + +/*============================================================================== + * JSON Object API (Implementation) + *============================================================================*/ + +yyjson_api_inline size_t yyjson_obj_size(yyjson_val *obj) { + return yyjson_is_obj(obj) ? unsafe_yyjson_get_len(obj) : 0; +} + +yyjson_api_inline yyjson_val *yyjson_obj_get(yyjson_val *obj, + const char *key) { + return yyjson_obj_getn(obj, key, key ? strlen(key) : 0); +} + +yyjson_api_inline yyjson_val *yyjson_obj_getn(yyjson_val *obj, + const char *_key, + size_t key_len) { + uint64_t tag = (((uint64_t)key_len) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + if (yyjson_likely(yyjson_is_obj(obj) && _key)) { + size_t len = unsafe_yyjson_get_len(obj); + yyjson_val *key = unsafe_yyjson_get_first(obj); + while (len-- > 0) { + if (key->tag == tag && + memcmp(key->uni.ptr, _key, key_len) == 0) { + return key + 1; + } + key = unsafe_yyjson_get_next(key + 1); + } + } + return NULL; +} + + + +/*============================================================================== + * JSON Object Iterator API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_obj_iter_init(yyjson_val *obj, + yyjson_obj_iter *iter) { + if (yyjson_likely(yyjson_is_obj(obj) && iter)) { + iter->idx = 0; + iter->max = unsafe_yyjson_get_len(obj); + iter->cur = unsafe_yyjson_get_first(obj); + iter->obj = obj; + return true; + } + if (iter) memset(iter, 0, sizeof(yyjson_obj_iter)); + return false; +} + +yyjson_api_inline yyjson_obj_iter yyjson_obj_iter_with(yyjson_val *obj) { + yyjson_obj_iter iter; + yyjson_obj_iter_init(obj, &iter); + return iter; +} + +yyjson_api_inline bool yyjson_obj_iter_has_next(yyjson_obj_iter *iter) { + return iter ? iter->idx < iter->max : false; +} + +yyjson_api_inline yyjson_val *yyjson_obj_iter_next(yyjson_obj_iter *iter) { + if (iter && iter->idx < iter->max) { + yyjson_val *key = iter->cur; + iter->idx++; + iter->cur = unsafe_yyjson_get_next(key + 1); + return key; + } + return NULL; +} + +yyjson_api_inline yyjson_val *yyjson_obj_iter_get_val(yyjson_val *key) { + return key ? key + 1 : NULL; +} + +yyjson_api_inline yyjson_val *yyjson_obj_iter_get(yyjson_obj_iter *iter, + const char *key) { + return yyjson_obj_iter_getn(iter, key, key ? strlen(key) : 0); +} + +yyjson_api_inline yyjson_val *yyjson_obj_iter_getn(yyjson_obj_iter *iter, + const char *key, + size_t key_len) { + if (iter && key) { + size_t idx = iter->idx; + size_t max = iter->max; + yyjson_val *cur = iter->cur; + if (yyjson_unlikely(idx == max)) { + idx = 0; + cur = unsafe_yyjson_get_first(iter->obj); + } + while (idx++ < max) { + yyjson_val *next = unsafe_yyjson_get_next(cur + 1); + if (unsafe_yyjson_get_len(cur) == key_len && + memcmp(cur->uni.str, key, key_len) == 0) { + iter->idx = idx; + iter->cur = next; + return cur + 1; + } + cur = next; + if (idx == iter->max && iter->idx < iter->max) { + idx = 0; + max = iter->idx; + cur = unsafe_yyjson_get_first(iter->obj); + } + } + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Structure (Implementation) + *============================================================================*/ + +/** + Mutable JSON value, 24 bytes. + The 'tag' and 'uni' field is same as immutable value. + The 'next' field links all elements inside the container to be a cycle. + */ +struct yyjson_mut_val { + uint64_t tag; /**< type, subtype and length */ + yyjson_val_uni uni; /**< payload */ + yyjson_mut_val *next; /**< the next value in circular linked list */ +}; + +/** + A memory chunk in string memory pool. + */ +typedef struct yyjson_str_chunk { + struct yyjson_str_chunk *next; /* next chunk linked list */ + size_t chunk_size; /* chunk size in bytes */ + /* char str[]; flexible array member */ +} yyjson_str_chunk; + +/** + A memory pool to hold all strings in a mutable document. + */ +typedef struct yyjson_str_pool { + char *cur; /* cursor inside current chunk */ + char *end; /* the end of current chunk */ + size_t chunk_size; /* chunk size in bytes while creating new chunk */ + size_t chunk_size_max; /* maximum chunk size in bytes */ + yyjson_str_chunk *chunks; /* a linked list of chunks, nullable */ +} yyjson_str_pool; + +/** + A memory chunk in value memory pool. + `sizeof(yyjson_val_chunk)` should not larger than `sizeof(yyjson_mut_val)`. + */ +typedef struct yyjson_val_chunk { + struct yyjson_val_chunk *next; /* next chunk linked list */ + size_t chunk_size; /* chunk size in bytes */ + /* char pad[sizeof(yyjson_mut_val) - sizeof(yyjson_val_chunk)]; padding */ + /* yyjson_mut_val vals[]; flexible array member */ +} yyjson_val_chunk; + +/** + A memory pool to hold all values in a mutable document. + */ +typedef struct yyjson_val_pool { + yyjson_mut_val *cur; /* cursor inside current chunk */ + yyjson_mut_val *end; /* the end of current chunk */ + size_t chunk_size; /* chunk size in bytes while creating new chunk */ + size_t chunk_size_max; /* maximum chunk size in bytes */ + yyjson_val_chunk *chunks; /* a linked list of chunks, nullable */ +} yyjson_val_pool; + +struct yyjson_mut_doc { + yyjson_mut_val *root; /**< root value of the JSON document, nullable */ + yyjson_alc alc; /**< a valid allocator, nonnull */ + yyjson_str_pool str_pool; /**< string memory pool */ + yyjson_val_pool val_pool; /**< value memory pool */ +}; + +/* Ensures the capacity to at least equal to the specified byte length. */ +yyjson_api bool unsafe_yyjson_str_pool_grow(yyjson_str_pool *pool, + const yyjson_alc *alc, + size_t len); + +/* Ensures the capacity to at least equal to the specified value count. */ +yyjson_api bool unsafe_yyjson_val_pool_grow(yyjson_val_pool *pool, + const yyjson_alc *alc, + size_t count); + +/* Allocate memory for string. */ +yyjson_api_inline char *unsafe_yyjson_mut_str_alc(yyjson_mut_doc *doc, + size_t len) { + char *mem; + const yyjson_alc *alc = &doc->alc; + yyjson_str_pool *pool = &doc->str_pool; + if (yyjson_unlikely((size_t)(pool->end - pool->cur) <= len)) { + if (yyjson_unlikely(!unsafe_yyjson_str_pool_grow(pool, alc, len + 1))) { + return NULL; + } + } + mem = pool->cur; + pool->cur = mem + len + 1; + return mem; +} + +yyjson_api_inline char *unsafe_yyjson_mut_strncpy(yyjson_mut_doc *doc, + const char *str, size_t len) { + char *mem = unsafe_yyjson_mut_str_alc(doc, len); + if (yyjson_unlikely(!mem)) return NULL; + memcpy((void *)mem, (const void *)str, len); + mem[len] = '\0'; + return mem; +} + +yyjson_api_inline yyjson_mut_val *unsafe_yyjson_mut_val(yyjson_mut_doc *doc, + size_t count) { + yyjson_mut_val *val; + yyjson_alc *alc = &doc->alc; + yyjson_val_pool *pool = &doc->val_pool; + if (yyjson_unlikely((size_t)(pool->end - pool->cur) < count)) { + if (yyjson_unlikely(!unsafe_yyjson_val_pool_grow(pool, alc, count))) { + return NULL; + } + } + val = pool->cur; + pool->cur += count; + return val; +} + + + +/*============================================================================== + * Mutable JSON Document API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_get_root(yyjson_mut_doc *doc) { + return doc ? doc->root : NULL; +} + +yyjson_api_inline void yyjson_mut_doc_set_root(yyjson_mut_doc *doc, + yyjson_mut_val *root) { + if (doc) doc->root = root; +} + + + +/*============================================================================== + * Mutable JSON Value Type API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_mut_is_raw(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_raw(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_null(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_null(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_true(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_true(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_false(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_false(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_bool(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_bool(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_uint(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_uint(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_sint(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_sint(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_int(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_int(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_real(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_real(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_num(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_num(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_str(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_str(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_arr(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_arr(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_obj(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_obj(val) : false; +} + +yyjson_api_inline bool yyjson_mut_is_ctn(yyjson_mut_val *val) { + return val ? unsafe_yyjson_is_ctn(val) : false; +} + + + +/*============================================================================== + * Mutable JSON Value Content API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_type yyjson_mut_get_type(yyjson_mut_val *val) { + return yyjson_get_type((yyjson_val *)val); +} + +yyjson_api_inline yyjson_subtype yyjson_mut_get_subtype(yyjson_mut_val *val) { + return yyjson_get_subtype((yyjson_val *)val); +} + +yyjson_api_inline uint8_t yyjson_mut_get_tag(yyjson_mut_val *val) { + return yyjson_get_tag((yyjson_val *)val); +} + +yyjson_api_inline const char *yyjson_mut_get_type_desc(yyjson_mut_val *val) { + return yyjson_get_type_desc((yyjson_val *)val); +} + +yyjson_api_inline const char *yyjson_mut_get_raw(yyjson_mut_val *val) { + return yyjson_get_raw((yyjson_val *)val); +} + +yyjson_api_inline bool yyjson_mut_get_bool(yyjson_mut_val *val) { + return yyjson_get_bool((yyjson_val *)val); +} + +yyjson_api_inline uint64_t yyjson_mut_get_uint(yyjson_mut_val *val) { + return yyjson_get_uint((yyjson_val *)val); +} + +yyjson_api_inline int64_t yyjson_mut_get_sint(yyjson_mut_val *val) { + return yyjson_get_sint((yyjson_val *)val); +} + +yyjson_api_inline int yyjson_mut_get_int(yyjson_mut_val *val) { + return yyjson_get_int((yyjson_val *)val); +} + +yyjson_api_inline double yyjson_mut_get_real(yyjson_mut_val *val) { + return yyjson_get_real((yyjson_val *)val); +} + +yyjson_api_inline double yyjson_mut_get_num(yyjson_mut_val *val) { + return yyjson_get_num((yyjson_val *)val); +} + +yyjson_api_inline const char *yyjson_mut_get_str(yyjson_mut_val *val) { + return yyjson_get_str((yyjson_val *)val); +} + +yyjson_api_inline size_t yyjson_mut_get_len(yyjson_mut_val *val) { + return yyjson_get_len((yyjson_val *)val); +} + +yyjson_api_inline bool yyjson_mut_equals_str(yyjson_mut_val *val, + const char *str) { + return yyjson_equals_str((yyjson_val *)val, str); +} + +yyjson_api_inline bool yyjson_mut_equals_strn(yyjson_mut_val *val, + const char *str, size_t len) { + return yyjson_equals_strn((yyjson_val *)val, str, len); +} + +yyjson_api bool unsafe_yyjson_mut_equals(yyjson_mut_val *lhs, + yyjson_mut_val *rhs); + +yyjson_api_inline bool yyjson_mut_equals(yyjson_mut_val *lhs, + yyjson_mut_val *rhs) { + if (yyjson_unlikely(!lhs || !rhs)) return false; + return unsafe_yyjson_mut_equals(lhs, rhs); +} + +yyjson_api_inline bool yyjson_mut_set_raw(yyjson_mut_val *val, + const char *raw, size_t len) { + if (yyjson_unlikely(!val || !raw)) return false; + unsafe_yyjson_set_raw(val, raw, len); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_null(yyjson_mut_val *val) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_null(val); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_bool(yyjson_mut_val *val, bool num) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_bool(val, num); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_uint(yyjson_mut_val *val, uint64_t num) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_uint(val, num); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_sint(yyjson_mut_val *val, int64_t num) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_sint(val, num); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_int(yyjson_mut_val *val, int num) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_sint(val, (int64_t)num); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_real(yyjson_mut_val *val, double num) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_real(val, num); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_str(yyjson_mut_val *val, + const char *str) { + if (yyjson_unlikely(!val || !str)) return false; + unsafe_yyjson_set_str(val, str); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_strn(yyjson_mut_val *val, + const char *str, size_t len) { + if (yyjson_unlikely(!val || !str)) return false; + unsafe_yyjson_set_strn(val, str, len); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_arr(yyjson_mut_val *val) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_arr(val, 0); + return true; +} + +yyjson_api_inline bool yyjson_mut_set_obj(yyjson_mut_val *val) { + if (yyjson_unlikely(!val)) return false; + unsafe_yyjson_set_obj(val, 0); + return true; +} + + + +/*============================================================================== + * Mutable JSON Value Creation API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_mut_val *yyjson_mut_raw(yyjson_mut_doc *doc, + const char *str) { + if (yyjson_likely(str)) return yyjson_mut_rawn(doc, str, strlen(str)); + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawn(yyjson_mut_doc *doc, + const char *str, + size_t len) { + if (yyjson_likely(doc && str)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; + val->uni.str = str; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawcpy(yyjson_mut_doc *doc, + const char *str) { + if (yyjson_likely(str)) return yyjson_mut_rawncpy(doc, str, strlen(str)); + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_rawncpy(yyjson_mut_doc *doc, + const char *str, + size_t len) { + if (yyjson_likely(doc && str)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + char *new_str = unsafe_yyjson_mut_strncpy(doc, str, len); + if (yyjson_likely(val && new_str)) { + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_RAW; + val->uni.str = new_str; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_null(yyjson_mut_doc *doc) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_NULL | YYJSON_SUBTYPE_NONE; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_true(yyjson_mut_doc *doc) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_TRUE; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_false(yyjson_mut_doc *doc) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_FALSE; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_bool(yyjson_mut_doc *doc, + bool _val) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_BOOL | (uint8_t)((uint8_t)_val << 3); + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_uint(yyjson_mut_doc *doc, + uint64_t num) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = num; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_sint(yyjson_mut_doc *doc, + int64_t num) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = num; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_int(yyjson_mut_doc *doc, + int64_t num) { + return yyjson_mut_sint(doc, num); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_real(yyjson_mut_doc *doc, + double num) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.f64 = num; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_str(yyjson_mut_doc *doc, + const char *str) { + if (yyjson_likely(str)) return yyjson_mut_strn(doc, str, strlen(str)); + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_strn(yyjson_mut_doc *doc, + const char *str, + size_t len) { + if (yyjson_likely(doc && str)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = str; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_strcpy(yyjson_mut_doc *doc, + const char *str) { + if (yyjson_likely(str)) return yyjson_mut_strncpy(doc, str, strlen(str)); + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_strncpy(yyjson_mut_doc *doc, + const char *str, + size_t len) { + if (yyjson_likely(doc && str)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + char *new_str = unsafe_yyjson_mut_strncpy(doc, str, len); + if (yyjson_likely(val && new_str)) { + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = new_str; + return val; + } + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Array API (Implementation) + *============================================================================*/ + +yyjson_api_inline size_t yyjson_mut_arr_size(yyjson_mut_val *arr) { + return yyjson_mut_is_arr(arr) ? unsafe_yyjson_get_len(arr) : 0; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get(yyjson_mut_val *arr, + size_t idx) { + if (yyjson_likely(idx < yyjson_mut_arr_size(arr))) { + yyjson_mut_val *val = (yyjson_mut_val *)arr->uni.ptr; + while (idx-- > 0) val = val->next; + return val->next; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get_first( + yyjson_mut_val *arr) { + if (yyjson_likely(yyjson_mut_arr_size(arr) > 0)) { + return ((yyjson_mut_val *)arr->uni.ptr)->next; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_get_last( + yyjson_mut_val *arr) { + if (yyjson_likely(yyjson_mut_arr_size(arr) > 0)) { + return ((yyjson_mut_val *)arr->uni.ptr); + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Array Iterator API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_mut_arr_iter_init(yyjson_mut_val *arr, + yyjson_mut_arr_iter *iter) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && iter)) { + iter->idx = 0; + iter->max = unsafe_yyjson_get_len(arr); + iter->cur = iter->max ? (yyjson_mut_val *)arr->uni.ptr : NULL; + iter->pre = NULL; + iter->arr = arr; + return true; + } + if (iter) memset(iter, 0, sizeof(yyjson_mut_arr_iter)); + return false; +} + +yyjson_api_inline yyjson_mut_arr_iter yyjson_mut_arr_iter_with( + yyjson_mut_val *arr) { + yyjson_mut_arr_iter iter; + yyjson_mut_arr_iter_init(arr, &iter); + return iter; +} + +yyjson_api_inline bool yyjson_mut_arr_iter_has_next(yyjson_mut_arr_iter *iter) { + return iter ? iter->idx < iter->max : false; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_iter_next( + yyjson_mut_arr_iter *iter) { + if (iter && iter->idx < iter->max) { + yyjson_mut_val *val = iter->cur; + iter->pre = val; + iter->cur = val->next; + iter->idx++; + return iter->cur; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_iter_remove( + yyjson_mut_arr_iter *iter) { + if (yyjson_likely(iter && 0 < iter->idx && iter->idx <= iter->max)) { + yyjson_mut_val *prev = iter->pre; + yyjson_mut_val *cur = iter->cur; + yyjson_mut_val *next = cur->next; + if (yyjson_unlikely(iter->idx == iter->max)) iter->arr->uni.ptr = prev; + iter->idx--; + iter->max--; + unsafe_yyjson_set_len(iter->arr, iter->max); + prev->next = next; + iter->cur = next; + return cur; + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Array Creation API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr(yyjson_mut_doc *doc) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_ARR | YYJSON_SUBTYPE_NONE; + return val; + } + } + return NULL; +} + +#define yyjson_mut_arr_with_func(func) \ + if (yyjson_likely(doc && ((0 < count && count < \ + (~(size_t)0) / sizeof(yyjson_mut_val) && vals) || count == 0))) { \ + yyjson_mut_val *arr = unsafe_yyjson_mut_val(doc, 1 + count); \ + if (yyjson_likely(arr)) { \ + arr->tag = ((uint64_t)count << YYJSON_TAG_BIT) | YYJSON_TYPE_ARR; \ + if (count > 0) { \ + size_t i; \ + for (i = 0; i < count; i++) { \ + yyjson_mut_val *val = arr + i + 1; \ + func \ + val->next = val + 1; \ + } \ + arr[count].next = arr + 1; \ + arr->uni.ptr = arr + count; \ + } \ + return arr; \ + } \ + } \ + return NULL + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_bool( + yyjson_mut_doc *doc, const bool *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_BOOL | (uint8_t)((uint8_t)vals[i] << 3); + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint( + yyjson_mut_doc *doc, const int64_t *vals, size_t count) { + return yyjson_mut_arr_with_sint64(doc, vals, count); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint( + yyjson_mut_doc *doc, const uint64_t *vals, size_t count) { + return yyjson_mut_arr_with_uint64(doc, vals, count); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_real( + yyjson_mut_doc *doc, const double *vals, size_t count) { + return yyjson_mut_arr_with_double(doc, vals, count); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint8( + yyjson_mut_doc *doc, const int8_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = (int64_t)vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint16( + yyjson_mut_doc *doc, const int16_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint32( + yyjson_mut_doc *doc, const int32_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_sint64( + yyjson_mut_doc *doc, const int64_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint8( + yyjson_mut_doc *doc, const uint8_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint16( + yyjson_mut_doc *doc, const uint16_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint32( + yyjson_mut_doc *doc, const uint32_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_uint64( + yyjson_mut_doc *doc, const uint64_t *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_float( + yyjson_mut_doc *doc, const float *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.f64 = (double)vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_double( + yyjson_mut_doc *doc, const double *vals, size_t count) { + yyjson_mut_arr_with_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.f64 = vals[i]; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_str( + yyjson_mut_doc *doc, const char **vals, size_t count) { + yyjson_mut_arr_with_func({ + uint64_t len = (uint64_t)strlen(vals[i]); + val->tag = (len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = vals[i]; + if (yyjson_unlikely(!val->uni.str)) return NULL; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strn( + yyjson_mut_doc *doc, const char **vals, const size_t *lens, size_t count) { + if (yyjson_unlikely(count > 0 && !lens)) return NULL; + yyjson_mut_arr_with_func({ + val->tag = ((uint64_t)lens[i] << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = vals[i]; + if (yyjson_unlikely(!val->uni.str)) return NULL; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strcpy( + yyjson_mut_doc *doc, const char **vals, size_t count) { + size_t len; + const char *str; + yyjson_mut_arr_with_func({ + str = vals[i]; + if (!str) return NULL; + len = strlen(str); + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = unsafe_yyjson_mut_strncpy(doc, str, len); + if (yyjson_unlikely(!val->uni.str)) return NULL; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_with_strncpy( + yyjson_mut_doc *doc, const char **vals, const size_t *lens, size_t count) { + size_t len; + const char *str; + if (yyjson_unlikely(count > 0 && !lens)) return NULL; + yyjson_mut_arr_with_func({ + str = vals[i]; + len = lens[i]; + val->tag = ((uint64_t)len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = unsafe_yyjson_mut_strncpy(doc, str, len); + if (yyjson_unlikely(!val->uni.str)) return NULL; + }); +} + +#undef yyjson_mut_arr_with_func + + + +/*============================================================================== + * Mutable JSON Array Modification API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_mut_arr_insert(yyjson_mut_val *arr, + yyjson_mut_val *val, size_t idx) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && val)) { + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_likely(idx <= len)) { + unsafe_yyjson_set_len(arr, len + 1); + if (len == 0) { + val->next = val; + arr->uni.ptr = val; + } else { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + if (idx == len) { + prev->next = val; + val->next = next; + arr->uni.ptr = val; + } else { + while (idx-- > 0) { + prev = next; + next = next->next; + } + prev->next = val; + val->next = next; + } + } + return true; + } + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_append(yyjson_mut_val *arr, + yyjson_mut_val *val) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && val)) { + size_t len = unsafe_yyjson_get_len(arr); + unsafe_yyjson_set_len(arr, len + 1); + if (len == 0) { + val->next = val; + } else { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + prev->next = val; + val->next = next; + } + arr->uni.ptr = val; + return true; + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_prepend(yyjson_mut_val *arr, + yyjson_mut_val *val) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && val)) { + size_t len = unsafe_yyjson_get_len(arr); + unsafe_yyjson_set_len(arr, len + 1); + if (len == 0) { + val->next = val; + arr->uni.ptr = val; + } else { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + prev->next = val; + val->next = next; + } + return true; + } + return false; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_replace(yyjson_mut_val *arr, + size_t idx, + yyjson_mut_val *val) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && val)) { + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_likely(idx < len)) { + if (yyjson_likely(len > 1)) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + while (idx-- > 0) { + prev = next; + next = next->next; + } + prev->next = val; + val->next = next->next; + if ((void *)next == arr->uni.ptr) arr->uni.ptr = val; + return next; + } else { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + val->next = val; + arr->uni.ptr = val; + return prev; + } + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove(yyjson_mut_val *arr, + size_t idx) { + if (yyjson_likely(yyjson_mut_is_arr(arr))) { + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_likely(idx < len)) { + unsafe_yyjson_set_len(arr, len - 1); + if (yyjson_likely(len > 1)) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + while (idx-- > 0) { + prev = next; + next = next->next; + } + prev->next = next->next; + if ((void *)next == arr->uni.ptr) arr->uni.ptr = prev; + return next; + } else { + return ((yyjson_mut_val *)arr->uni.ptr); + } + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove_first( + yyjson_mut_val *arr) { + if (yyjson_likely(yyjson_mut_is_arr(arr))) { + size_t len = unsafe_yyjson_get_len(arr); + if (len > 1) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + prev->next = next->next; + unsafe_yyjson_set_len(arr, len - 1); + return next; + } else if (len == 1) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + unsafe_yyjson_set_len(arr, 0); + return prev; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_remove_last( + yyjson_mut_val *arr) { + if (yyjson_likely(yyjson_mut_is_arr(arr))) { + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_likely(len > 1)) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + yyjson_mut_val *next = prev->next; + unsafe_yyjson_set_len(arr, len - 1); + while (--len > 0) prev = prev->next; + prev->next = next; + next = (yyjson_mut_val *)arr->uni.ptr; + arr->uni.ptr = prev; + return next; + } else if (len == 1) { + yyjson_mut_val *prev = ((yyjson_mut_val *)arr->uni.ptr); + unsafe_yyjson_set_len(arr, 0); + return prev; + } + } + return NULL; +} + +yyjson_api_inline bool yyjson_mut_arr_remove_range(yyjson_mut_val *arr, + size_t _idx, size_t _len) { + if (yyjson_likely(yyjson_mut_is_arr(arr))) { + yyjson_mut_val *prev, *next; + bool tail_removed; + size_t len = unsafe_yyjson_get_len(arr); + if (yyjson_unlikely(_idx + _len > len)) return false; + if (yyjson_unlikely(_len == 0)) return true; + unsafe_yyjson_set_len(arr, len - _len); + if (yyjson_unlikely(len == _len)) return true; + tail_removed = (_idx + _len == len); + prev = ((yyjson_mut_val *)arr->uni.ptr); + while (_idx-- > 0) prev = prev->next; + next = prev->next; + while (_len-- > 0) next = next->next; + prev->next = next; + if (yyjson_unlikely(tail_removed)) arr->uni.ptr = prev; + return true; + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_clear(yyjson_mut_val *arr) { + if (yyjson_likely(yyjson_mut_is_arr(arr))) { + unsafe_yyjson_set_len(arr, 0); + return true; + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_rotate(yyjson_mut_val *arr, + size_t idx) { + if (yyjson_likely(yyjson_mut_is_arr(arr) && + unsafe_yyjson_get_len(arr) > idx)) { + yyjson_mut_val *val = (yyjson_mut_val *)arr->uni.ptr; + while (idx-- > 0) val = val->next; + arr->uni.ptr = (void *)val; + return true; + } + return false; +} + + + +/*============================================================================== + * Mutable JSON Array Modification Convenience API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_mut_arr_add_val(yyjson_mut_val *arr, + yyjson_mut_val *val) { + return yyjson_mut_arr_append(arr, val); +} + +yyjson_api_inline bool yyjson_mut_arr_add_null(yyjson_mut_doc *doc, + yyjson_mut_val *arr) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_null(doc); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_true(yyjson_mut_doc *doc, + yyjson_mut_val *arr) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_true(doc); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_false(yyjson_mut_doc *doc, + yyjson_mut_val *arr) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_false(doc); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_bool(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + bool _val) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_bool(doc, _val); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_uint(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + uint64_t num) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_uint(doc, num); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_sint(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + int64_t num) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_sint(doc, num); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_int(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + int64_t num) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_sint(doc, num); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_real(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + double num) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_real(doc, num); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_str(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_str(doc, str); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_strn(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str, size_t len) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_strn(doc, str, len); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_strcpy(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_strcpy(doc, str); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_arr_add_strncpy(yyjson_mut_doc *doc, + yyjson_mut_val *arr, + const char *str, size_t len) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_strncpy(doc, str, len); + return yyjson_mut_arr_append(arr, val); + } + return false; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_add_arr(yyjson_mut_doc *doc, + yyjson_mut_val *arr) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_arr(doc); + return yyjson_mut_arr_append(arr, val) ? val : NULL; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_arr_add_obj(yyjson_mut_doc *doc, + yyjson_mut_val *arr) { + if (yyjson_likely(doc && yyjson_mut_is_arr(arr))) { + yyjson_mut_val *val = yyjson_mut_obj(doc); + return yyjson_mut_arr_append(arr, val) ? val : NULL; + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Object API (Implementation) + *============================================================================*/ + +yyjson_api_inline size_t yyjson_mut_obj_size(yyjson_mut_val *obj) { + return yyjson_mut_is_obj(obj) ? unsafe_yyjson_get_len(obj) : 0; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_get(yyjson_mut_val *obj, + const char *key) { + return yyjson_mut_obj_getn(obj, key, key ? strlen(key) : 0); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_getn(yyjson_mut_val *obj, + const char *_key, + size_t key_len) { + uint64_t tag = (((uint64_t)key_len) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + size_t len = yyjson_mut_obj_size(obj); + if (yyjson_likely(len && _key)) { + yyjson_mut_val *key = ((yyjson_mut_val *)obj->uni.ptr)->next->next; + while (len-- > 0) { + if (key->tag == tag && + memcmp(key->uni.ptr, _key, key_len) == 0) { + return key->next; + } + key = key->next->next; + } + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Object Iterator API (Implementation) + *============================================================================*/ + +yyjson_api_inline bool yyjson_mut_obj_iter_init(yyjson_mut_val *obj, + yyjson_mut_obj_iter *iter) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && iter)) { + iter->idx = 0; + iter->max = unsafe_yyjson_get_len(obj); + iter->cur = iter->max ? (yyjson_mut_val *)obj->uni.ptr : NULL; + iter->pre = NULL; + iter->obj = obj; + return true; + } + if (iter) memset(iter, 0, sizeof(yyjson_mut_obj_iter)); + return false; +} + +yyjson_api_inline yyjson_mut_obj_iter yyjson_mut_obj_iter_with( + yyjson_mut_val *obj) { + yyjson_mut_obj_iter iter; + yyjson_mut_obj_iter_init(obj, &iter); + return iter; +} + +yyjson_api_inline bool yyjson_mut_obj_iter_has_next(yyjson_mut_obj_iter *iter) { + return iter ? iter->idx < iter->max : false; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_next( + yyjson_mut_obj_iter *iter) { + if (iter && iter->idx < iter->max) { + yyjson_mut_val *key = iter->cur; + iter->pre = key; + iter->cur = key->next->next; + iter->idx++; + return iter->cur; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_get_val( + yyjson_mut_val *key) { + return key ? key->next : NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_remove( + yyjson_mut_obj_iter *iter) { + if (yyjson_likely(iter && 0 < iter->idx && iter->idx <= iter->max)) { + yyjson_mut_val *prev = iter->pre; + yyjson_mut_val *cur = iter->cur; + yyjson_mut_val *next = cur->next->next; + if (yyjson_unlikely(iter->idx == iter->max)) iter->obj->uni.ptr = prev; + iter->idx--; + iter->max--; + unsafe_yyjson_set_len(iter->obj, iter->max); + prev->next->next = next; + iter->cur = prev; + return cur->next; + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_get( + yyjson_mut_obj_iter *iter, const char *key) { + return yyjson_mut_obj_iter_getn(iter, key, key ? strlen(key) : 0); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_iter_getn( + yyjson_mut_obj_iter *iter, const char *key, size_t key_len) { + if (iter && key) { + size_t idx = 0; + size_t max = iter->max; + yyjson_mut_val *pre, *cur = iter->cur; + while (idx++ < max) { + pre = cur; + cur = cur->next->next; + if (unsafe_yyjson_get_len(cur) == key_len && + memcmp(cur->uni.str, key, key_len) == 0) { + iter->idx += idx; + if (iter->idx > max) iter->idx -= max + 1; + iter->pre = pre; + iter->cur = cur; + return cur->next; + } + } + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Object Creation API (Implementation) + *============================================================================*/ + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj(yyjson_mut_doc *doc) { + if (yyjson_likely(doc)) { + yyjson_mut_val *val = unsafe_yyjson_mut_val(doc, 1); + if (yyjson_likely(val)) { + val->tag = YYJSON_TYPE_OBJ | YYJSON_SUBTYPE_NONE; + return val; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_with_str(yyjson_mut_doc *doc, + const char **keys, + const char **vals, + size_t count) { + if (yyjson_likely(doc && ((count > 0 && keys && vals) || (count == 0)))) { + yyjson_mut_val *obj = unsafe_yyjson_mut_val(doc, 1 + count * 2); + if (yyjson_likely(obj)) { + obj->tag = ((uint64_t)count << YYJSON_TAG_BIT) | YYJSON_TYPE_OBJ; + if (count > 0) { + size_t i; + for (i = 0; i < count; i++) { + yyjson_mut_val *key = obj + (i * 2 + 1); + yyjson_mut_val *val = obj + (i * 2 + 2); + uint64_t key_len = (uint64_t)strlen(keys[i]); + uint64_t val_len = (uint64_t)strlen(vals[i]); + key->tag = (key_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->tag = (val_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + key->uni.str = keys[i]; + val->uni.str = vals[i]; + key->next = val; + val->next = val + 1; + } + obj[count * 2].next = obj + 1; + obj->uni.ptr = obj + (count * 2 - 1); + } + return obj; + } + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_with_kv(yyjson_mut_doc *doc, + const char **pairs, + size_t count) { + if (yyjson_likely(doc && ((count > 0 && pairs) || (count == 0)))) { + yyjson_mut_val *obj = unsafe_yyjson_mut_val(doc, 1 + count * 2); + if (yyjson_likely(obj)) { + obj->tag = ((uint64_t)count << YYJSON_TAG_BIT) | YYJSON_TYPE_OBJ; + if (count > 0) { + size_t i; + for (i = 0; i < count; i++) { + yyjson_mut_val *key = obj + (i * 2 + 1); + yyjson_mut_val *val = obj + (i * 2 + 2); + const char *key_str = pairs[i * 2 + 0]; + const char *val_str = pairs[i * 2 + 1]; + uint64_t key_len = (uint64_t)strlen(key_str); + uint64_t val_len = (uint64_t)strlen(val_str); + key->tag = (key_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->tag = (val_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + key->uni.str = key_str; + val->uni.str = val_str; + key->next = val; + val->next = val + 1; + } + obj[count * 2].next = obj + 1; + obj->uni.ptr = obj + (count * 2 - 1); + } + return obj; + } + } + return NULL; +} + + + +/*============================================================================== + * Mutable JSON Object Modification API (Implementation) + *============================================================================*/ + +yyjson_api_inline void unsafe_yyjson_mut_obj_add(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val, + size_t len) { + if (yyjson_likely(len)) { + yyjson_mut_val *prev_val = ((yyjson_mut_val *)obj->uni.ptr)->next; + yyjson_mut_val *next_key = prev_val->next; + prev_val->next = key; + val->next = next_key; + } else { + val->next = key; + } + key->next = val; + obj->uni.ptr = (void *)key; + unsafe_yyjson_set_len(obj, len + 1); +} + +yyjson_api_inline yyjson_mut_val *unsafe_yyjson_mut_obj_remove( + yyjson_mut_val *obj, const char *key, size_t key_len, uint64_t key_tag) { + size_t obj_len = unsafe_yyjson_get_len(obj); + if (obj_len) { + yyjson_mut_val *pre_key = (yyjson_mut_val *)obj->uni.ptr; + yyjson_mut_val *cur_key = pre_key->next->next; + yyjson_mut_val *removed_item = NULL; + size_t i; + for (i = 0; i < obj_len; i++) { + if (key_tag == cur_key->tag && + memcmp(key, cur_key->uni.ptr, key_len) == 0) { + if (!removed_item) removed_item = cur_key->next; + cur_key = cur_key->next->next; + pre_key->next->next = cur_key; + if (i + 1 == obj_len) obj->uni.ptr = pre_key; + i--; + obj_len--; + } else { + pre_key = cur_key; + cur_key = cur_key->next->next; + } + } + unsafe_yyjson_set_len(obj, obj_len); + return removed_item; + } else { + return NULL; + } +} + +yyjson_api_inline bool unsafe_yyjson_mut_obj_replace(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val) { + size_t key_len = unsafe_yyjson_get_len(key); + size_t obj_len = unsafe_yyjson_get_len(obj); + if (obj_len) { + yyjson_mut_val *pre_key = (yyjson_mut_val *)obj->uni.ptr; + yyjson_mut_val *cur_key = pre_key->next->next; + size_t i; + for (i = 0; i < obj_len; i++) { + if (key->tag == cur_key->tag && + memcmp(key->uni.str, cur_key->uni.ptr, key_len) == 0) { + cur_key->next->tag = val->tag; + cur_key->next->uni.u64 = val->uni.u64; + return true; + } else { + cur_key = cur_key->next->next; + } + } + } + return false; +} + +yyjson_api_inline void unsafe_yyjson_mut_obj_rotate(yyjson_mut_val *obj, + size_t idx) { + yyjson_mut_val *key = (yyjson_mut_val *)obj->uni.ptr; + while (idx-- > 0) key = key->next->next; + obj->uni.ptr = (void *)key; +} + +yyjson_api_inline bool yyjson_mut_obj_add(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && + yyjson_mut_is_str(key) && val)) { + unsafe_yyjson_mut_obj_add(obj, key, val, unsafe_yyjson_get_len(obj)); + return true; + } + return false; +} + +yyjson_api_inline bool yyjson_mut_obj_put(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val) { + bool replaced = false; + size_t key_len; + yyjson_mut_obj_iter iter; + yyjson_mut_val *cur_key; + if (yyjson_unlikely(!yyjson_mut_is_obj(obj) || + !yyjson_mut_is_str(key))) return false; + key_len = unsafe_yyjson_get_len(key); + yyjson_mut_obj_iter_init(obj, &iter); + while ((cur_key = yyjson_mut_obj_iter_next(&iter))) { + if (key->tag == cur_key->tag && + memcmp(key->uni.str, cur_key->uni.ptr, key_len) == 0) { + if (!replaced && val) { + replaced = true; + val->next = cur_key->next->next; + cur_key->next = val; + } else { + yyjson_mut_obj_iter_remove(&iter); + } + } + } + if (!replaced && val) unsafe_yyjson_mut_obj_add(obj, key, val, iter.max); + return true; +} + +yyjson_api_inline bool yyjson_mut_obj_insert(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val, + size_t idx) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && + yyjson_mut_is_str(key) && val)) { + size_t len = unsafe_yyjson_get_len(obj); + if (yyjson_likely(len >= idx)) { + if (len > idx) { + void *ptr = obj->uni.ptr; + unsafe_yyjson_mut_obj_rotate(obj, idx); + unsafe_yyjson_mut_obj_add(obj, key, val, len); + obj->uni.ptr = ptr; + } else { + unsafe_yyjson_mut_obj_add(obj, key, val, len); + } + return true; + } + } + return false; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove(yyjson_mut_val *obj, + yyjson_mut_val *key) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && yyjson_mut_is_str(key))) { + return unsafe_yyjson_mut_obj_remove(obj, key->uni.str, + unsafe_yyjson_get_len(key), + key->tag); + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_key( + yyjson_mut_val *obj, const char *key) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && key)) { + size_t key_len = strlen(key); + uint64_t tag = ((uint64_t)key_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + return unsafe_yyjson_mut_obj_remove(obj, key, key_len, tag); + } + return NULL; +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_keyn( + yyjson_mut_val *obj, const char *key, size_t key_len) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && key)) { + uint64_t tag = ((uint64_t)key_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + return unsafe_yyjson_mut_obj_remove(obj, key, key_len, tag); + } + return NULL; +} + +yyjson_api_inline bool yyjson_mut_obj_clear(yyjson_mut_val *obj) { + if (yyjson_likely(yyjson_mut_is_obj(obj))) { + unsafe_yyjson_set_len(obj, 0); + return true; + } + return false; +} + +yyjson_api_inline bool yyjson_mut_obj_replace(yyjson_mut_val *obj, + yyjson_mut_val *key, + yyjson_mut_val *val) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && + yyjson_mut_is_str(key) && val)) { + return unsafe_yyjson_mut_obj_replace(obj, key, val); + } + return false; +} + +yyjson_api_inline bool yyjson_mut_obj_rotate(yyjson_mut_val *obj, + size_t idx) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && + unsafe_yyjson_get_len(obj) > idx)) { + unsafe_yyjson_mut_obj_rotate(obj, idx); + return true; + } + return false; +} + + + +/*============================================================================== + * Mutable JSON Object Modification Convenience API (Implementation) + *============================================================================*/ + +#define yyjson_mut_obj_add_func(func) \ + if (yyjson_likely(doc && yyjson_mut_is_obj(obj) && _key)) { \ + yyjson_mut_val *key = unsafe_yyjson_mut_val(doc, 2); \ + if (yyjson_likely(key)) { \ + size_t len = unsafe_yyjson_get_len(obj); \ + yyjson_mut_val *val = key + 1; \ + key->tag = YYJSON_TYPE_STR | YYJSON_SUBTYPE_NONE; \ + key->tag |= (uint64_t)strlen(_key) << YYJSON_TAG_BIT; \ + key->uni.str = _key; \ + func \ + unsafe_yyjson_mut_obj_add(obj, key, val, len); \ + return true; \ + } \ + } \ + return false + +yyjson_api_inline bool yyjson_mut_obj_add_null(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_NULL | YYJSON_SUBTYPE_NONE; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_true(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_TRUE; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_false(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_BOOL | YYJSON_SUBTYPE_FALSE; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_bool(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + bool _val) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_BOOL | (uint8_t)((uint8_t)(_val) << 3); + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_uint(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + uint64_t _val) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_UINT; + val->uni.u64 = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_sint(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + int64_t _val) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_int(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + int64_t _val) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_SINT; + val->uni.i64 = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_real(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + double _val) { + yyjson_mut_obj_add_func({ + val->tag = YYJSON_TYPE_NUM | YYJSON_SUBTYPE_REAL; + val->uni.f64 = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_str(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + const char *_val) { + if (yyjson_unlikely(!_val)) return false; + yyjson_mut_obj_add_func({ + val->tag = ((uint64_t)strlen(_val) << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_strn(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + const char *_val, + size_t _len) { + if (yyjson_unlikely(!_val)) return false; + yyjson_mut_obj_add_func({ + val->tag = ((uint64_t)_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + val->uni.str = _val; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_strcpy(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + const char *_val) { + if (yyjson_unlikely(!_val)) return false; + yyjson_mut_obj_add_func({ + size_t _len = strlen(_val); + val->uni.str = unsafe_yyjson_mut_strncpy(doc, _val, _len); + if (yyjson_unlikely(!val->uni.str)) return false; + val->tag = ((uint64_t)_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_strncpy(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + const char *_val, + size_t _len) { + if (yyjson_unlikely(!_val)) return false; + yyjson_mut_obj_add_func({ + val->uni.str = unsafe_yyjson_mut_strncpy(doc, _val, _len); + if (yyjson_unlikely(!val->uni.str)) return false; + val->tag = ((uint64_t)_len << YYJSON_TAG_BIT) | YYJSON_TYPE_STR; + }); +} + +yyjson_api_inline bool yyjson_mut_obj_add_val(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *_key, + yyjson_mut_val *_val) { + if (yyjson_unlikely(!_val)) return false; + yyjson_mut_obj_add_func({ + val = _val; + }); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_str(yyjson_mut_val *obj, + const char *key) { + return yyjson_mut_obj_remove_strn(obj, key, key ? strlen(key) : 0); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_obj_remove_strn( + yyjson_mut_val *obj, const char *_key, size_t _len) { + if (yyjson_likely(yyjson_mut_is_obj(obj) && _key)) { + yyjson_mut_val *key; + yyjson_mut_obj_iter iter; + yyjson_mut_val *val_removed = NULL; + yyjson_mut_obj_iter_init(obj, &iter); + while ((key = yyjson_mut_obj_iter_next(&iter)) != NULL) { + if (unsafe_yyjson_get_len(key) == _len && + memcmp(key->uni.str, _key, _len) == 0) { + if (!val_removed) val_removed = key->next; + yyjson_mut_obj_iter_remove(&iter); + } + } + return val_removed; + } + return NULL; +} + +yyjson_api_inline bool yyjson_mut_obj_rename_key(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + const char *new_key) { + if (!key || !new_key) return false; + return yyjson_mut_obj_rename_keyn(doc, obj, key, strlen(key), + new_key, strlen(new_key)); +} + +yyjson_api_inline bool yyjson_mut_obj_rename_keyn(yyjson_mut_doc *doc, + yyjson_mut_val *obj, + const char *key, + size_t len, + const char *new_key, + size_t new_len) { + char *cpy_key = NULL; + yyjson_mut_val *old_key; + yyjson_mut_obj_iter iter; + if (!doc || !obj || !key || !new_key) return false; + yyjson_mut_obj_iter_init(obj, &iter); + while ((old_key = yyjson_mut_obj_iter_next(&iter))) { + if (unsafe_yyjson_equals_strn((void *)old_key, key, len)) { + if (!cpy_key) { + cpy_key = unsafe_yyjson_mut_strncpy(doc, new_key, new_len); + if (!cpy_key) return false; + } + yyjson_mut_set_strn(old_key, cpy_key, new_len); + } + } + return cpy_key != NULL; +} + + + +/*============================================================================== + * JSON Pointer API (Implementation) + *============================================================================*/ + +#define yyjson_ptr_set_err(_code, _msg) do { \ + if (err) { \ + err->code = YYJSON_PTR_ERR_##_code; \ + err->msg = _msg; \ + err->pos = 0; \ + } \ +} while(false) + +/* require: val != NULL, *ptr == '/', len > 0 */ +yyjson_api yyjson_val *unsafe_yyjson_ptr_getx(yyjson_val *val, + const char *ptr, size_t len, + yyjson_ptr_err *err); + +/* require: val != NULL, *ptr == '/', len > 0 */ +yyjson_api yyjson_mut_val *unsafe_yyjson_mut_ptr_getx(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/* require: val/new_val/doc != NULL, *ptr == '/', len > 0 */ +yyjson_api bool unsafe_yyjson_mut_ptr_putx(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, bool insert_new, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +/* require: val/err != NULL, *ptr == '/', len > 0 */ +yyjson_api yyjson_mut_val *unsafe_yyjson_mut_ptr_replacex( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err); + +/* require: val/err != NULL, *ptr == '/', len > 0 */ +yyjson_api yyjson_mut_val *unsafe_yyjson_mut_ptr_removex(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err); + +yyjson_api_inline yyjson_val *yyjson_doc_ptr_get(yyjson_doc *doc, + const char *ptr) { + if (yyjson_unlikely(!ptr)) return NULL; + return yyjson_doc_ptr_getn(doc, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_val *yyjson_doc_ptr_getn(yyjson_doc *doc, + const char *ptr, size_t len) { + return yyjson_doc_ptr_getx(doc, ptr, len, NULL); +} + +yyjson_api_inline yyjson_val *yyjson_doc_ptr_getx(yyjson_doc *doc, + const char *ptr, size_t len, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (yyjson_unlikely(!doc || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + return doc->root; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_ptr_getx(doc->root, ptr, len, err); +} + +yyjson_api_inline yyjson_val *yyjson_ptr_get(yyjson_val *val, + const char *ptr) { + if (yyjson_unlikely(!ptr)) return NULL; + return yyjson_ptr_getn(val, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_val *yyjson_ptr_getn(yyjson_val *val, + const char *ptr, size_t len) { + return yyjson_ptr_getx(val, ptr, len, NULL); +} + +yyjson_api_inline yyjson_val *yyjson_ptr_getx(yyjson_val *val, + const char *ptr, size_t len, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (yyjson_unlikely(!val || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + return val; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_ptr_getx(val, ptr, len, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_get(yyjson_mut_doc *doc, + const char *ptr) { + if (!ptr) return NULL; + return yyjson_mut_doc_ptr_getn(doc, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_getn(yyjson_mut_doc *doc, + const char *ptr, + size_t len) { + return yyjson_mut_doc_ptr_getx(doc, ptr, len, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_getx(yyjson_mut_doc *doc, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!doc || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + return doc->root; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_getx(doc->root, ptr, len, ctx, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_get(yyjson_mut_val *val, + const char *ptr) { + if (!ptr) return NULL; + return yyjson_mut_ptr_getn(val, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_getn(yyjson_mut_val *val, + const char *ptr, + size_t len) { + return yyjson_mut_ptr_getx(val, ptr, len, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_getx(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!val || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + return val; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_getx(val, ptr, len, ctx, err); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_add(yyjson_mut_doc *doc, + const char *ptr, + yyjson_mut_val *new_val) { + if (yyjson_unlikely(!ptr)) return false; + return yyjson_mut_doc_ptr_addn(doc, ptr, strlen(ptr), new_val); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_addn(yyjson_mut_doc *doc, + const char *ptr, + size_t len, + yyjson_mut_val *new_val) { + return yyjson_mut_doc_ptr_addx(doc, ptr, len, new_val, true, NULL, NULL); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_addx(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!doc || !ptr || !new_val)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return false; + } + if (yyjson_unlikely(len == 0)) { + if (doc->root) { + yyjson_ptr_set_err(SET_ROOT, "cannot set document's root"); + return false; + } else { + doc->root = new_val; + return true; + } + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return false; + } + if (yyjson_unlikely(!doc->root && !create_parent)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return false; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_mut_val *root = yyjson_mut_obj(doc); + if (yyjson_unlikely(!root)) { + yyjson_ptr_set_err(MEMORY_ALLOCATION, "failed to create value"); + return false; + } + if (unsafe_yyjson_mut_ptr_putx(root, ptr, len, new_val, doc, + create_parent, true, ctx, err)) { + doc->root = root; + return true; + } + return false; + } + return unsafe_yyjson_mut_ptr_putx(doc->root, ptr, len, new_val, doc, + create_parent, true, ctx, err); +} + +yyjson_api_inline bool yyjson_mut_ptr_add(yyjson_mut_val *val, + const char *ptr, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc) { + if (yyjson_unlikely(!ptr)) return false; + return yyjson_mut_ptr_addn(val, ptr, strlen(ptr), new_val, doc); +} + +yyjson_api_inline bool yyjson_mut_ptr_addn(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc) { + return yyjson_mut_ptr_addx(val, ptr, len, new_val, doc, true, NULL, NULL); +} + +yyjson_api_inline bool yyjson_mut_ptr_addx(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!val || !ptr || !new_val || !doc)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return false; + } + if (yyjson_unlikely(len == 0)) { + yyjson_ptr_set_err(SET_ROOT, "cannot set root"); + return false; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return false; + } + return unsafe_yyjson_mut_ptr_putx(val, ptr, len, new_val, + doc, create_parent, true, ctx, err); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_set(yyjson_mut_doc *doc, + const char *ptr, + yyjson_mut_val *new_val) { + if (yyjson_unlikely(!ptr)) return false; + return yyjson_mut_doc_ptr_setn(doc, ptr, strlen(ptr), new_val); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_setn(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val) { + return yyjson_mut_doc_ptr_setx(doc, ptr, len, new_val, true, NULL, NULL); +} + +yyjson_api_inline bool yyjson_mut_doc_ptr_setx(yyjson_mut_doc *doc, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!doc || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return false; + } + if (yyjson_unlikely(len == 0)) { + if (ctx) ctx->old = doc->root; + doc->root = new_val; + return true; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return false; + } + if (!new_val) { + if (!doc->root) { + yyjson_ptr_set_err(RESOLVE, "JSON pointer cannot be resolved"); + return false; + } + return !!unsafe_yyjson_mut_ptr_removex(doc->root, ptr, len, ctx, err); + } + if (yyjson_unlikely(!doc->root && !create_parent)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return false; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_mut_val *root = yyjson_mut_obj(doc); + if (yyjson_unlikely(!root)) { + yyjson_ptr_set_err(MEMORY_ALLOCATION, "failed to create value"); + return false; + } + if (unsafe_yyjson_mut_ptr_putx(root, ptr, len, new_val, doc, + create_parent, false, ctx, err)) { + doc->root = root; + return true; + } + return false; + } + return unsafe_yyjson_mut_ptr_putx(doc->root, ptr, len, new_val, doc, + create_parent, false, ctx, err); +} + +yyjson_api_inline bool yyjson_mut_ptr_set(yyjson_mut_val *val, + const char *ptr, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc) { + if (yyjson_unlikely(!ptr)) return false; + return yyjson_mut_ptr_setn(val, ptr, strlen(ptr), new_val, doc); +} + +yyjson_api_inline bool yyjson_mut_ptr_setn(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc) { + return yyjson_mut_ptr_setx(val, ptr, len, new_val, doc, true, NULL, NULL); +} + +yyjson_api_inline bool yyjson_mut_ptr_setx(yyjson_mut_val *val, + const char *ptr, size_t len, + yyjson_mut_val *new_val, + yyjson_mut_doc *doc, + bool create_parent, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!val || !ptr || !doc)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return false; + } + if (yyjson_unlikely(len == 0)) { + yyjson_ptr_set_err(SET_ROOT, "cannot set root"); + return false; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return false; + } + if (!new_val) { + return !!unsafe_yyjson_mut_ptr_removex(val, ptr, len, ctx, err); + } + return unsafe_yyjson_mut_ptr_putx(val, ptr, len, new_val, doc, + create_parent, false, ctx, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replace( + yyjson_mut_doc *doc, const char *ptr, yyjson_mut_val *new_val) { + if (!ptr) return NULL; + return yyjson_mut_doc_ptr_replacen(doc, ptr, strlen(ptr), new_val); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replacen( + yyjson_mut_doc *doc, const char *ptr, size_t len, yyjson_mut_val *new_val) { + return yyjson_mut_doc_ptr_replacex(doc, ptr, len, new_val, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_replacex( + yyjson_mut_doc *doc, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err) { + + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!doc || !ptr || !new_val)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + yyjson_mut_val *root = doc->root; + if (yyjson_unlikely(!root)) { + yyjson_ptr_set_err(RESOLVE, "JSON pointer cannot be resolved"); + return NULL; + } + if (ctx) ctx->old = root; + doc->root = new_val; + return root; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return NULL; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_replacex(doc->root, ptr, len, new_val, + ctx, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replace( + yyjson_mut_val *val, const char *ptr, yyjson_mut_val *new_val) { + if (!ptr) return NULL; + return yyjson_mut_ptr_replacen(val, ptr, strlen(ptr), new_val); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replacen( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val) { + return yyjson_mut_ptr_replacex(val, ptr, len, new_val, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_replacex( + yyjson_mut_val *val, const char *ptr, size_t len, yyjson_mut_val *new_val, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err) { + + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!val || !ptr || !new_val)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + yyjson_ptr_set_err(SET_ROOT, "cannot set root"); + return NULL; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_replacex(val, ptr, len, new_val, ctx, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_remove( + yyjson_mut_doc *doc, const char *ptr) { + if (!ptr) return NULL; + return yyjson_mut_doc_ptr_removen(doc, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_removen( + yyjson_mut_doc *doc, const char *ptr, size_t len) { + return yyjson_mut_doc_ptr_removex(doc, ptr, len, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_ptr_removex( + yyjson_mut_doc *doc, const char *ptr, size_t len, + yyjson_ptr_ctx *ctx, yyjson_ptr_err *err) { + + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!doc || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(!doc->root)) { + yyjson_ptr_set_err(NULL_ROOT, "document's root is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + yyjson_mut_val *root = doc->root; + if (ctx) ctx->old = root; + doc->root = NULL; + return root; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_removex(doc->root, ptr, len, ctx, err); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_remove(yyjson_mut_val *val, + const char *ptr) { + if (!ptr) return NULL; + return yyjson_mut_ptr_removen(val, ptr, strlen(ptr)); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_removen(yyjson_mut_val *val, + const char *ptr, + size_t len) { + return yyjson_mut_ptr_removex(val, ptr, len, NULL, NULL); +} + +yyjson_api_inline yyjson_mut_val *yyjson_mut_ptr_removex(yyjson_mut_val *val, + const char *ptr, + size_t len, + yyjson_ptr_ctx *ctx, + yyjson_ptr_err *err) { + yyjson_ptr_set_err(NONE, NULL); + if (ctx) memset(ctx, 0, sizeof(*ctx)); + + if (yyjson_unlikely(!val || !ptr)) { + yyjson_ptr_set_err(PARAMETER, "input parameter is NULL"); + return NULL; + } + if (yyjson_unlikely(len == 0)) { + yyjson_ptr_set_err(SET_ROOT, "cannot set root"); + return NULL; + } + if (yyjson_unlikely(*ptr != '/')) { + yyjson_ptr_set_err(SYNTAX, "no prefix '/'"); + return NULL; + } + return unsafe_yyjson_mut_ptr_removex(val, ptr, len, ctx, err); +} + +yyjson_api_inline bool yyjson_ptr_ctx_append(yyjson_ptr_ctx *ctx, + yyjson_mut_val *key, + yyjson_mut_val *val) { + yyjson_mut_val *ctn, *pre_key, *pre_val, *cur_key, *cur_val; + if (!ctx || !ctx->ctn || !val) return false; + ctn = ctx->ctn; + + if (yyjson_mut_is_obj(ctn)) { + if (!key) return false; + key->next = val; + pre_key = ctx->pre; + if (unsafe_yyjson_get_len(ctn) == 0) { + val->next = key; + ctn->uni.ptr = key; + ctx->pre = key; + } else if (!pre_key) { + pre_key = (yyjson_mut_val *)ctn->uni.ptr; + pre_val = pre_key->next; + val->next = pre_val->next; + pre_val->next = key; + ctn->uni.ptr = key; + ctx->pre = pre_key; + } else { + cur_key = pre_key->next->next; + cur_val = cur_key->next; + val->next = cur_val->next; + cur_val->next = key; + if (ctn->uni.ptr == cur_key) ctn->uni.ptr = key; + ctx->pre = cur_key; + } + } else { + pre_val = ctx->pre; + if (unsafe_yyjson_get_len(ctn) == 0) { + val->next = val; + ctn->uni.ptr = val; + ctx->pre = val; + } else if (!pre_val) { + pre_val = (yyjson_mut_val *)ctn->uni.ptr; + val->next = pre_val->next; + pre_val->next = val; + ctn->uni.ptr = val; + ctx->pre = pre_val; + } else { + cur_val = pre_val->next; + val->next = cur_val->next; + cur_val->next = val; + if (ctn->uni.ptr == cur_val) ctn->uni.ptr = val; + ctx->pre = cur_val; + } + } + unsafe_yyjson_inc_len(ctn); + return true; +} + +yyjson_api_inline bool yyjson_ptr_ctx_replace(yyjson_ptr_ctx *ctx, + yyjson_mut_val *val) { + yyjson_mut_val *ctn, *pre_key, *cur_key, *pre_val, *cur_val; + if (!ctx || !ctx->ctn || !ctx->pre || !val) return false; + ctn = ctx->ctn; + if (yyjson_mut_is_obj(ctn)) { + pre_key = ctx->pre; + pre_val = pre_key->next; + cur_key = pre_val->next; + cur_val = cur_key->next; + /* replace current value */ + cur_key->next = val; + val->next = cur_val->next; + ctx->old = cur_val; + } else { + pre_val = ctx->pre; + cur_val = pre_val->next; + /* replace current value */ + if (pre_val != cur_val) { + val->next = cur_val->next; + pre_val->next = val; + if (ctn->uni.ptr == cur_val) ctn->uni.ptr = val; + } else { + val->next = val; + ctn->uni.ptr = val; + ctx->pre = val; + } + ctx->old = cur_val; + } + return true; +} + +yyjson_api_inline bool yyjson_ptr_ctx_remove(yyjson_ptr_ctx *ctx) { + yyjson_mut_val *ctn, *pre_key, *pre_val, *cur_key, *cur_val; + size_t len; + if (!ctx || !ctx->ctn || !ctx->pre) return false; + ctn = ctx->ctn; + if (yyjson_mut_is_obj(ctn)) { + pre_key = ctx->pre; + pre_val = pre_key->next; + cur_key = pre_val->next; + cur_val = cur_key->next; + /* remove current key-value */ + pre_val->next = cur_val->next; + if (ctn->uni.ptr == cur_key) ctn->uni.ptr = pre_key; + ctx->pre = NULL; + ctx->old = cur_val; + } else { + pre_val = ctx->pre; + cur_val = pre_val->next; + /* remove current key-value */ + pre_val->next = cur_val->next; + if (ctn->uni.ptr == cur_val) ctn->uni.ptr = pre_val; + ctx->pre = NULL; + ctx->old = cur_val; + } + len = unsafe_yyjson_get_len(ctn) - 1; + if (len == 0) ctn->uni.ptr = NULL; + unsafe_yyjson_set_len(ctn, len); + return true; +} + +#undef yyjson_ptr_set_err + + + +/*============================================================================== + * JSON Value at Pointer API (Implementation) + *============================================================================*/ + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type bool. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_bool( + yyjson_val *root, const char *ptr, bool *value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_bool(val)) { + *value = unsafe_yyjson_get_bool(val); + return true; + } else { + return false; + } +} + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type uint. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_uint( + yyjson_val *root, const char *ptr, uint64_t *value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_uint(val)) { + *value = unsafe_yyjson_get_uint(val); + return true; + } else { + return false; + } +} + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type sint. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_sint( + yyjson_val *root, const char *ptr, int64_t *value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_sint(val)) { + *value = unsafe_yyjson_get_sint(val); + return true; + } else { + return false; + } +} + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type real. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_real( + yyjson_val *root, const char *ptr, double *value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_real(val)) { + *value = unsafe_yyjson_get_real(val); + return true; + } else { + return false; + } +} + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type sint, + uint or real. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_num( + yyjson_val *root, const char *ptr, double *value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_num(val)) { + *value = unsafe_yyjson_get_num(val); + return true; + } else { + return false; + } +} + +/** + Set provided `value` if the JSON Pointer (RFC 6901) exists and is type string. + Returns true if value at `ptr` exists and is the correct type, otherwise false. + */ +yyjson_api_inline bool yyjson_ptr_get_str( + yyjson_val *root, const char *ptr, const char **value) { + yyjson_val *val = yyjson_ptr_get(root, ptr); + if (value && yyjson_is_str(val)) { + *value = unsafe_yyjson_get_str(val); + return true; + } else { + return false; + } +} + + + +/*============================================================================== + * Deprecated + *============================================================================*/ + +/** @deprecated renamed to `yyjson_doc_ptr_get` */ +yyjson_deprecated("renamed to yyjson_doc_ptr_get") +yyjson_api_inline yyjson_val *yyjson_doc_get_pointer(yyjson_doc *doc, + const char *ptr) { + return yyjson_doc_ptr_get(doc, ptr); +} + +/** @deprecated renamed to `yyjson_doc_ptr_getn` */ +yyjson_deprecated("renamed to yyjson_doc_ptr_getn") +yyjson_api_inline yyjson_val *yyjson_doc_get_pointern(yyjson_doc *doc, + const char *ptr, + size_t len) { + return yyjson_doc_ptr_getn(doc, ptr, len); +} + +/** @deprecated renamed to `yyjson_mut_doc_ptr_get` */ +yyjson_deprecated("renamed to yyjson_mut_doc_ptr_get") +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_get_pointer( + yyjson_mut_doc *doc, const char *ptr) { + return yyjson_mut_doc_ptr_get(doc, ptr); +} + +/** @deprecated renamed to `yyjson_mut_doc_ptr_getn` */ +yyjson_deprecated("renamed to yyjson_mut_doc_ptr_getn") +yyjson_api_inline yyjson_mut_val *yyjson_mut_doc_get_pointern( + yyjson_mut_doc *doc, const char *ptr, size_t len) { + return yyjson_mut_doc_ptr_getn(doc, ptr, len); +} + +/** @deprecated renamed to `yyjson_ptr_get` */ +yyjson_deprecated("renamed to yyjson_ptr_get") +yyjson_api_inline yyjson_val *yyjson_get_pointer(yyjson_val *val, + const char *ptr) { + return yyjson_ptr_get(val, ptr); +} + +/** @deprecated renamed to `yyjson_ptr_getn` */ +yyjson_deprecated("renamed to yyjson_ptr_getn") +yyjson_api_inline yyjson_val *yyjson_get_pointern(yyjson_val *val, + const char *ptr, + size_t len) { + return yyjson_ptr_getn(val, ptr, len); +} + +/** @deprecated renamed to `yyjson_mut_ptr_get` */ +yyjson_deprecated("renamed to yyjson_mut_ptr_get") +yyjson_api_inline yyjson_mut_val *yyjson_mut_get_pointer(yyjson_mut_val *val, + const char *ptr) { + return yyjson_mut_ptr_get(val, ptr); +} + +/** @deprecated renamed to `yyjson_mut_ptr_getn` */ +yyjson_deprecated("renamed to yyjson_mut_ptr_getn") +yyjson_api_inline yyjson_mut_val *yyjson_mut_get_pointern(yyjson_mut_val *val, + const char *ptr, + size_t len) { + return yyjson_mut_ptr_getn(val, ptr, len); +} + +/** @deprecated renamed to `yyjson_mut_ptr_getn` */ +yyjson_deprecated("renamed to unsafe_yyjson_ptr_getn") +yyjson_api_inline yyjson_val *unsafe_yyjson_get_pointer(yyjson_val *val, + const char *ptr, + size_t len) { + yyjson_ptr_err err; + return unsafe_yyjson_ptr_getx(val, ptr, len, &err); +} + +/** @deprecated renamed to `unsafe_yyjson_mut_ptr_getx` */ +yyjson_deprecated("renamed to unsafe_yyjson_mut_ptr_getx") +yyjson_api_inline yyjson_mut_val *unsafe_yyjson_mut_get_pointer( + yyjson_mut_val *val, const char *ptr, size_t len) { + yyjson_ptr_err err; + return unsafe_yyjson_mut_ptr_getx(val, ptr, len, NULL, &err); +} + + + +/*============================================================================== + * Compiler Hint End + *============================================================================*/ + +#if defined(__clang__) +# pragma clang diagnostic pop +#elif defined(__GNUC__) +# if (__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6) +# pragma GCC diagnostic pop +# endif +#elif defined(_MSC_VER) +# pragma warning(pop) +#endif /* warning suppress end */ + +#ifdef __cplusplus +} +#endif /* extern "C" end */ + +#endif /* YYJSON_H */ diff --git a/Lib/OnnxRuntimeDmlProvider/.signature.p7s b/Lib/OnnxRuntimeDmlProvider/.signature.p7s new file mode 100644 index 0000000000000000000000000000000000000000..723b27d9ade926558fad3557adcce4ab84be2206 GIT binary patch literal 11402 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 A^#A|> literal 0 HcmV?d00001 diff --git a/Lib/OnnxRuntimeDmlProvider/LICENSE.txt b/Lib/OnnxRuntimeDmlProvider/LICENSE.txt new file mode 100644 index 0000000..48bc6bb --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/LICENSE.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) Microsoft Corporation + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Lib/OnnxRuntimeDmlProvider/Microsoft.ML.OnnxRuntime.DirectML.nuspec b/Lib/OnnxRuntimeDmlProvider/Microsoft.ML.OnnxRuntime.DirectML.nuspec new file mode 100644 index 0000000..4797b2d --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/Microsoft.ML.OnnxRuntime.DirectML.nuspec @@ -0,0 +1,39 @@ + + + + Microsoft.ML.OnnxRuntime.DirectML + 1.15.0 + Microsoft + Microsoft + false + LICENSE.txt + https://aka.ms/deprecateLicenseUrl + ORT_icon_for_light_bg.png + https://github.com/Microsoft/onnxruntime + This package contains native shared library artifacts for all supported platforms of ONNX Runtime. + Release Def: + Branch: refs/heads/rel-1.15.0 + Commit: ddaaeeab42432cf9b924b5aa0459d644f615a01f + Build: https://aiinfra.visualstudio.com/Lotus/_build/results?buildId=312266 + © Microsoft Corporation. All rights reserved. + native ONNX ONNXRuntime-Training Learning-on-The-Edge On-Device-Training MachineLearning + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Lib/OnnxRuntimeDmlProvider/ORT_icon_for_light_bg.png b/Lib/OnnxRuntimeDmlProvider/ORT_icon_for_light_bg.png new file mode 100644 index 0000000000000000000000000000000000000000..c3182f9422a6d420158f6ad83d680ac4b78bf7ca GIT binary patch literal 346655 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

*@~*1}WbHeknck?)q#vnq$+XT96mjZmI=pXy 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

6ku|z(lwxbmm*)Ezz{Y5r|D9S`Gy&(6oglwh- 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 l_I_yLkq;MKRT1JuF7pE4!0BNX(@@0%bolC3{ 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

U05mN*fxrtK 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, All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +Please also refer to the file CONTRIBUTING.md, which clarifies licensing of +external contributions to this project including patches, pull requests, etc. + +_____ + +onnx +Open Neural Network Exchange + +Copyright (c) Facebook, Inc. and Microsoft Corporation. All rights reserved. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +Eigen + +MPL v2.0 +Mozilla Public License Version 2.0 + + +================================== + +1. Definitions + +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions + +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities + +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination + +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. + +_____ + +intel/dnnl + +Copyright 2016-2018 Intel Corporation + +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +sub-components: + +xbyak + +Copyright (c) 2007 MITSUNARI Shigeo. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +Redistributions of source code must retain the above copyright notice, this +list of conditions and the following disclaimer. +Redistributions in binary form must reproduce the above copyright notice, +this list of conditions and the following disclaimer in the documentation +and/or other materials provided with the distribution. +Neither the name of the copyright owner nor the names of its contributors may +be used to endorse or promote products derived from this software without +specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +Microsoft GSL + +Copyright (c) 2015 Microsoft Corporation. All rights reserved. + +This code is licensed under the MIT License (MIT). + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + +_____ + +Tensorflow + +Copyright 2018 The TensorFlow Authors. All rights reserved. + +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, +and distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by +the copyright owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all +other entities that control, are controlled by, or are under common +control with that entity. For the purposes of this definition, +"control" means (i) the power, direct or indirect, to cause the +direction or management of such entity, whether by contract or +otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity +exercising permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, +including but not limited to software source code, documentation +source, and configuration files. + +"Object" form shall mean any form resulting from mechanical +transformation or translation of a Source form, including but +not limited to compiled object code, generated documentation, +and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or +Object form, made available under the License, as indicated by a +copyright notice that is included in or attached to the work +(an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object +form, that is based on (or derived from) the Work and for which the +editorial revisions, annotations, elaborations, or other modifications +represent, as a whole, an original work of authorship. For the purposes +of this License, Derivative Works shall not include works that remain +separable from, or merely link (or bind by name) to the interfaces of, +the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including +the original version of the Work and any modifications or additions +to that Work or Derivative Works thereof, that is intentionally +submitted to Licensor for inclusion in the Work by the copyright owner +or by an individual or Legal Entity authorized to submit on behalf of +the copyright owner. For the purposes of this definition, "submitted" +means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, +and issue tracking systems that are managed by, or on behalf of, the +Licensor for the purpose of discussing and improving the Work, but +excluding communication that is conspicuously marked or otherwise +designated in writing by the copyright owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity +on behalf of whom a Contribution has been received by Licensor and +subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the +Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of +this License, each Contributor hereby grants to You a perpetual, +worldwide, non-exclusive, no-charge, royalty-free, irrevocable +(except as stated in this section) patent license to make, have made, +use, offer to sell, sell, import, and otherwise transfer the Work, +where such license applies only to those patent claims licensable +by such Contributor that are necessarily infringed by their +Contribution(s) alone or by combination of their Contribution(s) +with the Work to which such Contribution(s) was submitted. If You +institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work +or a Contribution incorporated within the Work constitutes direct +or contributory patent infringement, then any patent licenses +granted to You under this License for that Work shall terminate +as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the +Work or Derivative Works thereof in any medium, with or without +modifications, and in Source or Object form, provided that You +meet the following conditions: + +(a) You must give any other recipients of the Work or +Derivative Works a copy of this License; and + +(b) You must cause any modified files to carry prominent notices +stating that You changed the files; and + +(c) You must retain, in the Source form of any Derivative Works +that You distribute, all copyright, patent, trademark, and +attribution notices from the Source form of the Work, +excluding those notices that do not pertain to any part of +the Derivative Works; and + +(d) If the Work includes a "NOTICE" text file as part of its +distribution, then any Derivative Works that You distribute must +include a readable copy of the attribution notices contained +within such NOTICE file, excluding those notices that do not +pertain to any part of the Derivative Works, in at least one +of the following places: within a NOTICE text file distributed +as part of the Derivative Works; within the Source form or +documentation, if provided along with the Derivative Works; or, +within a display generated by the Derivative Works, if and +wherever such third-party notices normally appear. The contents +of the NOTICE file are for informational purposes only and +do not modify the License. You may add Your own attribution +notices within Derivative Works that You distribute, alongside +or as an addendum to the NOTICE text from the Work, provided +that such additional attribution notices cannot be construed +as modifying the License. + +You may add Your own copyright statement to Your modifications and +may provide additional or different license terms and conditions +for use, reproduction, or distribution of Your modifications, or +for any such Derivative Works as a whole, provided Your use, +reproduction, and distribution of the Work otherwise complies with +the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, +any Contribution intentionally submitted for inclusion in the Work +by You to the Licensor shall be under the terms and conditions of +this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify +the terms of any separate license agreement you may have executed +with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade +names, trademarks, service marks, or product names of the Licensor, +except as required for reasonable and customary use in describing the +origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or +agreed to in writing, Licensor provides the Work (and each +Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied, including, without limitation, any warranties or conditions +of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A +PARTICULAR PURPOSE. You are solely responsible for determining the +appropriateness of using or redistributing the Work and assume any +risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, +whether in tort (including negligence), contract, or otherwise, +unless required by applicable law (such as deliberate and grossly +negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, +incidental, or consequential damages of any character arising as a +result of this License or out of the use or inability to use the +Work (including but not limited to damages for loss of goodwill, +work stoppage, computer failure or malfunction, or any and all +other commercial damages or losses), even if such Contributor +has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing +the Work or Derivative Works thereof, You may choose to offer, +and charge a fee for, acceptance of support, warranty, indemnity, +or other liability obligations and/or rights consistent with this +License. However, in accepting such obligations, You may act only +on Your own behalf and on Your sole responsibility, not on behalf +of any other Contributor, and only if You agree to indemnify, +defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason +of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2017, The TensorFlow Authors. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +Microsoft Cognitive Toolkit (CNTK) + +Copyright (c) Microsoft Corporation. All rights reserved. + +MIT License + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, +merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT +LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +_____ + +NumPy License + +Copyright (c) 2005, NumPy Developers + +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + + Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + Neither the name of the NumPy Developers nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +Pytorch / Caffe2 + +From PyTorch: + +Copyright (c) 2016- Facebook, Inc (Adam Paszke) +Copyright (c) 2014- Facebook, Inc (Soumith Chintala) +Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert) +Copyright (c) 2012-2014 Deepmind Technologies (Koray Kavukcuoglu) +Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu) +Copyright (c) 2011-2013 NYU (Clement Farabet) +Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston) +Copyright (c) 2006 Idiap Research Institute (Samy Bengio) +Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz) + +From Caffe2: + +Copyright (c) 2016-present, Facebook Inc. All rights reserved. + +All contributions by Facebook: +Copyright (c) 2016 Facebook Inc. + +All contributions by Google: +Copyright (c) 2015 Google Inc. +All rights reserved. + +All contributions by Yangqing Jia: +Copyright (c) 2015 Yangqing Jia +All rights reserved. + +All contributions from Caffe: +Copyright(c) 2013, 2014, 2015, the respective contributors +All rights reserved. + +All other contributions: +Copyright(c) 2015, 2016 the respective contributors +All rights reserved. + +Caffe2 uses a copyright model similar to Caffe: each contributor holds +copyright over their contributions to Caffe2. The project versioning records +all such contribution and copyright details. If a contributor wants to further +mark their specific copyright on a particular contribution, they should +indicate their copyright solely in the commit message of the change when it is +committed. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +3. Neither the names of Facebook, Deepmind Technologies, NYU, NEC Laboratories America + and IDIAP Research Institute nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +_____ + +Caffe + +COPYRIGHT + +All contributions by the University of California: +Copyright (c) 2014-2017 The Regents of the University of California (Regents) +All rights reserved. + +All other contributions: +Copyright (c) 2014-2017, the respective contributors +All rights reserved. + +Caffe uses a shared copyright model: each contributor holds copyright over +their contributions to Caffe. The project versioning records all such +contribution and copyright details. If a contributor wants to further mark +their specific copyright on a particular contribution, they should indicate +their copyright solely in the commit message of the change when it is +committed. + +LICENSE + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +CONTRIBUTION AGREEMENT + +By contributing to the BVLC/caffe repository through pull-request, comment, +or otherwise, the contributor releases their content to the +license and copyright terms herein. + +_____ + +The LLVM Compiler Infrastructure + +============================================================================== +LLVM Release License +============================================================================== +University of Illinois/NCSA +Open Source License + +Copyright (c) 2003-2017 University of Illinois at Urbana-Champaign. +All rights reserved. + +Developed by: + + LLVM Team + + University of Illinois at Urbana-Champaign + + http://llvm.org + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal with +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimers. + + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimers in the + documentation and/or other materials provided with the distribution. + + * Neither the names of the LLVM Team, University of Illinois at + Urbana-Champaign, nor the names of its contributors may be used to + endorse or promote products derived from this Software without specific + prior written permission. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE +SOFTWARE. + +============================================================================== +Copyrights and Licenses for Third Party Software Distributed with LLVM: +============================================================================== +The LLVM software contains code written by third parties. Such software will +have its own individual LICENSE.TXT file in the directory in which it appears. +This file will describe the copyrights, license, and restrictions which apply +to that code. + +The disclaimer of warranty in the University of Illinois Open Source License +applies to all code in the LLVM Distribution, and nothing in any of the +other licenses gives permission to use the names of the LLVM Team or the +University of Illinois to endorse or promote products derived from this +Software. + +The following pieces of software have additional or alternate copyrights, +licenses, and/or restrictions: + +Program Directory +------- --------- +Google Test llvm/utils/unittest/googletest +OpenBSD regex llvm/lib/Support/{reg*, COPYRIGHT.regex} +pyyaml tests llvm/test/YAMLParser/{*.data, LICENSE.TXT} +ARM contributions llvm/lib/Target/ARM/LICENSE.TXT +md5 contributions llvm/lib/Support/MD5.cpp llvm/include/llvm/Support/MD5.h + +_____ + +google/benchmark + + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +CONTRIBUTORS + +# People who have agreed to one of the CLAs and can contribute patches. +# The AUTHORS file lists the copyright holders; this file +# lists people. For example, Google employees are listed here +# but not in AUTHORS, because Google holds the copyright. +# +# Names should be added to this file only after verifying that +# the individual or the individual's organization has agreed to +# the appropriate Contributor License Agreement, found here: +# +# https://developers.google.com/open-source/cla/individual +# https://developers.google.com/open-source/cla/corporate +# +# The agreement for individuals can be filled out on the web. +# +# When adding J Random Contributor's name to this file, +# either J's name or J's organization's name should be +# added to the AUTHORS file, depending on whether the +# individual or corporate CLA was used. +# +# Names should be added to this file as: +# Name +# +# Please keep the list sorted. + +Albert Pretorius +Arne Beer +Billy Robert O'Neal III +Chris Kennelly +Christopher Seymour +David Coeurjolly +Deniz Evrenci +Dominic Hamon +Dominik Czarnota +Eric Fiselier +Eugene Zhuk +Evgeny Safronov +Federico Ficarelli +Felix Homann +Ismael Jimenez Martinez +Jern-Kuan Leong +JianXiong Zhou +Joao Paulo Magalhaes +John Millikin +Jussi Knuuttila +Kai Wolf +Kishan Kumar +Kaito Udagawa +Lei Xu +Matt Clarkson +Maxim Vafin +Nick Hutchinson +Oleksandr Sochka +Pascal Leroy +Paul Redmond +Pierre Phaneuf +Radoslav Yovchev +Raul Marin +Ray Glover +Robert Guo +Roman Lebedev +Shuo Chen +Tobias Ulvgård +Tom Madams +Yixuan Qiu +Yusuke Suzuki +Zbigniew Skowron + +AUTHORS + +# This is the official list of benchmark authors for copyright purposes. +# This file is distinct from the CONTRIBUTORS files. +# See the latter for an explanation. +# +# Names should be added to this file as: +# Name or Organization +# The email address is not required for organizations. +# +# Please keep the list sorted. + +Albert Pretorius +Arne Beer +Carto +Christopher Seymour +David Coeurjolly +Deniz Evrenci +Dirac Research +Dominik Czarnota +Eric Fiselier +Eugene Zhuk +Evgeny Safronov +Federico Ficarelli +Felix Homann +Google Inc. +International Business Machines Corporation +Ismael Jimenez Martinez +Jern-Kuan Leong +JianXiong Zhou +Joao Paulo Magalhaes +Jussi Knuuttila +Kaito Udagawa +Kishan Kumar +Lei Xu +Matt Clarkson +Maxim Vafin +MongoDB Inc. +Nick Hutchinson +Oleksandr Sochka +Paul Redmond +Radoslav Yovchev +Roman Lebedev +Shuo Chen +Steinar H. Gunderson +Stripe, Inc. +Yixuan Qiu +Yusuke Suzuki +Zbigniew Skowron + +_____ + +HalidelR + +Copyright (c) 2016 HalideIR contributors +Copyright (c) 2012-2014 MIT CSAIL, Google Inc., and other contributors +HalideIR is derived from the Halide project. + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +_____ + +Distributed Machine Learning Common Codebase + +Copyright (c) 2015 by Contributors + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +_____ + +DLPack: Open In Memory Tensor Structure + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2017 by Contributors + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +HowardHinnant/date + +The source code in this project is released using the MIT License. There is no +global license for the project because each file is licensed individually with +different author names and/or dates. + +If you contribute to this project, please add your name to the license of each +file you modify. If you have already contributed to this project and forgot to +add your name to the license, please feel free to submit a new P/R to add your +name to the license in each file you modified. + +For convenience, here is a copy of the MIT license found in each file except +without author names or dates: + +The MIT License (MIT) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ + +TVM Open Deep Learning Compiler Stack + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +CONTRIBUTORS + +TVM Contributors +================ +TVM adopts the Apache style model and governs by merit. We believe that it is important to create an inclusive community where everyone can use, +contribute to, and influence the direction of the project. We actively invite contributors who have earned the merit to be part of the development community. + +See the [community structure document](http://docs.tvm.ai/contribute/community.html) for the explanation of community structure and contribution guidelines. + +## Committers +- [Tianqi Chen](https://github.com/tqchen) (PMC) +- [Thierry Moreau](http://homes.cs.washington.edu/~moreau/) +- [Ziheng Jiang](https://github.com/ZihengJiang) +- [Haichen Shen](http://homes.cs.washington.edu/~haichen/) +- [Yizhi Liu](https://github.com/yzhliu) + +## Code Owners +- [Aditya Atluri](https://github.com/adityaatluri) ROCM +- [Leyuan Wang](https://github.com/Laurawly) TOPI +- [Yuwei Hu](https://github.com/Huyuwei) TOPI +- [Zhixun Tan](https://github.com/phisiart) OpenGL/WebGL backend +- [Nick Hynes](https://github.com/nhynes) SGX and secured computing +- [Lianmin Zheng](https://github.com/merrymercy) AutoTVM + +## Reviewers +- [Zhi Chen](https://github.com/zhiics) +- [Xiaoqiang Dan](https://github.com/xqdan) +- [Liangfu Chen](https://github.com/liangfu) +- [Masahiro Masuda](https://github.com/masahi) +- [Kazutaka Morita](https://github.com/kazum) +- [Tatsuya Nishiyama](https://github.com/nishi-t) +- [Pariksheet Pinjari](https://github.com/PariksheetPinjari909) +- [Jared Roesch](https://github.com/jroesch) +- [Siva](https://github.com/srkreddy1238) +- [Siju Samuel](https://github.com/siju-samuel) +- [Alex Weaver](https://github.com/alex-weaver) +- [Yao Wang](https://github.com/kevinthesun) +- [Jian Weng](https://github.com/were) +- [Eddie Yan](https://github.com/eqy) +- [Joshua Z. Zhang](https://github.com/zhreshold) + +## List of Contributors +- [Full List of Contributors](https://github.com/dmlc/tvm/graphs/contributors) + - To contributors: please add your name to the list. +- [Qiao Zhang](https://github.com/zhangqiaorjc) +- [Haolong Zhang](https://github.com/haolongzhangm) +- [Cody Hao Yu](https://github.com/comaniac) +- [Chris Nuernberger](https://github.com/cnuernber) + +_____ + +FreeBSD: getopt.c file + +Copyright (c) 1987, 1993, 1994 +The Regents of the University of California. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + + 1. Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. + +3. Neither the name of the University nor the names of its contributors +may be used to endorse or promote products derived from this software +without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. +_____ + + +google/googletest + +Copyright 2008, Google Inc. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +G3log : Asynchronous logger with Dynamic Sinks + +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to +_____ + +Scikit-learn + +Copyright (c) 2007–2018 The scikit-learn developers. +All rights reserved. + + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + a. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + b. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + c. Neither the name of the Scikit-learn Developers nor the names of + its contributors may be used to endorse or promote products + derived from this software without specific prior written + permission. + + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH +DAMAGE. + +_____ + +google/nsync + +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +google/re2 + +Copyright (c) 2009 The RE2 Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +_____ +onnx/onnx-tensorrt + +MIT License + +Copyright (c) 2018, NVIDIA CORPORATION. All rights reserved. +Copyright (c) 2018 Open Neural Network Exchange + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ +nvidia/cutlass + +Copyright (c) 2017 - 2022 NVIDIA CORPORATION & AFFILIATES. All rights reserved. +SPDX-License-Identifier: BSD-3-Clause + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this +list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, +this list of conditions and the following disclaimer in the documentation +and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ +Boost + +Boost Software License - Version 1.0 - August 17th, 2003 + +Permission is hereby granted, free of charge, to any person or organization +obtaining a copy of the software and accompanying documentation covered by +this license (the "Software") to use, reproduce, display, distribute, +execute, and transmit the Software, and to prepare derivative works of the +Software, and to permit third-parties to whom the Software is furnished to +do so, all subject to the following: + +The copyright notices in the Software and this entire statement, including +the above license grant, this restriction and the following disclaimer, +must be included in all copies of the Software, in whole or in part, and +all derivative works of the Software, unless such copies or derivative +works are solely in the form of machine-executable object code generated by +a source language processor. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT +SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE +FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +DEALINGS IN THE SOFTWARE. + + +_____ + +JDAI-CV/DNNLibrary + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [2019] [JD.com Inc. JD AI] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +_____ + +google/flatbuffers + + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2014 Google Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +_____ + +google/glog + +Copyright (c) 2008, Google Inc. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + +A function gettimeofday in utilities.cc is based on + +http://www.google.com/codesearch/p?hl=en#dR3YEbitojA/COPYING&q=GetSystemTimeAsFileTime%20license:bsd + +The license of this code is: + +Copyright (c) 2003-2008, Jouni Malinen and contributors +All Rights Reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +3. Neither the name(s) of the above-listed copyright holder(s) nor the + names of its contributors may be used to endorse or promote products + derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +abseil-cpp +https://github.com/abseil/abseil-cpp + + Apache License + Version 2.0, January 2004 + https://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + https://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +_____ + +microsoft/wil + +MIT License + +Copyright (c) Microsoft Corporation. All rights reserved. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE + +_____ + +nlohmann/json + +MIT License + +Copyright (c) 2013-2019 Niels Lohmann + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ + +dcleblanc/SafeInt + +MIT License + +Copyright (c) 2018 Microsoft + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ +Open MPI + +3-Clause BSD License + +Most files in this release are marked with the copyrights of the +organizations who have edited them. The copyrights below are in no +particular order and generally reflect members of the Open MPI core +team who have contributed code to this release. The copyrights for +code used under license from other parties are included in the +corresponding files. + +Copyright (c) 2004-2010 The Trustees of Indiana University and Indiana + University Research and Technology + Corporation. All rights reserved. +Copyright (c) 2004-2017 The University of Tennessee and The University + of Tennessee Research Foundation. All rights + reserved. +Copyright (c) 2004-2010 High Performance Computing Center Stuttgart, + University of Stuttgart. All rights reserved. +Copyright (c) 2004-2008 The Regents of the University of California. + All rights reserved. +Copyright (c) 2006-2017 Los Alamos National Security, LLC. All rights + reserved. +Copyright (c) 2006-2017 Cisco Systems, Inc. All rights reserved. +Copyright (c) 2006-2010 Voltaire, Inc. All rights reserved. +Copyright (c) 2006-2017 Sandia National Laboratories. All rights reserved. +Copyright (c) 2006-2010 Sun Microsystems, Inc. All rights reserved. + Use is subject to license terms. +Copyright (c) 2006-2017 The University of Houston. All rights reserved. +Copyright (c) 2006-2009 Myricom, Inc. All rights reserved. +Copyright (c) 2007-2017 UT-Battelle, LLC. All rights reserved. +Copyright (c) 2007-2017 IBM Corporation. All rights reserved. +Copyright (c) 1998-2005 Forschungszentrum Juelich, Juelich Supercomputing + Centre, Federal Republic of Germany +Copyright (c) 2005-2008 ZIH, TU Dresden, Federal Republic of Germany +Copyright (c) 2007 Evergrid, Inc. All rights reserved. +Copyright (c) 2008 Chelsio, Inc. All rights reserved. +Copyright (c) 2008-2009 Institut National de Recherche en + Informatique. All rights reserved. +Copyright (c) 2007 Lawrence Livermore National Security, LLC. + All rights reserved. +Copyright (c) 2007-2017 Mellanox Technologies. All rights reserved. +Copyright (c) 2006-2010 QLogic Corporation. All rights reserved. +Copyright (c) 2008-2017 Oak Ridge National Labs. All rights reserved. +Copyright (c) 2006-2012 Oracle and/or its affiliates. All rights reserved. +Copyright (c) 2009-2015 Bull SAS. All rights reserved. +Copyright (c) 2010 ARM ltd. All rights reserved. +Copyright (c) 2016 ARM, Inc. All rights reserved. +Copyright (c) 2010-2011 Alex Brick . All rights reserved. +Copyright (c) 2012 The University of Wisconsin-La Crosse. All rights + reserved. +Copyright (c) 2013-2016 Intel, Inc. All rights reserved. +Copyright (c) 2011-2017 NVIDIA Corporation. All rights reserved. +Copyright (c) 2016 Broadcom Limited. All rights reserved. +Copyright (c) 2011-2017 Fujitsu Limited. All rights reserved. +Copyright (c) 2014-2015 Hewlett-Packard Development Company, LP. All + rights reserved. +Copyright (c) 2013-2017 Research Organization for Information Science (RIST). + All rights reserved. +Copyright (c) 2017-2018 Amazon.com, Inc. or its affiliates. All Rights + reserved. +Copyright (c) 2018 DataDirect Networks. All rights reserved. +Copyright (c) 2018-2019 Triad National Security, LLC. All rights reserved. + +$COPYRIGHT$ + +Additional copyrights may follow + +$HEADER$ + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + +- Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +- Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer listed + in this license in the documentation and/or other materials + provided with the distribution. + +- Neither the name of the copyright holders nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +The copyright holders provide no reassurances that the source code +provided does not infringe any patent, copyright, or any other +intellectual property rights of third parties. The copyright holders +disclaim any liability to any recipient for claims brought against +recipient by any third party for infringement of that parties +intellectual property rights. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +The Android Open Source Project + +Copyright (C) 2017 The Android Open Source Project +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +------ + +libprotobuf-mutator + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + ----- + + openucx/ucx + https://github.com/openucx/ucx + + Copyright (c) 2014-2015 UT-Battelle, LLC. All rights reserved. + Copyright (C) 2014-2020 Mellanox Technologies Ltd. All rights reserved. + Copyright (C) 2014-2015 The University of Houston System. All rights reserved. + Copyright (C) 2015 The University of Tennessee and The University + of Tennessee Research Foundation. All rights reserved. + Copyright (C) 2016-2020 ARM Ltd. All rights reserved. + Copyright (c) 2016 Los Alamos National Security, LLC. All rights reserved. + Copyright (C) 2016-2020 Advanced Micro Devices, Inc. All rights reserved. + Copyright (C) 2019 UChicago Argonne, LLC. All rights reserved. + Copyright (c) 2018-2020 NVIDIA CORPORATION. All rights reserved. + Copyright (C) 2020 Huawei Technologies Co., Ltd. All rights reserved. + Copyright (C) 2016-2020 Stony Brook University. All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + 3. Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED + TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR + PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ----- + + From PyTorch: + + Copyright (c) 2016- Facebook, Inc (Adam Paszke) + Copyright (c) 2014- Facebook, Inc (Soumith Chintala) + Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert) + Copyright (c) 2012-2014 Deepmind Technologies (Koray Kavukcuoglu) + Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu) + Copyright (c) 2011-2013 NYU (Clement Farabet) + Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston) + Copyright (c) 2006 Idiap Research Institute (Samy Bengio) + Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz) + + From Caffe2: + + Copyright (c) 2016-present, Facebook Inc. All rights reserved. + + All contributions by Facebook: + Copyright (c) 2016 Facebook Inc. + + All contributions by Google: + Copyright (c) 2015 Google Inc. + All rights reserved. + + All contributions by Yangqing Jia: + Copyright (c) 2015 Yangqing Jia + All rights reserved. + + All contributions from Caffe: + Copyright(c) 2013, 2014, 2015, the respective contributors + All rights reserved. + + All other contributions: + Copyright(c) 2015, 2016 the respective contributors + All rights reserved. + + Caffe2 uses a copyright model similar to Caffe: each contributor holds + copyright over their contributions to Caffe2. The project versioning records + all such contribution and copyright details. If a contributor wants to further + mark their specific copyright on a particular contribution, they should + indicate their copyright solely in the commit message of the change when it is + committed. + + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + 3. Neither the names of Facebook, Deepmind Technologies, NYU, NEC Laboratories America + and IDIAP Research Institute nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + POSSIBILITY OF SUCH DAMAGE. + +_____ + + mpi4py + https://github.com/mpi4py/mpi4py/ + + ======================= + LICENSE: MPI for Python + ======================= + + :Author: Lisandro Dalcin + :Contact: dalcinl@gmail.com + + + Copyright (c) 2019, Lisandro Dalcin. + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +_____ +huggingface/transformers + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +_____ +msgpack/msgpack-python + +Copyright (C) 2008-2011 INADA Naoki + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +_____ +lanpa/tensorboardX + +MIT License + +Copyright (c) 2017 Tzu-Wei Huang + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +_____ +tensorflow/tensorboard + +Copyright 2017 The TensorFlow Authors. All rights reserved. + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2017, The TensorFlow Authors. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + + +_____ + +cerberus + +Cerberus is a lightweight and extensible data validation library for Python. + +ISC License + +Copyright (c) 2012-2016 Nicola Iarocci. + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted, provided that the above +copyright notice and this permission notice appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, +INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR +OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +PERFORMANCE OF THIS SOFTWARE. + +_____ + +MurmurHash3 + +MIT license + +https://github.com/aappleby/smhasher + +SMHasher is a test suite designed to test the distribution, collision, and +performance properties of non-cryptographic hash functions. +This is the home for the MurmurHash family of hash functions along with the +SMHasher test suite used to verify them. +SMHasher is released under the MIT license. +All MurmurHash versions are public domain software, and the author disclaims all copyright to their code. + +_____ + +gtest-ios-framework + +https://github.com/mestevens/gtest-ios-framework + +Copyright (c) 2013 Matthew Stevens + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +_____ + +DLPack + +https://github.com/dmlc/dlpack + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2017 by Contributors + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +emsdk + +MIT/Expat license + +https://github.com/emscripten-core/emsdk + +Copyright (c) 2018 Emscripten authors (see AUTHORS in Emscripten) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +---------------------------------------------------------------------------- + +This is the MIT/Expat Licence. For more information see: + +1. http://www.opensource.org/licenses/mit-license.php + +2. http://en.wikipedia.org/wiki/MIT_License + +_____ + +coremltools + +BSD-3-Clause License + +https://github.com/apple/coremltools + +Copyright (c) 2020, Apple Inc. All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + +3. Neither the name of the copyright holder(s) nor the names of any contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +© 2021 GitHub, Inc. + +_____ + +react-native + +MIT License + +https://github.com/facebook/react-native + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ + +pytorch/cpuinfo + +BSD 2-Clause "Simplified" License + +https://github.com/pytorch/cpuinfo + +Copyright (c) 2019 Google LLC +Copyright (c) 2017-2018 Facebook Inc. +Copyright (C) 2012-2017 Georgia Institute of Technology +Copyright (C) 2010-2012 Marat Dukhan + +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +SQLite Is Public Domain + +All of the code and documentation in SQLite has been dedicated to the public +domain by the authors. All code authors, and representatives of the companies +they work for, have signed affidavits dedicating their contributions to the +public domain and originals of those signed affidavits are stored in a firesafe +at the main offices of Hwaci. Anyone is free to copy, modify, publish, use, +compile, sell, or distribute the original SQLite code, either in source code +form or as a compiled binary, for any purpose, commercial or non-commercial, +and by any means. + +The previous paragraph applies to the deliverable code and documentation in +SQLite - those parts of the SQLite library that you actually bundle and ship +with a larger application. Some scripts used as part of the build process (for +example the "configure" scripts generated by autoconf) might fall under other +open-source licenses. Nothing from these build scripts ever reaches the final +deliverable SQLite library, however, and so the licenses associated with those +scripts should not be a factor in assessing your rights to copy and use the +SQLite library. + +All of the deliverable code in SQLite has been written from scratch. No code +has been taken from other projects or from the open internet. Every line of +code can be traced back to its original author, and all of those authors have +public domain dedications on file. So the SQLite code base is clean and is +uncontaminated with licensed code from other projects. + +_____ + +google/XNNPACK + +BSD License + +For XNNPACK software + +Copyright (c) Facebook, Inc. and its affiliates. All rights reserved. +Copyright 2019 Google LLC + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + + * Neither the name Facebook nor the names of its contributors may be used to + endorse or promote products derived from this software without specific + prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +google/sentencepiece, https://github.com/google/sentencepiece +(included when statically linked with onnxruntime-extensions) + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +dlfcn-win32/dlfcn-win32 is licensed under the MIT License + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. + +_____ + +The Python Imaging Library (PIL) is + + Copyright © 1997-2011 by Secret Labs AB + Copyright © 1995-2011 by Fredrik Lundh + +Pillow is the friendly PIL fork. It is + + Copyright © 2010-2023 by Alex Clark and contributors + +Like PIL, Pillow is licensed under the open source HPND License: + +By obtaining, using, and/or copying this software and/or its associated +documentation, you agree that you have read, understood, and will comply +with the following terms and conditions: + +Permission to use, copy, modify, and distribute this software and its +associated documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appears in all copies, and that +both that copyright notice and this permission notice appear in supporting +documentation, and that the name of Secret Labs AB or the author not be +used in advertising or publicity pertaining to distribution of the software +without specific, written prior permission. + +SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS +SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. +IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR ANY SPECIAL, +INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE +OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +PERFORMANCE OF THIS SOFTWARE. + +_____ + +openssl/openssl, https://github.com/openssl/openssl + + Apache License + Version 2.0, January 2004 + https://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + +_____ + +Tencent/rapidjson, https://github.com/Tencent/rapidjson + +Tencent is pleased to support the open source community by making RapidJSON available. + +Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved. + +If you have downloaded a copy of the RapidJSON binary from Tencent, please note that the RapidJSON binary is licensed under the MIT License. +If you have downloaded a copy of the RapidJSON source code from Tencent, please note that RapidJSON source code is licensed under the MIT License, except for the third-party components listed below which are subject to different license terms. Your integration of RapidJSON into your own projects may require compliance with the MIT License, as well as the other licenses applicable to the third-party components included within RapidJSON. To avoid the problematic JSON license in your own projects, it's sufficient to exclude the bin/jsonchecker/ directory, as it's the only code under the JSON license. +A copy of the MIT License is included in this file. + +Other dependencies and licenses: + +Open Source Software Licensed Under the BSD License: +-------------------------------------------------------------------- + +The msinttypes r29 +Copyright (c) 2006-2013 Alexander Chemeris +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. +* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. +* Neither the name of copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +Open Source Software Licensed Under the JSON License: +-------------------------------------------------------------------- + +json.org +Copyright (c) 2002 JSON.org +All Rights Reserved. + +JSON_checker +Copyright (c) 2002 JSON.org +All Rights Reserved. + + +Terms of the JSON License: +--------------------------------------------------- + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +The Software shall be used for Good, not Evil. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + +Terms of the MIT License: +-------------------------------------------------------------------- + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +_____ + +boostorg/boost, https://github.com/boostorg/boost + +Boost Software License - Version 1.0 - August 17th, 2003 + +Permission is hereby granted, free of charge, to any person or organization +obtaining a copy of the software and accompanying documentation covered by +this license (the "Software") to use, reproduce, display, distribute, +execute, and transmit the Software, and to prepare derivative works of the +Software, and to permit third-parties to whom the Software is furnished to +do so, all subject to the following: + +The copyright notices in the Software and this entire statement, including +the above license grant, this restriction and the following disclaimer, +must be included in all copies of the Software, in whole or in part, and +all derivative works of the Software, unless such copies or derivative +works are solely in the form of machine-executable object code generated by +a source language processor. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT +SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE +FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +DEALINGS IN THE SOFTWARE. + +_____ + +libb64/libb64, https://github.com/libb64/libb64 + +Copyright-Only Dedication (based on United States law) or Public Domain Certification + +The person or persons who have associated work with this document (the "Dedicator" or "Certifier") hereby either (a) certifies that, to the best of his knowledge, the work of authorship identified is in the public domain of the country from which the work is published, or (b) hereby dedicates whatever copyright the dedicators holds in the work of authorship identified below (the "Work") to the public domain. A certifier, moreover, dedicates any copyright interest he may have in the associated work, and for these purposes, is described as a "dedicator" below. + +A certifier has taken reasonable steps to verify the copyright status of this work. Certifier recognizes that his good faith efforts may not shield him from liability if in fact the work certified is not in the public domain. + +Dedicator makes this dedication for the benefit of the public at large and to the detriment of the Dedicator's heirs and successors. Dedicator intends this dedication to be an overt act of relinquishment in perpetuity of all present and future rights under copyright law, whether vested or contingent, in the Work. Dedicator understands that such relinquishment of all rights includes the relinquishment of all rights to enforce (by lawsuit or otherwise) those copyrights in the Work. + +Dedicator recognizes that, once placed in the public domain, the Work may be freely reproduced, distributed, transmitted, used, modified, built upon, or otherwise exploited by anyone for any purpose, commercial or non-commercial, and in any way, including by methods that have not yet been invented or conceived. + +_____ + +posix pthread library, https://sourceforge.net/projects/pthreads4w + + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +_____ + +Triton Inference Server & Client, https://github.com/triton-inference-server + +Copyright (c) 2022, NVIDIA CORPORATION. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of NVIDIA CORPORATION nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY +EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR +CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY +OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +_____ + +microsoft/mimalloc, https://github.com/microsoft/mimalloc + +MIT License + +Copyright (c) 2018-2021 Microsoft Corporation, Daan Leijen + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +_____ + +TensorFlow.js + +https://github.com/tensorflow/tfjs + + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +—— + +curl/curl + +https://github.com/curl + +COPYRIGHT AND PERMISSION NOTICE + +Copyright (C) Daniel Stenberg, , and many +contributors, see the THANKS file. + +All rights reserved. + +Permission to use, copy, modify, and distribute this software for any purpose +with or without fee is hereby granted, provided that the above copyright +notice and this permission notice appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN +NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE +OR OTHER DEALINGS IN THE SOFTWARE. + +Except as contained in this notice, the name of a copyright holder shall not +be used in advertising or otherwise to promote the sale, use or other dealings +in this Software without prior written authorization of the copyright holder. \ No newline at end of file diff --git a/Lib/OnnxRuntimeDmlProvider/[Content_Types].xml b/Lib/OnnxRuntimeDmlProvider/[Content_Types].xml new file mode 100644 index 0000000..4779aca --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/[Content_Types].xml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Lib/OnnxRuntimeDmlProvider/_rels/.rels b/Lib/OnnxRuntimeDmlProvider/_rels/.rels new file mode 100644 index 0000000..ec2e5af --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/_rels/.rels @@ -0,0 +1,5 @@ + + + + + \ No newline at end of file diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.props b/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.props new file mode 100644 index 0000000..9376d98 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.props @@ -0,0 +1,179 @@ + + + + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x86/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + x86 + arm64 + arm + $(Platform) + + + + $(MSBuildThisFileDirectory)..\..\runtimes\win-$(EnginePlatform)\native\onnxruntime.dll + + + + + true + true + true + + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + onnxruntime_providers_cuda.dll + PreserveNewest + false + + + onnxruntime_providers_dnnl.dll + PreserveNewest + false + + + onnxruntime_providers_tensorrt.dll + PreserveNewest + false + + + onnxruntime_providers_openvino.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.targets b/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.targets new file mode 100644 index 0000000..5702bc6 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/Microsoft.ML.OnnxRuntime.DirectML.targets @@ -0,0 +1,17 @@ + + + + + + + diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/cpu_provider_factory.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/cpu_provider_factory.h new file mode 100644 index 0000000..2926786 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/cpu_provider_factory.h @@ -0,0 +1,19 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +#include "onnxruntime_c_api.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * \param use_arena zero: false. non-zero: true. + */ +ORT_EXPORT +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProvider_CPU, _In_ OrtSessionOptions* options, int use_arena) +ORT_ALL_ARGS_NONNULL; + +#ifdef __cplusplus +} +#endif diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/dml_provider_factory.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/dml_provider_factory.h new file mode 100644 index 0000000..0782d2d --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/dml_provider_factory.h @@ -0,0 +1,106 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +#pragma once + +#pragma warning(push) +#pragma warning(disable : 4201) // nonstandard extension used: nameless struct/union +#ifdef _GAMING_XBOX_SCARLETT +#include +#elif defined(_GAMING_XBOX_XBOXONE) +#include +#else +#include +#endif +#pragma warning(pop) + +#ifdef __cplusplus +#include +#else +struct IDMLDevice; +typedef struct IDMLDevice IDMLDevice; +#endif + +// Windows pollutes the macro space, causing a build break in constants.h. +#undef OPTIONAL + +#include "onnxruntime_c_api.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * [[deprecated]] + * This export is deprecated. + * The OrtSessionOptionsAppendExecutionProvider_DML export on the OrtDmlApi should be used instead. + * + * Creates a DirectML Execution Provider which executes on the hardware adapter with the given device_id, also known as + * the adapter index. The device ID corresponds to the enumeration order of hardware adapters as given by + * IDXGIFactory::EnumAdapters. A device_id of 0 always corresponds to the default adapter, which is typically the + * primary display GPU installed on the system. A negative device_id is invalid. + */ +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProvider_DML, _In_ OrtSessionOptions* options, int device_id); + +/** + * [[deprecated]] + * This export is deprecated. + * The OrtSessionOptionsAppendExecutionProvider_DML1 export on the OrtDmlApi should be used instead. + * + * Creates a DirectML Execution Provider using the given DirectML device, and which executes work on the supplied D3D12 + * command queue. The DirectML device and D3D12 command queue must have the same parent ID3D12Device, or an error will + * be returned. The D3D12 command queue must be of type DIRECT or COMPUTE (see D3D12_COMMAND_LIST_TYPE). If this + * function succeeds, the inference session maintains a strong reference on both the dml_device and the command_queue + * objects. + * See also: DMLCreateDevice + * See also: ID3D12Device::CreateCommandQueue + */ +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProviderEx_DML, _In_ OrtSessionOptions* options, + _In_ IDMLDevice* dml_device, _In_ ID3D12CommandQueue* cmd_queue); + +struct OrtDmlApi; +typedef struct OrtDmlApi OrtDmlApi; + +struct OrtDmlApi { + /** + * Creates a DirectML Execution Provider which executes on the hardware adapter with the given device_id, also known as + * the adapter index. The device ID corresponds to the enumeration order of hardware adapters as given by + * IDXGIFactory::EnumAdapters. A device_id of 0 always corresponds to the default adapter, which is typically the + * primary display GPU installed on the system. A negative device_id is invalid. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_DML, _In_ OrtSessionOptions* options, int device_id); + + /** + * Creates a DirectML Execution Provider using the given DirectML device, and which executes work on the supplied D3D12 + * command queue. The DirectML device and D3D12 command queue must have the same parent ID3D12Device, or an error will + * be returned. The D3D12 command queue must be of type DIRECT or COMPUTE (see D3D12_COMMAND_LIST_TYPE). If this + * function succeeds, the inference session maintains a strong reference on both the dml_device and the command_queue + * objects. + * See also: DMLCreateDevice + * See also: ID3D12Device::CreateCommandQueue + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_DML1, _In_ OrtSessionOptions* options, + _In_ IDMLDevice* dml_device, _In_ ID3D12CommandQueue* cmd_queue); + + /** + * CreateGPUAllocationFromD3DResource + * This API creates a DML EP resource based on a user-specified D3D12 resource. + */ + ORT_API2_STATUS(CreateGPUAllocationFromD3DResource, _In_ ID3D12Resource* d3d_resource, _Out_ void** dml_resource); + + /** + * FreeGPUAllocation + * This API frees the DML EP resource created by CreateGPUAllocationFromD3DResource. + */ + ORT_API2_STATUS(FreeGPUAllocation, _In_ void* dml_resource); + + /** + * GetD3D12ResourceFromAllocation + * This API gets the D3D12 resource when an OrtValue has been allocated by the DML EP. + */ + ORT_API2_STATUS(GetD3D12ResourceFromAllocation, _In_ OrtAllocator* provider, _In_ void* dml_resource, _Out_ ID3D12Resource** d3d_resource); +}; + +#ifdef __cplusplus +} +#endif diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_c_api.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_c_api.h new file mode 100644 index 0000000..d215b12 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_c_api.h @@ -0,0 +1,4324 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +// See docs\c_cxx\README.md on generating the Doxygen documentation from this file + +/** \mainpage ONNX Runtime + * + * ONNX Runtime is a high-performance inference and training graph execution engine for deeplearning models. + * + * ONNX Runtime's C, C++ APIs offer an easy to use interface to onboard and execute onnx models. + * - \subpage c_cpp_api "Core C, C++ APIs" + * - \subpage training_c_cpp_api "Training C, C++ APIs for learning on the edge" + * + * \page c_cpp_api Core C, C++ APIs + *

C

+ * + * ::OrtApi - Click here to go to the structure with all C API functions. + * + *

C++

+ * + * ::Ort - Click here to go to the namespace holding all of the C++ wrapper classes + * + * It is a set of header only wrapper classes around the C API. The goal is to turn the C style return value error codes into C++ exceptions, and to + * automate memory management through standard C++ RAII principles. + * + * \addtogroup Global + * ONNX Runtime C API + * @{ + */ + +#pragma once +#include +#include +#include + +/** \brief The API version defined in this header + * + * This value is used by some API functions to behave as this version of the header expects. + */ +#define ORT_API_VERSION 15 + +#ifdef __cplusplus +extern "C" { +#endif + +//! @} +// SAL2 Definitions +#ifndef _WIN32 +#define _In_ +#define _In_z_ +#define _In_opt_ +#define _In_opt_z_ +#define _Out_ +#define _Outptr_ +#define _Out_opt_ +#define _Inout_ +#define _Inout_opt_ +#define _Frees_ptr_opt_ +#define _Ret_maybenull_ +#define _Ret_notnull_ +#define _Check_return_ +#define _Outptr_result_maybenull_ +#define _In_reads_(X) +#define _Inout_updates_all_(X) +#define _Out_writes_bytes_all_(X) +#define _Out_writes_all_(X) +#define _Success_(X) +#define _Outptr_result_buffer_maybenull_(X) +#define ORT_ALL_ARGS_NONNULL __attribute__((nonnull)) +#else +#include +#define ORT_ALL_ARGS_NONNULL +#endif + +#ifdef _WIN32 +// Define ORT_DLL_IMPORT if your program is dynamically linked to Ort. +// dllexport is not used, we use a .def file. +#ifdef ORT_DLL_IMPORT +#define ORT_EXPORT __declspec(dllimport) +#else +#define ORT_EXPORT +#endif +#define ORT_API_CALL _stdcall +#define ORT_MUST_USE_RESULT +#define ORTCHAR_T wchar_t +#else +// To make symbols visible on macOS/iOS +#ifdef __APPLE__ +#define ORT_EXPORT __attribute__((visibility("default"))) +#else +#define ORT_EXPORT +#endif +#define ORT_API_CALL +#define ORT_MUST_USE_RESULT __attribute__((warn_unused_result)) +#define ORTCHAR_T char +#endif + +/// ORTCHAR_T, ORT_TSTR are reserved specifically for path handling. +/// All other strings are UTF-8 encoded, use char and std::string +#ifndef ORT_TSTR +#ifdef _WIN32 +#define ORT_TSTR(X) L##X +// When X is a macro, L##X is not defined. In this case, we need to use ORT_TSTR_ON_MACRO. +#define ORT_TSTR_ON_MACRO(X) L"" X +#else +#define ORT_TSTR(X) X +#define ORT_TSTR_ON_MACRO(X) X +#endif +#endif + +// On Windows, ORT_FILE is a wchar_t version of the __FILE__ macro. +// Otherwise, ORT_FILE is equivalent to __FILE__. +#ifndef ORT_FILE +#define ORT_FILE_INTERNAL(x) ORT_TSTR(x) +#define ORT_FILE ORT_FILE_INTERNAL(__FILE__) +#endif + +// Any pointer marked with _In_ or _Out_, cannot be NULL. + +// Windows users should use unicode paths when possible to bypass the MAX_PATH limitation +// Every pointer marked with _In_ or _Out_, cannot be NULL. Caller should ensure that. +// for ReleaseXXX(...) functions, they can accept NULL pointer. + +#ifdef __cplusplus +// For any compiler with C++11 support, MSVC 2015 and greater, or Clang version supporting noexcept. +// Such complex condition is needed because compilers set __cplusplus value differently. +#ifndef __has_feature +#define __has_feature(x) 0 +#endif +#if ((__cplusplus >= 201103L) || (_MSC_VER >= 1900) || (defined(__has_feature) && __has_feature(cxx_noexcept))) +#define NO_EXCEPTION noexcept +#else +#define NO_EXCEPTION throw() +#endif +#else +#define NO_EXCEPTION +#endif + +// __VA_ARGS__ on Windows and Linux are different +#define ORT_API(RETURN_TYPE, NAME, ...) RETURN_TYPE ORT_API_CALL NAME(__VA_ARGS__) NO_EXCEPTION + +#define ORT_API_STATUS(NAME, ...) \ + _Success_(return == 0) _Check_return_ _Ret_maybenull_ OrtStatusPtr ORT_API_CALL NAME(__VA_ARGS__) \ + NO_EXCEPTION ORT_MUST_USE_RESULT + +// XXX: Unfortunately, SAL annotations are known to not work with function pointers +#define ORT_API2_STATUS(NAME, ...) \ + _Check_return_ _Ret_maybenull_ OrtStatusPtr(ORT_API_CALL* NAME)(__VA_ARGS__) NO_EXCEPTION ORT_MUST_USE_RESULT + +// Used in *.cc files. Almost as same as ORT_API_STATUS, except without ORT_MUST_USE_RESULT and ORT_EXPORT +#define ORT_API_STATUS_IMPL(NAME, ...) \ + _Success_(return == 0) _Check_return_ _Ret_maybenull_ OrtStatusPtr ORT_API_CALL NAME(__VA_ARGS__) NO_EXCEPTION + +#define ORT_CLASS_RELEASE(X) void(ORT_API_CALL * Release##X)(_Frees_ptr_opt_ Ort##X * input) + +#ifdef __DOXYGEN__ +#undef ORT_API_STATUS +#define ORT_API_STATUS(NAME, ...) OrtStatus* NAME(__VA_ARGS__) +#undef ORT_API2_STATUS +#define ORT_API2_STATUS(NAME, ...) OrtStatus* NAME(__VA_ARGS__) +#undef ORT_CLASS_RELEASE +#define ORT_CLASS_RELEASE(X) void Release##X(Ort##X* input) +#undef NO_EXCEPTION +#define NO_EXCEPTION +#endif +/** \addtogroup Global + * ONNX Runtime C API + * @{ + */ + +/** Copied from TensorProto::DataType + * Currently, Ort doesn't support complex64, complex128 + */ +typedef enum ONNXTensorElementDataType { + ONNX_TENSOR_ELEMENT_DATA_TYPE_UNDEFINED, + ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT, // maps to c type float + ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT8, // maps to c type uint8_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_INT8, // maps to c type int8_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT16, // maps to c type uint16_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_INT16, // maps to c type int16_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_INT32, // maps to c type int32_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_INT64, // maps to c type int64_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_STRING, // maps to c++ type std::string + ONNX_TENSOR_ELEMENT_DATA_TYPE_BOOL, + ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT16, + ONNX_TENSOR_ELEMENT_DATA_TYPE_DOUBLE, // maps to c type double + ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT32, // maps to c type uint32_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT64, // maps to c type uint64_t + ONNX_TENSOR_ELEMENT_DATA_TYPE_COMPLEX64, // complex with float32 real and imaginary components + ONNX_TENSOR_ELEMENT_DATA_TYPE_COMPLEX128, // complex with float64 real and imaginary components + ONNX_TENSOR_ELEMENT_DATA_TYPE_BFLOAT16 // Non-IEEE floating-point format based on IEEE754 single-precision +} ONNXTensorElementDataType; + +// Synced with onnx TypeProto oneof +typedef enum ONNXType { + ONNX_TYPE_UNKNOWN, + ONNX_TYPE_TENSOR, + ONNX_TYPE_SEQUENCE, + ONNX_TYPE_MAP, + ONNX_TYPE_OPAQUE, + ONNX_TYPE_SPARSETENSOR, + ONNX_TYPE_OPTIONAL +} ONNXType; + +// These types are synced with internal +// SparseFormatFlags +typedef enum OrtSparseFormat { + ORT_SPARSE_UNDEFINED = 0, + ORT_SPARSE_COO = 0x1, + ORT_SPARSE_CSRC = 0x2, + ORT_SPARSE_BLOCK_SPARSE = 0x4 +} OrtSparseFormat; + +// Enum allows to query sparse tensor indices +enum OrtSparseIndicesFormat { + ORT_SPARSE_COO_INDICES, + ORT_SPARSE_CSR_INNER_INDICES, + ORT_SPARSE_CSR_OUTER_INDICES, + ORT_SPARSE_BLOCK_SPARSE_INDICES +}; + +/** \brief Logging severity levels + * + * In typical API usage, specifying a logging severity level specifies the minimum severity of log messages to show. + */ +typedef enum OrtLoggingLevel { + ORT_LOGGING_LEVEL_VERBOSE, ///< Verbose informational messages (least severe). + ORT_LOGGING_LEVEL_INFO, ///< Informational messages. + ORT_LOGGING_LEVEL_WARNING, ///< Warning messages. + ORT_LOGGING_LEVEL_ERROR, ///< Error messages. + ORT_LOGGING_LEVEL_FATAL, ///< Fatal error messages (most severe). +} OrtLoggingLevel; + +typedef enum OrtErrorCode { + ORT_OK, + ORT_FAIL, + ORT_INVALID_ARGUMENT, + ORT_NO_SUCHFILE, + ORT_NO_MODEL, + ORT_ENGINE_ERROR, + ORT_RUNTIME_EXCEPTION, + ORT_INVALID_PROTOBUF, + ORT_MODEL_LOADED, + ORT_NOT_IMPLEMENTED, + ORT_INVALID_GRAPH, + ORT_EP_FAIL, +} OrtErrorCode; + +typedef enum OrtOpAttrType { + ORT_OP_ATTR_UNDEFINED = 0, + ORT_OP_ATTR_INT, + ORT_OP_ATTR_INTS, + ORT_OP_ATTR_FLOAT, + ORT_OP_ATTR_FLOATS, + ORT_OP_ATTR_STRING, + ORT_OP_ATTR_STRINGS, +} OrtOpAttrType; + +//! @} +#define ORT_RUNTIME_CLASS(X) \ + struct Ort##X; \ + typedef struct Ort##X Ort##X; + +/** \addtogroup Global + * ONNX Runtime C API + * @{ + */ +// The actual types defined have an Ort prefix +ORT_RUNTIME_CLASS(Env); +ORT_RUNTIME_CLASS(Status); // nullptr for Status* indicates success +ORT_RUNTIME_CLASS(MemoryInfo); +ORT_RUNTIME_CLASS(IoBinding); +ORT_RUNTIME_CLASS(Session); // Don't call ReleaseSession from Dllmain (because session owns a thread pool) +ORT_RUNTIME_CLASS(Value); +ORT_RUNTIME_CLASS(RunOptions); +ORT_RUNTIME_CLASS(TypeInfo); +ORT_RUNTIME_CLASS(TensorTypeAndShapeInfo); +ORT_RUNTIME_CLASS(MapTypeInfo); +ORT_RUNTIME_CLASS(SequenceTypeInfo); +ORT_RUNTIME_CLASS(OptionalTypeInfo); +ORT_RUNTIME_CLASS(SessionOptions); +ORT_RUNTIME_CLASS(CustomOpDomain); +ORT_RUNTIME_CLASS(ModelMetadata); +ORT_RUNTIME_CLASS(ThreadPoolParams); +ORT_RUNTIME_CLASS(ThreadingOptions); +ORT_RUNTIME_CLASS(ArenaCfg); +ORT_RUNTIME_CLASS(PrepackedWeightsContainer); +ORT_RUNTIME_CLASS(TensorRTProviderOptionsV2); +ORT_RUNTIME_CLASS(CUDAProviderOptionsV2); +ORT_RUNTIME_CLASS(CANNProviderOptions); +ORT_RUNTIME_CLASS(DnnlProviderOptions); +ORT_RUNTIME_CLASS(Op); +ORT_RUNTIME_CLASS(OpAttr); +ORT_RUNTIME_CLASS(Logger); + +#ifdef _WIN32 +typedef _Return_type_success_(return == 0) OrtStatus* OrtStatusPtr; +#else +typedef OrtStatus* OrtStatusPtr; +#endif + +/** \brief Memory allocation interface + * + * Structure of function pointers that defines a memory allocator. This can be created and filled in by the user for custom allocators. + * + * When an allocator is passed to any function, be sure that the allocator object is not destroyed until the last allocated object using it is freed. + */ +typedef struct OrtAllocator { + uint32_t version; ///< Must be initialized to ORT_API_VERSION + void*(ORT_API_CALL* Alloc)(struct OrtAllocator* this_, size_t size); ///< Returns a pointer to an allocated block of `size` bytes + void(ORT_API_CALL* Free)(struct OrtAllocator* this_, void* p); ///< Free a block of memory previously allocated with OrtAllocator::Alloc + const struct OrtMemoryInfo*(ORT_API_CALL* Info)(const struct OrtAllocator* this_); ///< Return a pointer to an ::OrtMemoryInfo that describes this allocator +} OrtAllocator; + +typedef void(ORT_API_CALL* OrtLoggingFunction)( + void* param, OrtLoggingLevel severity, const char* category, const char* logid, const char* code_location, + const char* message); + +/** \brief Graph optimization level + * + * Refer to https://www.onnxruntime.ai/docs/performance/graph-optimizations.html#graph-optimization-levels + * for an in-depth understanding of the Graph Optimization Levels. + */ +typedef enum GraphOptimizationLevel { + ORT_DISABLE_ALL = 0, + ORT_ENABLE_BASIC = 1, + ORT_ENABLE_EXTENDED = 2, + ORT_ENABLE_ALL = 99 +} GraphOptimizationLevel; + +typedef enum ExecutionMode { + ORT_SEQUENTIAL = 0, + ORT_PARALLEL = 1, +} ExecutionMode; + +/** \brief Language projection identifiers + * /see OrtApi::SetLanguageProjection + */ +typedef enum OrtLanguageProjection { + ORT_PROJECTION_C = 0, + ORT_PROJECTION_CPLUSPLUS = 1, + ORT_PROJECTION_CSHARP = 2, + ORT_PROJECTION_PYTHON = 3, + ORT_PROJECTION_JAVA = 4, + ORT_PROJECTION_WINML = 5, + ORT_PROJECTION_NODEJS = 6, +} OrtLanguageProjection; + +struct OrtKernelInfo; +typedef struct OrtKernelInfo OrtKernelInfo; +struct OrtKernelContext; +typedef struct OrtKernelContext OrtKernelContext; +struct OrtCustomOp; +typedef struct OrtCustomOp OrtCustomOp; + +typedef enum OrtAllocatorType { + OrtInvalidAllocator = -1, + OrtDeviceAllocator = 0, + OrtArenaAllocator = 1 +} OrtAllocatorType; + +/** \brief Memory types for allocated memory, execution provider specific types should be extended in each provider. + */ +// Whenever this struct is updated, please also update the MakeKey function in onnxruntime / core / framework / execution_provider.cc +typedef enum OrtMemType { + OrtMemTypeCPUInput = -2, ///< Any CPU memory used by non-CPU execution provider + OrtMemTypeCPUOutput = -1, ///< CPU accessible memory outputted by non-CPU execution provider, i.e. CUDA_PINNED + OrtMemTypeCPU = OrtMemTypeCPUOutput, ///< Temporary CPU accessible memory allocated by non-CPU execution provider, i.e. CUDA_PINNED + OrtMemTypeDefault = 0, ///< The default allocator for execution provider +} OrtMemType; + +/** \brief This mimics OrtDevice type constants so they can be returned in the API + */ +typedef enum OrtMemoryInfoDeviceType { + OrtMemoryInfoDeviceType_CPU = 0, + OrtMemoryInfoDeviceType_GPU = 1, + OrtMemoryInfoDeviceType_FPGA = 2 +} OrtMemoryInfoDeviceType; + +/** \brief Algorithm to use for cuDNN Convolution Op + */ +typedef enum OrtCudnnConvAlgoSearch { + OrtCudnnConvAlgoSearchExhaustive, // expensive exhaustive benchmarking using cudnnFindConvolutionForwardAlgorithmEx + OrtCudnnConvAlgoSearchHeuristic, // lightweight heuristic based search using cudnnGetConvolutionForwardAlgorithm_v7 + OrtCudnnConvAlgoSearchDefault, // default algorithm using CUDNN_CONVOLUTION_FWD_ALGO_IMPLICIT_PRECOMP_GEMM +} OrtCudnnConvAlgoSearch; + +/** \brief CUDA Provider Options + * + * \see OrtApi::SessionOptionsAppendExecutionProvider_CUDA + */ +typedef struct OrtCUDAProviderOptions { +#ifdef __cplusplus + OrtCUDAProviderOptions() + : device_id{}, + cudnn_conv_algo_search{OrtCudnnConvAlgoSearchExhaustive}, + gpu_mem_limit{SIZE_MAX}, + arena_extend_strategy{}, + do_copy_in_default_stream{1}, + has_user_compute_stream{}, + user_compute_stream{}, + default_memory_arena_cfg{}, + tunable_op_enable{false}, + tunable_op_tuning_enable{false} {} +#endif + + /** \brief CUDA device Id + * Defaults to 0. + */ + int device_id; + + /** \brief CUDA Convolution algorithm search configuration. + * See enum OrtCudnnConvAlgoSearch for more details. + * Defaults to OrtCudnnConvAlgoSearchExhaustive. + */ + OrtCudnnConvAlgoSearch cudnn_conv_algo_search; + + /** \brief CUDA memory limit (To use all possible memory pass in maximum size_t) + * Defaults to SIZE_MAX. + * \note If a ::OrtArenaCfg has been applied, it will override this field + */ + size_t gpu_mem_limit; + + /** \brief Strategy used to grow the memory arena + * 0 = kNextPowerOfTwo
+ * 1 = kSameAsRequested
+ * Defaults to 0. + * \note If a ::OrtArenaCfg has been applied, it will override this field + */ + int arena_extend_strategy; + + /** \brief Flag indicating if copying needs to take place on the same stream as the compute stream in the CUDA EP + * 0 = Use separate streams for copying and compute. + * 1 = Use the same stream for copying and compute. + * Defaults to 1. + * WARNING: Setting this to 0 may result in data races for some models. + * Please see issue #4829 for more details. + */ + int do_copy_in_default_stream; + + /** \brief Flag indicating if there is a user provided compute stream + * Defaults to 0. + */ + int has_user_compute_stream; + + /** \brief User provided compute stream. + * If provided, please set `has_user_compute_stream` to 1. + */ + void* user_compute_stream; + + /** \brief CUDA memory arena configuration parameters + */ + OrtArenaCfg* default_memory_arena_cfg; + + /** \brief Enable TunableOp for using. + * Set it to 1/0 to enable/disable TunableOp. Otherwise, it is disabled by default. + * This option can be overriden by environment variable ORT_CUDA_TUNABLE_OP_ENABLE. + */ + int tunable_op_enable; + + /** \brief Enable TunableOp for tuning. + * Set it to 1/0 to enable/disable TunableOp tuning. Otherwise, it is disabled by default. + * This option can be overriden by environment variable ORT_CUDA_TUNABLE_OP_TUNING_ENABLE. + */ + int tunable_op_tuning_enable; + +} OrtCUDAProviderOptions; + +/** \brief ROCM Provider Options + * + * \see OrtApi::SessionOptionsAppendExecutionProvider_ROCM + */ +typedef struct OrtROCMProviderOptions { +#ifdef __cplusplus + OrtROCMProviderOptions() + : device_id{}, + miopen_conv_exhaustive_search{0}, + gpu_mem_limit{SIZE_MAX}, + arena_extend_strategy{}, + do_copy_in_default_stream{1}, + has_user_compute_stream{}, + user_compute_stream{}, + default_memory_arena_cfg{}, + tunable_op_enable{false}, + tunable_op_tuning_enable{false} {} +#endif + + /** \brief ROCM device Id + * Defaults to 0. + */ + int device_id; + + /** \brief ROCM MIOpen Convolution algorithm exaustive search option. + * Defaults to 0 (false). + */ + int miopen_conv_exhaustive_search; + + /** \brief ROCM memory limit (To use all possible memory pass in maximum size_t) + * Defaults to SIZE_MAX. + * \note If a ::OrtArenaCfg has been applied, it will override this field + */ + size_t gpu_mem_limit; + + /** \brief Strategy used to grow the memory arena + * 0 = kNextPowerOfTwo
+ * 1 = kSameAsRequested
+ * Defaults to 0. + * \note If a ::OrtArenaCfg has been applied, it will override this field + */ + int arena_extend_strategy; + + /** \brief Flag indicating if copying needs to take place on the same stream as the compute stream in the ROCM EP + * 0 = Use separate streams for copying and compute. + * 1 = Use the same stream for copying and compute. + * Defaults to 1. + * WARNING: Setting this to 0 may result in data races for some models. + * Please see issue #4829 for more details. + */ + int do_copy_in_default_stream; + + /** \brief Flag indicating if there is a user provided compute stream + * Defaults to 0. + */ + int has_user_compute_stream; + + /** \brief User provided compute stream. + * If provided, please set `has_user_compute_stream` to 1. + */ + void* user_compute_stream; + + /** \brief ROCM memory arena configuration parameters + */ + OrtArenaCfg* default_memory_arena_cfg; + + /** \brief Enable TunableOp for using. + * Set it to 1/0 to enable/disable TunableOp. Otherwise, it is disabled by default. + * This option can be overriden by environment variable ORT_ROCM_TUNABLE_OP_ENABLE. + */ + int tunable_op_enable; + + /** \brief Enable TunableOp for tuning. + * Set it to 1/0 to enable/disable TunableOp tuning. Otherwise, it is disabled by default. + * This option can be overriden by environment variable ORT_ROCM_TUNABLE_OP_TUNING_ENABLE. + */ + int tunable_op_tuning_enable; + +} OrtROCMProviderOptions; + +/** \brief TensorRT Provider Options + * + * \see OrtApi::SessionOptionsAppendExecutionProvider_TensorRT + */ +typedef struct OrtTensorRTProviderOptions { + int device_id; ///< CUDA device id (0 = default device) + int has_user_compute_stream; // indicator of user specified CUDA compute stream. + void* user_compute_stream; // user specified CUDA compute stream. + int trt_max_partition_iterations; // maximum iterations for TensorRT parser to get capability + int trt_min_subgraph_size; // minimum size of TensorRT subgraphs + size_t trt_max_workspace_size; // maximum workspace size for TensorRT. + int trt_fp16_enable; // enable TensorRT FP16 precision. Default 0 = false, nonzero = true + int trt_int8_enable; // enable TensorRT INT8 precision. Default 0 = false, nonzero = true + const char* trt_int8_calibration_table_name; // TensorRT INT8 calibration table name. + int trt_int8_use_native_calibration_table; // use native TensorRT generated calibration table. Default 0 = false, nonzero = true + int trt_dla_enable; // enable DLA. Default 0 = false, nonzero = true + int trt_dla_core; // DLA core number. Default 0 + int trt_dump_subgraphs; // dump TRT subgraph. Default 0 = false, nonzero = true + int trt_engine_cache_enable; // enable engine caching. Default 0 = false, nonzero = true + const char* trt_engine_cache_path; // specify engine cache path + int trt_engine_decryption_enable; // enable engine decryption. Default 0 = false, nonzero = true + const char* trt_engine_decryption_lib_path; // specify engine decryption library path + int trt_force_sequential_engine_build; // force building TensorRT engine sequentially. Default 0 = false, nonzero = true + // This is the legacy struct and don't add new fields here. + // For new field that can be represented by string, please add it in include/onnxruntime/core/providers/tensorrt/tensorrt_provider_options.h + // For non-string field, need to create a new separate api to handle it. +} OrtTensorRTProviderOptions; + +/** \brief MIGraphX Provider Options + * + * \see OrtApi::SessionOptionsAppendExecutionProvider_MIGraphX + */ +typedef struct OrtMIGraphXProviderOptions { + int device_id; // hip device id. + int migraphx_fp16_enable; // enable MIGraphX FP16 precision. Default 0 = false, nonzero = true + int migraphx_int8_enable; // enable MIGraphX INT8 precision. Default 0 = false, nonzero = true +} OrtMIGraphXProviderOptions; + +/** \brief OpenVINO Provider Options + * + * \see OrtApi::SessionOptionsAppendExecutionProvider_OpenVINO + */ +typedef struct OrtOpenVINOProviderOptions { +#ifdef __cplusplus + OrtOpenVINOProviderOptions() : device_type{}, + enable_vpu_fast_compile{}, + device_id{}, + num_of_threads{}, + cache_dir{}, + context{}, + enable_opencl_throttling{}, + enable_dynamic_shapes{} {} +#endif + /** \brief Device type string + * + * Valid settings are one of: "CPU_FP32", "CPU_FP16", "GPU_FP32", "GPU_FP16" + */ + const char* device_type; + unsigned char enable_vpu_fast_compile; ///< 0 = disabled, nonzero = enabled + const char* device_id; + size_t num_of_threads; ///< 0 = Use default number of threads + const char* cache_dir; // path is set to empty by default + void* context; + unsigned char enable_opencl_throttling; ///< 0 = disabled, nonzero = enabled + unsigned char enable_dynamic_shapes; ///< 0 = disabled, nonzero = enabled +} OrtOpenVINOProviderOptions; + +struct OrtApi; +typedef struct OrtApi OrtApi; + +struct OrtTrainingApi; +typedef struct OrtTrainingApi OrtTrainingApi; + +/** \brief The helper interface to get the right version of OrtApi + * + * Get a pointer to this structure through ::OrtGetApiBase + */ +struct OrtApiBase { + /** \brief Get a pointer to the requested version of the ::OrtApi + * + * \param[in] version Must be ::ORT_API_VERSION + * \return The ::OrtApi for the version requested, nullptr will be returned if this version is unsupported, for example when using a runtime + * older than the version created with this header file. + * + * One can call GetVersionString() to get the version of the Onnxruntime library for logging + * and error reporting purposes. + */ + const OrtApi*(ORT_API_CALL* GetApi)(uint32_t version)NO_EXCEPTION; + + /** \brief Returns a null terminated string of the version of the Onnxruntime library (eg: "1.8.1") + * + * \return UTF-8 encoded version string. Do not deallocate the returned buffer. + */ + const char*(ORT_API_CALL* GetVersionString)(void)NO_EXCEPTION; +}; + +typedef struct OrtApiBase OrtApiBase; + +/** \brief The Onnxruntime library's entry point to access the C API + * + * Call this to get the a pointer to an ::OrtApiBase + */ +ORT_EXPORT const OrtApiBase* ORT_API_CALL OrtGetApiBase(void) NO_EXCEPTION; + +/** \brief Thread work loop function + * + * Onnxruntime will provide the working loop on custom thread creation + * Argument is an onnxruntime built-in type which will be provided when thread pool calls OrtCustomCreateThreadFn + */ +typedef void (*OrtThreadWorkerFn)(void* ort_worker_fn_param); + +typedef const struct OrtCustomHandleType { + char __place_holder; +}* OrtCustomThreadHandle; + +/** \brief Ort custom thread creation function + * + * The function should return a thread handle to be used in onnxruntime thread pools + * Onnxruntime will throw exception on return value of nullptr or 0, indicating that the function failed to create a thread + */ +typedef OrtCustomThreadHandle (*OrtCustomCreateThreadFn)(void* ort_custom_thread_creation_options, OrtThreadWorkerFn ort_thread_worker_fn, void* ort_worker_fn_param); + +/** \brief Custom thread join function + * + * Onnxruntime thread pool destructor will call the function to join a custom thread. + * Argument ort_custom_thread_handle is the value returned by OrtCustomCreateThreadFn + */ +typedef void (*OrtCustomJoinThreadFn)(OrtCustomThreadHandle ort_custom_thread_handle); + +typedef OrtStatus*(ORT_API_CALL* RegisterCustomOpsFn)(OrtSessionOptions* options, const OrtApiBase* api); + +/** \brief The C API + * + * All C API functions are defined inside this structure as pointers to functions. + * Call OrtApiBase::GetApi to get a pointer to it + * + * \nosubgrouping + */ +struct OrtApi { + /// \name OrtStatus + /// @{ + + /** + * \brief Create an OrtStatus from a null terminated string + * + * \param[in] code + * \param[in] msg A null-terminated string. Its contents will be copied. + * \return A new OrtStatus object, must be destroyed with OrtApi::ReleaseStatus + */ + OrtStatus*(ORT_API_CALL* CreateStatus)(OrtErrorCode code, _In_ const char* msg)NO_EXCEPTION ORT_ALL_ARGS_NONNULL; + + /** \brief Get OrtErrorCode from OrtStatus + * + * \param[in] status + * \return OrtErrorCode that \p status was created with + */ + OrtErrorCode(ORT_API_CALL* GetErrorCode)(_In_ const OrtStatus* status) NO_EXCEPTION ORT_ALL_ARGS_NONNULL; + + /** \brief Get error string from OrtStatus + * + * \param[in] status + * \return The error message inside the `status`. Do not free the returned value. + */ + const char*(ORT_API_CALL* GetErrorMessage)(_In_ const OrtStatus* status)NO_EXCEPTION ORT_ALL_ARGS_NONNULL; + + /// @} + /// \name OrtEnv + /// @{ + + /** \brief Create an OrtEnv + * + * \param[in] log_severity_level The log severity level. + * \param[in] logid The log identifier. + * \param[out] out Returned newly created OrtEnv. Must be freed with OrtApi::ReleaseEnv + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateEnv, OrtLoggingLevel log_severity_level, _In_ const char* logid, _Outptr_ OrtEnv** out); + + /** \brief Create an OrtEnv + * + * \param[in] logging_function A pointer to a logging function. + * \param[in] logger_param A pointer to arbitrary data passed as the ::OrtLoggingFunction `param` parameter to + * `logging_function`. + * \param[in] log_severity_level The log severity level. + * \param[in] logid The log identifier. + * \param[out] out Returned newly created OrtEnv. Must be freed with OrtApi::ReleaseEnv + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateEnvWithCustomLogger, OrtLoggingFunction logging_function, _In_opt_ void* logger_param, + OrtLoggingLevel log_severity_level, _In_ const char* logid, _Outptr_ OrtEnv** out); + + /** \brief Enable Telemetry + * + * \note Telemetry events are on by default since they are lightweight + * \param[in] env + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(EnableTelemetryEvents, _In_ const OrtEnv* env); + /** \brief Disable Telemetry + * + * \see OrtApi::EnableTelemetryEvents + * \param[in] env + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(DisableTelemetryEvents, _In_ const OrtEnv* env); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief Create an OrtSession from a model file + * + * \param[in] env + * \param[in] model_path + * \param[in] options + * \param[out] out Returned newly created OrtSession. Must be freed with OrtApi::ReleaseSession + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + // TODO: document the path separator convention? '/' vs '\' + // TODO: should specify the access characteristics of model_path. Is this read only during the + // execution of CreateSession, or does the OrtSession retain a handle to the file/directory + // and continue to access throughout the OrtSession lifetime? + // What sort of access is needed to model_path : read or read/write? + ORT_API2_STATUS(CreateSession, _In_ const OrtEnv* env, _In_ const ORTCHAR_T* model_path, + _In_ const OrtSessionOptions* options, _Outptr_ OrtSession** out); + + /** \brief Create an OrtSession from memory + * + * \param[in] env + * \param[in] model_data + * \param[in] model_data_length + * \param[in] options + * \param[out] out Returned newly created OrtSession. Must be freed with OrtApi::ReleaseSession + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSessionFromArray, _In_ const OrtEnv* env, _In_ const void* model_data, size_t model_data_length, + _In_ const OrtSessionOptions* options, _Outptr_ OrtSession** out); + + /** \brief Run the model in an ::OrtSession + * + * Will not return until the model run has completed. Multiple threads might be used to run the model based on + * the options in the ::OrtSession and settings used when creating the ::OrtEnv + * + * \param[in] session + * \param[in] run_options If nullptr, will use a default ::OrtRunOptions + * \param[in] input_names Array of null terminated UTF8 encoded strings of the input names + * \param[in] inputs Array of ::OrtValue%s of the input values + * \param[in] input_len Number of elements in the input_names and inputs arrays + * \param[in] output_names Array of null terminated UTF8 encoded strings of the output names + * \param[in] output_names_len Number of elements in the output_names and outputs array + * \param[out] outputs Array of ::OrtValue%s that the outputs are stored in. This can also be + * an array of nullptr values, in this case ::OrtValue objects will be allocated and pointers + * to them will be set into the `outputs` array. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(Run, _Inout_ OrtSession* session, _In_opt_ const OrtRunOptions* run_options, + _In_reads_(input_len) const char* const* input_names, + _In_reads_(input_len) const OrtValue* const* inputs, size_t input_len, + _In_reads_(output_names_len) const char* const* output_names, size_t output_names_len, + _Inout_updates_all_(output_names_len) OrtValue** outputs); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Create an ::OrtSessionOptions object + * + * To use additional providers, you must build ORT with the extra providers enabled. Then call one of these + * functions to enable them in the session:
+ * OrtSessionOptionsAppendExecutionProvider_CPU
+ * OrtSessionOptionsAppendExecutionProvider_CUDA
+ * OrtSessionOptionsAppendExecutionProvider_(remaining providers...)
+ * The order they are called indicates the preference order as well. In other words call this method + * on your most preferred execution provider first followed by the less preferred ones. + * If none are called Ort will use its internal CPU execution provider. + * + * \param[out] options The newly created OrtSessionOptions. Must be freed with OrtApi::ReleaseSessionOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSessionOptions, _Outptr_ OrtSessionOptions** options); + + /** \brief Set filepath to save optimized model after graph level transformations + * + * \param[in] options + * \param[in] optimized_model_filepath + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetOptimizedModelFilePath, _Inout_ OrtSessionOptions* options, + _In_ const ORTCHAR_T* optimized_model_filepath); + + /** \brief Create a copy of an existing ::OrtSessionOptions + * + * \param[in] in_options OrtSessionOptions to copy + * \param[out] out_options Returned newly created ::OrtSessionOptions. Must be freed with OrtApi::ReleaseSessionOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CloneSessionOptions, _In_ const OrtSessionOptions* in_options, + _Outptr_ OrtSessionOptions** out_options); + + /** \brief Set execution mode + * + * Controls whether you want to execute operators in your graph sequentially or in parallel. Usually when the model + * has many branches, setting this option to ExecutionMode.ORT_PARALLEL will give you better performance. + * See [docs/ONNX_Runtime_Perf_Tuning.md] for more details. + * + * \param[in] options + * \param[in] execution_mode + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetSessionExecutionMode, _Inout_ OrtSessionOptions* options, ExecutionMode execution_mode); + + /** \brief Enable profiling for a session + * + * \param[in] options + * \param[in] profile_file_prefix + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(EnableProfiling, _Inout_ OrtSessionOptions* options, _In_ const ORTCHAR_T* profile_file_prefix); + + /** \brief Disable profiling for a session + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(DisableProfiling, _Inout_ OrtSessionOptions* options); + + /** \brief Enable the memory pattern optimization + * + * The idea is if the input shapes are the same, we could trace the internal memory allocation + * and generate a memory pattern for future request. So next time we could just do one allocation + * with a big chunk for all the internal memory allocation. + * \note Memory pattern optimization is only available when Sequential Execution mode is enabled (see OrtApi::SetSessionExecutionMode) + * + * \see OrtApi::DisableMemPattern + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(EnableMemPattern, _Inout_ OrtSessionOptions* options); + + /** \brief Disable the memory pattern optimization + * + * \see OrtApi::EnableMemPattern + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(DisableMemPattern, _Inout_ OrtSessionOptions* options); + + /** \brief Enable the memory arena on CPU + * + * Arena may pre-allocate memory for future usage. + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(EnableCpuMemArena, _Inout_ OrtSessionOptions* options); + + /** \brief Disable the memory arena on CPU + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(DisableCpuMemArena, _Inout_ OrtSessionOptions* options); + + /** \brief Set session log id + * + * \param[in] options + * \param[in] logid The log identifier. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetSessionLogId, _Inout_ OrtSessionOptions* options, const char* logid); + + /** \brief Set session log verbosity level + * + * Applies to session load, initialization, etc + * + * \param[in] options + * \param[in] session_log_verbosity_level \snippet{doc} snippets.dox Log Verbosity Level + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetSessionLogVerbosityLevel, _Inout_ OrtSessionOptions* options, int session_log_verbosity_level); + + /** \brief Set session log severity level + * + * \param[in] options + * \param[in] session_log_severity_level The log severity level (refer to ::OrtLoggingLevel for possible values). + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetSessionLogSeverityLevel, _Inout_ OrtSessionOptions* options, int session_log_severity_level); + + /** \brief Set the optimization level to apply when loading a graph + * + * Please see https://onnxruntime.ai/docs/performance/graph-optimizations.html for an in-depth explanation + * \param[in,out] options The session options object + * \param[in] graph_optimization_level The optimization level + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetSessionGraphOptimizationLevel, _Inout_ OrtSessionOptions* options, + GraphOptimizationLevel graph_optimization_level); + + /** \brief Sets the number of threads used to parallelize the execution within nodes + * + * When running a single node operation, ex. add, this sets the maximum number of threads to use. + * + * \note If built with OpenMP, this has no effect on the number of threads used. In this case + * use the OpenMP env variables to configure the number of intra op num threads. + * + * \param[in] options + * \param[in] intra_op_num_threads Number of threads to use
+ * A value of 0 will use the default number of threads
+ * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetIntraOpNumThreads, _Inout_ OrtSessionOptions* options, int intra_op_num_threads); + + /** \brief Sets the number of threads used to parallelize the execution of the graph + * + * If nodes can be run in parallel, this sets the maximum number of threads to use to run them in parallel. + * + * \note If sequential execution is enabled this value is ignored, it acts as if it was set to 1. + * + * \param[in] options + * \param[in] inter_op_num_threads Number of threads to use
+ * A value of 0 will use the default number of threads
+ * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetInterOpNumThreads, _Inout_ OrtSessionOptions* options, int inter_op_num_threads); + + /// @} + /// \name OrtCustomOpDomain + /// @{ + + /** \brief Create a custom op domain + * + * \param[in] domain + * \param[out] out Newly created domain. Must be freed with OrtApi::ReleaseCustomOpDomain + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateCustomOpDomain, _In_ const char* domain, _Outptr_ OrtCustomOpDomain** out); + + /** \brief Add a custom op to a custom op domain + * + * \note The OrtCustomOp* pointer must remain valid until the ::OrtCustomOpDomain using it is released + * + * \param[in] custom_op_domain + * \param[in] op + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CustomOpDomain_Add, _Inout_ OrtCustomOpDomain* custom_op_domain, _In_ const OrtCustomOp* op); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Add custom op domain to a session options + * + * \note The OrtCustomOpDomain* must not be deleted until all sessions using it are released + * + * \param[in] options + * \param[in] custom_op_domain + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(AddCustomOpDomain, _Inout_ OrtSessionOptions* options, _In_ OrtCustomOpDomain* custom_op_domain); + + /** \deprecated Use OrtApi::RegisterCustomOpsLibrary_V2. + * + * Registers custom ops from a shared library. + * + * Loads a shared library (dll on windows, so on linux, etc) named 'library_path' and looks for this entry point: + * OrtStatus* RegisterCustomOps(OrtSessionOptions * options, const OrtApiBase* api); + * It then passes in the provided session options to this function along with the api base. + * The handle to the loaded library is returned in library_handle. It can be freed by the caller after all sessions using the passed in + * session options are destroyed, or if an error occurs and it is non null. + * + * \param[in] options + * \param[in] library_path + * \param[out] library_handle OS specific handle to the loaded library (Use FreeLibrary on Windows, dlclose on Linux, etc.. to unload) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RegisterCustomOpsLibrary, _Inout_ OrtSessionOptions* options, _In_ const char* library_path, _Outptr_ void** library_handle); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief Get input count for a session + * + * This number must also match the number of inputs passed to OrtApi::Run + * + * \see OrtApi::SessionGetInputTypeInfo, OrtApi::SessionGetInputName, OrtApi::Session + * + * \param[in] session + * \param[out] out Number of inputs + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetInputCount, _In_ const OrtSession* session, _Out_ size_t* out); + + /** \brief Get output count for a session + * + * This number must also match the number of outputs returned by OrtApi::Run + * + * \see OrtApi::SessionGetOutputTypeInfo, OrtApi::SessionGetOutputName, OrtApi::Session + * + * \param[in] session + * \param[out] out Number of outputs + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOutputCount, _In_ const OrtSession* session, _Out_ size_t* out); + + /** \brief Get overridable initializer count + * + * \see OrtApi::SessionGetOverridableInitializerTypeInfo, OrtApi::SessionGetOverridableInitializerName + * + * \param[in] session + * \param[in] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOverridableInitializerCount, _In_ const OrtSession* session, _Out_ size_t* out); + + /** \brief Get input type information + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetInputCount returns (exclusive) + * \param[out] type_info Must be freed with OrtApi::ReleaseTypeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetInputTypeInfo, _In_ const OrtSession* session, size_t index, _Outptr_ OrtTypeInfo** type_info); + + /** \brief Get output type information + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetOutputCount returns (exclusive) + * \param[out] type_info Must be freed with OrtApi::ReleaseTypeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOutputTypeInfo, _In_ const OrtSession* session, size_t index, _Outptr_ OrtTypeInfo** type_info); + + /** \brief Get overridable initializer type information + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetOverridableInitializerCount returns (exclusive) + * \param[out] type_info Must be freed with OrtApi::ReleaseTypeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOverridableInitializerTypeInfo, _In_ const OrtSession* session, size_t index, _Outptr_ OrtTypeInfo** type_info); + + /** \brief Get input name + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetInputCount returns (exclusive) + * \param[in] allocator + * \param[out] value Set to a null terminated UTF-8 encoded string allocated using `allocator`. Must be freed using `allocator`. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetInputName, _In_ const OrtSession* session, size_t index, _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /** \brief Get output name + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetOutputCount returns (exclusive) + * \param[in] allocator + * \param[out] value Set to a null terminated UTF-8 encoded string allocated using `allocator`. Must be freed using `allocator`. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOutputName, _In_ const OrtSession* session, size_t index, _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /** \brief Get overridable initializer name + * + * \param[in] session + * \param[in] index Must be between 0 (inclusive) and what OrtApi::SessionGetOverridableInitializerCount returns (exclusive) + * \param[in] allocator + * \param[out] value Set to a null terminated UTF-8 encoded string allocated using `allocator`. Must be freed using `allocator`. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetOverridableInitializerName, _In_ const OrtSession* session, size_t index, + _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /// @} + /// \name OrtRunOptions + /// @{ + + /** \brief Create an OrtRunOptions + * + * \param[out] out Returned newly created ::OrtRunOptions. Must be freed with OrtApi::ReleaseRunOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateRunOptions, _Outptr_ OrtRunOptions** out); + + /** \brief Set per-run log verbosity level + * + * \see OrtApi::RunOptionsGetRunLogVerbosityLevel + * + * \param[in] options + * \param[in] log_verbosity_level \snippet{doc} snippets.dox Log Verbosity Level + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RunOptionsSetRunLogVerbosityLevel, _Inout_ OrtRunOptions* options, int log_verbosity_level); + + /** \brief Set per-run log severity level + * + * \see OrtApi::RunOptionsGetRunLogSeverityLevel + * + * \param[in] options + * \param[in] log_severity_level The log severity level (refer to ::OrtLoggingLevel for possible values). + */ + ORT_API2_STATUS(RunOptionsSetRunLogSeverityLevel, _Inout_ OrtRunOptions* options, int log_severity_level); + + /** \brief Set per-run tag + * + * This is used in a per-run log identifier. + * + * \see OrtApi::RunOptionsGetRunTag + * + * \param[in] options + * \param[in] run_tag The run tag. + */ + ORT_API2_STATUS(RunOptionsSetRunTag, _Inout_ OrtRunOptions* options, _In_ const char* run_tag); + + /** \brief Get per-run log verbosity level + * + * \see OrtApi::RunOptionsSetRunLogVerbosityLevel + * + * \param[in] options + * \param[out] log_verbosity_level \snippet{doc} snippets.dox Log Verbosity Level + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RunOptionsGetRunLogVerbosityLevel, _In_ const OrtRunOptions* options, + _Out_ int* log_verbosity_level); + + /** \brief Get per-run log severity level + * + * \see OrtApi::RunOptionsSetRunLogSeverityLevel + * + * \param[in] options + * \param[out] log_severity_level The log severity level (refer to ::OrtLoggingLevel for possible values). + */ + ORT_API2_STATUS(RunOptionsGetRunLogSeverityLevel, _In_ const OrtRunOptions* options, _Out_ int* log_severity_level); + + /** \brief Get per-run tag + * + * This is used in a per-run log identifier. + * + * \see OrtApi::RunOptionsSetRunTag + * + * \param[in] options + * \param[out] run_tag The run tag. + * Do not free this value, it is owned by `options`. It will be invalidated if the run tag + * changes (i.e., with OrtApi::RunOptionsSetRunTag) or `options` is freed. + */ + ORT_API2_STATUS(RunOptionsGetRunTag, _In_ const OrtRunOptions* options, _Out_ const char** run_tag); + + /** \brief Set terminate flag + * + * If a currently executing session needs to be force terminated, this can be called from another thread to force it to fail with an error. + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RunOptionsSetTerminate, _Inout_ OrtRunOptions* options); + + /** \brief Clears the terminate flag + * + * Used so the OrtRunOptions instance can be used in a new OrtApi::Run call without it instantly terminating + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RunOptionsUnsetTerminate, _Inout_ OrtRunOptions* options); + + /// @} + /// \name OrtValue + /// @{ + + /** \brief Create a tensor + * + * Create a tensor using a supplied ::OrtAllocator + * + * \param[in] allocator + * \param[in] shape Pointer to the tensor shape dimensions. + * \param[in] shape_len The number of tensor shape dimensions. + * \param[in] type + * \param[out] out Returns newly created ::OrtValue. Must be freed with OrtApi::ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateTensorAsOrtValue, _Inout_ OrtAllocator* allocator, _In_ const int64_t* shape, size_t shape_len, + ONNXTensorElementDataType type, _Outptr_ OrtValue** out); + + /** \brief Create a tensor backed by a user supplied buffer + * + * Create a tensor with user's buffer. You can fill the buffer either before calling this function or after. + * p_data is owned by caller. ReleaseValue won't release p_data. + * + * \param[in] info Memory description of where the p_data buffer resides (CPU vs GPU etc). + * \param[in] p_data Pointer to the data buffer. + * \param[in] p_data_len The number of bytes in the data buffer. + * \param[in] shape Pointer to the tensor shape dimensions. + * \param[in] shape_len The number of tensor shape dimensions. + * \param[in] type The data type. + * \param[out] out Returns newly created ::OrtValue. Must be freed with OrtApi::ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateTensorWithDataAsOrtValue, _In_ const OrtMemoryInfo* info, _Inout_ void* p_data, + size_t p_data_len, _In_ const int64_t* shape, size_t shape_len, ONNXTensorElementDataType type, + _Outptr_ OrtValue** out); + + /** \brief Return if an ::OrtValue is a tensor type + * + * \param[in] value A tensor type (string tensors are not supported) + * \param[out] out Set to 1 iff ::OrtValue is a tensor, 0 otherwise + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(IsTensor, _In_ const OrtValue* value, _Out_ int* out); + + /** \brief Get a pointer to the raw data inside a tensor + * + * Used to read/write/modify the internal tensor data directly. + * \note The returned pointer is valid until the \p value is destroyed. + * + * \param[in] value A tensor type (string tensors are not supported) + * \param[out] out Filled in with a pointer to the internal storage + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorMutableData, _In_ OrtValue* value, _Outptr_ void** out); + + /** \brief Set all strings at once in a string tensor + * + * \param[in,out] value A tensor of type ONNX_TENSOR_ELEMENT_DATA_TYPE_STRING + * \param[in] s An array of strings. Each string in this array must be null terminated. + * \param[in] s_len Count of strings in s (Must match the size of \p value's tensor shape) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(FillStringTensor, _Inout_ OrtValue* value, _In_ const char* const* s, size_t s_len); + + /** \brief Get total byte length for all strings in a string tensor + * + * Typically used with OrtApi::GetStringTensorContent + * + * \param[in] value A tensor of type ONNX_TENSOR_ELEMENT_DATA_TYPE_STRING + * \param[out] len Total byte length of all strings (does not include trailing nulls) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetStringTensorDataLength, _In_ const OrtValue* value, _Out_ size_t* len); + + /** \brief Get all strings from a string tensor + * + * An example of the results:
+ * Given \p value is a string tensor with the strings { "This" "is" "a" "test" }
+ * \p s must have a size of 11 bytes
+ * \p offsets must have 4 elements
+ * After the call, these values will be filled in:
+ * \p s will contain "Thisisatest"
+ * \p offsets will contain { 0, 4, 6, 7 }
+ * The length of the last string is just s_len - offsets[last] + * + * \param[in] value A tensor of type ONNX_TENSOR_ELEMENT_DATA_TYPE_STRING + * \param[in] s Buffer to sequentially write all tensor strings to. Each string is NOT null-terminated. + * \param[in] s_len Number of bytes of buffer pointed to by \p s (Get it from OrtApi::GetStringTensorDataLength) + * \param[out] offsets Array of start offsets into the strings written to \p s + * \param[in] offsets_len Number of elements in offsets + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetStringTensorContent, _In_ const OrtValue* value, _Out_writes_bytes_all_(s_len) void* s, + size_t s_len, _Out_writes_all_(offsets_len) size_t* offsets, size_t offsets_len); + + /// @} + /// \name OrtTypeInfo + /// @{ + + /** \brief Get ::OrtTensorTypeAndShapeInfo from an ::OrtTypeInfo + * + * \param[in] type_info + * \param[out] out Do not free this value, it will be valid until type_info is freed. + * If type_info does not represent tensor, this value will be set to nullptr. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CastTypeInfoToTensorInfo, _In_ const OrtTypeInfo* type_info, + _Outptr_result_maybenull_ const OrtTensorTypeAndShapeInfo** out); + + /** \brief Get ::ONNXType from ::OrtTypeInfo + * + * \param[in] type_info + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetOnnxTypeFromTypeInfo, _In_ const OrtTypeInfo* type_info, _Out_ enum ONNXType* out); + + /// @} + /// \name OrtTensorTypeAndShapeInfo + /// @{ + + /** \brief Create an ::OrtTensorTypeAndShapeInfo object + * + * \param[out] out Returns newly created ::OrtTensorTypeAndShapeInfo. Must be freed with OrtApi::ReleaseTensorTypeAndShapeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateTensorTypeAndShapeInfo, _Outptr_ OrtTensorTypeAndShapeInfo** out); + + /** \brief Set element type in ::OrtTensorTypeAndShapeInfo + * + * \param[in] info + * \param[in] type + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetTensorElementType, _Inout_ OrtTensorTypeAndShapeInfo* info, enum ONNXTensorElementDataType type); + + /** \brief Set shape information in ::OrtTensorTypeAndShapeInfo + * + * \param[in] info + * \param[in] dim_values Array with `dim_count` elements. Can contain negative values. + * \param[in] dim_count Number of elements in `dim_values` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetDimensions, OrtTensorTypeAndShapeInfo* info, _In_ const int64_t* dim_values, size_t dim_count); + + /** \brief Get element type in ::OrtTensorTypeAndShapeInfo + * + * \see OrtApi::SetTensorElementType + * + * \param[in] info + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorElementType, _In_ const OrtTensorTypeAndShapeInfo* info, + _Out_ enum ONNXTensorElementDataType* out); + + /** \brief Get dimension count in ::OrtTensorTypeAndShapeInfo + * + * \see OrtApi::GetDimensions + * + * \param[in] info + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetDimensionsCount, _In_ const OrtTensorTypeAndShapeInfo* info, _Out_ size_t* out); + + /** \brief Get dimensions in ::OrtTensorTypeAndShapeInfo + * + * \param[in] info + * \param[out] dim_values Array with `dim_values_length` elements. On return, filled with the dimensions stored in the ::OrtTensorTypeAndShapeInfo + * \param[in] dim_values_length Number of elements in `dim_values`. Use OrtApi::GetDimensionsCount to get this value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetDimensions, _In_ const OrtTensorTypeAndShapeInfo* info, _Out_ int64_t* dim_values, + size_t dim_values_length); + + /** \brief Get symbolic dimension names in ::OrtTensorTypeAndShapeInfo + * + * \param[in] info + * \param[in] dim_params Array with `dim_params_length` elements. On return filled with pointers to null terminated strings of the dimension names + * \param[in] dim_params_length Number of elements in `dim_params`. Use OrtApi::GetDimensionsCount to get this value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSymbolicDimensions, _In_ const OrtTensorTypeAndShapeInfo* info, + _Out_writes_all_(dim_params_length) const char* dim_params[], size_t dim_params_length); + + /** \brief Get total number of elements in a tensor shape from an ::OrtTensorTypeAndShapeInfo + * + * Return the number of elements specified by the tensor shape (all dimensions multiplied by each other). + * For 0 dimensions, 1 is returned. If any dimension is less than 0, the result is always -1. + * + * Examples:
+ * [] = 1
+ * [1,3,4] = 12
+ * [2,0,4] = 0
+ * [-1,3,4] = -1
+ * + * \param[in] info + * \param[out] out Number of elements + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorShapeElementCount, _In_ const OrtTensorTypeAndShapeInfo* info, _Out_ size_t* out); + + /// @} + /// \name OrtValue + /// @{ + + /** \brief Get type and shape information from a tensor ::OrtValue + * + * \param[in] value Must be a tensor (not a map/sequence/etc) or will return failure + * \param[out] out Newly created ::OrtTensorTypeAndShapeInfo. Must be freed with OrtApi::ReleaseTensorTypeAndShapeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorTypeAndShape, _In_ const OrtValue* value, _Outptr_ OrtTensorTypeAndShapeInfo** out); + + /** \brief Get type information of an OrtValue + * + * \param[in] value + * \param[out] out Newly created ::OrtTypeInfo. Must be freed with OrtApi::ReleaseTypeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTypeInfo, _In_ const OrtValue* value, _Outptr_result_maybenull_ OrtTypeInfo** out); + + /** \brief Get ONNXType of an ::OrtValue + * + * \param[in] value + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetValueType, _In_ const OrtValue* value, _Out_ enum ONNXType* out); + + /// @} + /// \name OrtMemoryInfo + /// @{ + + /** \brief Create an ::OrtMemoryInfo + * + * \param[in] name + * \param[in] type + * \param[in] id + * \param[in] mem_type + * \param[out] out Newly created ::OrtMemoryInfo. Must be freed with OrtAPi::ReleaseMemoryInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateMemoryInfo, _In_ const char* name, enum OrtAllocatorType type, int id, + enum OrtMemType mem_type, _Outptr_ OrtMemoryInfo** out); + + /** \brief Create an ::OrtMemoryInfo for CPU memory + * + * Special case version of OrtApi::CreateMemoryInfo for CPU based memory. Same as using OrtApi::CreateMemoryInfo with name = "Cpu" and id = 0. + * + * \param[in] type + * \param[in] mem_type + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateCpuMemoryInfo, enum OrtAllocatorType type, enum OrtMemType mem_type, + _Outptr_ OrtMemoryInfo** out); + + /** \brief Compare ::OrtMemoryInfo objects for equality + * + * Compares all settings of each ::OrtMemoryInfo for equality + * + * \param[in] info1 + * \param[in] info2 + * \param[out] out Set to 0 if equal, -1 if not equal + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CompareMemoryInfo, _In_ const OrtMemoryInfo* info1, _In_ const OrtMemoryInfo* info2, _Out_ int* out); + + /** \brief Get name from ::OrtMemoryInfo + * + * \param[in] ptr + * \param[out] out Writes null terminated string to this pointer. Do NOT free the returned pointer. It is valid for the lifetime of the ::OrtMemoryInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(MemoryInfoGetName, _In_ const OrtMemoryInfo* ptr, _Out_ const char** out); + + /** \brief Get the id from ::OrtMemoryInfo + */ + ORT_API2_STATUS(MemoryInfoGetId, _In_ const OrtMemoryInfo* ptr, _Out_ int* out); + + /** \brief Get the ::OrtMemType from ::OrtMemoryInfo + */ + ORT_API2_STATUS(MemoryInfoGetMemType, _In_ const OrtMemoryInfo* ptr, _Out_ OrtMemType* out); + + /** \brief Get the ::OrtAllocatorType from ::OrtMemoryInfo + */ + ORT_API2_STATUS(MemoryInfoGetType, _In_ const OrtMemoryInfo* ptr, _Out_ OrtAllocatorType* out); + + /// @} + /// \name OrtAllocator + /// @{ + + /// \brief Calls OrtAllocator::Alloc function + ORT_API2_STATUS(AllocatorAlloc, _Inout_ OrtAllocator* ort_allocator, size_t size, _Outptr_ void** out); + /// \brief Calls OrtAllocator::Free function + ORT_API2_STATUS(AllocatorFree, _Inout_ OrtAllocator* ort_allocator, void* p); + /// \brief Calls OrtAllocator::Info function + ORT_API2_STATUS(AllocatorGetInfo, _In_ const OrtAllocator* ort_allocator, _Outptr_ const struct OrtMemoryInfo** out); + + /** \brief Get the default allocator + * + * The default allocator is a CPU based, non-arena. Always returns the same pointer to the same default allocator. + * + * \param[out] out Returned value should NOT be freed + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetAllocatorWithDefaultOptions, _Outptr_ OrtAllocator** out); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Override session symbolic dimensions + * + * Override symbolic dimensions (by specific denotation strings) with actual values if known at session initialization time to enable + * optimizations that can take advantage of fixed values (such as memory planning, etc) + * + * \param[in] options + * \param[in] dim_denotation + * \param[in] dim_value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(AddFreeDimensionOverride, _Inout_ OrtSessionOptions* options, _In_ const char* dim_denotation, + _In_ int64_t dim_value); + + /// @} + /// \name OrtValue + /// @{ + + /* Internal information (not seen in Doxygen) + * + * APIs to support non-tensor types - map and sequence. + * Currently only the following types are supported + * Note: the following types should be kept in sync with data_types.h + * Map types + * ========= + * std::map + * std::map + * std::map + * std::map + * std::map + * std::map + * std::map + * std::map + * + * Sequence types + * ============== + * std::vector + * std::vector + * std::vector + * std::vector + * std::vector> + * std::vector + */ + + /** \brief Get non tensor data from an ::OrtValue + * + * If `value` is of type ONNX_TYPE_MAP, you need to retrieve the keys and values + * separately. Use index=0 to retrieve keys and index=1 to retrieve values. + * If `value` is of type ONNX_TYPE_SEQUENCE, use index to retrieve the index'th element + * of the sequence. + * + * \param[in] value + * \param[in] index See above for usage based on `value` type + * \param[in] allocator Allocator used to allocate ::OrtValue + * \param[out] out Created ::OrtValue that holds the element requested. Must be freed with OrtApi::ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetValue, _In_ const OrtValue* value, int index, _Inout_ OrtAllocator* allocator, + _Outptr_ OrtValue** out); + + /** \brief Get non tensor value count from an ::OrtValue + * + * If `value` is of type ONNX_TYPE_MAP 2 will always be returned. For ONNX_TYPE_SEQUENCE + * the number of elements in the sequence will be returned + * + * \param[in] value + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetValueCount, _In_ const OrtValue* value, _Out_ size_t* out); + + /** \brief Create a map or sequence ::OrtValue + * + * To construct a map (ONNX_TYPE_MAP), use num_values = 2 and `in` should be an array of 2 ::OrtValue%s + * representing keys and values.
+ * + * To construct a sequence (ONNX_TYPE_SEQUENCE), use num_values = N where N is the number of the elements in the + * sequence. 'in' should be an array of N ::OrtValue%s. + * + * \param[in] in See above for details + * \param[in] num_values + * \param[in] value_type Must be either ONNX_TYPE_MAP or ONNX_TYPE_SEQUENCE + * \param[out] out Newly created ::OrtValue. Must be freed with OrtApi::ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateValue, _In_reads_(num_values) const OrtValue* const* in, size_t num_values, + enum ONNXType value_type, _Outptr_ OrtValue** out); + + /** \brief Create an opaque (custom user defined type) ::OrtValue + * + * Constructs an ::OrtValue that contains a value of non-standard type created for + * experiments or while awaiting standardization. ::OrtValue in this case would contain + * an internal representation of the Opaque type. Opaque types are distinguished from + * each other by two strings 1) domain and 2) type name. The combination of the two + * must be unique, so the type representation is properly identified internally. The combination + * must be properly registered from within ORT at both compile/run time or by another API. + * + * To construct the ::OrtValue pass domain and type names, also a pointer to a data container + * the type of which must be known to both ORT and the client program. That data container may or may + * not match the internal representation of the Opaque type. The sizeof(data_container) is passed for + * verification purposes. + * + * \param[in] domain_name Null terminated string of the domain name + * \param[in] type_name Null terminated string of the type name + * \param[in] data_container User pointer Data to populate ::OrtValue + * \param[in] data_container_size Size in bytes of what `data_container` points to + * \param[out] out Newly created ::OrtValue. Must be freed with OrtApi::ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateOpaqueValue, _In_z_ const char* domain_name, _In_z_ const char* type_name, + _In_ const void* data_container, size_t data_container_size, _Outptr_ OrtValue** out); + + /** \brief Get internal data from an opaque (custom user defined type) ::OrtValue + * + * Copies internal data from an opaque value into a user provided buffer + * + * \see OrtApi::CreateOpaqueValue + * + * \param[in] domain_name Null terminated string of the domain name + * \param[in] type_name Null terminated string of the type name + * \param[in] in The opaque ::OrtValue + * \param[out] data_container Buffer to copy data into + * \param[out] data_container_size Size in bytes of the buffer pointed to by data_container. Must match the size of the internal buffer. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetOpaqueValue, _In_ const char* domain_name, _In_ const char* type_name, _In_ const OrtValue* in, + _Out_ void* data_container, size_t data_container_size); + + /// @} + /// \name OrtKernelInfo + /// Custom operator APIs. + /// @{ + + /** \brief Get a float stored as an attribute in the graph node + * + * \param[in] info ::OrtKernelInfo instance + * \param[in] name Null terminated string of the name of the attribute + * \param[out] out Pointer to memory where the attribute will be stored + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttribute_float, _In_ const OrtKernelInfo* info, _In_ const char* name, + _Out_ float* out); + + /** \brief Fetch a 64-bit int stored as an attribute in the graph node + * + * \param[in] info ::OrtKernelInfo instance + * \param[in] name Null terminated string of the name of the attribute + * \param[out] out Pointer to memory where the attribute will be stored + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttribute_int64, _In_ const OrtKernelInfo* info, _In_ const char* name, + _Out_ int64_t* out); + + /** \brief Fetch a string stored as an attribute in the graph node + * + * If `out` is nullptr, the value of `size` is set to the true size of the string + * attribute, and a success status is returned. + * + * If the `size` parameter is greater than or equal to the actual string attribute's size, + * the value of `size` is set to the true size of the string attribute, the provided memory + * is filled with the attribute's contents, and a success status is returned. + * + * If the `size` parameter is less than the actual string attribute's size and `out` + * is not nullptr, the value of `size` is set to the true size of the string attribute + * and a failure status is returned.) + * + * \param[in] info ::OrtKernelInfo instance + * \param[in] name Null terminated string of the name of the attribute + * \param[out] out Pointer to memory where the attribute will be stored + * \param[in,out] size See above comments for details + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttribute_string, _In_ const OrtKernelInfo* info, _In_ const char* name, _Out_ char* out, + _Inout_ size_t* size); + + /// @} + /// \name OrtKernelContext + /// Custom operator APIs. + /// @{ + + /** \brief Used for custom operators, get the input count of a kernel + * + * \see ::OrtCustomOp + */ + ORT_API2_STATUS(KernelContext_GetInputCount, _In_ const OrtKernelContext* context, _Out_ size_t* out); + + /** \brief Used for custom operators, get the output count of a kernel + * + * \see ::OrtCustomOp + */ + ORT_API2_STATUS(KernelContext_GetOutputCount, _In_ const OrtKernelContext* context, _Out_ size_t* out); + + /** \brief Used for custom operators, get an input of a kernel + * + * \see ::OrtCustomOp + */ + ORT_API2_STATUS(KernelContext_GetInput, _In_ const OrtKernelContext* context, _In_ size_t index, + _Out_ const OrtValue** out); + + /** \brief Used for custom operators, get an output of a kernel + * + * \see ::OrtCustomOp + */ + ORT_API2_STATUS(KernelContext_GetOutput, _Inout_ OrtKernelContext* context, _In_ size_t index, + _In_ const int64_t* dim_values, size_t dim_count, _Outptr_ OrtValue** out); + + /// @} + /// \name OrtEnv + /// @{ + ORT_CLASS_RELEASE(Env); + /// @} + /// \name OrtStatus + /// @{ + ORT_CLASS_RELEASE(Status); + /// @} + /// \name OrtMemoryInfo + /// @{ + ORT_CLASS_RELEASE(MemoryInfo); + /// @} + /// \name OrtSession + /// @{ + ORT_CLASS_RELEASE(Session); // Don't call ReleaseSession from Dllmain (because session owns a thread pool) + /// @} + /// \name OrtValue + /// @{ + ORT_CLASS_RELEASE(Value); + /// @} + /// \name OrtRunOptions + /// @{ + ORT_CLASS_RELEASE(RunOptions); + /// @} + /// \name OrtTypeInfo + /// @{ + ORT_CLASS_RELEASE(TypeInfo); + /// @} + /// \name OrtTensorTypeAndShapeInfo + /// @{ + ORT_CLASS_RELEASE(TensorTypeAndShapeInfo); + /// @} + /// \name OrtSessionOptions + /// @{ + ORT_CLASS_RELEASE(SessionOptions); + /// @} + /// \name OrtCustomOpDomain + /// @{ + ORT_CLASS_RELEASE(CustomOpDomain); + + /// @} + /// \name OrtTypeInfo + /// @{ + + /** \brief Get denotation from type information + * + * Augments ::OrtTypeInfo to return denotations on the type. + * + * This is used by WinML to determine if an input/output is intended to be an Image or a Tensor. + * + * \param[in] type_info + * \param[out] denotation Pointer to the null terminated denotation string is written to this pointer. This pointer is valid until the object is destroyed or the name is changed, do not free. + * \param[out] len Length in bytes of the string returned in `denotation` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetDenotationFromTypeInfo, _In_ const OrtTypeInfo* type_info, _Out_ const char** const denotation, + _Out_ size_t* len); + + /** \brief Get detailed map information from an ::OrtTypeInfo + * + * This augments ::OrtTypeInfo to return an ::OrtMapTypeInfo when the type is a map. + * The OrtMapTypeInfo has additional information about the map's key type and value type. + * + * This is used by WinML to support model reflection APIs. + * + * \param[out] type_info + * \param[out] out A pointer to the ::OrtMapTypeInfo. Do not free this value. If type_info + * does not contain a map, this value will be set to nullptr. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CastTypeInfoToMapTypeInfo, _In_ const OrtTypeInfo* type_info, + _Outptr_result_maybenull_ const OrtMapTypeInfo** out); + + /** \brief Cast ::OrtTypeInfo to an ::OrtSequenceTypeInfo + * + * This api augments ::OrtTypeInfo to return an ::OrtSequenceTypeInfo when the type is a sequence. + * The ::OrtSequenceTypeInfo has additional information about the sequence's element type. + * + * This is used by WinML to support model reflection APIs. + * + * \param[in] type_info + * \param[out] out A pointer to the OrtSequenceTypeInfo. Do not free this value. If type_info + * doesn not contain a sequence, this value will be set to nullptr. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CastTypeInfoToSequenceTypeInfo, _In_ const OrtTypeInfo* type_info, + _Outptr_result_maybenull_ const OrtSequenceTypeInfo** out); + + /// @} + /// \name OrtMapTypeInfo + /// @{ + + /** \brief Get key type from an ::OrtMapTypeInfo + * + * Key types are restricted to being scalar types. + * + * This is used by WinML to support model reflection APIs. + * + * \param[in] map_type_info + * \param[out] out + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetMapKeyType, _In_ const OrtMapTypeInfo* map_type_info, _Out_ enum ONNXTensorElementDataType* out); + + /** \brief Get the value type from an ::OrtMapTypeInfo + * + * \param[in] map_type_info + * \param[out] type_info + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetMapValueType, _In_ const OrtMapTypeInfo* map_type_info, _Outptr_ OrtTypeInfo** type_info); + + /// @} + /// \name OrtSequenceTypeInfo + /// @{ + + /** \brief Get element type from an ::OrtSequenceTypeInfo + * + * This is used by WinML to support model reflection APIs. + * + * \param[in] sequence_type_info + * \param[out] type_info + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSequenceElementType, _In_ const OrtSequenceTypeInfo* sequence_type_info, + _Outptr_ OrtTypeInfo** type_info); + + /// @} + /// \name OrtMapTypeInfo + /// @{ + ORT_CLASS_RELEASE(MapTypeInfo); + /// @} + /// \name OrtSequenceTypeInfo + /// @{ + ORT_CLASS_RELEASE(SequenceTypeInfo); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief End profiling and return filename of the profile data + * + * Profiling is turned on through OrtApi::EnableProfiling + * + * \param[in] session + * \param[in] allocator + * \param[out] out Null terminated string of the filename, allocated using `allocator`. Must be freed using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionEndProfiling, _In_ OrtSession* session, _Inout_ OrtAllocator* allocator, _Outptr_ char** out); + + /** \brief Get ::OrtModelMetadata from an ::OrtSession + * + * \param[in] session + * \param[out] out Newly created ::OrtModelMetadata. Must be freed using OrtApi::ReleaseModelMetadata + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetModelMetadata, _In_ const OrtSession* session, _Outptr_ OrtModelMetadata** out); + + /// @} + /// \name OrtModelMetadata + /// @{ + + /** \brief Get `producer name` from an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[in] allocator + * \param[out] value Set to a null terminated string allocated using `allocator`. Must be freed using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetProducerName, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /** \brief Get `graph name` from an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[in] allocator + * \param[out] value Set to a null terminated string allocated using `allocator`. Must be freed using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetGraphName, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /** \brief Get `domain` from an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[in] allocator + * \param[out] value Set to a null terminated string allocated using `allocator`. Must be freed using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetDomain, _In_ const OrtModelMetadata* model_metadata, _Inout_ OrtAllocator* allocator, + _Outptr_ char** value); + + /** \brief Get `description` from an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[in] allocator + * \param[out] value Set to a null terminated string allocated using `allocator`. Must be freed using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetDescription, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /** \brief Return data for a key in the custom metadata map in an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[in] allocator + * \param[in] key Null terminated string + * \param[out] value Set to a null terminated string allocated using `allocator`. Must be freed using `allocator` + * `value` will be set to nullptr if the given key is not found in the custom metadata map. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataLookupCustomMetadataMap, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _In_ const char* key, _Outptr_result_maybenull_ char** value); + + /** \brief Get version number from an ::OrtModelMetadata + * + * \param[in] model_metadata + * \param[out] value Set to the version number + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetVersion, _In_ const OrtModelMetadata* model_metadata, _Out_ int64_t* value); + + ORT_CLASS_RELEASE(ModelMetadata); + + /// @} + /// \name OrtEnv + /// @{ + + /** \brief Create an OrtEnv + * + * Create an environment with global threadpools that will be shared across sessions. + * Use this in conjunction with OrtApi::DisablePerSessionThreads or else the session will use + * its own thread pools. + * + * \param[in] log_severity_level The log severity level. + * \param[in] logid The log identifier. + * \param[in] tp_options + * \param[out] out Returned newly created OrtEnv. Must be freed with OrtApi::ReleaseEnv + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateEnvWithGlobalThreadPools, OrtLoggingLevel log_severity_level, _In_ const char* logid, + _In_ const OrtThreadingOptions* tp_options, _Outptr_ OrtEnv** out); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Use global thread pool on a session + * + * Disable using per session thread pool and use the shared global threadpool. + * This should be used in conjunction with OrtApi::CreateEnvWithGlobalThreadPools. + * + * \param[in] options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(DisablePerSessionThreads, _Inout_ OrtSessionOptions* options); + + /// @} + /// \name OrtThreadingOptions + /// @{ + + /** \brief Create an ::OrtThreadingOptions + * + * \param[out] out Newly created ::OrtThreadingOptions. Must be freed with OrtApi::ReleaseThreadingOptions + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateThreadingOptions, _Outptr_ OrtThreadingOptions** out); + + ORT_CLASS_RELEASE(ThreadingOptions); + + /// @} + /// \name OrtModelMetadata + /// @{ + + /** + * + * \param[in] model_metadata + * \param[in] allocator + * \param[out] keys Array of null terminated strings (array count = num_keys) allocated using `allocator`. + * The strings and the pointer array must be freed using `allocator` + * `keys` will be set to nullptr if the custom metadata map is empty. + * \param[out] num_keys Set to the number of elements in the `keys` array + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetCustomMetadataMapKeys, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _Outptr_result_buffer_maybenull_(*num_keys) char*** keys, _Out_ int64_t* num_keys); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** + * + * Override symbolic dimensions (by specific name strings) with actual values + * if known at session initialization time to enable optimizations that can + * take advantage of fixed values (such as memory planning, etc) + * + */ + ORT_API2_STATUS(AddFreeDimensionOverrideByName, + _Inout_ OrtSessionOptions* options, _In_ const char* dim_name, + _In_ int64_t dim_value); + + /// @} + /// \name Misc + /// @{ + + /** \brief Get the names of all available providers + * + * \note The providers in the list are not guaranteed to be usable. They may fail to load due to missing system dependencies. + * For example, if the CUDA/cuDNN libraries are not installed, the CUDA provider will report an error when it is added to the session options. + * + * \param[out] out_ptr Set to a pointer to an array of null terminated strings of the available providers. The entries and the + * array itself must be freed using OrtApi::ReleaseAvailableProviders + * \param[out] provider_length Set to the number of entries in the `out_ptr` array + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetAvailableProviders, _Outptr_ char*** out_ptr, _Out_ int* provider_length); + + /** \brief Release data from OrtApi::GetAvailableProviders. This API will never fail + * so you can rely on it in a noexcept code. + * + * \param[in] ptr The `out_ptr` result from OrtApi::GetAvailableProviders. + * \param[in] providers_length The `provider_length` result from OrtApi::GetAvailableProviders + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ReleaseAvailableProviders, _In_ char** ptr, + _In_ int providers_length); + + /// @} + /// \name OrtValue + /// @{ + + /** \brief Get the length of a single string in a string tensor + * + * \param[in] value A string tensor + * \param[in] index Index of the string in the tensor + * \param[out] out Set to number of bytes of the string element + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetStringTensorElementLength, _In_ const OrtValue* value, size_t index, _Out_ size_t* out); + + /** \brief Get a single string from a string tensor + * + * \param[in] value A string tensor + * \param[in] s_len Number of bytes in the `s` buffer. Must match the value returned by OrtApi::GetStringTensorElementLength. + * \param[in] index Index of the string in the tensor + * \param[out] s The string element contents in UTF-8 encoding. The string is NOT null-terminated. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetStringTensorElement, _In_ const OrtValue* value, size_t s_len, size_t index, _Out_writes_bytes_all_(s_len) void* s); + + /** \brief Set a single string in a string tensor + * + * \param[in] value A string tensor + * \param[in] s A null terminated UTF-8 encoded string + * \param[in] index Index of the string in the tensor to set + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(FillStringTensorElement, _Inout_ OrtValue* value, _In_ const char* s, size_t index); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Set a session configuration entry as a pair of strings + * + * If a configuration with same key exists, this will overwrite the configuration with the given config_value. + * + * The config_key and the format of config_value are defined in onnxruntime_session_options_config_keys.h + * + * \param[in] options + * \param[in] config_key A null terminated string representation of the config key + * \param[in] config_value A null terminated string representation of the config value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(AddSessionConfigEntry, _Inout_ OrtSessionOptions* options, + _In_z_ const char* config_key, _In_z_ const char* config_value); + + /// @} + /// \name OrtAllocator + /// @{ + + /** \brief Create an allocator for an ::OrtSession following an ::OrtMemoryInfo + * + * \param[in] session + * \param[in] mem_info valid ::OrtMemoryInfo instance + * \param[out] out Newly created ::OrtAllocator. Must be freed with OrtApi::ReleaseAllocator + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateAllocator, _In_ const OrtSession* session, _In_ const OrtMemoryInfo* mem_info, + _Outptr_ OrtAllocator** out); + + /** \brief Release an ::OrtAllocator obtained from OrtApi::CreateAllocator + */ + ORT_CLASS_RELEASE(Allocator); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief Run a model using Io Bindings for the inputs & outputs + * + * \see OrtApi::Run + * + * \param[in] session + * \param[in] run_options + * \param[in] binding_ptr + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RunWithBinding, _Inout_ OrtSession* session, _In_ const OrtRunOptions* run_options, _In_ const OrtIoBinding* binding_ptr); + + /** \brief Create an ::OrtIoBinding instance + * + * An IoBinding object allows one to bind pre-allocated ::OrtValue%s to input names. + * Thus if you want to use a raw on device buffer as input or output you can avoid + * extra copy during runtime. + * + * \param[in] session + * \param[out] out Newly created ::OrtIoBinding. Must be freed with OrtApi::ReleaseIoBinding + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateIoBinding, _Inout_ OrtSession* session, _Outptr_ OrtIoBinding** out); + + /// @} + /// \name OrtIoBinding + /// @{ + + /** \brief Release an ::OrtIoBinding obtained from OrtApi::CreateIoBinding + */ + ORT_CLASS_RELEASE(IoBinding); + + /** \brief Bind an ::OrtValue to an ::OrtIoBinding input + * + * When using OrtApi::RunWithBinding this value is used for the named input + * + * \param[in] binding_ptr + * \param[in] name Name for the model input + * \param[in] val_ptr ::OrtValue of Tensor type. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(BindInput, _Inout_ OrtIoBinding* binding_ptr, _In_ const char* name, _In_ const OrtValue* val_ptr); + + /** \brief Bind an ::OrtValue to an ::OrtIoBinding output + * + * When using OrtApi::RunWithBinding this value is used for the named output + * + * \param[in] binding_ptr + * \param[in] name Null terminated string of the model output name + * \param[in] val_ptr ::OrtValue of Tensor type. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(BindOutput, _Inout_ OrtIoBinding* binding_ptr, _In_ const char* name, _In_ const OrtValue* val_ptr); + + /** \brief Bind an ::OrtIoBinding output to a device + * + * Binds the ::OrtValue to a device which is specified by ::OrtMemoryInfo. + * You can either create an instance of ::OrtMemoryInfo with a device id or obtain one from the allocator that you have created/are using + * This is useful when one or more outputs have dynamic shapes and, it is hard to pre-allocate and bind a chunk of + * memory within ::OrtValue ahead of time. + * + * \see OrtApi::RunWithBinding + * + * \param[in] binding_ptr + * \param[in] name Null terminated string of the device name + * \param[in] mem_info_ptr + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(BindOutputToDevice, _Inout_ OrtIoBinding* binding_ptr, _In_ const char* name, _In_ const OrtMemoryInfo* mem_info_ptr); + + /** \brief Get the names of an ::OrtIoBinding's outputs + * + * Returns the names of the outputs in the order they were bound. This is useful after running the model + * with bound outputs because the returned names are in order in which output ::OrtValue are returned. This is useful if + * the order of outputs and their names is not known. + * + * \param[in] binding_ptr + * \param[in] allocator Allocator used to allocate continuous buffers for output strings and lengths. + * \param[out] buffer Returns an array of non-null terminated UTF-8 strings. The number of strings stored is returned in the count parameter. + * This buffer is allocated using `allocator` and must be freed using it. + * \param[out] lengths Returns an array of `count` lengths of the strings returned in `buffer` + * This buffer is allocated using `allocator` and must be freed using it. + * \param[out] count Number of strings returned. If `binding_ptr` has no bound outputs, zero is returned, + * no memory allocation is performed and buffer and lengths are set to nullptr. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetBoundOutputNames, _In_ const OrtIoBinding* binding_ptr, _In_ OrtAllocator* allocator, + _Out_ char** buffer, _Out_writes_all_(count) size_t** lengths, _Out_ size_t* count); + + /** \brief Get the output ::OrtValue objects from an ::OrtIoBinding + * + * Returns an array of pointers to individually allocated ::OrtValue%s that contain results of a model execution with OrtApi::RunWithBinding + * The array contains the same number of ::OrtValue%s and they are in the same order as they were bound with OrtApi::BindOutput + * or OrtApi::BindOutputToDevice. + * + * The returned ::OrtValue%s must be released using OrtApi::ReleaseValue after they are no longer needed. + * The array is allocated using the specified instance of the allocator and must be freed using the same allocator after + * all the ::OrtValue%s contained therein are individually released. + * + * \param[in] binding_ptr + * \param[in] allocator Allocator used to allocate output array + * \param[out] output Set to the allocated array of allocated ::OrtValue outputs. Set to nullptr if there are 0 outputs. + * \param[out] output_count Set to number of ::OrtValue%s returned + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetBoundOutputValues, _In_ const OrtIoBinding* binding_ptr, _In_ OrtAllocator* allocator, + _Out_writes_all_(output_count) OrtValue*** output, _Out_ size_t* output_count); + + /** \brief Clears any previously set Inputs for an ::OrtIoBinding + */ + void(ORT_API_CALL* ClearBoundInputs)(_Inout_ OrtIoBinding* binding_ptr) NO_EXCEPTION ORT_ALL_ARGS_NONNULL; + + /** \brief Clears any previously set Outputs for an ::OrtIoBinding + */ + void(ORT_API_CALL* ClearBoundOutputs)(_Inout_ OrtIoBinding* binding_ptr) NO_EXCEPTION ORT_ALL_ARGS_NONNULL; + + /// @} + /// \name OrtValue + /// @{ + + /** \brief Direct memory access to a specified tensor element + * + * For example, given a tensor with shape of [3,224,224], a pointer to the element at location [2,150,128] can be retrieved + * + * This function only works for numeric type tensors (No strings, etc). + * This is a no-copy method whose returned pointer is valid until the passed in ::OrtValue is free'd. + * + * \param[in] value + * \param[in] location_values Pointer to an array of index values that specify an element's location relative to its shape + * \param[in] location_values_count Number of elements in location_values. Must match the number of elements in the tensor's shape. + * \param[out] out Set to a pointer to the element specified + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(TensorAt, _Inout_ OrtValue* value, const int64_t* location_values, size_t location_values_count, _Outptr_ void** out); + + /// @} + /// \name OrtEnv + /// @{ + + /** \brief Create an allocator and register it with the ::OrtEnv + * + * Enables sharing the allocator between multiple sessions that use the same env instance. + * Lifetime of the created allocator will be valid for the duration of the environment. + * Returns an error if an allocator with the same ::OrtMemoryInfo is already registered. + * + * See https://onnxruntime.ai/docs/get-started/with-c.html for details. + * + * \param[in] env ::OrtEnv instance + * \param[in] mem_info + * \param[in] arena_cfg Pass nullptr for defaults + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateAndRegisterAllocator, _Inout_ OrtEnv* env, _In_ const OrtMemoryInfo* mem_info, + _In_ const OrtArenaCfg* arena_cfg); + + /** \brief Set language projection + * + * Set the language projection for collecting telemetry data when Env is created. + * + * The default is ORT_PROJECTION_C, which means it will classify the language not in the list to C also. + * + * \param[in] ort_env + * \param[in] projection + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetLanguageProjection, _In_ const OrtEnv* ort_env, _In_ OrtLanguageProjection projection); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief Return the time that profiling was started + * + * \note The timer precision varies per platform. On Windows and MacOS, the precision will be ~100ns + * + * \param[in] session + * \param[out] out nanoseconds of profiling's start time + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionGetProfilingStartTimeNs, _In_ const OrtSession* session, _Outptr_ uint64_t* out); + + /// @} + /// \name OrtThreadingOptions + /// @{ + + /** \brief Set global intra-op thread count + * + * This configures the global thread pool options to be used in the call to OrtApi::CreateEnvWithGlobalThreadPools + * + * \param[in] tp_options + * \param[in] intra_op_num_threads Number of threads, special values:
+ * 0 = Use default thread count
+ * 1 = The invoking thread will be used; no threads will be created in the thread pool. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalIntraOpNumThreads, _Inout_ OrtThreadingOptions* tp_options, int intra_op_num_threads); + + /** \brief Set global inter-op thread count + * + * This configures the global thread pool options to be used in the call to OrtApi::CreateEnvWithGlobalThreadPools + * + * \param[in] tp_options + * \param[in] inter_op_num_threads Number of threads, special values:
+ * 0 = Use default thread count
+ * 1 = The invoking thread will be used; no threads will be created in the thread pool. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalInterOpNumThreads, _Inout_ OrtThreadingOptions* tp_options, int inter_op_num_threads); + + /** \brief Set global spin control options + * + * This will configure the global thread pool options to be used in the call to OrtApi::CreateEnvWithGlobalThreadPools. + * Allow spinning of thread pools when their queues are empty. This will set the value for both + * inter_op and intra_op threadpools. + * + * \param[in] tp_options + * \param[in] allow_spinning Valid values are 0 or 1.
+ * 0 = It won't spin (recommended if CPU usage is high)
+ * 1 = Threadpool will spin to wait for queue to become non-empty + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalSpinControl, _Inout_ OrtThreadingOptions* tp_options, int allow_spinning); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Add a pre-allocated initializer to a session + * + * If a model contains an initializer with a name that is same as the name passed to this call, + * ORT will use this initializer instance instead of deserializing one from the model file. This + * is useful when you want to share the same initializer across sessions. + * + * \param[in] options + * \param[in] name Null terminated string of the initializer name + * \param[in] val ::OrtValue containing the initializer. Its lifetime and the underlying initializer buffer must be + * managed by the user (created using the OrtApi::CreateTensorWithDataAsOrtValue) and it must outlive the session object + * to which it is added. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(AddInitializer, _Inout_ OrtSessionOptions* options, _In_z_ const char* name, + _In_ const OrtValue* val); + + /// @} + /// \name OrtEnv + /// @{ + + /** + * Create a custom environment with global threadpools and logger that will be shared across sessions. + * Use this in conjunction with OrtApi::DisablePerSessionThreads or else the session will use + * its own thread pools. + * + * \param[in] logging_function A pointer to a logging function. + * \param[in] logger_param A pointer to arbitrary data passed as the ::OrtLoggingFunction `param` parameter to + * `logging_function`. + * \param[in] log_severity_level The log severity level. + * \param[in] logid The log identifier. + * \param[in] tp_options + * \param[out] out Newly created OrtEnv. Must be freed with OrtApi::ReleaseEnv + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateEnvWithCustomLoggerAndGlobalThreadPools, OrtLoggingFunction logging_function, _In_opt_ void* logger_param, OrtLoggingLevel log_severity_level, + _In_ const char* logid, _In_ const struct OrtThreadingOptions* tp_options, _Outptr_ OrtEnv** out); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Append CUDA provider to session options + * + * If CUDA is not available (due to a non CUDA enabled build, or if CUDA is not installed on the system), this function will return failure. + * + * \param[in] options + * \param[in] cuda_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_CUDA, + _In_ OrtSessionOptions* options, _In_ const OrtCUDAProviderOptions* cuda_options); + + /** \brief Append ROCM execution provider to the session options + * + * If ROCM is not available (due to a non ROCM enabled build, or if ROCM is not installed on the system), this function will return failure. + * + * \param[in] options + * \param[in] rocm_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_ROCM, + _In_ OrtSessionOptions* options, _In_ const OrtROCMProviderOptions* rocm_options); + + /** \brief Append OpenVINO execution provider to the session options + * + * If OpenVINO is not available (due to a non OpenVINO enabled build, or if OpenVINO is not installed on the system), this function will fail. + * + * \param[in] options + * \param[in] provider_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_OpenVINO, + _In_ OrtSessionOptions* options, _In_ const OrtOpenVINOProviderOptions* provider_options); + + /// @} + /// \name OrtThreadingOptions + /// @{ + + /** \brief Set threading flush-to-zero and denormal-as-zero + * + * Sets global thread pool options to be used in the call to OrtApi::CreateEnvWithGlobalThreadPools. + * Flush-to-zero and denormal-as-zero are applied to threads in both intra and inter global thread pool. + * \note This option is not needed if the models used have no denormals. Having no denormals is recommended as this option may hurt model accuracy. + * + * \param[in] tp_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalDenormalAsZero, _Inout_ OrtThreadingOptions* tp_options); + + /// @} + /// \name OrtArenaCfg + /// @{ + + /** \deprecated Use OrtApi::CreateArenaCfgV2 + * + * This will create the configuration of an arena that can eventually be used to define an arena based allocator's behavior + * + * \param[in] max_mem Use 0 to allow ORT to choose the default + * \param[in] arena_extend_strategy Use -1 to allow ORT to choose the default, 0 = kNextPowerOfTwo, 1 = kSameAsRequested + * \param[in] initial_chunk_size_bytes Use -1 to allow ORT to choose the default + * \param[in] max_dead_bytes_per_chunk Use -1 to allow ORT to choose the default + * \param[in] out A pointer to an OrtArenaCfg instance + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateArenaCfg, _In_ size_t max_mem, int arena_extend_strategy, int initial_chunk_size_bytes, + int max_dead_bytes_per_chunk, _Outptr_ OrtArenaCfg** out); + + ORT_CLASS_RELEASE(ArenaCfg); + + /// @} + /// \name OrtModelMetadata + /// @{ + + /** + * Use this to obtain the description of the graph present in the model + * (doc_string field of the GraphProto message within the ModelProto message). + * If it doesn't exist, an empty string will be returned. + * + * \param[in] model_metadata An instance of ::OrtModelMetadata + * \param[in] allocator Allocator used to allocate the string that will be returned back + * \param[out] value Set to a null terminated string allocated using `allocator`. The caller is responsible for freeing it using `allocator` + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(ModelMetadataGetGraphDescription, _In_ const OrtModelMetadata* model_metadata, + _Inout_ OrtAllocator* allocator, _Outptr_ char** value); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Append TensorRT provider to session options + * + * If TensorRT is not available (due to a non TensorRT enabled build, or if TensorRT is not installed on the system), this function will return failure. + * + * \param[in] options + * \param[in] tensorrt_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_TensorRT, + _In_ OrtSessionOptions* options, _In_ const OrtTensorRTProviderOptions* tensorrt_options); + + /// @} + /// \name Misc + /// @{ + + /** \brief Set current GPU device ID + * + * Set the current device id of the GPU execution provider (CUDA/tensorrt/rocm). The device id should be less + * than the total number of devices available. This is only useful when multiple-GPUs are installed and it is + * required to restrict execution to a single GPU. + * + * \param[in] device_id + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetCurrentGpuDeviceId, _In_ int device_id); + + /** \brief Get current GPU device ID + * + * Get the current device id of the GPU execution provider (CUDA/tensorrt/rocm). + * + * \see OrtApi::SetCurrentGpuDeviceId + * + * \param[out] device_id + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetCurrentGpuDeviceId, _In_ int* device_id); + + /// @} + /// \name OrtKernelInfo + /// Custom operator APIs. + /// @{ + + /** \brief Fetch an array of int64_t values stored as an attribute in the graph node + * + * + * If `out` is nullptr, the value of `size` is set to the true size of the attribute + * array's size, and a success status is returned. + * + * If the `size` parameter is greater than or equal to the actual attribute array's size, + * the value of `size` is set to the true size of the attribute array's size, + * the provided memory is filled with the attribute's contents, + * and a success status is returned. + * + * If the `size` parameter is less than the actual attribute array's size and `out` + * is not nullptr, the value of `size` is set to the true size of the attribute array's size + * and a failure status is returned.) + * + * \param[in] info instance + * \param[in] name name of the attribute to be parsed + * \param[out] out pointer to memory where the attribute's contents are to be stored + * \param[in, out] size actual size of attribute array + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttributeArray_float, _In_ const OrtKernelInfo* info, _In_ const char* name, + _Out_ float* out, _Inout_ size_t* size); + + /** \brief Fetch an array of int64_t values stored as an attribute in the graph node + * + * If `out` is nullptr, the value of `size` is set to the true size of the attribute + * array's size, and a success status is returned. + * + * If the `size` parameter is greater than or equal to the actual attribute array's size, + * the value of `size` is set to the true size of the attribute array's size, + * the provided memory is filled with the attribute's contents, + * and a success status is returned. + * + * If the `size` parameter is less than the actual attribute array's size and `out` + * is not nullptr, the value of `size` is set to the true size of the attribute array's size + * and a failure status is returned.) + * + * \param[in] info instance + * \param[in] name name of the attribute to be parsed + * \param[out] out pointer to memory where the attribute's contents are to be stored + * \param[in, out] size actual size of attribute array + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttributeArray_int64, _In_ const OrtKernelInfo* info, _In_ const char* name, + _Out_ int64_t* out, _Inout_ size_t* size); + + /// @} + /// \name OrtArenaCfg + /// @{ + + /** \brief Create an ::OrtArenaCfg + * + * Create the configuration of an arena that can eventually be used to define an arena based allocator's behavior. + * + * Supported keys are (See https://onnxruntime.ai/docs/get-started/with-c.html for details on what the + * following parameters mean and how to choose these values.): + * "max_mem": Maximum memory that can be allocated by the arena based allocator. + * Use 0 for ORT to pick the best value. Default is 0. + * "arena_extend_strategy": 0 = kNextPowerOfTwo, 1 = kSameAsRequested. + * Use -1 to allow ORT to choose the default. + * "initial_chunk_size_bytes": (Possible) Size of the first allocation in the arena. + * Only relevant if arena strategy is `kNextPowerOfTwo`. Use -1 to allow ORT to choose the default. + * Ultimately, the first allocation size is determined by the allocation memory request. + * "max_dead_bytes_per_chunk": Threshold of unused memory in an allocated chunk of arena memory after + * crossing which the current chunk is chunked into 2. + * "initial_growth_chunk_size_bytes": (Possible) Size of the second allocation in the arena. + * Only relevant if arena strategy is `kNextPowerOfTwo`. Use -1 to allow ORT to choose the default. + * Ultimately, the allocation size is determined by the allocation memory request. + * Further allocation sizes are governed by the arena extend strategy. + * + * \param[in] arena_config_keys Keys to configure the arena + * \param[in] arena_config_values Values to configure the arena + * \param[in] num_keys Number of keys in `arena_config_keys` and `arena_config_values` + * \param[out] out Newly created ::OrtArenaCfg. Must be freed with OrtApi::ReleaseArenaCfg + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateArenaCfgV2, _In_reads_(num_keys) const char* const* arena_config_keys, + _In_reads_(num_keys) const size_t* arena_config_values, _In_ size_t num_keys, + _Outptr_ OrtArenaCfg** out); + + /// @} + /// \name OrtRunOptions + /// @{ + + /** \brief Set a single run configuration entry as a pair of strings + * + * If a configuration with same key exists, this will overwrite the configuration with the given config_value + * + * The config_key and the format of config_value are defined in onnxruntime_run_options_config_keys.h + * + * \param[in] options + * \param[in] config_key A null terminated string representation of the config key + * \param[in] config_value A null terminated string representation of the config value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(AddRunConfigEntry, _Inout_ OrtRunOptions* options, + _In_z_ const char* config_key, _In_z_ const char* config_value); + + /// @} + /// \name OrtPrepackedWeightsContainer + /// @{ + + /** \brief Create an ::OrtPrepackedWeightsContainer + * + * This container will hold pre-packed buffers of shared initializers for sharing between sessions + * (i.e.) if there are shared initializers that can be shared between sessions, the pre-packed buffers + * of these (if any) may possibly be shared to provide memory footprint savings. Pass this container + * to sessions that you would like to share pre-packed buffers of shared initializers at session + * creation time. + * + * \param[out] out Newly created ::OrtPrepackedWeightsContainer. Must be freed with OrtApi::ReleasePrepackedWeightsContainer + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreatePrepackedWeightsContainer, _Outptr_ OrtPrepackedWeightsContainer** out); + + /** \brief Release OrtPrepackedWeightsContainer instance + * + * \note instance must not be released until the sessions using it are released + */ + ORT_CLASS_RELEASE(PrepackedWeightsContainer); + + /// @} + /// \name OrtSession + /// @{ + + /** \brief Create session with prepacked weights container + * + * Same functionality offered by OrtApi::CreateSession except that a container that contains + * pre-packed weights' buffers is written into/read from by the created session. + * This is useful when used in conjunction with OrtApi::AddInitializer which injects + * shared initializer info into sessions. Wherever possible, the pre-packed versions of these + * shared initializers are cached in this container so that multiple sessions can just re-use + * these instead of duplicating these in memory. + * + * \param[in] env OrtEnv instance instance + * \param[in] model_path Null terminated string of the path (wchar on Windows, char otherwise) + * \param[in] options + * \param[in] prepacked_weights_container + * \param[out] out Newly created ::OrtSession. Must be freed with OrtApi::ReleaseSession + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSessionWithPrepackedWeightsContainer, _In_ const OrtEnv* env, _In_ const ORTCHAR_T* model_path, + _In_ const OrtSessionOptions* options, _Inout_ OrtPrepackedWeightsContainer* prepacked_weights_container, + _Outptr_ OrtSession** out); + + /** \brief Create session from memory with prepacked weights container + * + * Same functionality offered by OrtApi::CreateSessionFromArray except that a container that contains + * pre-packed weights' buffers is written into/read from by the created session. + * This is useful when used in conjunction with OrtApi::AddInitializer which injects + * shared initializer info into sessions. Wherever possible, the pre-packed versions of these + * shared initializers are cached in this container so that multiple sessions can just re-use + * these instead of duplicating these in memory. + * + * \param[in] env + * \param[in] model_data Array of bytes holding the model + * \param[in] model_data_length Number of bytes in `model_data_model` + * \param[in] options + * \param[in] prepacked_weights_container + * \param[out] out Newly created ::OrtSession. Must be freed with OrtApi::ReleaseSession + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSessionFromArrayWithPrepackedWeightsContainer, _In_ const OrtEnv* env, + _In_ const void* model_data, size_t model_data_length, + _In_ const OrtSessionOptions* options, _Inout_ OrtPrepackedWeightsContainer* prepacked_weights_container, + _Outptr_ OrtSession** out); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Append TensorRT execution provider to the session options + * + * If TensorRT is not available (due to a non TensorRT enabled build), this function will return failure. + * + * This is slightly different from OrtApi::SessionOptionsAppendExecutionProvider_TensorRT, it takes an + * ::OrtTensorRTProviderOptions which is publicly defined. This takes an opaque ::OrtTensorRTProviderOptionsV2 + * which must be created with OrtApi::CreateTensorRTProviderOptions. + * + * For OrtApi::SessionOptionsAppendExecutionProvider_TensorRT, the user needs to instantiate ::OrtTensorRTProviderOptions + * as well as allocate/release buffers for some members of ::OrtTensorRTProviderOptions. + * Here, OrtApi::CreateTensorRTProviderOptions and Ortapi::ReleaseTensorRTProviderOptions will do the memory management for you. + * + * \param[in] options + * \param[in] tensorrt_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_TensorRT_V2, + _In_ OrtSessionOptions* options, _In_ const OrtTensorRTProviderOptionsV2* tensorrt_options); + + /// @} + /// \name OrtTensorRTProviderOptionsV2 + /// @{ + + /** \brief Create an OrtTensorRTProviderOptionsV2 + * + * \param[out] out Newly created ::OrtTensorRTProviderOptionsV2. Must be released with OrtApi::ReleaseTensorRTProviderOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateTensorRTProviderOptions, _Outptr_ OrtTensorRTProviderOptionsV2** out); + + /** \brief Set options in a TensorRT Execution Provider. + * + * Please refer to https://onnxruntime.ai/docs/execution-providers/TensorRT-ExecutionProvider.html#cc + * to know the available keys and values. Key should be in null terminated string format of the member of ::OrtTensorRTProviderOptionsV2 + * and value should be its related range. + * + * For example, key="trt_max_workspace_size" and value="2147483648" + * + * \param[in] tensorrt_options + * \param[in] provider_options_keys Array of UTF-8 null-terminated string for provider options keys + * \param[in] provider_options_values Array of UTF-8 null-terminated string for provider options values + * \param[in] num_keys Number of elements in the `provider_option_keys` and `provider_options_values` arrays + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(UpdateTensorRTProviderOptions, _Inout_ OrtTensorRTProviderOptionsV2* tensorrt_options, + _In_reads_(num_keys) const char* const* provider_options_keys, + _In_reads_(num_keys) const char* const* provider_options_values, + _In_ size_t num_keys); + + /** \brief Get serialized TensorRT provider options string. + * + * For example, "trt_max_workspace_size=2147483648;trt_max_partition_iterations=10;trt_int8_enable=1;......" + * + * \param tensorrt_options - OrtTensorRTProviderOptionsV2 instance + * \param allocator - a ptr to an instance of OrtAllocator obtained with OrtApi::CreateAllocator or OrtApi::GetAllocatorWithDefaultOptions + * the specified allocator will be used to allocate continuous buffers for output strings and lengths. + * \param ptr - is a UTF-8 null terminated string allocated using 'allocator'. The caller is responsible for using the same allocator to free it. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorRTProviderOptionsAsString, _In_ const OrtTensorRTProviderOptionsV2* tensorrt_options, _Inout_ OrtAllocator* allocator, _Outptr_ char** ptr); + + /** \brief Release an ::OrtTensorRTProviderOptionsV2 + * + * \note This is an exception in the naming convention of other Release* functions, as the name of the method does not have the V2 suffix, but the type does + */ + void(ORT_API_CALL* ReleaseTensorRTProviderOptions)(_Frees_ptr_opt_ OrtTensorRTProviderOptionsV2* input); + + /// @} + /// \name OrtSessionOptions + /// @{ + + /** \brief Enable custom operators + * + * See onnxruntime-extensions: https://github.com/microsoft/onnxruntime-extensions.git + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(EnableOrtCustomOps, _Inout_ OrtSessionOptions* options); + + /// @} + /// \name OrtAllocator + /// @{ + + /** \brief Register a custom allocator + * + * Enables sharing between multiple sessions that use the same env instance. + * Returns an error if an allocator with the same ::OrtMemoryInfo is already registered. + * + * The behavior of this is exactly the same as OrtApi::CreateAndRegisterAllocator except + * instead of ORT creating an allocator based on provided info, in this case + * ORT uses the user-provided custom allocator. + * See https://onnxruntime.ai/docs/get-started/with-c.html for details. + * + * \param[in] env + * \param[in] allocator User provided allocator + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(RegisterAllocator, _Inout_ OrtEnv* env, _In_ OrtAllocator* allocator); + + /** \brief Unregister a custom allocator + * + * It is an error if you provide an ::OrtMemoryInfo not corresponding to any + * registered allocators for sharing. + * + * \param[in] env + * \param[in] mem_info + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(UnregisterAllocator, _Inout_ OrtEnv* env, + _In_ const OrtMemoryInfo* mem_info); + + /// @} + /// \name OrtValue + /// @{ + + /** \brief Sets *out to 1 iff an ::OrtValue is a SparseTensor, and 0 otherwise + * + * \param[in] value existing ::OrtValue + * \param[out] out unless an error occurs, contains 1 iff the value contains an instance + * of sparse tensor or 0 otherwise. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(IsSparseTensor, _In_ const OrtValue* value, _Out_ int* out); + + /** \brief Create an ::OrtValue with a sparse tensor that is empty. + * + * Use FillSparseTensor() functions to populate sparse tensor with non-zero values and + * format specific indices data. + * Use ReleaseValue to destroy the sparse tensor, this will also release the buffer inside the output value + * if any was allocated. + * \param[in,out] allocator allocator to use when performing an allocation. Allocation will be performed + * by FillSparseTensor() APIs. The lifespan of the allocator instance must eclipse the lifespan + * this sparse tensor instance as the same allocator will be used to free memory. + * \param[in] dense_shape shape of the original dense tensor + * \param[in] dense_shape_len number of shape dimensions being passed + * \param[in] type must be one of TENSOR_ELEMENT_DATA_TYPE_xxxx + * \param[out] out Should be freed by calling ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSparseTensorAsOrtValue, _Inout_ OrtAllocator* allocator, _In_ const int64_t* dense_shape, + size_t dense_shape_len, ONNXTensorElementDataType type, _Outptr_ OrtValue** out); + + /** + * This fills populates an empty tensor that was created using OrtApi::CreateSparseTensorAsOrtValue. + * This will allocate required memory and copy the supplied NNZ values and COO indices into that memory allocation. + * Memory allocation is performed using the allocator that was specified with OrtApi::CreateSparseTensorAsOrtValue. + * + * \param[in,out] ort_value ::OrtValue to populate with data + * \param[in] data_mem_info serves to identify the location of the data to be copied. If the allocator specified + * at the creation time has memory info that is not the same as mem_info argument to this function a X-device copy will be performed. + * String data is assumed to be on CPU and will only be copied into a CPU allocated buffer. + * \param[in] values_shape pointer to values shape array + * \param[in] values_shape_len length of the values_shape + * \param[in] values pointer to an array of values. For strings, pass const char**. + * \param[in] indices_data pointer to a location of COO indices + * \param[in] indices_num number of COO indices + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(FillSparseTensorCoo, _Inout_ OrtValue* ort_value, _In_ const OrtMemoryInfo* data_mem_info, + _In_ const int64_t* values_shape, size_t values_shape_len, _In_ const void* values, + _In_ const int64_t* indices_data, size_t indices_num); + + /** + * This fills populates an empty tensor that was created using OrtApi::CreateSparseTensorAsOrtValue. + * This will allocate required memory and copy the supplied NNZ values and CSR indices into that memory allocation. + * Memory allocation is performed using the allocator that was specified with OrtApi::CreateSparseTensorAsOrtValue. + * + * \param[in,out] ort_value ::OrtValue to populate with data + * \param[in] data_mem_info serves to identify the location of the data to be copied. If the allocator specified + * at the creation time has memory info that is not the same as mem_info argument to this function a X-device copy will be performed. + * String data is assumed to be on CPU and will only be copied into a CPU allocated buffer. + * \param[in] values_shape pointer to values shape array + * \param[in] values_shape_len length of the values_shape + * \param[in] values - pointer to an array of values. For strings, pass const char**. + * \param[in] inner_indices_data pointer to a location of CSR inner indices + * \param[in] inner_indices_num number of CSR inner indices + * \param[in] outer_indices_data pointer to a location of CSR outer indices + * \param[in] outer_indices_num number of CSR outer indices + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(FillSparseTensorCsr, _Inout_ OrtValue* ort_value, _In_ const OrtMemoryInfo* data_mem_info, + _In_ const int64_t* values_shape, size_t values_shape_len, _In_ const void* values, + _In_ const int64_t* inner_indices_data, size_t inner_indices_num, + _In_ const int64_t* outer_indices_data, size_t outer_indices_num); + + /** + * This fills populates an empty tensor that was created using OrtApi::CreateSparseTensorAsOrtValue. + * This will allocate required memory and copy the supplied NNZ values and BlockSparse indices into that memory allocation. + * Memory allocation is performed using the allocator that was specified with OrtApi::CreateSparseTensorAsOrtValue. + * + * \param[in,out] ort_value ::OrtValue to populate with data + * \param[in] data_mem_info serves to identify the location of the data to be copied. If the allocator specified + * at the creation time has memory info that is not the same as mem_info argument to this function a X-device copy will be performed. + * String data is assumed to be on CPU and will only be copied into a CPU allocated buffer. + * \param[in] values_shape + * \param[in] values_shape_len + * \param[in] values structure with values information + * \param[in] indices_shape_data pointer to a location of indices shape + * \param[in] indices_shape_len length of the block sparse indices shape + * \param[in] indices_data pointer to a location of indices data. Shape will determine the length of the indices data. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(FillSparseTensorBlockSparse, _Inout_ OrtValue* ort_value, _In_ const OrtMemoryInfo* data_mem_info, + _In_ const int64_t* values_shape, size_t values_shape_len, _In_ const void* values, + _In_ const int64_t* indices_shape_data, size_t indices_shape_len, + _In_ const int32_t* indices_data); + + /** + * Create an ::OrtValue with a sparse tensor. This is the first step. + * Next, use UseIndices() functions to supply sparse tensor with + * format specific indices data and set its sparse format to a specific enum value. + * This will not perform memory allocations. It will + * use supplied user buffer which should outlive the created sparse tensor. + * Use OrtApi::ReleaseValue to destroy the sparse tensor. It would not release the supplied values buffer. + * This function can not be used to map strings from the user allocated memory. Strings must always be copied + * and have UTF-8 encoding. Therefore, use OrtApi::CreateSparseTensorAsOrtValue above and then fill it with data + * using appropriate Make*() function. + * + * \param[in] info memory info where sparse values reside. + * \param[in,out] p_data pointer to a user allocated buffer with values. To create a full sparse tensor with no non-zero + * values, pass nullptr + * \param[in] dense_shape shape of the original dense tensor + * \param[in] dense_shape_len number of shape dimensions being passed + * \param[in] values_shape shape of the values data. To create a fully sparse tensor with no non-zero values, + * pass {0} shape. + * \param[in] values_shape_len number of values shape dimensions + * \param[in] type must be one of TENSOR_ELEMENT_DATA_TYPE_xxxx + * \param[out] out Should be freed by calling ReleaseValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(CreateSparseTensorWithValuesAsOrtValue, _In_ const OrtMemoryInfo* info, _Inout_ void* p_data, + _In_ const int64_t* dense_shape, size_t dense_shape_len, + _In_ const int64_t* values_shape, size_t values_shape_len, + ONNXTensorElementDataType type, _Outptr_ OrtValue** out); + + /** + * This assigns Coo format indices to the SparseTensor that was created by + * OrtApi::CreateSparseTensorWithValuesAsOrtValue above. It also sets OrtSparseFormat to + * ORT_SPARSE_COO. This will not allocate any additional memory for data. The life span of + * indices_data buffer should eclipse the life span of this ::OrtValue. + * + * \param[in,out] ort_value ::OrtValue instance constructed with OrtApi::CreateSparseTensorWithValuesAsOrtValue + * \param[in,out] indices_data pointer to a user pre-allocated buffer or nullptr for fully sparse tensors. + * \param[in] indices_num number of COO indices. Should either be 0 for fully sparse tensors, be equal + * to the number of nnz values specified to OrtApi::CreateSparseTensorWithValuesAsOrtValue for 1-D {nnz} indices or + * be twice as number of nnz values for a 2-D indices {nnz, 2} + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(UseCooIndices, _Inout_ OrtValue* ort_value, _Inout_ int64_t* indices_data, size_t indices_num); + + /** + * The assigns CSR format indices to the SparseTensor that was created by + * OrtApi::CreateSparseTensorWithValuesAsOrtValue above. It also sets OrtSparseFormat to + * ORT_SPARSE_CSRC. This will not allocate any additional memory for data. The life spans of + * inner_data and outer_data buffers should eclipse the life span of this ::OrtValue. + * + * \param[in,out] ort_value ::OrtValue instance constructed with OrtApi::CreateSparseTensorWithValuesAsOrtValue + * \param[in,out] inner_data pointer to a user pre-allocated buffer or nullptr for fully sparse tensors. + * \param[in] inner_num number of inner CSR indices. Should either be 0 for fully sparse tensors or be equal + * to the number of nnz values specified to OrtApi::CreateSparseTensorWithValuesAsOrtValue. + * \param[in,out] outer_data pointer to user pre-allocated buffer or nullptr for fully sparse tensors. + * \param[in] outer_num number of CSR outer indices. Should either be 0 for fully sparse tensors or + * equal to rows + 1 of the dense shape. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(UseCsrIndices, _Inout_ OrtValue* ort_value, _Inout_ int64_t* inner_data, size_t inner_num, + _Inout_ int64_t* outer_data, size_t outer_num); + + /** + * The assigns BlockSparse format indices to the SparseTensor that was created by + * OrtApi::CreateSparseTensorWithValuesAsOrtValue above. It also sets OrtSparseFormat to + * ORT_SPARSE_BLOCK_SPARSE. This will not allocate any additional memory for data. The life span of + * indices_data buffer must eclipse the lifespan of this ::OrtValue. + * + * \param[in,out] ort_value OrtValue instance constructed with OrtApi::CreateSparseTensorWithValuesAsOrtValue + * \param[in] indices_shape pointer to indices shape. Use {0} for fully sparse tensors + * \param[in] indices_shape_len length of the indices shape + * \param[in,out] indices_data pointer to user pre-allocated buffer or nullptr for fully sparse tensors. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(UseBlockSparseIndices, _Inout_ OrtValue* ort_value, const int64_t* indices_shape, size_t indices_shape_len, _Inout_ int32_t* indices_data); + + /** \brief Returns sparse tensor format enum iff a given ort value contains an instance of sparse tensor. + * + * \param[in] ort_value ::OrtValue that contains an instance of sparse tensor + * \param[out] out pointer to out parameter + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSparseTensorFormat, _In_ const OrtValue* ort_value, _Out_ enum OrtSparseFormat* out); + + /** \brief Returns data type and shape of sparse tensor values (nnz) iff ::OrtValue contains a SparseTensor. + * + * \param[in] ort_value An ::OrtValue that contains a fully constructed sparse tensor + * \param[out] out Must be freed by OrtApi::ReleaseTensorTypeAndShapeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSparseTensorValuesTypeAndShape, _In_ const OrtValue* ort_value, _Outptr_ OrtTensorTypeAndShapeInfo** out); + + /** \brief Returns numeric data for sparse tensor values (nnz). For string values use GetStringTensor*(). + * + * \param[in] ort_value an instance of ::OrtValue containing sparse tensor + * \param[out] out returns a pointer to values data. Do not attempt to free this ptr. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSparseTensorValues, _In_ const OrtValue* ort_value, _Outptr_ const void** out); + + /** \brief Returns data type, shape for the type of indices specified by indices_format. + * + * \param[in] ort_value ::OrtValue containing sparse tensor. + * \param[in] indices_format One of the indices formats. It is an error to request a format that the sparse + * tensor does not contain. + * \param[out] out an instance of ::OrtTensorTypeAndShapeInfo. Must be freed by OrtApi::ReleaseTensorTypeAndShapeInfo + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSparseTensorIndicesTypeShape, _In_ const OrtValue* ort_value, enum OrtSparseIndicesFormat indices_format, _Outptr_ OrtTensorTypeAndShapeInfo** out); + + /** \brief Returns indices data for the type of the indices specified by indices_format + * + * \param[in] ort_value ::OrtValue containing sparse tensor. + * \param[in] indices_format One of the indices formats. It is an error to request a format that the sparse tensor does not contain. + * \param[out] num_indices Pointer to where the number of indices entries is returned + * \param[out] indices Returned pointer to the indices data. Do not free the returned pointer as it refers to internal data owned by the ::OrtValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetSparseTensorIndices, _In_ const OrtValue* ort_value, enum OrtSparseIndicesFormat indices_format, _Out_ size_t* num_indices, _Outptr_ const void** indices); + /// @} + /// \name OrtSessionOptions + /// @{ + + /** + * \brief Sets out to 1 iff an optional type OrtValue has an element, 0 otherwise (OrtValue is None) + * Use this API to find if the optional type OrtValue is None or not. + * If the optional type OrtValue is not None, use the OrtValue just like any other OrtValue. + * For example, if you get an OrtValue that corresponds to Optional(tensor) and + * if HasValue() returns true, use it as tensor and so on. + + * \param[in] value Input OrtValue. + * \param[out] out indicating if the input OrtValue contains data (1) or if it is a None (0) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(HasValue, _In_ const OrtValue* value, _Out_ int* out); + + /// @} + /// \name OrtKernelContext + /// Custom operator APIs. + /// @{ + + /** \brief Used for custom operators, gets the GPU compute stream to use to launch the custom a GPU kernel + * \see ::OrtCustomOp + * \param[in] context OrtKernelContext instance + * \param[out] out Returns pointer to a GPU compute stream that can be used to launch the custom GPU kernel. + * If retrieving the GPU compute stream is not relevant (GPU not enabled in the build, kernel partitioned to + * some other EP), then a nullptr is returned as the output param. + * Do not free or mutate the returned pointer as it refers to internal data owned by the underlying session. + * Only use it for custom kernel launching. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelContext_GetGPUComputeStream, _In_ const OrtKernelContext* context, _Outptr_ void** out); + + /// @} + /// \name GetTensorMemoryInfo + /// @{ + /** \brief Returns a pointer to the ::OrtMemoryInfo of a Tensor + * \param[in] value ::OrtValue containing tensor. + * \param[out] mem_info ::OrtMemoryInfo of the tensor. Do NOT free the returned pointer. It is valid for the lifetime of the ::OrtValue + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetTensorMemoryInfo, _In_ const OrtValue* value, _Out_ const OrtMemoryInfo** mem_info); + + /// @} + /// \name GetExecutionProviderApi + /// @{ + /** \brief Get a pointer to the requested version of the Execution Provider specific + * API extensions to the OrtApi + * \param[in] provider_name The name of the execution provider name. Currently only the following + * values are supported: "DML". + * \param[in] version Must be ::ORT_API_VERSION. + * \param[out] provider_api A void pointer containing a reference to the execution provider versioned api structure. + * For example, the provider_api pointer can be cast to the OrtDmlApi* when the provider_name is "DML". + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetExecutionProviderApi, _In_ const char* provider_name, _In_ uint32_t version, _Outptr_ const void** provider_api); + + /// @} + + /// \name SessionOptions + /// @{ + /** \brief Set custom thread creation function + * + * \param[in] options Session options + * \param[in] ort_custom_create_thread_fn Custom thread creation function + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsSetCustomCreateThreadFn, _Inout_ OrtSessionOptions* options, _In_ OrtCustomCreateThreadFn ort_custom_create_thread_fn); + + /** \brief Set creation options for custom thread + * + * \param[in] options Session options + * \param[in] ort_custom_thread_creation_options Custom thread creation options (can be nullptr) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsSetCustomThreadCreationOptions, _Inout_ OrtSessionOptions* options, _In_ void* ort_custom_thread_creation_options); + + /** \brief Set custom thread join function + * + * \param[in] options Session options + * \param[in] ort_custom_join_thread_fn Custom join thread function, must not be nullptr when ort_custom_create_thread_fn is set + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SessionOptionsSetCustomJoinThreadFn, _Inout_ OrtSessionOptions* options, _In_ OrtCustomJoinThreadFn ort_custom_join_thread_fn); + /// @} + + /// \name OrtThreadingOptions + /// @{ + /** \brief Set custom thread creation function for global thread pools + * + * \param[inout] tp_options + * \param[in] ort_custom_create_thread_fn Custom thread creation function + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalCustomCreateThreadFn, _Inout_ OrtThreadingOptions* tp_options, _In_ OrtCustomCreateThreadFn ort_custom_create_thread_fn); + + /** \brief Set custom thread creation options for global thread pools + * + * \param[inout] tp_options + * \param[in] ort_custom_thread_creation_options Custom thread creation options (can be nullptr) + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalCustomThreadCreationOptions, _Inout_ OrtThreadingOptions* tp_options, _In_ void* ort_custom_thread_creation_options); + + /** \brief Set custom thread join function for global thread pools + * + * \param[inout] tp_options + * \param[in] ort_custom_join_thread_fn Custom thread join function, must not be nullptr when global ort_custom_create_thread_fn is set + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SetGlobalCustomJoinThreadFn, _Inout_ OrtThreadingOptions* tp_options, _In_ OrtCustomJoinThreadFn ort_custom_join_thread_fn); + /// @} + + /** \brief Synchronize bound inputs. The call may be necessary for some providers, such as cuda, + * in case the system that allocated bound memory operated on a different stream. However, the + * operation is provider specific and could be a no-op. + * + * \param[inout] binding_ptr + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SynchronizeBoundInputs, _Inout_ OrtIoBinding* binding_ptr); + + /** \brief Synchronize bound outputs. The call may be necessary for some providers, such as cuda, + * in case the system that allocated bound memory operated on a different stream. However, the + * operation is provider specific and could be a no-op. + * + * \param[inout] binding_ptr + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(SynchronizeBoundOutputs, _Inout_ OrtIoBinding* binding_ptr); + + /// \name OrtSessionOptions + /// @{ + + /** \brief Append CUDA execution provider to the session options + * + * If CUDA is not available (due to a non CUDA enabled build), this function will return failure. + * + * This is slightly different from OrtApi::SessionOptionsAppendExecutionProvider_CUDA, it takes an + * ::OrtCUDAProviderOptions which is publicly defined. This takes an opaque ::OrtCUDAProviderOptionsV2 + * which must be created with OrtApi::CreateCUDAProviderOptions. + * + * For OrtApi::SessionOptionsAppendExecutionProvider_CUDA, the user needs to instantiate ::OrtCUDAProviderOptions + * as well as allocate/release buffers for some members of ::OrtCUDAProviderOptions. + * Here, OrtApi::CreateCUDAProviderOptions and Ortapi::ReleaseCUDAProviderOptions will do the memory management for you. + * + * \param[in] options + * \param[in] cuda_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.11. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_CUDA_V2, + _In_ OrtSessionOptions* options, _In_ const OrtCUDAProviderOptionsV2* cuda_options); + + /// @} + /// \name OrtCUDAProviderOptionsV2 + /// @{ + + /** \brief Create an OrtCUDAProviderOptionsV2 + * + * \param[out] out Newly created ::OrtCUDAProviderOptionsV2. Must be released with OrtApi::ReleaseCudaProviderOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.11. + */ + ORT_API2_STATUS(CreateCUDAProviderOptions, _Outptr_ OrtCUDAProviderOptionsV2** out); + + /** \brief Set options in a CUDA Execution Provider. + * + * Please refer to https://onnxruntime.ai/docs/execution-providers/CUDA-ExecutionProvider.html#configuration-options + * to know the available keys and values. Key should be in null terminated string format of the member of ::OrtCUDAProviderOptionsV2 + * and value should be its related range. + * + * For example, key="device_id" and value="0" + * + * \param[in] cuda_options + * \param[in] provider_options_keys Array of UTF-8 null-terminated string for provider options keys + * \param[in] provider_options_values Array of UTF-8 null-terminated string for provider options values + * \param[in] num_keys Number of elements in the `provider_option_keys` and `provider_options_values` arrays + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.11. + */ + ORT_API2_STATUS(UpdateCUDAProviderOptions, _Inout_ OrtCUDAProviderOptionsV2* cuda_options, + _In_reads_(num_keys) const char* const* provider_options_keys, + _In_reads_(num_keys) const char* const* provider_options_values, + _In_ size_t num_keys); + + /** + * Get serialized CUDA provider options string. + * + * For example, "device_id=0;arena_extend_strategy=0;......" + * + * \param cuda_options - OrtCUDAProviderOptionsV2 instance + * \param allocator - a ptr to an instance of OrtAllocator obtained with CreateAllocator() or GetAllocatorWithDefaultOptions() + * the specified allocator will be used to allocate continuous buffers for output strings and lengths. + * \param ptr - is a UTF-8 null terminated string allocated using 'allocator'. The caller is responsible for using the same allocator to free it. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.11. + */ + ORT_API2_STATUS(GetCUDAProviderOptionsAsString, _In_ const OrtCUDAProviderOptionsV2* cuda_options, _Inout_ OrtAllocator* allocator, _Outptr_ char** ptr); + + /** \brief Release an ::OrtCUDAProviderOptionsV2 + * + * \note This is an exception in the naming convention of other Release* functions, as the name of the method does not have the V2 suffix, but the type does + * + * \since Version 1.11. + */ + void(ORT_API_CALL* ReleaseCUDAProviderOptions)(_Frees_ptr_opt_ OrtCUDAProviderOptionsV2* input); + + /// @} + + /** \brief Append MIGraphX provider to session options + * + * If MIGraphX is not available (due to a non MIGraphX enabled build, or if MIGraphX is not installed on the system), this function will return failure. + * + * \param[in] options + * \param[in] migraphx_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.11. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_MIGraphX, + _In_ OrtSessionOptions* options, _In_ const OrtMIGraphXProviderOptions* migraphx_options); + + /** \brief Replace initialized Tensors with external data with the data provided in initializers. + * + * The function will find the initialized TensorProtos with external data in the graph with the provided names and + * replace them with the provided tensors. The API verifies that the TensorProto being replaced + * has an external data reference and has the same name, dimensions and data type as its replacement. The replacement + * will occur before any of the optimizations take place. The data will be copied into the graph + * since TensorProto can't refer to the user provided buffers. + * + * Once the model has been loaded, the OrtValue(s) added to SessionOptions instance will be removed + * from the internal SessionOptions copy to save memory, the user provided buffers can then be deallocated + * and the SessionOptions instance that refers to them can be destroyed. + * + * \param[in] options + * \param[in] initializer_names Array of null terminated UTF-8 encoded strings of the initializers names. + * \param[in] initializers Array of ::OrtValue type + * \param[in] initializers_num Number of elements in the initializer_names and initializers + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.12. + */ + ORT_API2_STATUS(AddExternalInitializers, _In_ OrtSessionOptions* options, + _In_reads_(input_len) const char* const* initializer_names, + _In_reads_(input_len) const OrtValue* const* initializers, size_t initializers_num); + + /** \brief: Create attribute of onnxruntime operator + * + * \param[in] name Name of the attribute + * \param[in] data Data content of the attribute + * \param[in] len Number of bytes stored in data + * \param[in] type Data type + * \param[out] op_attr Attribute that has been created, which must be released by OrtApi::ReleaseOpAttr + * + * \since Version 1.12. + */ + ORT_API2_STATUS(CreateOpAttr, + _In_ const char* name, + _In_ const void* data, + _In_ int len, + _In_ OrtOpAttrType type, + _Outptr_ OrtOpAttr** op_attr); + + /* \brief: Release op attribute + * + * \param[in] opAttr Attribute created by OrtApi::CreateOpAttr + * + * \since Version 1.12. + */ + ORT_CLASS_RELEASE(OpAttr); + + /** \brief: Create onnxruntime native operator + * + * \param[in] info Kernel info + * \param[in] op_name Operator name + * \param[in] domain Operator domain + * \param[in] version Operator opset version + * \param[in] type_constraint_names Name of the type contraints, such as "T" or "T1" + * \param[in] type_constraint_values Type of each contraints + * \param[in] type_constraint_count Number of contraints + * \param[in] attr_values Attributes used to initialize the operator + * \param[in] attr_count Number of the attributes + * \param[in] input_count Number of inputs + * \param[in] output_count Number of outputs + * \param[out] ort_op Operator that has been created + * + * \since Version 1.12. + */ + ORT_API2_STATUS(CreateOp, + _In_ const OrtKernelInfo* info, + _In_z_ const char* op_name, + _In_z_ const char* domain, + int version, + _In_reads_(type_constraint_count) const char** type_constraint_names, + _In_reads_(type_constraint_count) const ONNXTensorElementDataType* type_constraint_values, + int type_constraint_count, + _In_reads_(attr_count) const OrtOpAttr* const* attr_values, + int attr_count, + int input_count, + int output_count, + _Outptr_ OrtOp** ort_op); + + /** \brief: Invoke the operator created by OrtApi::CreateOp + * The inputs must follow the order as specified in onnx specification + * + * \param[in] context Kernel context + * \param[in] ort_op Operator that has been created + * \param[in] input_values Array of inputs + * \param[in] input_count Number of inputs + * \param[in] output_values Array of outputs + * \param[in] output_count Number of outputs + * + * \since Version 1.12. + */ + ORT_API2_STATUS(InvokeOp, + _In_ const OrtKernelContext* context, + _In_ const OrtOp* ort_op, + _In_ const OrtValue* const* input_values, + _In_ int input_count, + _Inout_ OrtValue* const* output_values, + _In_ int output_count); + + /* \brief: Release an onnxruntime operator + * + * \param[in] Op Operator created by OrtApi::CreateOp + * + * \since Version 1.12. + */ + ORT_CLASS_RELEASE(Op); + + /** \brief: Append execution provider to the session options. + * \param[in] options + * \param[in] provider_name - provider to add. + * \param[in] provider_options_keys - keys to configure the provider options + * \param[in] provider_options_values - values to configure the provider options + * \param[in] num_keys - number of keys passed in + * + * Currently supported providers: + * QNN + * SNPE + * XNNPACK + * + * Note: If an execution provider has a dedicated SessionOptionsAppendExecutionProvider_ function + * that should be used to add it. + * + * QNN supported keys: + * "backend_path": file path to QNN backend library. + * "profiling_level": QNN profiling level, options: "basic", "detailed". + * "rpc_control_latency": QNN RPC control latency. + * + * SNPE supported keys: + * "runtime": SNPE runtime engine, options: "CPU", "CPU_FLOAT32", "GPU", "GPU_FLOAT32_16_HYBRID", "GPU_FLOAT16", + * "DSP", "DSP_FIXED8_TF", "AIP_FIXED_TF", "AIP_FIXED8_TF". + * Mapping to SNPE Runtime_t definition: CPU, CPU_FLOAT32 => zdl::DlSystem::Runtime_t::CPU; + * GPU, GPU_FLOAT32_16_HYBRID => zdl::DlSystem::Runtime_t::GPU; + * GPU_FLOAT16 => zdl::DlSystem::Runtime_t::GPU_FLOAT16; + * DSP, DSP_FIXED8_TF => zdl::DlSystem::Runtime_t::DSP. + * AIP_FIXED_TF, AIP_FIXED8_TF => zdl::DlSystem::Runtime_t::AIP_FIXED_TF. + * "priority": execution priority, options: "low", "normal". + * "buffer_type": ITensor or user buffers, options: "ITENSOR", user buffer with different types - "TF8", "TF16", "UINT8", "FLOAT". + * "ITENSOR" -- default, ITensor which is float only. + * "TF8" -- quantized model required, "FLOAT" -- for both quantized or non-quantized model + * If SNPE is not available (due to a non Snpe enabled build or its dependencies not being installed), this function will fail. + * + * XNNPACK supported keys: + * "intra_op_num_threads": number of thread-pool size to use for XNNPACK execution provider. + * default value is 0, which means to use the session thread-pool size. + * + * \since Version 1.12. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider, _In_ OrtSessionOptions* options, + _In_ const char* provider_name, + _In_reads_(num_keys) const char* const* provider_options_keys, + _In_reads_(num_keys) const char* const* provider_options_values, + _In_ size_t num_keys); + + /* \brief: Get a copy of kernel info + * + * \param[in] info Kernel info + * \param[out] info_copy Copy of kernel info + * + * \since Version 1.12. + */ + ORT_API2_STATUS(CopyKernelInfo, + _In_ const OrtKernelInfo* info, + _Outptr_ OrtKernelInfo** info_copy); + + /* \brief: Release kernel info + * + * \param[in] KernelInfo A copy of kernel info returned by CopyKernelInfo + * + * \since Version 1.12. + */ + ORT_CLASS_RELEASE(KernelInfo); + + /// \name Ort Training + /// @{ + /** \brief Gets the Training C Api struct + * + * Call this function to access the ::OrtTrainingApi structure that holds pointers to functions that enable + * training with onnxruntime. + * \note A NULL pointer will be returned and no error message will be printed if the training api + * is not supported with this build. A NULL pointer will be returned and an error message will be + * printed if the provided version is unsupported, for example when using a runtime older than the + * version created with this header file. + * + * \param[in] version Must be ::ORT_API_VERSION + * \return The ::OrtTrainingApi struct for the version requested. + * + * \since Version 1.13 + */ + const OrtTrainingApi*(ORT_API_CALL* GetTrainingApi)(uint32_t version)NO_EXCEPTION; + + /// @} + + /** \brief Append CANN provider to session options + * + * If CANN is not available (due to a non CANN enabled build, or if CANN is not installed on the system), this function will return failure. + * + * \param[in] options + * \param[in] cann_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.13. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_CANN, + _In_ OrtSessionOptions* options, _In_ const OrtCANNProviderOptions* cann_options); + + /** \brief Create an OrtCANNProviderOptions + * + * \param[out] out created ::OrtCANNProviderOptions. Must be released with OrtApi::ReleaseCANNProviderOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.13. + */ + ORT_API2_STATUS(CreateCANNProviderOptions, _Outptr_ OrtCANNProviderOptions** out); + + /** \brief Set options in a CANN Execution Provider. + * + * \param[in] cann_options + * \param[in] provider_options_keys Array of UTF-8 null-terminated string for provider options keys + * \param[in] provider_options_values Array of UTF-8 null-terminated string for provider options values + * \param[in] num_keys Number of elements in the `provider_option_keys` and `provider_options_values` arrays + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.13. + */ + ORT_API2_STATUS(UpdateCANNProviderOptions, _Inout_ OrtCANNProviderOptions* cann_options, + _In_reads_(num_keys) const char* const* provider_options_keys, + _In_reads_(num_keys) const char* const* provider_options_values, + _In_ size_t num_keys); + + /** \brief Get serialized CANN provider options string. + * + * \param[in] cann_options OrtCANNProviderOptions instance + * \param[in] allocator a ptr to an instance of OrtAllocator obtained with CreateAllocator() + * or GetAllocatorWithDefaultOptions(), the specified allocator will be used to allocate + * continuous buffers for output strings and lengths. + * \param[out] ptr is a UTF-8 null terminated string allocated using 'allocator'. + * The caller is responsible for using the same allocator to free it. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.13. + */ + ORT_API2_STATUS(GetCANNProviderOptionsAsString, _In_ const OrtCANNProviderOptions* cann_options, + _Inout_ OrtAllocator* allocator, _Outptr_ char** ptr); + + /** \brief Release an OrtCANNProviderOptions + * + * \param[in] the pointer of OrtCANNProviderOptions which will been deleted + * + * \since Version 1.13. + */ + void(ORT_API_CALL* ReleaseCANNProviderOptions)(_Frees_ptr_opt_ OrtCANNProviderOptions* input); + + /* \brief Get OrtDevice type from MemoryInfo + * + * \since Version 1.14 + */ + void(ORT_API_CALL* MemoryInfoGetDeviceType)(_In_ const OrtMemoryInfo* ptr, _Out_ OrtMemoryInfoDeviceType* out); + + /* \brief Update the OrtEnv instance with custom log severity level + * + * \param[in] ort_env The OrtEnv instance being used + * \param[in] log_severity_level The log severity level. + * + * \since Version 1.14. + */ + ORT_API2_STATUS(UpdateEnvWithCustomLogLevel, _In_ OrtEnv* ort_env, OrtLoggingLevel log_severity_level); + + /* \brief Set affinities for intra op threads + * + * Affinity string follows format: + * logical_processor_id,logical_processor_id;logical_processor_id,logical_processor_id + * Semicolon isolates configurations among threads, while comma split processors where ith thread expected to attach to. + * e.g. 1,2,3;4,5 + * specifies affinities for two threads, with the 1st thread attach to the 1st, 2nd, and 3rd processor, and 2nd thread to the 4th and 5th. + * To ease the configuration, an "interval" is also allowed: + * e.g. 1-8;8-16;17-24 + * orders that the 1st thread runs on first eight processors, 2nd thread runs on next eight processors, and so forth. + * Note: + * 1. Once set, the number of thread affinities must equal to intra_op_num_threads - 1, + * ort does not set affinity on the main thread which is started and managed by the calling app; + * 2. For windows, ort will infer the group id from a logical processor id, for example, assuming there are two groups with each has 64 logical processors, + * an id of 64 will be inferred as the last processor of the 1st group, while 65 will be interpreted as the 1st processor of the second group. + * Hence 64-65 is an invalid configuration, because a windows thread cannot be attached to processors across group boundary. + * + * \since Version 1.14 + */ + ORT_API2_STATUS(SetGlobalIntraOpThreadAffinity, _Inout_ OrtThreadingOptions* tp_options, const char* affinity_string); + + /** \brief Register custom ops from a shared library. + * + * Loads a shared library (.dll on windows, .so on linux, etc) named 'library_name' and looks for this entry point: + * OrtStatus* RegisterCustomOps(OrtSessionOptions * options, const OrtApiBase* api); + * It then passes in the provided session options to this function along with the api base. + * + * The handle to the loaded library is automatically released by ORT when the last OrtSession that references the + * library handle is released. If no OrtSession is created, then the library handle is released when the provided + * OrtSessionOptions is released. + * + * \param[in] options The session options. + * \param[in] library_name The name of the shared library to load and register. Refer to OS-specific dynamic library + * loading utilities (e.g., LoadLibraryEx on Windows or dlopen on Linux/MacOS) for information + * on the format of library names and search paths. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(RegisterCustomOpsLibrary_V2, _Inout_ OrtSessionOptions* options, _In_ const ORTCHAR_T* library_name); + + /** \brief Register custom ops by calling a RegisterCustomOpsFn function. + * + * Searches for registration_func_name and if found calls it. + * + * The library containing the function must either be linked against or previously loaded by the executable. + * + * If you want ONNX Runtime to load the library and manage its lifetime, use RegisterCustomOpsLibrary_V2. + * + * RegisterCustomOpsUsingFunction can be used in scenarios where it may not be possible for ONNX Runtime to load + * the library from a path. e.g. mobile platforms where the library must be linked into the app. + * + * The registration function must have the signature of RegisterCustomOpsFn: + * OrtStatus* (*fn)(OrtSessionOptions* options, const OrtApiBase* api); + * + * See https://onnxruntime.ai/docs/reference/operators/add-custom-op.html for details on how the registration + * function should be implemented. + * + * \param[in] options OrtSessionOptions that is passed through as the first argument in the call to the + * registration function. + * \param[in] registration_func_name Name of registration function to use. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(RegisterCustomOpsUsingFunction, _Inout_ OrtSessionOptions* options, + _In_ const char* registration_func_name); + + /// \name OrtKernelInfo + /// Custom operator APIs. + /// @{ + + /** \brief Get the number of inputs from ::OrtKernelInfo. + * + * Used in the CreateKernel callback of an OrtCustomOp to query the number of inputs + * during kernel/session creation. + * + * \param[in] info Instance of ::OrtKernelInfo. + * \param[out] out Pointer to variable assigned with the result on success. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetInputCount, _In_ const OrtKernelInfo* info, _Out_ size_t* out); + + /** \brief Get the number of outputs from ::OrtKernelInfo. + * + * Used in the CreateKernel callback of an OrtCustomOp to query the number of outputs + * during kernel/session creation. + * + * \param[in] info Instance of ::OrtKernelInfo. + * \param[out] out Pointer to variable assigned with the result on success. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetOutputCount, _In_ const OrtKernelInfo* info, _Out_ size_t* out); + + /** \brief Get the name of a ::OrtKernelInfo's input. + * + * Used in the CreateKernel callback of an OrtCustomOp to query an input's name + * during kernel/session creation. + * + * If `out` is nullptr, the value of `size` is set to the size of the name + * string (including null-terminator), and a success status is returned. + * + * If the `size` parameter is greater than or equal to the name string's size, + * the value of `size` is set to the true size of the string (including null-terminator), + * the provided memory is filled with the string's contents, and a success status is returned. + * + * If the `size` parameter is less than the actual string's size and `out` + * is not nullptr, the value of `size` is set to the true size of the string + * and a failure status is returned. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[in] index The index of the input name to get. Returns a failure status if out-of-bounds. + * \param[out] out Memory location into which to write the UTF-8 null-terminated string representing the input's name. + * \param[in,out] size Pointer to the size of the `out` buffer. See above comments for details. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetInputName, _In_ const OrtKernelInfo* info, size_t index, _Out_ char* out, + _Inout_ size_t* size); + + /** \brief Get the name of a ::OrtKernelInfo's output. + * + * Used in the CreateKernel callback of an OrtCustomOp to query an output's name + * during kernel/session creation. + * + * If `out` is nullptr, the value of `size` is set to the size of the name + * string (including null-terminator), and a success status is returned. + * + * If the `size` parameter is greater than or equal to the name string's size, + * the value of `size` is set to the true size of the string (including null-terminator), + * the provided memory is filled with the string's contents, and a success status is returned. + * + * If the `size` parameter is less than the actual string's size and `out` + * is not nullptr, the value of `size` is set to the true size of the string + * and a failure status is returned. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[in] index The index of the output name to get. Returns a failure status if out-of-bounds. + * \param[out] out Memory location into which to write the UTF-8 null-terminated string representing the output's + * name. + * \param[in,out] size Pointer to the size of the `out` buffer. See above comments for details. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetOutputName, _In_ const OrtKernelInfo* info, size_t index, _Out_ char* out, + _Inout_ size_t* size); + + /** \brief Get the type information for a ::OrtKernelInfo's input. + * + * Used in the CreateKernel callback of an OrtCustomOp to query the shape and type information + * of an input during kernel/session creation. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[in] index Which input to get the type information for + * \param[out] type_info Pointer set to the resulting ::OrtTypeInfo. Must be freed with OrtApi::ReleaseTypeInfo. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetInputTypeInfo, _In_ const OrtKernelInfo* info, size_t index, + _Outptr_ OrtTypeInfo** type_info); + + /** \brief Get the type information for a ::OrtKernelInfo's output. + * + * Used in the CreateKernel callback of an OrtCustomOp to query the shape and type information + * of an output during kernel/session creation. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[in] index Which input to get the type information for + * \param[out] type_info Pointer set to the resulting ::OrtTypeInfo. Must be freed with OrtApi::ReleaseTypeInfo. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(KernelInfo_GetOutputTypeInfo, _In_ const OrtKernelInfo* info, size_t index, + _Outptr_ OrtTypeInfo** type_info); + + /** \brief Get a ::OrtValue tensor stored as an attribute in the graph node. + * + * Used in the CreateKernel callback of an OrtCustomOp to get a tensor attribute. + * + * \param[in] info ::OrtKernelInfo instance. + * \param[in] name UTF-8 null-terminated string representing the attribute's name. + * \param[in] allocator Allocator used to allocate the internal tensor state. + * \param[out] out Returns newly created ::OrtValue. Must be freed with OrtApi::ReleaseValue, + * which will also free internal tensor state allocated with the provided allocator. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(KernelInfoGetAttribute_tensor, _In_ const OrtKernelInfo* info, _In_z_ const char* name, + _Inout_ OrtAllocator* allocator, _Outptr_ OrtValue** out); + + /// @} + /// \name OrtSessionOptions + /// Custom operator APIs + /// @{ + + /** \brief Checks if the given session configuration entry exists. + * + * The config_key formats are defined in onnxruntime_session_options_config_keys.h + * + * Can be used in a custom operator library to check for session configuration entries + * that target one or more custom operators in the library. Example: The config entry + * custom_op.myop.some_key targets a custom op named "myop". + * + * \param[in] options The ::OrtSessionOptions instance. + * \param[in] config_key A null-terminated UTF-8 string representation of the configuration key. + * \param[out] out Pointer set to 1 if the entry exists and 0 otherwise. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(HasSessionConfigEntry, _In_ const OrtSessionOptions* options, + _In_z_ const char* config_key, _Out_ int* out); + + /** \brief Get a session configuration value. + * + * Returns a failure status if the configuration key does not exist. + * The config_key and the format of config_value are defined in onnxruntime_session_options_config_keys.h + * + * If `config_value` is nullptr, the value of `size` is set to the true size of the string + * value (including null-terminator), and a success status is returned. + * + * If the `size` parameter is greater than or equal to the actual string value's size, + * the value of `size` is set to the true size of the string value, the provided memory + * is filled with the value's contents, and a success status is returned. + * + * If the `size` parameter is less than the actual string value's size and `config_value` + * is not nullptr, the value of `size` is set to the true size of the string value + * and a failure status is returned. + * + * Can be used in a custom operator library to get session configuration entries + * that target one or more custom operators in the library. Example: The config entry + * custom_op.myop.some_key targets a custom op named "myop". + * + * \param[in] options The session options. + * \param[in] config_key A null-terminated UTF-8 string representation of the config key. + * \param[in] config_value Pointer to memory where the null-terminated UTF-8 string value will be stored. + * \param[in,out] size Pointer to the size of the `config_value` buffer. See above comments for details. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.14 + */ + ORT_API2_STATUS(GetSessionConfigEntry, _In_ const OrtSessionOptions* options, + _In_z_ const char* config_key, _Out_ char* config_value, _Inout_ size_t* size); + + /// @} + + /** \brief Append dnnl provider to session options + * + * If oneDNN is not available, this function will return failure. + * + * \param[in] options + * \param[in] dnnl_options + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(SessionOptionsAppendExecutionProvider_Dnnl, + _In_ OrtSessionOptions* options, _In_ const OrtDnnlProviderOptions* dnnl_options); + + /** \brief Create an OrtDnnlProviderOptions + * + * \param[out] out Newly created ::OrtDnnlProviderOptions. Must be released with OrtApi::ReleaseDnnlProviderOptions + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(CreateDnnlProviderOptions, _Outptr_ OrtDnnlProviderOptions** out); + + /** \brief Set options in a oneDNN Execution Provider. + * + * Key should be in null terminated string format of the member of ::OrtDnnlProviderOptions + * and value should be its related range. + * + * For example, key="use_arena" and value="1" + * + * \param[in] dnnl_options + * \param[in] provider_options_keys Array of UTF-8 null-terminated string for provider options keys + * \param[in] provider_options_values Array of UTF-8 null-terminated string for provider options values + * \param[in] num_keys Number of elements in the `provider_option_keys` and `provider_options_values` arrays + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(UpdateDnnlProviderOptions, _Inout_ OrtDnnlProviderOptions* dnnl_options, + _In_reads_(num_keys) const char* const* provider_options_keys, + _In_reads_(num_keys) const char* const* provider_options_values, + _In_ size_t num_keys); + + /** + * Get serialized oneDNN provider options string. + * + * For example, "use_arena=1;......" + * + * \param dnnl_options - OrtDnnlProviderOptions instance + * \param allocator - a ptr to an instance of OrtAllocator obtained with CreateAllocator() or GetAllocatorWithDefaultOptions() + * the specified allocator will be used to allocate continuous buffers for output strings and lengths. + * \param ptr - is a UTF-8 null terminated string allocated using 'allocator'. The caller is responsible for using the same allocator to free it. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(GetDnnlProviderOptionsAsString, _In_ const OrtDnnlProviderOptions* dnnl_options, _Inout_ OrtAllocator* allocator, _Outptr_ char** ptr); + + /** \brief Release an ::OrtDnnlProviderOptions + * + * \since Version 1.15. + */ + void(ORT_API_CALL* ReleaseDnnlProviderOptions)(_Frees_ptr_opt_ OrtDnnlProviderOptions* input); + + /// \name OrtKernelInfo + /// Custom operator APIs. + /// @{ + + /** \brief Get the graph node name from ::OrtKernelInfo. + * + * If `out` is nullptr, the value of `size` is set to the size of the name + * string (including null-terminator), and a success status is returned. + * + * If the `size` parameter is greater than or equal to the name string's size, + * the value of `size` is set to the true size of the string (including null-terminator), + * the provided memory is filled with the string's contents, and a success status is returned. + * + * If the `size` parameter is less than the actual string's size and `out` + * is not nullptr, the value of `size` is set to the true size of the string + * and a failure status is returned. + * + * Can be used in a custom operator's CreateKernel callback to get the name of the operator's node name in the graph. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[out] out Memory location into which to write the UTF-8 null-terminated string representing the name. + * \param[in,out] size Pointer to the size of the `out` buffer. See above comments for details. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.15 + */ + ORT_API2_STATUS(KernelInfo_GetNodeName, _In_ const OrtKernelInfo* info, _Out_ char* out, _Inout_ size_t* size); + + /** \brief Get the session logger from ::OrtKernelInfo. + * + * Used in the CreateKernel callback of an OrtCustomOp to get a logger that can be used to log + * messages. + * + * \param[in] info An instance of ::OrtKernelInfo. + * \param[out] logger Pointer set to the session's ::OrtLogger. Owned by ONNX Runtime, so do not free. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.15 + */ + ORT_API2_STATUS(KernelInfo_GetLogger, _In_ const OrtKernelInfo* info, _Outptr_ const OrtLogger** logger); + + /// @} + /// \name OrtKernelContext + /// Custom operator APIs. + /// @{ + + /** \brief Get the runtime logger from ::OrtKernelContext. + * + * Used in the KernelCompute callback of an OrtCustomOp to get a logger that can be used to log + * messages during inference. + * + * \param[in] context An instance of ::OrtKernelContext. + * \param[out] logger Pointer set to the kernel context's ::OrtLogger. Owned by ONNX Runtime, so do not free. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.15 + */ + ORT_API2_STATUS(KernelContext_GetLogger, _In_ const OrtKernelContext* context, _Outptr_ const OrtLogger** logger); + + /// @} + /// \name OrtLogger + /// Custom operator APIs. + /// @{ + + /** \brief Logs a message at the given severity level using the provided ::OrtLogger. + * + * Only messages with a severity level equal or greater than the ::OrtLogger's logging severity level + * are logged. Use OrtApi::Logger_GetLoggingSeverityLevel to get the ::OrtLogger's logging severity + * level. + * + * Can be used in custom operators to log messages with the logger retrieved via OrtApi::KernelInfo_GetLogger. + * + * \param[in] logger The ::OrtLogger instance. + * \param[in] log_severity_level The message's severity level. + * \param[in] message The message to log. + * \param[in] file_path The filepath of the file in which the message is logged. Usually the value of ORT_FILE. + * \param[in] line_number The file line number in which the message is logged. Usually the value of __LINE__. + * \param[in] func_name The name of the function in which the message is logged. Usually the value of __FUNCTION__. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.15 + */ + ORT_API2_STATUS(Logger_LogMessage, _In_ const OrtLogger* logger, OrtLoggingLevel log_severity_level, + _In_z_ const char* message, _In_z_ const ORTCHAR_T* file_path, int line_number, + _In_z_ const char* func_name); + + /** \brief Get the logging severity level of the ::OrtLogger. + * + * Can be used in a custom operator to get the logging serverity level of the ::OrtLogger associated with + * the ::OrtKernelInfo. + * + * \param[in] logger The ::OrtLogger instance. + * \param[out] out Pointer to variable assigned with the logging severity level on success. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * \since Version 1.15 + */ + ORT_API2_STATUS(Logger_GetLoggingSeverityLevel, _In_ const OrtLogger* logger, _Out_ OrtLoggingLevel* out); + + /// @} + + /** \brief Get a ::OrtValue tensor stored as a constant initializer in the graph node. + * + * Used in the CreateKernel callback of an OrtCustomOp to get a tensor value. + * + * \param[in] info ::OrtKernelInfo instance. + * \param[in] index The node index. + * \param[out] is_constant Is it a constant node input or not. + * \param[out] out The OrtValue tensor value. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(KernelInfoGetConstantInput_tensor, _In_ const OrtKernelInfo* info, size_t index, _Out_ int* is_constant, _Outptr_ const OrtValue** out); + + /** \brief Get Optional Type information from an ::OrtTypeInfo + * + * This augments ::OrtTypeInfo to return an ::OrtOptionalTypeInfo when the type is optional. + * The OrtOptionalTypeInfo also has a nested ::OrtTypeInfo that describes the type of the optional value. + * ::OrtOptionalTypeInfo type can only appear within model metadata to describe inputs/outputs. + * The actual OrtValues that are supplied in place of optional type inputs should contain + * specific type that is described by ::OrtOptionalTypeInfo. + * + * So the picture: ::OrtTypeInfo -> ::OrtOptionalTypeInfo -> ::OrtTypeInfo (describes the type that can be supplied + * in place of the optional type when creating the actual ::OrtValue). + * + * \param[in] type_info + * \param[out] out A pointer to the ::OrtOptionalTypeInfo. Do not free this value, + * it is owned by OrtTypeInfo instance. When the type_info does not represent + * optional type, nullptr is returned in out. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(CastTypeInfoToOptionalTypeInfo, _In_ const OrtTypeInfo* type_info, + _Outptr_result_maybenull_ const OrtOptionalTypeInfo** out); + + /** \brief Get OrtTypeInfo for the allowed contained type from an ::OrtOptionalTypeInfo. + * + * This augments ::OrtOptionalTypeInfo to return an ::OrtTypeInfo for the contained type. + * The OrtOptionalTypeInfo has a nested ::OrtTypeInfo that describes the type of the optional value. + * ::OrtOptionalTypeInfo type can only appear within model metadata to describe inputs/outputs. + * The actual OrtValues that are supplied in place of optional type inputs should contain + * specific type that is described by the returned ::OrtTypeInfo. + * + * \param[in] optional_type_info + * \param[out] out A pointer to the ::OrtTypeInfo for what the optional value could be. + * it is owned by OrtOptionalTypeInfo instance. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(GetOptionalContainedTypeInfo, _In_ const OrtOptionalTypeInfo* optional_type_info, + _Outptr_ OrtTypeInfo** out); + + /** \brief Set a single string in a string tensor + * Do not zero terminate the string data. + * + * \param[in] value A string tensor + * \param[in] index - flat index of the element + * \param[in] length_in_bytes length of the buffer in utf-8 bytes (without the null terminator) + * \param[inout] buffer - address of return value + * + * \snippet{doc} snippets.dox OrtStatus Return Value + */ + ORT_API2_STATUS(GetResizedStringTensorElementBuffer, _Inout_ OrtValue* value, _In_ size_t index, _In_ size_t length_in_bytes, _Inout_ char** buffer); + + /** \brief Get Allocator from KernelContext for a specific memoryInfo. + * + * \param[in] context OrtKernelContext instance + * \param[in] mem_info OrtMemoryInfo instance + * \param[out] out A pointer to OrtAllocator. + * + * \snippet{doc} snippets.dox OrtStatus Return Value + * + * \since Version 1.15. + */ + ORT_API2_STATUS(KernelContext_GetAllocator, _In_ const OrtKernelContext* context, _In_ const OrtMemoryInfo* mem_info, _Outptr_ OrtAllocator** out); + + /** \brief Returns a null terminated string of the build info including git info and cxx flags + * + * \return UTF-8 encoded version string. Do not deallocate the returned buffer. + * + * \since Version 1.15. + */ + const char*(ORT_API_CALL* GetBuildInfoString)(void); +}; + +/* + * Steps to use a custom op: + * 1 Create an OrtCustomOpDomain with the domain name used by the custom ops + * 2 Create an OrtCustomOp structure for each op and add them to the domain + * 3 Call OrtAddCustomOpDomain to add the custom domain of ops to the session options + */ + +// Specifies some characteristics of inputs/outputs of custom ops: +// Specify if the inputs/outputs are one of: +// 1) Non-optional (input/output must be present in the node) +// 2) Optional (input/output may be absent in the node) +// 3) Variadic: A variadic input or output specifies N (i.e., the minimum arity) or more operands. +// Only the last input or output of a custom op may be marked as variadic. +// The homogeneity of the variadic input or output determines whether all operands must be of the same +// tensor element type. +typedef enum OrtCustomOpInputOutputCharacteristic { + INPUT_OUTPUT_REQUIRED = 0, + INPUT_OUTPUT_OPTIONAL, + INPUT_OUTPUT_VARIADIC, +} OrtCustomOpInputOutputCharacteristic; + +/* + * The OrtCustomOp structure defines a custom op's schema and its kernel callbacks. The callbacks are filled in by + * the implementor of the custom op. + */ +struct OrtCustomOp { + uint32_t version; // Must be initialized to ORT_API_VERSION + + // This callback creates the kernel, which is a user defined parameter that is passed to the Kernel* callbacks below. + void*(ORT_API_CALL* CreateKernel)(_In_ const struct OrtCustomOp* op, _In_ const OrtApi* api, + _In_ const OrtKernelInfo* info); + + // Returns the name of the op + const char*(ORT_API_CALL* GetName)(_In_ const struct OrtCustomOp* op); + + // Returns the type of the execution provider, return nullptr to use CPU execution provider + const char*(ORT_API_CALL* GetExecutionProviderType)(_In_ const struct OrtCustomOp* op); + + // Returns the count and types of the input & output tensors + ONNXTensorElementDataType(ORT_API_CALL* GetInputType)(_In_ const struct OrtCustomOp* op, _In_ size_t index); + size_t(ORT_API_CALL* GetInputTypeCount)(_In_ const struct OrtCustomOp* op); + ONNXTensorElementDataType(ORT_API_CALL* GetOutputType)(_In_ const struct OrtCustomOp* op, _In_ size_t index); + size_t(ORT_API_CALL* GetOutputTypeCount)(_In_ const struct OrtCustomOp* op); + + // Op kernel callbacks + void(ORT_API_CALL* KernelCompute)(_In_ void* op_kernel, _In_ OrtKernelContext* context); + void(ORT_API_CALL* KernelDestroy)(_In_ void* op_kernel); + + // Returns the characteristics of the input & output tensors + OrtCustomOpInputOutputCharacteristic(ORT_API_CALL* GetInputCharacteristic)(_In_ const struct OrtCustomOp* op, _In_ size_t index); + OrtCustomOpInputOutputCharacteristic(ORT_API_CALL* GetOutputCharacteristic)(_In_ const struct OrtCustomOp* op, _In_ size_t index); + + // Returns the memory type of the input tensors. This API allows the custom op + // to place the inputs on specific devices. By default, it returns + // OrtMemTypeDefault, which means the input is placed on the default device for + // the execution provider. If the inputs need to be with different memory tyeps, + // this function can be overridden to return the specific memory types. + OrtMemType(ORT_API_CALL* GetInputMemoryType)(_In_ const struct OrtCustomOp* op, _In_ size_t index); + + // Returns the minimum number of input arguments expected for the variadic input. + // Applicable only for custom ops that have a variadic input. + int(ORT_API_CALL* GetVariadicInputMinArity)(_In_ const struct OrtCustomOp* op); + + // Returns true (non-zero) if all arguments of a variadic input have to be of the same type (homogeneous), + // and false (zero) otherwise. + // Applicable only for custom ops that have a variadic input. + int(ORT_API_CALL* GetVariadicInputHomogeneity)(_In_ const struct OrtCustomOp* op); + + // Returns the minimum number of output values expected for the variadic output. + // Applicable only for custom ops that have a variadic output. + int(ORT_API_CALL* GetVariadicOutputMinArity)(_In_ const struct OrtCustomOp* op); + + // Returns true (non-zero) if all outputs values of a variadic output have to be of the same type (homogeneous), + // and false (zero) otherwise. + // Applicable only for custom ops that have a variadic output. + int(ORT_API_CALL* GetVariadicOutputHomogeneity)(_In_ const struct OrtCustomOp* op); +}; + +/* + * This is the old way to add the CUDA provider to the session, please use SessionOptionsAppendExecutionProvider_CUDA above to access the latest functionality + * This function always exists, but will only succeed if Onnxruntime was built with CUDA support and the CUDA provider shared library exists + * + * \param device_id CUDA device id, starts from zero. + */ +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProvider_CUDA, _In_ OrtSessionOptions* options, int device_id); + +/* + * This is the old way to add the MIGraphX provider to the session, please use + * SessionOptionsAppendExecutionProvider_MIGraphX above to access the latest functionality + * This function always exists, but will only succeed if Onnxruntime was built with + * HIP support and the MIGraphX provider shared library exists + * + * \param device_id HIP device id, starts from zero. + */ +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProvider_MIGraphX, _In_ OrtSessionOptions* options, int device_id); + +/* + * This is the old way to add the oneDNN provider to the session, please use + * SessionOptionsAppendExecutionProvider_oneDNN above to access the latest functionality + * This function always exists, but will only succeed if Onnxruntime was built with + * oneDNN support and the oneDNN provider shared library exists + * + * \param use_arena zero: false. non-zero: true. + */ +ORT_API_STATUS(OrtSessionOptionsAppendExecutionProvider_Dnnl, _In_ OrtSessionOptions* options, int use_arena); + +#ifdef __cplusplus +} +#endif +/// @} diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_api.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_api.h new file mode 100644 index 0000000..2d5e1a9 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_api.h @@ -0,0 +1,2088 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +// Summary: The Ort C++ API is a header only wrapper around the Ort C API. +// +// The C++ API simplifies usage by returning values directly instead of error codes, throwing exceptions on errors +// and automatically releasing resources in the destructors. The primary purpose of C++ API is exception safety so +// all the resources follow RAII and do not leak memory. +// +// Each of the C++ wrapper classes holds only a pointer to the C internal object. Treat them like smart pointers. +// To create an empty object, pass 'nullptr' to the constructor (for example, Env e{nullptr};). However, you can't use them +// until you assign an instance that actually holds an underlying object. +// +// For Ort objects only move assignment between objects is allowed, there are no copy constructors. +// Some objects have explicit 'Clone' methods for this purpose. +// +// ConstXXXX types are copyable since they do not own the underlying C object, so you can pass them to functions as arguments +// by value or by reference. ConstXXXX types are restricted to const only interfaces. +// +// UnownedXXXX are similar to ConstXXXX but also allow non-const interfaces. +// +// The lifetime of the corresponding owning object must eclipse the lifetimes of the ConstXXXX/UnownedXXXX types. They exists so you do not +// have to fallback to C types and the API with the usual pitfalls. In general, do not use C API from your C++ code. + +#pragma once +#include "onnxruntime_c_api.h" +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#ifdef ORT_NO_EXCEPTIONS +#include +#endif + +/** \brief All C++ Onnxruntime APIs are defined inside this namespace + * + */ +namespace Ort { + +/** \brief All C++ methods that can fail will throw an exception of this type + * + * If ORT_NO_EXCEPTIONS is defined, then any error will result in a call to abort() + */ +struct Exception : std::exception { + Exception(std::string&& string, OrtErrorCode code) : message_{std::move(string)}, code_{code} {} + + OrtErrorCode GetOrtErrorCode() const { return code_; } + const char* what() const noexcept override { return message_.c_str(); } + + private: + std::string message_; + OrtErrorCode code_; +}; + +#ifdef ORT_NO_EXCEPTIONS +// The #ifndef is for the very special case where the user of this library wants to define their own way of handling errors. +// NOTE: This header expects control flow to not continue after calling ORT_CXX_API_THROW +#ifndef ORT_CXX_API_THROW +#define ORT_CXX_API_THROW(string, code) \ + do { \ + std::cerr << Ort::Exception(string, code) \ + .what() \ + << std::endl; \ + abort(); \ + } while (false) +#endif +#else +#define ORT_CXX_API_THROW(string, code) \ + throw Ort::Exception(string, code) +#endif + +// This is used internally by the C++ API. This class holds the global variable that points to the OrtApi, +// it's in a template so that we can define a global variable in a header and make +// it transparent to the users of the API. +template +struct Global { + static const OrtApi* api_; +}; + +// If macro ORT_API_MANUAL_INIT is defined, no static initialization will be performed. Instead, user must call InitApi() before using it. +template +#ifdef ORT_API_MANUAL_INIT +const OrtApi* Global::api_{}; +inline void InitApi() noexcept { Global::api_ = OrtGetApiBase()->GetApi(ORT_API_VERSION); } + +// Used by custom operator libraries that are not linked to onnxruntime. Sets the global API object, which is +// required by C++ APIs. +// +// Example mycustomop.cc: +// +// #define ORT_API_MANUAL_INIT +// #include +// #undef ORT_API_MANUAL_INIT +// +// OrtStatus* ORT_API_CALL RegisterCustomOps(OrtSessionOptions* options, const OrtApiBase* api_base) { +// Ort::InitApi(api_base->GetApi(ORT_API_VERSION)); +// // ... +// } +// +inline void InitApi(const OrtApi* api) noexcept { Global::api_ = api; } +#else +#if defined(_MSC_VER) && !defined(__clang__) +#pragma warning(push) +// "Global initializer calls a non-constexpr function." Therefore you can't use ORT APIs in the other global initializers. +// Please define ORT_API_MANUAL_INIT if it conerns you. +#pragma warning(disable : 26426) +#endif +const OrtApi* Global::api_ = OrtGetApiBase()->GetApi(ORT_API_VERSION); +#if defined(_MSC_VER) && !defined(__clang__) +#pragma warning(pop) +#endif +#endif + +/// This returns a reference to the OrtApi interface in use +inline const OrtApi& GetApi() noexcept { return *Global::api_; } + +/// +/// This function returns the onnxruntime version string +/// +/// version string major.minor.rev +std::string GetVersionString(); + +/// +/// This function returns the onnxruntime build information: including git branch, +/// git commit id, build type(Debug/Release/RelWithDebInfo) and cmake cpp flags. +/// +/// string +std::string GetBuildInfoString(); + +/// +/// This is a C++ wrapper for OrtApi::GetAvailableProviders() and +/// returns a vector of strings representing the available execution providers. +/// +/// vector of strings +std::vector GetAvailableProviders(); + +/** \brief IEEE 754 half-precision floating point data type + * \details It is necessary for type dispatching to make use of C++ API + * The type is implicitly convertible to/from uint16_t. + * The size of the structure should align with uint16_t and one can freely cast + * uint16_t buffers to/from Ort::Float16_t to feed and retrieve data. + * + * Generally, you can feed any of your types as float16/blfoat16 data to create a tensor + * on top of it, providing it can form a continuous buffer with 16-bit elements with no padding. + * And you can also feed a array of uint16_t elements directly. For example, + * + * \code{.unparsed} + * uint16_t values[] = { 15360, 16384, 16896, 17408, 17664}; + * constexpr size_t values_length = sizeof(values) / sizeof(values[0]); + * std::vector dims = {values_length}; // one dimensional example + * Ort::MemoryInfo info("Cpu", OrtDeviceAllocator, 0, OrtMemTypeDefault); + * // Note we are passing bytes count in this api, not number of elements -> sizeof(values) + * auto float16_tensor = Ort::Value::CreateTensor(info, values, sizeof(values), + * dims.data(), dims.size(), ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT16); + * \endcode + * + * Here is another example, a little bit more elaborate. Let's assume that you use your own float16 type and you want to use + * a templated version of the API above so the type is automatically set based on your type. You will need to supply an extra + * template specialization. + * + * \code{.unparsed} + * namespace yours { struct half {}; } // assume this is your type, define this: + * namespace Ort { + * template<> + * struct TypeToTensorType { static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT16; }; + * } //namespace Ort + * + * std::vector values; + * std::vector dims = {values.size()}; // one dimensional example + * Ort::MemoryInfo info("Cpu", OrtDeviceAllocator, 0, OrtMemTypeDefault); + * // Here we are passing element count -> values.size() + * auto float16_tensor = Ort::Value::CreateTensor(info, values.data(), values.size(), dims.data(), dims.size()); + * + * \endcode + */ +struct Float16_t { + uint16_t value; + constexpr Float16_t() noexcept : value(0) {} + constexpr Float16_t(uint16_t v) noexcept : value(v) {} + constexpr operator uint16_t() const noexcept { return value; } + constexpr bool operator==(const Float16_t& rhs) const noexcept { return value == rhs.value; }; + constexpr bool operator!=(const Float16_t& rhs) const noexcept { return value != rhs.value; }; +}; + +static_assert(sizeof(Float16_t) == sizeof(uint16_t), "Sizes must match"); + +/** \brief bfloat16 (Brain Floating Point) data type + * \details It is necessary for type dispatching to make use of C++ API + * The type is implicitly convertible to/from uint16_t. + * The size of the structure should align with uint16_t and one can freely cast + * uint16_t buffers to/from Ort::BFloat16_t to feed and retrieve data. + * + * See also code examples for Float16_t above. + */ +struct BFloat16_t { + uint16_t value; + constexpr BFloat16_t() noexcept : value(0) {} + constexpr BFloat16_t(uint16_t v) noexcept : value(v) {} + constexpr operator uint16_t() const noexcept { return value; } + constexpr bool operator==(const BFloat16_t& rhs) const noexcept { return value == rhs.value; }; + constexpr bool operator!=(const BFloat16_t& rhs) const noexcept { return value != rhs.value; }; +}; + +static_assert(sizeof(BFloat16_t) == sizeof(uint16_t), "Sizes must match"); + +namespace detail { +// This is used internally by the C++ API. This macro is to make it easy to generate overloaded methods for all of the various OrtRelease* functions for every Ort* type +// This can't be done in the C API since C doesn't have function overloading. +#define ORT_DEFINE_RELEASE(NAME) \ + inline void OrtRelease(Ort##NAME* ptr) { GetApi().Release##NAME(ptr); } + +ORT_DEFINE_RELEASE(Allocator); +ORT_DEFINE_RELEASE(MemoryInfo); +ORT_DEFINE_RELEASE(CustomOpDomain); +ORT_DEFINE_RELEASE(ThreadingOptions); +ORT_DEFINE_RELEASE(Env); +ORT_DEFINE_RELEASE(RunOptions); +ORT_DEFINE_RELEASE(Session); +ORT_DEFINE_RELEASE(SessionOptions); +ORT_DEFINE_RELEASE(TensorTypeAndShapeInfo); +ORT_DEFINE_RELEASE(SequenceTypeInfo); +ORT_DEFINE_RELEASE(MapTypeInfo); +ORT_DEFINE_RELEASE(TypeInfo); +ORT_DEFINE_RELEASE(Value); +ORT_DEFINE_RELEASE(ModelMetadata); +ORT_DEFINE_RELEASE(IoBinding); +ORT_DEFINE_RELEASE(ArenaCfg); +ORT_DEFINE_RELEASE(Status); +ORT_DEFINE_RELEASE(OpAttr); +ORT_DEFINE_RELEASE(Op); +ORT_DEFINE_RELEASE(KernelInfo); + +#undef ORT_DEFINE_RELEASE + +/** \brief This is a tagging template type. Use it with Base to indicate that the C++ interface object + * has no ownership of the underlying C object. + */ +template +struct Unowned { + using Type = T; +}; + +/** \brief Used internally by the C++ API. C++ wrapper types inherit from this. + * This is a zero cost abstraction to wrap the C API objects and delete them on destruction. + * + * All of the C++ classes + * a) serve as containers for pointers to objects that are created by the underlying C API. + * Their size is just a pointer size, no need to dynamically allocate them. Use them by value. + * b) Each of struct XXXX, XXX instances function as smart pointers to the underlying C API objects. + * they would release objects owned automatically when going out of scope, they are move-only. + * c) ConstXXXX and UnownedXXX structs function as non-owning, copyable containers for the above pointers. + * ConstXXXX allow calling const interfaces only. They give access to objects that are owned by somebody else + * such as Onnxruntime or instances of XXXX classes. + * d) serve convenient interfaces that return C++ objects and further enhance exception and type safety so they can be used + * in C++ code. + * + */ + +/// +/// This is a non-const pointer holder that is move-only. Disposes of the pointer on destruction. +/// +template +struct Base { + using contained_type = T; + + constexpr Base() = default; + constexpr explicit Base(contained_type* p) noexcept : p_{p} {} + ~Base() { OrtRelease(p_); } + + Base(const Base&) = delete; + Base& operator=(const Base&) = delete; + + Base(Base&& v) noexcept : p_{v.p_} { v.p_ = nullptr; } + Base& operator=(Base&& v) noexcept { + OrtRelease(p_); + p_ = v.release(); + return *this; + } + + constexpr operator contained_type*() const noexcept { return p_; } + + /// \brief Relinquishes ownership of the contained C object pointer + /// The underlying object is not destroyed + contained_type* release() { + T* p = p_; + p_ = nullptr; + return p; + } + + protected: + contained_type* p_{}; +}; + +// Undefined. For const types use Base> +template +struct Base; + +/// +/// Covers unowned pointers owned by either the ORT +/// or some other instance of CPP wrappers. +/// Used for ConstXXX and UnownedXXXX types that are copyable. +/// Also convenient to wrap raw OrtXX pointers . +/// +/// +template +struct Base> { + using contained_type = typename Unowned::Type; + + constexpr Base() = default; + constexpr explicit Base(contained_type* p) noexcept : p_{p} {} + + ~Base() = default; + + Base(const Base&) = default; + Base& operator=(const Base&) = default; + + Base(Base&& v) noexcept : p_{v.p_} { v.p_ = nullptr; } + Base& operator=(Base&& v) noexcept { + p_ = nullptr; + std::swap(p_, v.p_); + return *this; + } + + constexpr operator contained_type*() const noexcept { return p_; } + + protected: + contained_type* p_{}; +}; + +// Light functor to release memory with OrtAllocator +struct AllocatedFree { + OrtAllocator* allocator_; + explicit AllocatedFree(OrtAllocator* allocator) + : allocator_(allocator) {} + void operator()(void* ptr) const { + if (ptr) allocator_->Free(allocator_, ptr); + } +}; + +} // namespace detail + +struct AllocatorWithDefaultOptions; +struct Env; +struct TypeInfo; +struct Value; +struct ModelMetadata; + +/** \brief unique_ptr typedef used to own strings allocated by OrtAllocators + * and release them at the end of the scope. The lifespan of the given allocator + * must eclipse the lifespan of AllocatedStringPtr instance + */ +using AllocatedStringPtr = std::unique_ptr; + +/** \brief The Status that holds ownership of OrtStatus received from C API + * Use it to safely destroy OrtStatus* returned from the C API. Use appropriate + * constructors to construct an instance of a Status object from exceptions. + */ +struct Status : detail::Base { + explicit Status(std::nullptr_t) noexcept {} ///< Create an empty object, must be assigned a valid one to be used + explicit Status(OrtStatus* status) noexcept; ///< Takes ownership of OrtStatus instance returned from the C API. + explicit Status(const Exception&) noexcept; ///< Creates status instance out of exception + explicit Status(const std::exception&) noexcept; ///< Creates status instance out of exception + Status(const char* message, OrtErrorCode code) noexcept; ///< Creates status instance out of null-terminated string message. + std::string GetErrorMessage() const; + OrtErrorCode GetErrorCode() const; + bool IsOK() const noexcept; ///< Returns true if instance represents an OK (non-error) status. +}; + +/** \brief The ThreadingOptions + * + * The ThreadingOptions used for set global threadpools' options of The Env. + */ +struct ThreadingOptions : detail::Base { + /// \brief Wraps OrtApi::CreateThreadingOptions + ThreadingOptions(); + + /// \brief Wraps OrtApi::SetGlobalIntraOpNumThreads + ThreadingOptions& SetGlobalIntraOpNumThreads(int intra_op_num_threads); + + /// \brief Wraps OrtApi::SetGlobalInterOpNumThreads + ThreadingOptions& SetGlobalInterOpNumThreads(int inter_op_num_threads); + + /// \brief Wraps OrtApi::SetGlobalSpinControl + ThreadingOptions& SetGlobalSpinControl(int allow_spinning); + + /// \brief Wraps OrtApi::SetGlobalDenormalAsZero + ThreadingOptions& SetGlobalDenormalAsZero(); + + /// \brief Wraps OrtApi::SetGlobalCustomCreateThreadFn + ThreadingOptions& SetGlobalCustomCreateThreadFn(OrtCustomCreateThreadFn ort_custom_create_thread_fn); + + /// \brief Wraps OrtApi::SetGlobalCustomThreadCreationOptions + ThreadingOptions& SetGlobalCustomThreadCreationOptions(void* ort_custom_thread_creation_options); + + /// \brief Wraps OrtApi::SetGlobalCustomJoinThreadFn + ThreadingOptions& SetGlobalCustomJoinThreadFn(OrtCustomJoinThreadFn ort_custom_join_thread_fn); +}; + +/** \brief The Env (Environment) + * + * The Env holds the logging state used by all other objects. + * Note: One Env must be created before using any other Onnxruntime functionality + */ +struct Env : detail::Base { + explicit Env(std::nullptr_t) {} ///< Create an empty Env object, must be assigned a valid one to be used + + /// \brief Wraps OrtApi::CreateEnv + Env(OrtLoggingLevel logging_level = ORT_LOGGING_LEVEL_WARNING, _In_ const char* logid = ""); + + /// \brief Wraps OrtApi::CreateEnvWithCustomLogger + Env(OrtLoggingLevel logging_level, const char* logid, OrtLoggingFunction logging_function, void* logger_param); + + /// \brief Wraps OrtApi::CreateEnvWithGlobalThreadPools + Env(const OrtThreadingOptions* tp_options, OrtLoggingLevel logging_level = ORT_LOGGING_LEVEL_WARNING, _In_ const char* logid = ""); + + /// \brief Wraps OrtApi::CreateEnvWithCustomLoggerAndGlobalThreadPools + Env(const OrtThreadingOptions* tp_options, OrtLoggingFunction logging_function, void* logger_param, + OrtLoggingLevel logging_level = ORT_LOGGING_LEVEL_WARNING, _In_ const char* logid = ""); + + /// \brief C Interop Helper + explicit Env(OrtEnv* p) : Base{p} {} + + Env& EnableTelemetryEvents(); ///< Wraps OrtApi::EnableTelemetryEvents + Env& DisableTelemetryEvents(); ///< Wraps OrtApi::DisableTelemetryEvents + + Env& UpdateEnvWithCustomLogLevel(OrtLoggingLevel log_severity_level); ///< Wraps OrtApi::UpdateEnvWithCustomLogLevel + + Env& CreateAndRegisterAllocator(const OrtMemoryInfo* mem_info, const OrtArenaCfg* arena_cfg); ///< Wraps OrtApi::CreateAndRegisterAllocator +}; + +/** \brief Custom Op Domain + * + */ +struct CustomOpDomain : detail::Base { + explicit CustomOpDomain(std::nullptr_t) {} ///< Create an empty CustomOpDomain object, must be assigned a valid one to be used + + /// \brief Wraps OrtApi::CreateCustomOpDomain + explicit CustomOpDomain(const char* domain); + + // This does not take ownership of the op, simply registers it. + void Add(const OrtCustomOp* op); ///< Wraps CustomOpDomain_Add +}; + +/** \brief RunOptions + * + */ +struct RunOptions : detail::Base { + explicit RunOptions(std::nullptr_t) {} ///< Create an empty RunOptions object, must be assigned a valid one to be used + RunOptions(); ///< Wraps OrtApi::CreateRunOptions + + RunOptions& SetRunLogVerbosityLevel(int); ///< Wraps OrtApi::RunOptionsSetRunLogVerbosityLevel + int GetRunLogVerbosityLevel() const; ///< Wraps OrtApi::RunOptionsGetRunLogVerbosityLevel + + RunOptions& SetRunLogSeverityLevel(int); ///< Wraps OrtApi::RunOptionsSetRunLogSeverityLevel + int GetRunLogSeverityLevel() const; ///< Wraps OrtApi::RunOptionsGetRunLogSeverityLevel + + RunOptions& SetRunTag(const char* run_tag); ///< wraps OrtApi::RunOptionsSetRunTag + const char* GetRunTag() const; ///< Wraps OrtApi::RunOptionsGetRunTag + + RunOptions& AddConfigEntry(const char* config_key, const char* config_value); ///< Wraps OrtApi::AddRunConfigEntry + + /** \brief Terminates all currently executing Session::Run calls that were made using this RunOptions instance + * + * If a currently executing session needs to be force terminated, this can be called from another thread to force it to fail with an error + * Wraps OrtApi::RunOptionsSetTerminate + */ + RunOptions& SetTerminate(); + + /** \brief Clears the terminate flag so this RunOptions instance can be used in a new Session::Run call without it instantly terminating + * + * Wraps OrtApi::RunOptionsUnsetTerminate + */ + RunOptions& UnsetTerminate(); +}; + +namespace detail { +// Utility function that returns a SessionOption config entry key for a specific custom operator. +// Ex: custom_op.[custom_op_name].[config] +std::string MakeCustomOpConfigEntryKey(const char* custom_op_name, const char* config); +} // namespace detail + +/// +/// Class that represents session configuration entries for one or more custom operators. +/// +/// Example: +/// Ort::CustomOpConfigs op_configs; +/// op_configs.AddConfig("my_custom_op", "device_type", "CPU"); +/// +/// Passed to Ort::SessionOptions::RegisterCustomOpsLibrary. +/// +struct CustomOpConfigs { + CustomOpConfigs() = default; + ~CustomOpConfigs() = default; + CustomOpConfigs(const CustomOpConfigs&) = default; + CustomOpConfigs& operator=(const CustomOpConfigs&) = default; + CustomOpConfigs(CustomOpConfigs&& o) = default; + CustomOpConfigs& operator=(CustomOpConfigs&& o) = default; + + /** \brief Adds a session configuration entry/value for a specific custom operator. + * + * \param custom_op_name The name of the custom operator for which to add a configuration entry. + * Must match the name returned by the CustomOp's GetName() method. + * \param config_key The name of the configuration entry. + * \param config_value The value of the configuration entry. + * \return A reference to this object to enable call chaining. + */ + CustomOpConfigs& AddConfig(const char* custom_op_name, const char* config_key, const char* config_value); + + /** \brief Returns a flattened map of custom operator configuration entries and their values. + * + * The keys has been flattened to include both the custom operator name and the configuration entry key name. + * For example, a prior call to AddConfig("my_op", "key", "value") corresponds to the flattened key/value pair + * {"my_op.key", "value"}. + * + * \return An unordered map of flattened configurations. + */ + const std::unordered_map& GetFlattenedConfigs() const; + + private: + std::unordered_map flat_configs_; +}; + +/** \brief Options object used when creating a new Session object + * + * Wraps ::OrtSessionOptions object and methods + */ + +struct SessionOptions; + +namespace detail { +// we separate const-only methods because passing const ptr to non-const methods +// is only discovered when inline methods are compiled which is counter-intuitive +template +struct ConstSessionOptionsImpl : Base { + using B = Base; + using B::B; + + SessionOptions Clone() const; ///< Creates and returns a copy of this SessionOptions object. Wraps OrtApi::CloneSessionOptions + + std::string GetConfigEntry(const char* config_key) const; ///< Wraps OrtApi::GetSessionConfigEntry + bool HasConfigEntry(const char* config_key) const; ///< Wraps OrtApi::HasSessionConfigEntry + std::string GetConfigEntryOrDefault(const char* config_key, const std::string& def); +}; + +template +struct SessionOptionsImpl : ConstSessionOptionsImpl { + using B = ConstSessionOptionsImpl; + using B::B; + + SessionOptionsImpl& SetIntraOpNumThreads(int intra_op_num_threads); ///< Wraps OrtApi::SetIntraOpNumThreads + SessionOptionsImpl& SetInterOpNumThreads(int inter_op_num_threads); ///< Wraps OrtApi::SetInterOpNumThreads + SessionOptionsImpl& SetGraphOptimizationLevel(GraphOptimizationLevel graph_optimization_level); ///< Wraps OrtApi::SetSessionGraphOptimizationLevel + + SessionOptionsImpl& EnableCpuMemArena(); ///< Wraps OrtApi::EnableCpuMemArena + SessionOptionsImpl& DisableCpuMemArena(); ///< Wraps OrtApi::DisableCpuMemArena + + SessionOptionsImpl& SetOptimizedModelFilePath(const ORTCHAR_T* optimized_model_file); ///< Wraps OrtApi::SetOptimizedModelFilePath + + SessionOptionsImpl& EnableProfiling(const ORTCHAR_T* profile_file_prefix); ///< Wraps OrtApi::EnableProfiling + SessionOptionsImpl& DisableProfiling(); ///< Wraps OrtApi::DisableProfiling + + SessionOptionsImpl& EnableOrtCustomOps(); ///< Wraps OrtApi::EnableOrtCustomOps + + SessionOptionsImpl& EnableMemPattern(); ///< Wraps OrtApi::EnableMemPattern + SessionOptionsImpl& DisableMemPattern(); ///< Wraps OrtApi::DisableMemPattern + + SessionOptionsImpl& SetExecutionMode(ExecutionMode execution_mode); ///< Wraps OrtApi::SetSessionExecutionMode + + SessionOptionsImpl& SetLogId(const char* logid); ///< Wraps OrtApi::SetSessionLogId + SessionOptionsImpl& SetLogSeverityLevel(int level); ///< Wraps OrtApi::SetSessionLogSeverityLevel + + SessionOptionsImpl& Add(OrtCustomOpDomain* custom_op_domain); ///< Wraps OrtApi::AddCustomOpDomain + + SessionOptionsImpl& DisablePerSessionThreads(); ///< Wraps OrtApi::DisablePerSessionThreads + + SessionOptionsImpl& AddConfigEntry(const char* config_key, const char* config_value); ///< Wraps OrtApi::AddSessionConfigEntry + + SessionOptionsImpl& AddInitializer(const char* name, const OrtValue* ort_val); ///< Wraps OrtApi::AddInitializer + SessionOptionsImpl& AddExternalInitializers(const std::vector& names, const std::vector& ort_values); ///< Wraps OrtApi::AddExternalInitializers + + SessionOptionsImpl& AppendExecutionProvider_CUDA(const OrtCUDAProviderOptions& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_CUDA + SessionOptionsImpl& AppendExecutionProvider_CUDA_V2(const OrtCUDAProviderOptionsV2& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_CUDA_V2 + SessionOptionsImpl& AppendExecutionProvider_ROCM(const OrtROCMProviderOptions& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_ROCM + SessionOptionsImpl& AppendExecutionProvider_OpenVINO(const OrtOpenVINOProviderOptions& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_OpenVINO + SessionOptionsImpl& AppendExecutionProvider_TensorRT(const OrtTensorRTProviderOptions& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_TensorRT + SessionOptionsImpl& AppendExecutionProvider_TensorRT_V2(const OrtTensorRTProviderOptionsV2& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_TensorRT + SessionOptionsImpl& AppendExecutionProvider_MIGraphX(const OrtMIGraphXProviderOptions& provider_options); ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_MIGraphX + ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_CANN + SessionOptionsImpl& AppendExecutionProvider_CANN(const OrtCANNProviderOptions& provider_options); + ///< Wraps OrtApi::SessionOptionsAppendExecutionProvider_Dnnl + SessionOptionsImpl& AppendExecutionProvider_Dnnl(const OrtDnnlProviderOptions& provider_options); + /// Wraps OrtApi::SessionOptionsAppendExecutionProvider. Currently supports QNN, SNPE and XNNPACK. + SessionOptionsImpl& AppendExecutionProvider(const std::string& provider_name, + const std::unordered_map& provider_options = {}); + + SessionOptionsImpl& SetCustomCreateThreadFn(OrtCustomCreateThreadFn ort_custom_create_thread_fn); ///< Wraps OrtApi::SessionOptionsSetCustomCreateThreadFn + SessionOptionsImpl& SetCustomThreadCreationOptions(void* ort_custom_thread_creation_options); ///< Wraps OrtApi::SessionOptionsSetCustomThreadCreationOptions + SessionOptionsImpl& SetCustomJoinThreadFn(OrtCustomJoinThreadFn ort_custom_join_thread_fn); ///< Wraps OrtApi::SessionOptionsSetCustomJoinThreadFn + + ///< Registers the custom operator from the specified shared library via OrtApi::RegisterCustomOpsLibrary_V2. + ///< The custom operator configurations are optional. If provided, custom operator configs are set via + ///< OrtApi::AddSessionConfigEntry. + SessionOptionsImpl& RegisterCustomOpsLibrary(const ORTCHAR_T* library_name, const CustomOpConfigs& custom_op_configs = {}); + + SessionOptionsImpl& RegisterCustomOpsUsingFunction(const char* function_name); ///< Wraps OrtApi::RegisterCustomOpsUsingFunction +}; +} // namespace detail + +using UnownedSessionOptions = detail::SessionOptionsImpl>; +using ConstSessionOptions = detail::ConstSessionOptionsImpl>; + +/** \brief Wrapper around ::OrtSessionOptions + * + */ +struct SessionOptions : detail::SessionOptionsImpl { + explicit SessionOptions(std::nullptr_t) {} ///< Create an empty SessionOptions object, must be assigned a valid one to be used + SessionOptions(); ///< Wraps OrtApi::CreateSessionOptions + explicit SessionOptions(OrtSessionOptions* p) : SessionOptionsImpl{p} {} ///< Used for interop with the C API + UnownedSessionOptions GetUnowned() const { return UnownedSessionOptions{this->p_}; } + ConstSessionOptions GetConst() const { return ConstSessionOptions{this->p_}; } +}; + +/** \brief Wrapper around ::OrtModelMetadata + * + */ +struct ModelMetadata : detail::Base { + explicit ModelMetadata(std::nullptr_t) {} ///< Create an empty ModelMetadata object, must be assigned a valid one to be used + explicit ModelMetadata(OrtModelMetadata* p) : Base{p} {} ///< Used for interop with the C API + + /** \brief Returns a copy of the producer name. + * + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetProducerNameAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetProducerName + + /** \brief Returns a copy of the graph name. + * + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetGraphNameAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetGraphName + + /** \brief Returns a copy of the domain name. + * + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetDomainAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetDomain + + /** \brief Returns a copy of the description. + * + * \param allocator to allocate memory for the copy of the string returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetDescriptionAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetDescription + + /** \brief Returns a copy of the graph description. + * + * \param allocator to allocate memory for the copy of the string returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetGraphDescriptionAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetGraphDescription + + /** \brief Returns a vector of copies of the custom metadata keys. + * + * \param allocator to allocate memory for the copy of the string returned + * \return a instance std::vector of smart pointers that would deallocate the buffers when out of scope. + * The OrtAllocator instance must be valid at the point of memory release. + */ + std::vector GetCustomMetadataMapKeysAllocated(OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataGetCustomMetadataMapKeys + + /** \brief Looks up a value by a key in the Custom Metadata map + * + * \param key zero terminated string key to lookup + * \param allocator to allocate memory for the copy of the string returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * maybe nullptr if key is not found. + * + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr LookupCustomMetadataMapAllocated(const char* key, OrtAllocator* allocator) const; ///< Wraps OrtApi::ModelMetadataLookupCustomMetadataMap + + int64_t GetVersion() const; ///< Wraps OrtApi::ModelMetadataGetVersion +}; + +struct IoBinding; + +namespace detail { + +// we separate const-only methods because passing const ptr to non-const methods +// is only discovered when inline methods are compiled which is counter-intuitive +template +struct ConstSessionImpl : Base { + using B = Base; + using B::B; + + size_t GetInputCount() const; ///< Returns the number of model inputs + size_t GetOutputCount() const; ///< Returns the number of model outputs + size_t GetOverridableInitializerCount() const; ///< Returns the number of inputs that have defaults that can be overridden + + /** \brief Returns a copy of input name at the specified index. + * + * \param index must less than the value returned by GetInputCount() + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetInputNameAllocated(size_t index, OrtAllocator* allocator) const; + + /** \brief Returns a copy of output name at then specified index. + * + * \param index must less than the value returned by GetOutputCount() + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetOutputNameAllocated(size_t index, OrtAllocator* allocator) const; + + /** \brief Returns a copy of the overridable initializer name at then specified index. + * + * \param index must less than the value returned by GetOverridableInitializerCount() + * \param allocator to allocate memory for the copy of the name returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr GetOverridableInitializerNameAllocated(size_t index, OrtAllocator* allocator) const; ///< Wraps OrtApi::SessionGetOverridableInitializerName + + uint64_t GetProfilingStartTimeNs() const; ///< Wraps OrtApi::SessionGetProfilingStartTimeNs + ModelMetadata GetModelMetadata() const; ///< Wraps OrtApi::SessionGetModelMetadata + + TypeInfo GetInputTypeInfo(size_t index) const; ///< Wraps OrtApi::SessionGetInputTypeInfo + TypeInfo GetOutputTypeInfo(size_t index) const; ///< Wraps OrtApi::SessionGetOutputTypeInfo + TypeInfo GetOverridableInitializerTypeInfo(size_t index) const; ///< Wraps OrtApi::SessionGetOverridableInitializerTypeInfo +}; + +template +struct SessionImpl : ConstSessionImpl { + using B = ConstSessionImpl; + using B::B; + + /** \brief Run the model returning results in an Ort allocated vector. + * + * Wraps OrtApi::Run + * + * The caller provides a list of inputs and a list of the desired outputs to return. + * + * See the output logs for more information on warnings/errors that occur while processing the model. + * Common errors are.. (TODO) + * + * \param[in] run_options + * \param[in] input_names Array of null terminated strings of length input_count that is the list of input names + * \param[in] input_values Array of Value objects of length input_count that is the list of input values + * \param[in] input_count Number of inputs (the size of the input_names & input_values arrays) + * \param[in] output_names Array of C style strings of length output_count that is the list of output names + * \param[in] output_count Number of outputs (the size of the output_names array) + * \return A std::vector of Value objects that directly maps to the output_names array (eg. output_name[0] is the first entry of the returned vector) + */ + std::vector Run(const RunOptions& run_options, const char* const* input_names, const Value* input_values, size_t input_count, + const char* const* output_names, size_t output_count); + + /** \brief Run the model returning results in user provided outputs + * Same as Run(const RunOptions&, const char* const*, const Value*, size_t,const char* const*, size_t) + */ + void Run(const RunOptions& run_options, const char* const* input_names, const Value* input_values, size_t input_count, + const char* const* output_names, Value* output_values, size_t output_count); + + void Run(const RunOptions& run_options, const IoBinding&); ///< Wraps OrtApi::RunWithBinding + + /** \brief End profiling and return a copy of the profiling file name. + * + * \param allocator to allocate memory for the copy of the string returned + * \return a instance of smart pointer that would deallocate the buffer when out of scope. + * The OrtAllocator instances must be valid at the point of memory release. + */ + AllocatedStringPtr EndProfilingAllocated(OrtAllocator* allocator); ///< Wraps OrtApi::SessionEndProfiling +}; + +} // namespace detail + +using ConstSession = detail::ConstSessionImpl>; +using UnownedSession = detail::SessionImpl>; + +/** \brief Wrapper around ::OrtSession + * + */ +struct Session : detail::SessionImpl { + explicit Session(std::nullptr_t) {} ///< Create an empty Session object, must be assigned a valid one to be used + Session(const Env& env, const ORTCHAR_T* model_path, const SessionOptions& options); ///< Wraps OrtApi::CreateSession + Session(const Env& env, const ORTCHAR_T* model_path, const SessionOptions& options, + OrtPrepackedWeightsContainer* prepacked_weights_container); ///< Wraps OrtApi::CreateSessionWithPrepackedWeightsContainer + Session(const Env& env, const void* model_data, size_t model_data_length, const SessionOptions& options); ///< Wraps OrtApi::CreateSessionFromArray + Session(const Env& env, const void* model_data, size_t model_data_length, const SessionOptions& options, + OrtPrepackedWeightsContainer* prepacked_weights_container); ///< Wraps OrtApi::CreateSessionFromArrayWithPrepackedWeightsContainer + + ConstSession GetConst() const { return ConstSession{this->p_}; } + UnownedSession GetUnowned() const { return UnownedSession{this->p_}; } +}; + +namespace detail { +template +struct MemoryInfoImpl : Base { + using B = Base; + using B::B; + + std::string GetAllocatorName() const; + OrtAllocatorType GetAllocatorType() const; + int GetDeviceId() const; + OrtMemoryInfoDeviceType GetDeviceType() const; + OrtMemType GetMemoryType() const; + + template + bool operator==(const MemoryInfoImpl& o) const; +}; +} // namespace detail + +// Const object holder that does not own the underlying object +using ConstMemoryInfo = detail::MemoryInfoImpl>; + +/** \brief Wrapper around ::OrtMemoryInfo + * + */ +struct MemoryInfo : detail::MemoryInfoImpl { + static MemoryInfo CreateCpu(OrtAllocatorType type, OrtMemType mem_type1); + explicit MemoryInfo(std::nullptr_t) {} ///< No instance is created + explicit MemoryInfo(OrtMemoryInfo* p) : MemoryInfoImpl{p} {} ///< Take ownership of a pointer created by C Api + MemoryInfo(const char* name, OrtAllocatorType type, int id, OrtMemType mem_type); + ConstMemoryInfo GetConst() const { return ConstMemoryInfo{this->p_}; } +}; + +namespace detail { +template +struct TensorTypeAndShapeInfoImpl : Base { + using B = Base; + using B::B; + + ONNXTensorElementDataType GetElementType() const; ///< Wraps OrtApi::GetTensorElementType + size_t GetElementCount() const; ///< Wraps OrtApi::GetTensorShapeElementCount + + size_t GetDimensionsCount() const; ///< Wraps OrtApi::GetDimensionsCount + + /** \deprecated use GetShape() returning std::vector + * [[deprecated]] + * This interface is unsafe to use + */ + [[deprecated("use GetShape()")]] void GetDimensions(int64_t* values, size_t values_count) const; ///< Wraps OrtApi::GetDimensions + + void GetSymbolicDimensions(const char** values, size_t values_count) const; ///< Wraps OrtApi::GetSymbolicDimensions + + std::vector GetShape() const; ///< Uses GetDimensionsCount & GetDimensions to return a std::vector of the shape +}; + +} // namespace detail + +using ConstTensorTypeAndShapeInfo = detail::TensorTypeAndShapeInfoImpl>; + +/** \brief Wrapper around ::OrtTensorTypeAndShapeInfo + * + */ +struct TensorTypeAndShapeInfo : detail::TensorTypeAndShapeInfoImpl { + explicit TensorTypeAndShapeInfo(std::nullptr_t) {} ///< Create an empty TensorTypeAndShapeInfo object, must be assigned a valid one to be used + explicit TensorTypeAndShapeInfo(OrtTensorTypeAndShapeInfo* p) : TensorTypeAndShapeInfoImpl{p} {} ///< Used for interop with the C API + ConstTensorTypeAndShapeInfo GetConst() const { return ConstTensorTypeAndShapeInfo{this->p_}; } +}; + +namespace detail { +template +struct SequenceTypeInfoImpl : Base { + using B = Base; + using B::B; + TypeInfo GetSequenceElementType() const; ///< Wraps OrtApi::GetSequenceElementType +}; + +} // namespace detail + +using ConstSequenceTypeInfo = detail::SequenceTypeInfoImpl>; + +/** \brief Wrapper around ::OrtSequenceTypeInfo + * + */ +struct SequenceTypeInfo : detail::SequenceTypeInfoImpl { + explicit SequenceTypeInfo(std::nullptr_t) {} ///< Create an empty SequenceTypeInfo object, must be assigned a valid one to be used + explicit SequenceTypeInfo(OrtSequenceTypeInfo* p) : SequenceTypeInfoImpl{p} {} ///< Used for interop with the C API + ConstSequenceTypeInfo GetConst() const { return ConstSequenceTypeInfo{this->p_}; } +}; + +namespace detail { +template +struct OptionalTypeInfoImpl : Base { + using B = Base; + using B::B; + TypeInfo GetOptionalElementType() const; ///< Wraps OrtApi::CastOptionalTypeToContainedTypeInfo +}; + +} // namespace detail + +// This is always owned by the TypeInfo and can only be obtained from it. +using ConstOptionalTypeInfo = detail::OptionalTypeInfoImpl>; + +namespace detail { +template +struct MapTypeInfoImpl : detail::Base { + using B = Base; + using B::B; + ONNXTensorElementDataType GetMapKeyType() const; ///< Wraps OrtApi::GetMapKeyType + TypeInfo GetMapValueType() const; ///< Wraps OrtApi::GetMapValueType +}; + +} // namespace detail + +using ConstMapTypeInfo = detail::MapTypeInfoImpl>; + +/** \brief Wrapper around ::OrtMapTypeInfo + * + */ +struct MapTypeInfo : detail::MapTypeInfoImpl { + explicit MapTypeInfo(std::nullptr_t) {} ///< Create an empty MapTypeInfo object, must be assigned a valid one to be used + explicit MapTypeInfo(OrtMapTypeInfo* p) : MapTypeInfoImpl{p} {} ///< Used for interop with the C API + ConstMapTypeInfo GetConst() const { return ConstMapTypeInfo{this->p_}; } +}; + +namespace detail { +template +struct TypeInfoImpl : detail::Base { + using B = Base; + using B::B; + + ConstTensorTypeAndShapeInfo GetTensorTypeAndShapeInfo() const; ///< Wraps OrtApi::CastTypeInfoToTensorInfo + ConstSequenceTypeInfo GetSequenceTypeInfo() const; ///< Wraps OrtApi::CastTypeInfoToSequenceTypeInfo + ConstMapTypeInfo GetMapTypeInfo() const; ///< Wraps OrtApi::CastTypeInfoToMapTypeInfo + ConstOptionalTypeInfo GetOptionalTypeInfo() const; ///< wraps OrtApi::CastTypeInfoToOptionalTypeInfo + + ONNXType GetONNXType() const; +}; +} // namespace detail + +/// +/// Contains a constant, unowned OrtTypeInfo that can be copied and passed around by value. +/// Provides access to const OrtTypeInfo APIs. +/// +using ConstTypeInfo = detail::TypeInfoImpl>; + +/// +/// Type information that may contain either TensorTypeAndShapeInfo or +/// the information about contained sequence or map depending on the ONNXType. +/// +struct TypeInfo : detail::TypeInfoImpl { + explicit TypeInfo(std::nullptr_t) {} ///< Create an empty TypeInfo object, must be assigned a valid one to be used + explicit TypeInfo(OrtTypeInfo* p) : TypeInfoImpl{p} {} ///< C API Interop + + ConstTypeInfo GetConst() const { return ConstTypeInfo{this->p_}; } +}; + +namespace detail { +// This structure is used to feed sparse tensor values +// information for use with FillSparseTensor() API +// if the data type for the sparse tensor values is numeric +// use data.p_data, otherwise, use data.str pointer to feed +// values. data.str is an array of const char* that are zero terminated. +// number of strings in the array must match shape size. +// For fully sparse tensors use shape {0} and set p_data/str +// to nullptr. +struct OrtSparseValuesParam { + const int64_t* values_shape; + size_t values_shape_len; + union { + const void* p_data; + const char** str; + } data; +}; + +// Provides a way to pass shape in a single +// argument +struct Shape { + const int64_t* shape; + size_t shape_len; +}; + +template +struct ConstValueImpl : Base { + using B = Base; + using B::B; + + /// + /// Obtains a pointer to a user defined data for experimental purposes + /// + template + void GetOpaqueData(const char* domain, const char* type_name, R&) const; ///< Wraps OrtApi::GetOpaqueValue + + bool IsTensor() const; ///< Returns true if Value is a tensor, false for other types like map/sequence/etc + bool HasValue() const; /// < Return true if OrtValue contains data and returns false if the OrtValue is a None + + size_t GetCount() const; // If a non tensor, returns 2 for map and N for sequence, where N is the number of elements + Value GetValue(int index, OrtAllocator* allocator) const; + + /// + /// This API returns a full length of string data contained within either a tensor or a sparse Tensor. + /// For sparse tensor it returns a full length of stored non-empty strings (values). The API is useful + /// for allocating necessary memory and calling GetStringTensorContent(). + /// + /// total length of UTF-8 encoded bytes contained. No zero terminators counted. + size_t GetStringTensorDataLength() const; + + /// + /// The API copies all of the UTF-8 encoded string data contained within a tensor or a sparse tensor + /// into a supplied buffer. Use GetStringTensorDataLength() to find out the length of the buffer to allocate. + /// The user must also allocate offsets buffer with the number of entries equal to that of the contained + /// strings. + /// + /// Strings are always assumed to be on CPU, no X-device copy. + /// + /// user allocated buffer + /// length in bytes of the allocated buffer + /// a pointer to the offsets user allocated buffer + /// count of offsets, must be equal to the number of strings contained. + /// that can be obtained from the shape of the tensor or from GetSparseTensorValuesTypeAndShapeInfo() + /// for sparse tensors + void GetStringTensorContent(void* buffer, size_t buffer_length, size_t* offsets, size_t offsets_count) const; + + /// + /// Returns a const typed pointer to the tensor contained data. + /// No type checking is performed, the caller must ensure the type matches the tensor type. + /// + /// + /// const pointer to data, no copies made + template + const R* GetTensorData() const; ///< Wraps OrtApi::GetTensorMutableData /// + + /// + /// Returns a non-typed pointer to a tensor contained data. + /// + /// const pointer to data, no copies made + const void* GetTensorRawData() const; + + /// + /// The API returns type information for data contained in a tensor. For sparse + /// tensors it returns type information for contained non-zero values. + /// It returns dense shape for sparse tensors. + /// + /// TypeInfo + TypeInfo GetTypeInfo() const; + + /// + /// The API returns type information for data contained in a tensor. For sparse + /// tensors it returns type information for contained non-zero values. + /// It returns dense shape for sparse tensors. + /// + /// TensorTypeAndShapeInfo + TensorTypeAndShapeInfo GetTensorTypeAndShapeInfo() const; + + /// + /// This API returns information about the memory allocation used to hold data. + /// + /// Non owning instance of MemoryInfo + ConstMemoryInfo GetTensorMemoryInfo() const; + + /// + /// The API copies UTF-8 encoded bytes for the requested string element + /// contained within a tensor or a sparse tensor into a provided buffer. + /// Use GetStringTensorElementLength() to obtain the length of the buffer to allocate. + /// + /// + /// + /// + void GetStringTensorElement(size_t buffer_length, size_t element_index, void* buffer) const; + + /// + /// Returns string tensor UTF-8 encoded string element. + /// Use of this API is recommended over GetStringTensorElement() that takes void* buffer pointer. + /// + /// + /// std::string + std::string GetStringTensorElement(size_t element_index) const; + + /// + /// The API returns a byte length of UTF-8 encoded string element + /// contained in either a tensor or a spare tensor values. + /// + /// + /// byte length for the specified string element + size_t GetStringTensorElementLength(size_t element_index) const; + +#if !defined(DISABLE_SPARSE_TENSORS) + /// + /// The API returns the sparse data format this OrtValue holds in a sparse tensor. + /// If the sparse tensor was not fully constructed, i.e. Use*() or Fill*() API were not used + /// the value returned is ORT_SPARSE_UNDEFINED. + /// + /// Format enum + OrtSparseFormat GetSparseFormat() const; + + /// + /// The API returns type and shape information for stored non-zero values of the + /// sparse tensor. Use GetSparseTensorValues() to obtain values buffer pointer. + /// + /// TensorTypeAndShapeInfo values information + TensorTypeAndShapeInfo GetSparseTensorValuesTypeAndShapeInfo() const; + + /// + /// The API returns type and shape information for the specified indices. Each supported + /// indices have their own enum values even if a give format has more than one kind of indices. + /// Use GetSparseTensorIndicesData() to obtain pointer to indices buffer. + /// + /// enum requested + /// type and shape information + TensorTypeAndShapeInfo GetSparseTensorIndicesTypeShapeInfo(OrtSparseIndicesFormat format) const; + + /// + /// The API retrieves a pointer to the internal indices buffer. The API merely performs + /// a convenience data type casting on the return type pointer. Make sure you are requesting + /// the right type, use GetSparseTensorIndicesTypeShapeInfo(); + /// + /// type to cast to + /// requested indices kind + /// number of indices entries + /// Pinter to the internal sparse tensor buffer containing indices. Do not free this pointer. + template + const R* GetSparseTensorIndicesData(OrtSparseIndicesFormat indices_format, size_t& num_indices) const; + + /// + /// Returns true if the OrtValue contains a sparse tensor + /// + /// + bool IsSparseTensor() const; + + /// + /// The API returns a pointer to an internal buffer of the sparse tensor + /// containing non-zero values. The API merely does casting. Make sure you + /// are requesting the right data type by calling GetSparseTensorValuesTypeAndShapeInfo() + /// first. + /// + /// numeric data types only. Use GetStringTensor*() to retrieve strings. + /// a pointer to the internal values buffer. Do not free this pointer. + template + const R* GetSparseTensorValues() const; + +#endif +}; + +template +struct ValueImpl : ConstValueImpl { + using B = ConstValueImpl; + using B::B; + + /// + /// Returns a non-const typed pointer to an OrtValue/Tensor contained buffer + /// No type checking is performed, the caller must ensure the type matches the tensor type. + /// + /// non-const pointer to data, no copies made + template + R* GetTensorMutableData(); + + /// + /// Returns a non-typed non-const pointer to a tensor contained data. + /// + /// pointer to data, no copies made + void* GetTensorMutableRawData(); + + /// + // Obtain a reference to an element of data at the location specified + /// by the vector of dims. + /// + /// + /// [in] expressed by a vecotr of dimensions offsets + /// + template + R& At(const std::vector& location); + + /// + /// Set all strings at once in a string tensor + /// + /// [in] An array of strings. Each string in this array must be null terminated. + /// [in] Count of strings in s (Must match the size of \p value's tensor shape) + void FillStringTensor(const char* const* s, size_t s_len); + + /// + /// Set a single string in a string tensor + /// + /// [in] A null terminated UTF-8 encoded string + /// [in] Index of the string in the tensor to set + void FillStringTensorElement(const char* s, size_t index); + + /// + /// Allocate if necessary and obtain a pointer to a UTF-8 + /// encoded string element buffer indexed by the flat element index, + /// of the specified length. + /// + /// This API is for advanced usage. It avoids a need to construct + /// an auxiliary array of string pointers, and allows to write data directly + /// (do not zero terminate). + /// + /// + /// + /// a pointer to a writable buffer + char* GetResizedStringTensorElementBuffer(size_t index, size_t buffer_length); + +#if !defined(DISABLE_SPARSE_TENSORS) + /// + /// Supplies COO format specific indices and marks the contained sparse tensor as being a COO format tensor. + /// Values are supplied with a CreateSparseTensor() API. The supplied indices are not copied and the user + /// allocated buffers lifespan must eclipse that of the OrtValue. + /// The location of the indices is assumed to be the same as specified by OrtMemoryInfo argument at the creation time. + /// + /// pointer to the user allocated buffer with indices. Use nullptr for fully sparse tensors. + /// number of indices entries. Use 0 for fully sparse tensors + void UseCooIndices(int64_t* indices_data, size_t indices_num); + + /// + /// Supplies CSR format specific indices and marks the contained sparse tensor as being a CSR format tensor. + /// Values are supplied with a CreateSparseTensor() API. The supplied indices are not copied and the user + /// allocated buffers lifespan must eclipse that of the OrtValue. + /// The location of the indices is assumed to be the same as specified by OrtMemoryInfo argument at the creation time. + /// + /// pointer to the user allocated buffer with inner indices or nullptr for fully sparse tensors + /// number of csr inner indices or 0 for fully sparse tensors + /// pointer to the user allocated buffer with outer indices or nullptr for fully sparse tensors + /// number of csr outer indices or 0 for fully sparse tensors + void UseCsrIndices(int64_t* inner_data, size_t inner_num, int64_t* outer_data, size_t outer_num); + + /// + /// Supplies BlockSparse format specific indices and marks the contained sparse tensor as being a BlockSparse format tensor. + /// Values are supplied with a CreateSparseTensor() API. The supplied indices are not copied and the user + /// allocated buffers lifespan must eclipse that of the OrtValue. + /// The location of the indices is assumed to be the same as specified by OrtMemoryInfo argument at the creation time. + /// + /// indices shape or a {0} for fully sparse + /// user allocated buffer with indices or nullptr for fully spare tensors + void UseBlockSparseIndices(const Shape& indices_shape, int32_t* indices_data); + + /// + /// The API will allocate memory using the allocator instance supplied to the CreateSparseTensor() API + /// and copy the values and COO indices into it. If data_mem_info specifies that the data is located + /// at difference device than the allocator, a X-device copy will be performed if possible. + /// + /// specified buffer memory description + /// values buffer information. + /// coo indices buffer or nullptr for fully sparse data + /// number of COO indices or 0 for fully sparse data + void FillSparseTensorCoo(const OrtMemoryInfo* data_mem_info, const OrtSparseValuesParam& values_param, + const int64_t* indices_data, size_t indices_num); + + /// + /// The API will allocate memory using the allocator instance supplied to the CreateSparseTensor() API + /// and copy the values and CSR indices into it. If data_mem_info specifies that the data is located + /// at difference device than the allocator, a X-device copy will be performed if possible. + /// + /// specified buffer memory description + /// values buffer information + /// csr inner indices pointer or nullptr for fully sparse tensors + /// number of csr inner indices or 0 for fully sparse tensors + /// pointer to csr indices data or nullptr for fully sparse tensors + /// number of csr outer indices or 0 + void FillSparseTensorCsr(const OrtMemoryInfo* data_mem_info, + const OrtSparseValuesParam& values, + const int64_t* inner_indices_data, size_t inner_indices_num, + const int64_t* outer_indices_data, size_t outer_indices_num); + + /// + /// The API will allocate memory using the allocator instance supplied to the CreateSparseTensor() API + /// and copy the values and BlockSparse indices into it. If data_mem_info specifies that the data is located + /// at difference device than the allocator, a X-device copy will be performed if possible. + /// + /// specified buffer memory description + /// values buffer information + /// indices shape. use {0} for fully sparse tensors + /// pointer to indices data or nullptr for fully sparse tensors + void FillSparseTensorBlockSparse(const OrtMemoryInfo* data_mem_info, + const OrtSparseValuesParam& values, + const Shape& indices_shape, + const int32_t* indices_data); + +#endif +}; + +} // namespace detail + +using ConstValue = detail::ConstValueImpl>; +using UnownedValue = detail::ValueImpl>; + +/** \brief Wrapper around ::OrtValue + * + */ +struct Value : detail::ValueImpl { + using Base = detail::ValueImpl; + using OrtSparseValuesParam = detail::OrtSparseValuesParam; + using Shape = detail::Shape; + + explicit Value(std::nullptr_t) {} ///< Create an empty Value object, must be assigned a valid one to be used + explicit Value(OrtValue* p) : Base{p} {} ///< Used for interop with the C API + Value(Value&&) = default; + Value& operator=(Value&&) = default; + + ConstValue GetConst() const { return ConstValue{this->p_}; } + UnownedValue GetUnowned() const { return UnownedValue{this->p_}; } + + /** \brief Creates a tensor with a user supplied buffer. Wraps OrtApi::CreateTensorWithDataAsOrtValue. + * \tparam T The numeric datatype. This API is not suitable for strings. + * \param info Memory description of where the p_data buffer resides (CPU vs GPU etc). + * \param p_data Pointer to the data buffer. + * \param p_data_element_count The number of elements in the data buffer. + * \param shape Pointer to the tensor shape dimensions. + * \param shape_len The number of tensor shape dimensions. + */ + template + static Value CreateTensor(const OrtMemoryInfo* info, T* p_data, size_t p_data_element_count, const int64_t* shape, size_t shape_len); + + /** \brief Creates a tensor with a user supplied buffer. Wraps OrtApi::CreateTensorWithDataAsOrtValue. + * \param info Memory description of where the p_data buffer resides (CPU vs GPU etc). + * \param p_data Pointer to the data buffer. + * \param p_data_byte_count The number of bytes in the data buffer. + * \param shape Pointer to the tensor shape dimensions. + * \param shape_len The number of tensor shape dimensions. + * \param type The data type. + */ + static Value CreateTensor(const OrtMemoryInfo* info, void* p_data, size_t p_data_byte_count, const int64_t* shape, size_t shape_len, + ONNXTensorElementDataType type); + + /** \brief Creates a tensor using a supplied OrtAllocator. Wraps OrtApi::CreateTensorAsOrtValue. + * \tparam T The numeric datatype. This API is not suitable for strings. + * \param allocator The allocator to use. + * \param shape Pointer to the tensor shape dimensions. + * \param shape_len The number of tensor shape dimensions. + */ + template + static Value CreateTensor(OrtAllocator* allocator, const int64_t* shape, size_t shape_len); + + /** \brief Creates a tensor using a supplied OrtAllocator. Wraps OrtApi::CreateTensorAsOrtValue. + * \param allocator The allocator to use. + * \param shape Pointer to the tensor shape dimensions. + * \param shape_len The number of tensor shape dimensions. + * \param type The data type. + */ + static Value CreateTensor(OrtAllocator* allocator, const int64_t* shape, size_t shape_len, ONNXTensorElementDataType type); + + static Value CreateMap(Value& keys, Value& values); ///< Wraps OrtApi::CreateValue + static Value CreateSequence(std::vector& values); ///< Wraps OrtApi::CreateValue + + template + static Value CreateOpaque(const char* domain, const char* type_name, const T&); ///< Wraps OrtApi::CreateOpaqueValue + +#if !defined(DISABLE_SPARSE_TENSORS) + /// + /// This is a simple forwarding method to the other overload that helps deducing + /// data type enum value from the type of the buffer. + /// + /// numeric datatype. This API is not suitable for strings. + /// Memory description where the user buffers reside (CPU vs GPU etc) + /// pointer to the user supplied buffer, use nullptr for fully sparse tensors + /// a would be dense shape of the tensor + /// non zero values shape. Use a single 0 shape for fully sparse tensors. + /// + template + static Value CreateSparseTensor(const OrtMemoryInfo* info, T* p_data, const Shape& dense_shape, + const Shape& values_shape); + + /// + /// Creates an OrtValue instance containing SparseTensor. This constructs + /// a sparse tensor that makes use of user allocated buffers. It does not make copies + /// of the user provided data and does not modify it. The lifespan of user provided buffers should + /// eclipse the life span of the resulting OrtValue. This call constructs an instance that only contain + /// a pointer to non-zero values. To fully populate the sparse tensor call UseIndices() API below + /// to supply a sparse format specific indices. + /// This API is not suitable for string data. Use CreateSparseTensor() with allocator specified so strings + /// can be properly copied into the allocated buffer. + /// + /// Memory description where the user buffers reside (CPU vs GPU etc) + /// pointer to the user supplied buffer, use nullptr for fully sparse tensors + /// a would be dense shape of the tensor + /// non zero values shape. Use a single 0 shape for fully sparse tensors. + /// data type + /// Ort::Value instance containing SparseTensor + static Value CreateSparseTensor(const OrtMemoryInfo* info, void* p_data, const Shape& dense_shape, + const Shape& values_shape, ONNXTensorElementDataType type); + + /// + /// This is a simple forwarding method to the below CreateSparseTensor. + /// This helps to specify data type enum in terms of C++ data type. + /// Use CreateSparseTensor + /// + /// numeric data type only. String data enum must be specified explicitly. + /// allocator to use + /// a would be dense shape of the tensor + /// Ort::Value + template + static Value CreateSparseTensor(OrtAllocator* allocator, const Shape& dense_shape); + + /// + /// Creates an instance of OrtValue containing sparse tensor. The created instance has no data. + /// The data must be supplied by on of the FillSparseTensor() methods that take both non-zero values + /// and indices. The data will be copied into a buffer that would be allocated using the supplied allocator. + /// Use this API to create OrtValues that contain sparse tensors with all supported data types including + /// strings. + /// + /// allocator to use. The allocator lifespan must eclipse that of the resulting OrtValue + /// a would be dense shape of the tensor + /// data type + /// an instance of Ort::Value + static Value CreateSparseTensor(OrtAllocator* allocator, const Shape& dense_shape, ONNXTensorElementDataType type); + +#endif // !defined(DISABLE_SPARSE_TENSORS) +}; + +/// +/// Represents native memory allocation coming from one of the +/// OrtAllocators registered with OnnxRuntime. +/// Use it to wrap an allocation made by an allocator +/// so it can be automatically released when no longer needed. +/// +struct MemoryAllocation { + MemoryAllocation(OrtAllocator* allocator, void* p, size_t size); + ~MemoryAllocation(); + MemoryAllocation(const MemoryAllocation&) = delete; + MemoryAllocation& operator=(const MemoryAllocation&) = delete; + MemoryAllocation(MemoryAllocation&&) noexcept; + MemoryAllocation& operator=(MemoryAllocation&&) noexcept; + + void* get() { return p_; } + size_t size() const { return size_; } + + private: + OrtAllocator* allocator_; + void* p_; + size_t size_; +}; + +namespace detail { +template +struct AllocatorImpl : Base { + using B = Base; + using B::B; + + void* Alloc(size_t size); + MemoryAllocation GetAllocation(size_t size); + void Free(void* p); + ConstMemoryInfo GetInfo() const; +}; + +} // namespace detail + +/** \brief Wrapper around ::OrtAllocator default instance that is owned by Onnxruntime + * + */ +struct AllocatorWithDefaultOptions : detail::AllocatorImpl> { + explicit AllocatorWithDefaultOptions(std::nullptr_t) {} ///< Convenience to create a class member and then replace with an instance + AllocatorWithDefaultOptions(); +}; + +/** \brief Wrapper around ::OrtAllocator + * + */ +struct Allocator : detail::AllocatorImpl { + explicit Allocator(std::nullptr_t) {} ///< Convenience to create a class member and then replace with an instance + Allocator(const Session& session, const OrtMemoryInfo*); +}; + +using UnownedAllocator = detail::AllocatorImpl>; + +namespace detail { +namespace binding_utils { +// Bring these out of template +std::vector GetOutputNamesHelper(const OrtIoBinding* binding, OrtAllocator*); +std::vector GetOutputValuesHelper(const OrtIoBinding* binding, OrtAllocator*); +} // namespace binding_utils + +template +struct ConstIoBindingImpl : Base { + using B = Base; + using B::B; + + std::vector GetOutputNames() const; + std::vector GetOutputNames(OrtAllocator*) const; + std::vector GetOutputValues() const; + std::vector GetOutputValues(OrtAllocator*) const; +}; + +template +struct IoBindingImpl : ConstIoBindingImpl { + using B = ConstIoBindingImpl; + using B::B; + + void BindInput(const char* name, const Value&); + void BindOutput(const char* name, const Value&); + void BindOutput(const char* name, const OrtMemoryInfo*); + void ClearBoundInputs(); + void ClearBoundOutputs(); + void SynchronizeInputs(); + void SynchronizeOutputs(); +}; + +} // namespace detail + +using ConstIoBinding = detail::ConstIoBindingImpl>; +using UnownedIoBinding = detail::IoBindingImpl>; + +/** \brief Wrapper around ::OrtIoBinding + * + */ +struct IoBinding : detail::IoBindingImpl { + explicit IoBinding(std::nullptr_t) {} ///< Create an empty object for convenience. Sometimes, we want to initialize members later. + explicit IoBinding(Session& session); + ConstIoBinding GetConst() const { return ConstIoBinding{this->p_}; } + UnownedIoBinding GetUnowned() const { return UnownedIoBinding{this->p_}; } +}; + +/*! \struct Ort::ArenaCfg + * \brief it is a structure that represents the configuration of an arena based allocator + * \details Please see docs/C_API.md for details + */ +struct ArenaCfg : detail::Base { + explicit ArenaCfg(std::nullptr_t) {} ///< Create an empty ArenaCfg object, must be assigned a valid one to be used + /** + * Wraps OrtApi::CreateArenaCfg + * \param max_mem - use 0 to allow ORT to choose the default + * \param arena_extend_strategy - use -1 to allow ORT to choose the default, 0 = kNextPowerOfTwo, 1 = kSameAsRequested + * \param initial_chunk_size_bytes - use -1 to allow ORT to choose the default + * \param max_dead_bytes_per_chunk - use -1 to allow ORT to choose the default + * See docs/C_API.md for details on what the following parameters mean and how to choose these values + */ + ArenaCfg(size_t max_mem, int arena_extend_strategy, int initial_chunk_size_bytes, int max_dead_bytes_per_chunk); +}; + +// +// Custom OPs (only needed to implement custom OPs) +// + +/// +/// This struct provides life time management for custom op attribute +/// +struct OpAttr : detail::Base { + OpAttr(const char* name, const void* data, int len, OrtOpAttrType type); +}; + +/** + * Macro that logs a message using the provided logger. Throws an exception if OrtApi::Logger_LogMessage fails. + * Example: ORT_CXX_LOG(logger, ORT_LOGGING_LEVEL_INFO, "Log a message"); + * + * \param logger The Ort::Logger instance to use. Must be a value or reference. + * \param message_severity The logging severity level of the message. + * \param message A null-terminated UTF-8 message to log. + */ +#define ORT_CXX_LOG(logger, message_severity, message) \ + do { \ + if (message_severity >= logger.GetLoggingSeverityLevel()) { \ + Ort::ThrowOnError(logger.LogMessage(message_severity, ORT_FILE, __LINE__, \ + static_cast(__FUNCTION__), message)); \ + } \ + } while (false) + +/** + * Macro that logs a message using the provided logger. Can be used in noexcept code since errors are silently ignored. + * Example: ORT_CXX_LOG_NOEXCEPT(logger, ORT_LOGGING_LEVEL_INFO, "Log a message"); + * + * \param logger The Ort::Logger instance to use. Must be a value or reference. + * \param message_severity The logging severity level of the message. + * \param message A null-terminated UTF-8 message to log. + */ +#define ORT_CXX_LOG_NOEXCEPT(logger, message_severity, message) \ + do { \ + if (message_severity >= logger.GetLoggingSeverityLevel()) { \ + static_cast(logger.LogMessage(message_severity, ORT_FILE, __LINE__, \ + static_cast(__FUNCTION__), message)); \ + } \ + } while (false) + +/** + * Macro that logs a printf-like formatted message using the provided logger. Throws an exception if + * OrtApi::Logger_LogMessage fails or if a formatting error occurs. + * Example: ORT_CXX_LOGF(logger, ORT_LOGGING_LEVEL_INFO, "Log an int: %d", 12); + * + * \param logger The Ort::Logger instance to use. Must be a value or reference. + * \param message_severity The logging severity level of the message. + * \param format A null-terminated UTF-8 format string forwarded to a printf-like function. + * Refer to https://en.cppreference.com/w/cpp/io/c/fprintf for information on valid formats. + * \param ... Zero or more variadic arguments referenced by the format string. + */ +#define ORT_CXX_LOGF(logger, message_severity, /*format,*/...) \ + do { \ + if (message_severity >= logger.GetLoggingSeverityLevel()) { \ + Ort::ThrowOnError(logger.LogFormattedMessage(message_severity, ORT_FILE, __LINE__, \ + static_cast(__FUNCTION__), __VA_ARGS__)); \ + } \ + } while (false) + +/** + * Macro that logs a printf-like formatted message using the provided logger. Can be used in noexcept code since errors + * are silently ignored. + * Example: ORT_CXX_LOGF_NOEXCEPT(logger, ORT_LOGGING_LEVEL_INFO, "Log an int: %d", 12); + * + * \param logger The Ort::Logger instance to use. Must be a value or reference. + * \param message_severity The logging severity level of the message. + * \param format A null-terminated UTF-8 format string forwarded to a printf-like function. + * Refer to https://en.cppreference.com/w/cpp/io/c/fprintf for information on valid formats. + * \param ... Zero or more variadic arguments referenced by the format string. + */ +#define ORT_CXX_LOGF_NOEXCEPT(logger, message_severity, /*format,*/...) \ + do { \ + if (message_severity >= logger.GetLoggingSeverityLevel()) { \ + static_cast(logger.LogFormattedMessage(message_severity, ORT_FILE, __LINE__, \ + static_cast(__FUNCTION__), __VA_ARGS__)); \ + } \ + } while (false) + +/// +/// This class represents an ONNX Runtime logger that can be used to log information with an +/// associated severity level and source code location (file path, line number, function name). +/// +/// A Logger can be obtained from within custom operators by calling Ort::KernelInfo::GetLogger(). +/// Instances of Ort::Logger are the size of two pointers and can be passed by value. +/// +/// Use the ORT_CXX_LOG macros to ensure the source code location is set properly from the callsite +/// and to take advantage of a cached logging severity level that can bypass calls to the underlying C API. +/// +struct Logger { + /** + * Creates an empty Ort::Logger. Must be initialized from a valid Ort::Logger before use. + */ + Logger() = default; + + /** + * Creates an empty Ort::Logger. Must be initialized from a valid Ort::Logger before use. + */ + explicit Logger(std::nullptr_t) {} + + /** + * Creates a logger from an ::OrtLogger instance. Caches the logger's current severity level by calling + * OrtApi::Logger_GetLoggingSeverityLevel. Throws an exception if OrtApi::Logger_GetLoggingSeverityLevel fails. + * + * \param logger The ::OrtLogger to wrap. + */ + explicit Logger(const OrtLogger* logger); + + ~Logger() = default; + + Logger(const Logger&) = default; + Logger& operator=(const Logger&) = default; + + Logger(Logger&& v) noexcept = default; + Logger& operator=(Logger&& v) noexcept = default; + + /** + * Returns the logger's current severity level from the cached member. + * + * \return The current ::OrtLoggingLevel. + */ + OrtLoggingLevel GetLoggingSeverityLevel() const noexcept; + + /** + * Logs the provided message via OrtApi::Logger_LogMessage. Use the ORT_CXX_LOG or ORT_CXX_LOG_NOEXCEPT + * macros to properly set the source code location and to use the cached severity level to potentially bypass + * calls to the underlying C API. + * + * \param log_severity_level The message's logging severity level. + * \param file_path The filepath of the file in which the message is logged. Usually the value of ORT_FILE. + * \param line_number The file line number in which the message is logged. Usually the value of __LINE__. + * \param func_name The name of the function in which the message is logged. Usually the value of __FUNCTION__. + * \param message The message to log. + * \return A Ort::Status value to indicate error or success. + */ + Status LogMessage(OrtLoggingLevel log_severity_level, const ORTCHAR_T* file_path, int line_number, + const char* func_name, const char* message) const noexcept; + + /** + * Logs a printf-like formatted message via OrtApi::Logger_LogMessage. Use the ORT_CXX_LOGF or ORT_CXX_LOGF_NOEXCEPT + * macros to properly set the source code location and to use the cached severity level to potentially bypass + * calls to the underlying C API. Returns an error status if a formatting error occurs. + * + * \param log_severity_level The message's logging severity level. + * \param file_path The filepath of the file in which the message is logged. Usually the value of ORT_FILE. + * \param line_number The file line number in which the message is logged. Usually the value of __LINE__. + * \param func_name The name of the function in which the message is logged. Usually the value of __FUNCTION__. + * \param format A null-terminated UTF-8 format string forwarded to a printf-like function. + * Refer to https://en.cppreference.com/w/cpp/io/c/fprintf for information on valid formats. + * \param args Zero or more variadic arguments referenced by the format string. + * \return A Ort::Status value to indicate error or success. + */ + template + Status LogFormattedMessage(OrtLoggingLevel log_severity_level, const ORTCHAR_T* file_path, int line_number, + const char* func_name, const char* format, Args&&... args) const noexcept; + + private: + const OrtLogger* logger_{}; + OrtLoggingLevel cached_severity_level_{}; +}; + +/// +/// This class wraps a raw pointer OrtKernelContext* that is being passed +/// to the custom kernel Compute() method. Use it to safely access context +/// attributes, input and output parameters with exception safety guarantees. +/// See usage example in onnxruntime/test/testdata/custom_op_library/custom_op_library.cc +/// +struct KernelContext { + explicit KernelContext(OrtKernelContext* context); + size_t GetInputCount() const; + size_t GetOutputCount() const; + ConstValue GetInput(size_t index) const; + UnownedValue GetOutput(size_t index, const int64_t* dim_values, size_t dim_count) const; + UnownedValue GetOutput(size_t index, const std::vector& dims) const; + void* GetGPUComputeStream() const; + Logger GetLogger() const; + OrtAllocator* GetAllocator(const OrtMemoryInfo& memory_info) const; + + private: + OrtKernelContext* ctx_; +}; + +struct KernelInfo; + +namespace detail { +namespace attr_utils { +void GetAttr(const OrtKernelInfo* p, const char* name, float&); +void GetAttr(const OrtKernelInfo* p, const char* name, int64_t&); +void GetAttr(const OrtKernelInfo* p, const char* name, std::string&); +void GetAttrs(const OrtKernelInfo* p, const char* name, std::vector&); +void GetAttrs(const OrtKernelInfo* p, const char* name, std::vector&); +} // namespace attr_utils + +template +struct KernelInfoImpl : Base { + using B = Base; + using B::B; + + KernelInfo Copy() const; + + template // R is only implemented for float, int64_t, and string + R GetAttribute(const char* name) const { + R val; + attr_utils::GetAttr(this->p_, name, val); + return val; + } + + template // R is only implemented for std::vector, std::vector + std::vector GetAttributes(const char* name) const { + std::vector result; + attr_utils::GetAttrs(this->p_, name, result); + return result; + } + + Value GetTensorAttribute(const char* name, OrtAllocator* allocator) const; + + size_t GetInputCount() const; + size_t GetOutputCount() const; + + std::string GetInputName(size_t index) const; + std::string GetOutputName(size_t index) const; + + TypeInfo GetInputTypeInfo(size_t index) const; + TypeInfo GetOutputTypeInfo(size_t index) const; + + ConstValue GetTensorConstantInput(size_t index, int* is_constant) const; + + std::string GetNodeName() const; + Logger GetLogger() const; +}; + +} // namespace detail + +using ConstKernelInfo = detail::KernelInfoImpl>; + +/// +/// This struct owns the OrtKernInfo* pointer when a copy is made. +/// For convenient wrapping of OrtKernelInfo* passed to kernel constructor +/// and query attributes, warp the pointer with Ort::Unowned instance +/// so it does not destroy the pointer the kernel does not own. +/// +struct KernelInfo : detail::KernelInfoImpl { + explicit KernelInfo(std::nullptr_t) {} ///< Create an empty instance to initialize later + explicit KernelInfo(OrtKernelInfo* info); ///< Take ownership of the instance + ConstKernelInfo GetConst() const { return ConstKernelInfo{this->p_}; } +}; + +/// +/// Create and own custom defined operation. +/// +struct Op : detail::Base { + explicit Op(std::nullptr_t) {} ///< Create an empty Operator object, must be assigned a valid one to be used + + explicit Op(OrtOp*); ///< Take ownership of the OrtOp + + static Op Create(const OrtKernelInfo* info, const char* op_name, const char* domain, + int version, const char** type_constraint_names, + const ONNXTensorElementDataType* type_constraint_values, + size_t type_constraint_count, + const OpAttr* attr_values, + size_t attr_count, + size_t input_count, size_t output_count); + + void Invoke(const OrtKernelContext* context, + const Value* input_values, + size_t input_count, + Value* output_values, + size_t output_count); + + // For easier refactoring + void Invoke(const OrtKernelContext* context, + const OrtValue* const* input_values, + size_t input_count, + OrtValue* const* output_values, + size_t output_count); +}; + +/// +/// This entire structure is deprecated, but we not marking +/// it as a whole yet since we want to preserve for the next release. +/// +struct CustomOpApi { + CustomOpApi(const OrtApi& api) : api_(api) {} + + /** \deprecated use Ort::Value::GetTensorTypeAndShape() + * [[deprecated]] + * This interface produces a pointer that must be released. Not exception safe. + */ + [[deprecated("use Ort::Value::GetTensorTypeAndShape()")]] OrtTensorTypeAndShapeInfo* GetTensorTypeAndShape(_In_ const OrtValue* value); + + /** \deprecated use Ort::TensorTypeAndShapeInfo::GetElementCount() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::TensorTypeAndShapeInfo::GetElementCount()")]] size_t GetTensorShapeElementCount(_In_ const OrtTensorTypeAndShapeInfo* info); + + /** \deprecated use Ort::TensorTypeAndShapeInfo::GetElementType() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::TensorTypeAndShapeInfo::GetElementType()")]] ONNXTensorElementDataType GetTensorElementType(const OrtTensorTypeAndShapeInfo* info); + + /** \deprecated use Ort::TensorTypeAndShapeInfo::GetDimensionsCount() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::TensorTypeAndShapeInfo::GetDimensionsCount()")]] size_t GetDimensionsCount(_In_ const OrtTensorTypeAndShapeInfo* info); + + /** \deprecated use Ort::TensorTypeAndShapeInfo::GetShape() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::TensorTypeAndShapeInfo::GetShape()")]] void GetDimensions(_In_ const OrtTensorTypeAndShapeInfo* info, _Out_ int64_t* dim_values, size_t dim_values_length); + + /** \deprecated + * [[deprecated]] + * This interface sets dimensions to TensorTypeAndShapeInfo, but has no effect on the OrtValue. + */ + [[deprecated("Do not use")]] void SetDimensions(OrtTensorTypeAndShapeInfo* info, _In_ const int64_t* dim_values, size_t dim_count); + + /** \deprecated use Ort::Value::GetTensorMutableData() + * [[deprecated]] + * This interface is redundant. + */ + template + [[deprecated("use Ort::Value::GetTensorMutableData()")]] T* GetTensorMutableData(_Inout_ OrtValue* value); + + /** \deprecated use Ort::Value::GetTensorData() + * [[deprecated]] + * This interface is redundant. + */ + template + [[deprecated("use Ort::Value::GetTensorData()")]] const T* GetTensorData(_Inout_ const OrtValue* value); + + /** \deprecated use Ort::Value::GetTensorMemoryInfo() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::Value::GetTensorMemoryInfo()")]] const OrtMemoryInfo* GetTensorMemoryInfo(_In_ const OrtValue* value); + + /** \deprecated use Ort::TensorTypeAndShapeInfo::GetShape() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::TensorTypeAndShapeInfo::GetShape()")]] std::vector GetTensorShape(const OrtTensorTypeAndShapeInfo* info); + + /** \deprecated use TensorTypeAndShapeInfo instances for automatic ownership. + * [[deprecated]] + * This interface is not exception safe. + */ + [[deprecated("use TensorTypeAndShapeInfo")]] void ReleaseTensorTypeAndShapeInfo(OrtTensorTypeAndShapeInfo* input); + + /** \deprecated use Ort::KernelContext::GetInputCount + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::KernelContext::GetInputCount")]] size_t KernelContext_GetInputCount(const OrtKernelContext* context); + + /** \deprecated use Ort::KernelContext::GetInput + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::KernelContext::GetInput")]] const OrtValue* KernelContext_GetInput(const OrtKernelContext* context, _In_ size_t index); + + /** \deprecated use Ort::KernelContext::GetOutputCount + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::KernelContext::GetOutputCount")]] size_t KernelContext_GetOutputCount(const OrtKernelContext* context); + + /** \deprecated use Ort::KernelContext::GetOutput + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::KernelContext::GetOutput")]] OrtValue* KernelContext_GetOutput(OrtKernelContext* context, _In_ size_t index, _In_ const int64_t* dim_values, size_t dim_count); + + /** \deprecated use Ort::KernelContext::GetGPUComputeStream + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::KernelContext::GetGPUComputeStream")]] void* KernelContext_GetGPUComputeStream(const OrtKernelContext* context); + + /** \deprecated use Ort::ThrowOnError() + * [[deprecated]] + * This interface is redundant. + */ + [[deprecated("use Ort::ThrowOnError()")]] void ThrowOnError(OrtStatus* result); + + /** \deprecated use Ort::OpAttr + * [[deprecated]] + * This interface is not exception safe. + */ + [[deprecated("use Ort::OpAttr")]] OrtOpAttr* CreateOpAttr(_In_ const char* name, + _In_ const void* data, + _In_ int len, + _In_ OrtOpAttrType type); + + /** \deprecated use Ort::OpAttr + * [[deprecated]] + * This interface is not exception safe. + */ + [[deprecated("use Ort::OpAttr")]] void ReleaseOpAttr(_Frees_ptr_opt_ OrtOpAttr* op_attr); + + /** \deprecated use Ort::Op + * [[deprecated]] + * This interface is not exception safe. + */ + [[deprecated("use Ort::Op")]] OrtOp* CreateOp(_In_ const OrtKernelInfo* info, + _In_z_ const char* op_name, + _In_z_ const char* domain, + int version, + _In_reads_(type_constraint_count) const char** type_constraint_names, + _In_reads_(type_constraint_count) const ONNXTensorElementDataType* type_constraint_values, + int type_constraint_count, + _In_reads_(attr_count) const OrtOpAttr* const* attr_values, + int attr_count, + int input_count, + int output_count); + + /** \deprecated use Ort::Op::Invoke + * [[deprecated]] + * This interface is redundant + */ + [[deprecated("use Ort::Op::Invoke")]] void InvokeOp(_In_ const OrtKernelContext* context, + _In_ const OrtOp* ort_op, + _In_ const OrtValue* const* input_values, + _In_ int input_count, + _Inout_ OrtValue* const* output_values, + _In_ int output_count); + + /** \deprecated use Ort::Op for automatic lifespan management. + * [[deprecated]] + * This interface is not exception safe. + */ + [[deprecated("use Ort::Op")]] void ReleaseOp(_Frees_ptr_opt_ OrtOp* ort_op); + + /** \deprecated use Ort::KernelInfo for automatic lifespan management or for + * querying attributes + * [[deprecated]] + * This interface is redundant + */ + template // T is only implemented for std::vector, std::vector, float, int64_t, and string + [[deprecated("use Ort::KernelInfo::GetAttribute")]] T KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name); + + /** \deprecated use Ort::KernelInfo::Copy + * querying attributes + * [[deprecated]] + * This interface is not exception safe + */ + [[deprecated("use Ort::KernelInfo::Copy")]] OrtKernelInfo* CopyKernelInfo(_In_ const OrtKernelInfo* info); + + /** \deprecated use Ort::KernelInfo for lifespan management + * querying attributes + * [[deprecated]] + * This interface is not exception safe + */ + [[deprecated("use Ort::KernelInfo")]] void ReleaseKernelInfo(_Frees_ptr_opt_ OrtKernelInfo* info_copy); + + private: + const OrtApi& api_; +}; + +template +struct CustomOpBase : OrtCustomOp { + CustomOpBase() { + OrtCustomOp::version = ORT_API_VERSION; + OrtCustomOp::CreateKernel = [](const OrtCustomOp* this_, const OrtApi* api, const OrtKernelInfo* info) { return static_cast(this_)->CreateKernel(*api, info); }; + OrtCustomOp::GetName = [](const OrtCustomOp* this_) { return static_cast(this_)->GetName(); }; + + OrtCustomOp::GetExecutionProviderType = [](const OrtCustomOp* this_) { return static_cast(this_)->GetExecutionProviderType(); }; + + OrtCustomOp::GetInputTypeCount = [](const OrtCustomOp* this_) { return static_cast(this_)->GetInputTypeCount(); }; + OrtCustomOp::GetInputType = [](const OrtCustomOp* this_, size_t index) { return static_cast(this_)->GetInputType(index); }; + OrtCustomOp::GetInputMemoryType = [](const OrtCustomOp* this_, size_t index) { return static_cast(this_)->GetInputMemoryType(index); }; + + OrtCustomOp::GetOutputTypeCount = [](const OrtCustomOp* this_) { return static_cast(this_)->GetOutputTypeCount(); }; + OrtCustomOp::GetOutputType = [](const OrtCustomOp* this_, size_t index) { return static_cast(this_)->GetOutputType(index); }; + + OrtCustomOp::KernelCompute = [](void* op_kernel, OrtKernelContext* context) { static_cast(op_kernel)->Compute(context); }; +#if defined(_MSC_VER) && !defined(__clang__) +#pragma warning(push) +#pragma warning(disable : 26409) +#endif + OrtCustomOp::KernelDestroy = [](void* op_kernel) { delete static_cast(op_kernel); }; +#if defined(_MSC_VER) && !defined(__clang__) +#pragma warning(pop) +#endif + OrtCustomOp::GetInputCharacteristic = [](const OrtCustomOp* this_, size_t index) { return static_cast(this_)->GetInputCharacteristic(index); }; + OrtCustomOp::GetOutputCharacteristic = [](const OrtCustomOp* this_, size_t index) { return static_cast(this_)->GetOutputCharacteristic(index); }; + + OrtCustomOp::GetVariadicInputMinArity = [](const OrtCustomOp* this_) { return static_cast(this_)->GetVariadicInputMinArity(); }; + OrtCustomOp::GetVariadicInputHomogeneity = [](const OrtCustomOp* this_) { return static_cast(static_cast(this_)->GetVariadicInputHomogeneity()); }; + OrtCustomOp::GetVariadicOutputMinArity = [](const OrtCustomOp* this_) { return static_cast(this_)->GetVariadicOutputMinArity(); }; + OrtCustomOp::GetVariadicOutputHomogeneity = [](const OrtCustomOp* this_) { return static_cast(static_cast(this_)->GetVariadicOutputHomogeneity()); }; + } + + // Default implementation of GetExecutionProviderType that returns nullptr to default to the CPU provider + const char* GetExecutionProviderType() const { return nullptr; } + + // Default implementations of GetInputCharacteristic() and GetOutputCharacteristic() below + // (inputs and outputs are required by default) + OrtCustomOpInputOutputCharacteristic GetInputCharacteristic(size_t /*index*/) const { + return OrtCustomOpInputOutputCharacteristic::INPUT_OUTPUT_REQUIRED; + } + + OrtCustomOpInputOutputCharacteristic GetOutputCharacteristic(size_t /*index*/) const { + return OrtCustomOpInputOutputCharacteristic::INPUT_OUTPUT_REQUIRED; + } + + // Default implemention of GetInputMemoryType() that returns OrtMemTypeDefault + OrtMemType GetInputMemoryType(size_t /*index*/) const { + return OrtMemTypeDefault; + } + + // Default implementation of GetVariadicInputMinArity() returns 1 to specify that a variadic input + // should expect at least 1 argument. + int GetVariadicInputMinArity() const { + return 1; + } + + // Default implementation of GetVariadicInputHomegeneity() returns true to specify that all arguments + // to a variadic input should be of the same type. + bool GetVariadicInputHomogeneity() const { + return true; + } + + // Default implementation of GetVariadicOutputMinArity() returns 1 to specify that a variadic output + // should produce at least 1 output value. + int GetVariadicOutputMinArity() const { + return 1; + } + + // Default implementation of GetVariadicOutputHomegeneity() returns true to specify that all output values + // produced by a variadic output should be of the same type. + bool GetVariadicOutputHomogeneity() const { + return true; + } + + // Declare list of session config entries used by this Custom Op. + // Implement this function in order to get configs from CustomOpBase::GetSessionConfigs(). + // This default implementation returns an empty vector of config entries. + std::vector GetSessionConfigKeys() const { + return std::vector{}; + } + + protected: + // Helper function that returns a map of session config entries specified by CustomOpBase::GetSessionConfigKeys. + void GetSessionConfigs(std::unordered_map& out, ConstSessionOptions options) const; +}; + +} // namespace Ort + +#include "onnxruntime_cxx_inline.h" diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_inline.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_inline.h new file mode 100644 index 0000000..b72bcd3 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_cxx_inline.h @@ -0,0 +1,2035 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +// Do not include this file directly. Please include "onnxruntime_cxx_api.h" instead. +// If interested in trying out features of the new experimental C++ API, include "experimental_onnxruntime_cxx_api.h" instead. +// +// These are the inline implementations of the C++ header APIs. They're in this separate file as to not clutter +// the main C++ file with implementation details. + +namespace Ort { + +namespace detail { +inline void ThrowStatus(const Status& st) { + std::string error_message = st.GetErrorMessage(); + OrtErrorCode error_code = st.GetErrorCode(); + ORT_CXX_API_THROW(std::move(error_message), error_code); +} +} // namespace detail + +inline void ThrowOnError(OrtStatus* ort_status) { + if (ort_status) { + Ort::Status st(ort_status); + detail::ThrowStatus(st); + } +} + +inline void ThrowOnError(const Status& st) { + if (st) { + detail::ThrowStatus(st); + } +} + +inline Status::Status(OrtStatus* status) noexcept : Base{status} { +} + +inline Status::Status(const std::exception& e) noexcept { + p_ = GetApi().CreateStatus(ORT_FAIL, e.what()); +} + +inline Status::Status(const Exception& e) noexcept { + p_ = GetApi().CreateStatus(e.GetOrtErrorCode(), e.what()); +} + +inline Status::Status(const char* message, OrtErrorCode code) noexcept { + p_ = GetApi().CreateStatus(code, message); +} + +inline std::string Status::GetErrorMessage() const { + std::string message(GetApi().GetErrorMessage(p_)); + return message; +} + +inline OrtErrorCode Status::GetErrorCode() const { + return GetApi().GetErrorCode(p_); +} + +inline bool Status::IsOK() const noexcept { + return (p_ == nullptr); +} + +// This template converts a C++ type into it's ONNXTensorElementDataType +template +struct TypeToTensorType; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_FLOAT16; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_BFLOAT16; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_DOUBLE; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_INT8; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_INT16; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_INT32; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_INT64; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT8; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT16; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT32; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_UINT64; +}; +template <> +struct TypeToTensorType { + static constexpr ONNXTensorElementDataType type = ONNX_TENSOR_ELEMENT_DATA_TYPE_BOOL; +}; + +inline MemoryAllocation::MemoryAllocation(OrtAllocator* allocator, void* p, size_t size) + : allocator_(allocator), p_(p), size_(size) { +} + +inline MemoryAllocation::~MemoryAllocation() { + if (p_ != nullptr) { + // We do not throw out of destructor + auto ret = GetApi().AllocatorFree(allocator_, p_); + static_cast(ret); + } +} + +inline MemoryAllocation::MemoryAllocation(MemoryAllocation&& o) noexcept : allocator_(nullptr), p_(nullptr), size_(0) { + *this = std::move(o); +} + +inline MemoryAllocation& MemoryAllocation::operator=(MemoryAllocation&& o) noexcept { + OrtAllocator* alloc = nullptr; + void* p = nullptr; + size_t sz = 0; + + // Swap out this + std::swap(alloc, allocator_); + std::swap(p, p_); + std::swap(sz, size_); + + // Swap with incoming + std::swap(allocator_, o.allocator_); + std::swap(p_, o.p_); + std::swap(size_, o.size_); + + // Destroy this instance if needed + MemoryAllocation this_alloc(alloc, p, sz); + return *this; +} + +namespace detail { + +template +inline void* AllocatorImpl::Alloc(size_t size) { + void* out; + ThrowOnError(GetApi().AllocatorAlloc(this->p_, size, &out)); + return out; +} + +template +inline MemoryAllocation AllocatorImpl::GetAllocation(size_t size) { + void* out; + ThrowOnError(GetApi().AllocatorAlloc(this->p_, size, &out)); + MemoryAllocation result(this->p_, out, size); + return result; +} + +template +inline void AllocatorImpl::Free(void* p) { + ThrowOnError(GetApi().AllocatorFree(this->p_, p)); +} + +template +inline ConstMemoryInfo AllocatorImpl::GetInfo() const { + const OrtMemoryInfo* out; + ThrowOnError(GetApi().AllocatorGetInfo(this->p_, &out)); + return ConstMemoryInfo{out}; +} + +} // namespace detail + +inline AllocatorWithDefaultOptions::AllocatorWithDefaultOptions() { + ThrowOnError(GetApi().GetAllocatorWithDefaultOptions(&this->p_)); +} + +inline Allocator::Allocator(const Session& sess, const OrtMemoryInfo* mem_info) { + ThrowOnError(GetApi().CreateAllocator(sess, mem_info, &this->p_)); +} + +namespace detail { + +template +inline std::string MemoryInfoImpl::GetAllocatorName() const { + const char* name = nullptr; + ThrowOnError(GetApi().MemoryInfoGetName(this->p_, &name)); + return std::string(name); +} + +template +inline OrtAllocatorType MemoryInfoImpl::GetAllocatorType() const { + OrtAllocatorType type; + ThrowOnError(GetApi().MemoryInfoGetType(this->p_, &type)); + return type; +} + +template +inline int MemoryInfoImpl::GetDeviceId() const { + int id = 0; + ThrowOnError(GetApi().MemoryInfoGetId(this->p_, &id)); + return id; +} + +template +inline OrtMemoryInfoDeviceType MemoryInfoImpl::GetDeviceType() const { + OrtMemoryInfoDeviceType type; + GetApi().MemoryInfoGetDeviceType(this->p_, &type); + return type; +} + +template +inline OrtMemType MemoryInfoImpl::GetMemoryType() const { + OrtMemType type; + ThrowOnError(GetApi().MemoryInfoGetMemType(this->p_, &type)); + return type; +} + +template +template +inline bool MemoryInfoImpl::operator==(const MemoryInfoImpl& o) const { + int comp_result = 0; + ThrowOnError(Ort::GetApi().CompareMemoryInfo(this->p_, o, &comp_result)); + return comp_result == 0; +} + +} // namespace detail + +inline MemoryInfo MemoryInfo::CreateCpu(OrtAllocatorType type, OrtMemType mem_type) { + OrtMemoryInfo* p; + ThrowOnError(GetApi().CreateCpuMemoryInfo(type, mem_type, &p)); + return MemoryInfo(p); +} + +inline MemoryInfo::MemoryInfo(const char* name, OrtAllocatorType type, int id, OrtMemType mem_type) { + ThrowOnError(GetApi().CreateMemoryInfo(name, type, id, mem_type, &this->p_)); +} + +namespace detail { +template +inline std::vector ConstIoBindingImpl::GetOutputNames() const { + AllocatorWithDefaultOptions allocator; + return binding_utils::GetOutputNamesHelper(this->p_, allocator); +} + +template +inline std::vector ConstIoBindingImpl::GetOutputNames(OrtAllocator* allocator) const { + return binding_utils::GetOutputNamesHelper(this->p_, allocator); +} + +template +inline std::vector ConstIoBindingImpl::GetOutputValues() const { + AllocatorWithDefaultOptions allocator; + return binding_utils::GetOutputValuesHelper(this->p_, allocator); +} + +template +inline std::vector ConstIoBindingImpl::GetOutputValues(OrtAllocator* allocator) const { + return binding_utils::GetOutputValuesHelper(this->p_, allocator); +} + +template +inline void IoBindingImpl::BindInput(const char* name, const Value& value) { + ThrowOnError(GetApi().BindInput(this->p_, name, value)); +} + +template +inline void IoBindingImpl::BindOutput(const char* name, const Value& value) { + ThrowOnError(GetApi().BindOutput(this->p_, name, value)); +} + +template +inline void IoBindingImpl::BindOutput(const char* name, const OrtMemoryInfo* mem_info) { + ThrowOnError(GetApi().BindOutputToDevice(this->p_, name, mem_info)); +} + +template +inline void IoBindingImpl::ClearBoundInputs() { + GetApi().ClearBoundInputs(this->p_); +} + +template +inline void IoBindingImpl::ClearBoundOutputs() { + GetApi().ClearBoundOutputs(this->p_); +} + +template +inline void IoBindingImpl::SynchronizeInputs() { + ThrowOnError(GetApi().SynchronizeBoundInputs(this->p_)); +} + +template +inline void IoBindingImpl::SynchronizeOutputs() { + ThrowOnError(GetApi().SynchronizeBoundOutputs(this->p_)); +} + +namespace binding_utils { +inline std::vector GetOutputNamesHelper(const OrtIoBinding* binding, OrtAllocator* allocator) { + std::vector result; + auto free_fn = detail::AllocatedFree(allocator); + using Ptr = std::unique_ptr; + + char* buffer = nullptr; + size_t* lengths = nullptr; + size_t count = 0; + ThrowOnError(GetApi().GetBoundOutputNames(binding, allocator, &buffer, &lengths, &count)); + + if (count == 0) { + return result; + } + + Ptr buffer_g(buffer, free_fn); + Ptr lengths_g(lengths, free_fn); + + result.reserve(count); + for (size_t i = 0; i < count; ++i) { + auto sz = *lengths; + result.emplace_back(buffer, sz); + buffer += sz; + ++lengths; + } + return result; +} + +inline std::vector GetOutputValuesHelper(const OrtIoBinding* binding, OrtAllocator* allocator) { + std::vector result; + size_t owned = 0; + size_t output_count = 0; + // Lambda to release the buffer when no longer needed and + // make sure that we destroy all instances on exception + auto free_fn = [&owned, &output_count, allocator](OrtValue** buffer) { + if (buffer) { + while (owned < output_count) { + auto* p = buffer + owned++; + GetApi().ReleaseValue(*p); + } + allocator->Free(allocator, buffer); + } + }; + using Ptr = std::unique_ptr; + + OrtValue** output_buffer = nullptr; + ThrowOnError(GetApi().GetBoundOutputValues(binding, allocator, &output_buffer, &output_count)); + if (output_count == 0) { + return result; + } + + Ptr buffer_g(output_buffer, free_fn); + + result.reserve(output_count); + for (size_t i = 0; i < output_count; ++i) { + result.emplace_back(output_buffer[i]); + ++owned; + } + return result; +} + +} // namespace binding_utils +} // namespace detail + +inline IoBinding::IoBinding(Session& session) { + ThrowOnError(GetApi().CreateIoBinding(session, &this->p_)); +} + +inline ArenaCfg::ArenaCfg(size_t max_mem, int arena_extend_strategy, int initial_chunk_size_bytes, int max_dead_bytes_per_chunk) { + ThrowOnError(GetApi().CreateArenaCfg(max_mem, arena_extend_strategy, initial_chunk_size_bytes, max_dead_bytes_per_chunk, &p_)); +} + +inline ThreadingOptions::ThreadingOptions() { + ThrowOnError(GetApi().CreateThreadingOptions(&p_)); +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalIntraOpNumThreads(int intra_op_num_threads) { + ThrowOnError(GetApi().SetGlobalIntraOpNumThreads(p_, intra_op_num_threads)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalInterOpNumThreads(int inter_op_num_threads) { + ThrowOnError(GetApi().SetGlobalInterOpNumThreads(p_, inter_op_num_threads)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalSpinControl(int allow_spinning) { + ThrowOnError(GetApi().SetGlobalSpinControl(p_, allow_spinning)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalDenormalAsZero() { + ThrowOnError(GetApi().SetGlobalDenormalAsZero(p_)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalCustomCreateThreadFn(OrtCustomCreateThreadFn ort_custom_create_thread_fn) { + ThrowOnError(GetApi().SetGlobalCustomCreateThreadFn(p_, ort_custom_create_thread_fn)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalCustomThreadCreationOptions(void* ort_custom_thread_creation_options) { + ThrowOnError(GetApi().SetGlobalCustomThreadCreationOptions(p_, ort_custom_thread_creation_options)); + return *this; +} + +inline ThreadingOptions& ThreadingOptions::SetGlobalCustomJoinThreadFn(OrtCustomJoinThreadFn ort_custom_join_thread_fn) { + ThrowOnError(GetApi().SetGlobalCustomJoinThreadFn(p_, ort_custom_join_thread_fn)); + return *this; +} + +inline Env::Env(OrtLoggingLevel logging_level, _In_ const char* logid) { + ThrowOnError(GetApi().CreateEnv(logging_level, logid, &p_)); + if (strcmp(logid, "onnxruntime-node") == 0) { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_NODEJS)); + } else { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_CPLUSPLUS)); + } +} + +inline Env::Env(OrtLoggingLevel logging_level, const char* logid, OrtLoggingFunction logging_function, void* logger_param) { + ThrowOnError(GetApi().CreateEnvWithCustomLogger(logging_function, logger_param, logging_level, logid, &p_)); + if (strcmp(logid, "onnxruntime-node") == 0) { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_NODEJS)); + } else { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_CPLUSPLUS)); + } +} + +inline Env::Env(const OrtThreadingOptions* tp_options, OrtLoggingLevel logging_level, _In_ const char* logid) { + ThrowOnError(GetApi().CreateEnvWithGlobalThreadPools(logging_level, logid, tp_options, &p_)); + if (strcmp(logid, "onnxruntime-node") == 0) { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_NODEJS)); + } else { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_CPLUSPLUS)); + } +} + +inline Env::Env(const OrtThreadingOptions* tp_options, OrtLoggingFunction logging_function, void* logger_param, + OrtLoggingLevel logging_level, _In_ const char* logid) { + ThrowOnError(GetApi().CreateEnvWithCustomLoggerAndGlobalThreadPools(logging_function, logger_param, logging_level, logid, tp_options, &p_)); + if (strcmp(logid, "onnxruntime-node") == 0) { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_NODEJS)); + } else { + ThrowOnError(GetApi().SetLanguageProjection(p_, OrtLanguageProjection::ORT_PROJECTION_CPLUSPLUS)); + } +} + +inline Env& Env::EnableTelemetryEvents() { + ThrowOnError(GetApi().EnableTelemetryEvents(p_)); + return *this; +} + +inline Env& Env::DisableTelemetryEvents() { + ThrowOnError(GetApi().DisableTelemetryEvents(p_)); + return *this; +} + +inline Env& Env::UpdateEnvWithCustomLogLevel(OrtLoggingLevel log_severity_level) { + ThrowOnError(GetApi().UpdateEnvWithCustomLogLevel(p_, log_severity_level)); + return *this; +} + +inline Env& Env::CreateAndRegisterAllocator(const OrtMemoryInfo* mem_info, const OrtArenaCfg* arena_cfg) { + ThrowOnError(GetApi().CreateAndRegisterAllocator(p_, mem_info, arena_cfg)); + return *this; +} + +inline CustomOpDomain::CustomOpDomain(const char* domain) { + ThrowOnError(GetApi().CreateCustomOpDomain(domain, &p_)); +} + +inline void CustomOpDomain::Add(const OrtCustomOp* op) { + ThrowOnError(GetApi().CustomOpDomain_Add(p_, op)); +} + +inline RunOptions::RunOptions() { + ThrowOnError(GetApi().CreateRunOptions(&p_)); +} + +inline RunOptions& RunOptions::SetRunLogVerbosityLevel(int level) { + ThrowOnError(GetApi().RunOptionsSetRunLogVerbosityLevel(p_, level)); + return *this; +} + +inline RunOptions& RunOptions::SetRunLogSeverityLevel(int level) { + ThrowOnError(GetApi().RunOptionsSetRunLogSeverityLevel(p_, level)); + return *this; +} + +inline int RunOptions::GetRunLogVerbosityLevel() const { + int out; + ThrowOnError(GetApi().RunOptionsGetRunLogVerbosityLevel(p_, &out)); + return out; +} + +inline int RunOptions::GetRunLogSeverityLevel() const { + int out; + ThrowOnError(GetApi().RunOptionsGetRunLogSeverityLevel(p_, &out)); + return out; +} + +inline RunOptions& RunOptions::SetRunTag(const char* run_tag) { + ThrowOnError(GetApi().RunOptionsSetRunTag(p_, run_tag)); + return *this; +} + +inline const char* RunOptions::GetRunTag() const { + const char* out; + ThrowOnError(GetApi().RunOptionsGetRunTag(p_, &out)); + return out; +} + +inline RunOptions& RunOptions::AddConfigEntry(const char* config_key, const char* config_value) { + ThrowOnError(GetApi().AddRunConfigEntry(p_, config_key, config_value)); + return *this; +} + +inline RunOptions& RunOptions::SetTerminate() { + ThrowOnError(GetApi().RunOptionsSetTerminate(p_)); + return *this; +} + +inline RunOptions& RunOptions::UnsetTerminate() { + ThrowOnError(GetApi().RunOptionsUnsetTerminate(p_)); + return *this; +} + +namespace detail { + +template +inline Ort::SessionOptions ConstSessionOptionsImpl::Clone() const { + OrtSessionOptions* out; + ThrowOnError(GetApi().CloneSessionOptions(this->p_, &out)); + return SessionOptions{out}; +} + +template +inline std::string ConstSessionOptionsImpl::GetConfigEntry(const char* config_key) const { + size_t size = 0; + // Feed nullptr for the data buffer to query the true size of the string value + Ort::ThrowOnError(GetApi().GetSessionConfigEntry(this->p_, config_key, nullptr, &size)); + + std::string out; + out.resize(size); + Ort::ThrowOnError(GetApi().GetSessionConfigEntry(this->p_, config_key, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + + return out; +} + +template +inline bool ConstSessionOptionsImpl::HasConfigEntry(const char* config_key) const { + int out = 0; + Ort::ThrowOnError(GetApi().HasSessionConfigEntry(this->p_, config_key, &out)); + return static_cast(out); +} + +template +inline std::string ConstSessionOptionsImpl::GetConfigEntryOrDefault(const char* config_key, const std::string& def) { + if (!this->HasConfigEntry(config_key)) { + return def; + } + + return this->GetConfigEntry(config_key); +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetIntraOpNumThreads(int intra_op_num_threads) { + ThrowOnError(GetApi().SetIntraOpNumThreads(this->p_, intra_op_num_threads)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetInterOpNumThreads(int inter_op_num_threads) { + ThrowOnError(GetApi().SetInterOpNumThreads(this->p_, inter_op_num_threads)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetGraphOptimizationLevel(GraphOptimizationLevel graph_optimization_level) { + ThrowOnError(GetApi().SetSessionGraphOptimizationLevel(this->p_, graph_optimization_level)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetOptimizedModelFilePath(const ORTCHAR_T* optimized_model_filepath) { + ThrowOnError(GetApi().SetOptimizedModelFilePath(this->p_, optimized_model_filepath)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::EnableProfiling(const ORTCHAR_T* profile_file_prefix) { + ThrowOnError(GetApi().EnableProfiling(this->p_, profile_file_prefix)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::DisableProfiling() { + ThrowOnError(GetApi().DisableProfiling(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::EnableOrtCustomOps() { + ThrowOnError(GetApi().EnableOrtCustomOps(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::EnableMemPattern() { + ThrowOnError(GetApi().EnableMemPattern(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::DisableMemPattern() { + ThrowOnError(GetApi().DisableMemPattern(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::EnableCpuMemArena() { + ThrowOnError(GetApi().EnableCpuMemArena(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::DisableCpuMemArena() { + ThrowOnError(GetApi().DisableCpuMemArena(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetExecutionMode(ExecutionMode execution_mode) { + ThrowOnError(GetApi().SetSessionExecutionMode(this->p_, execution_mode)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetLogId(const char* logid) { + ThrowOnError(GetApi().SetSessionLogId(this->p_, logid)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetLogSeverityLevel(int level) { + ThrowOnError(GetApi().SetSessionLogSeverityLevel(this->p_, level)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::Add(OrtCustomOpDomain* custom_op_domain) { + ThrowOnError(GetApi().AddCustomOpDomain(this->p_, custom_op_domain)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AddConfigEntry(const char* config_key, const char* config_value) { + ThrowOnError(GetApi().AddSessionConfigEntry(this->p_, config_key, config_value)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AddInitializer(const char* name, const OrtValue* ort_val) { + ThrowOnError(GetApi().AddInitializer(this->p_, name, ort_val)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::DisablePerSessionThreads() { + ThrowOnError(GetApi().DisablePerSessionThreads(this->p_)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AddExternalInitializers(const std::vector& names, + const std::vector& ort_values) { + const size_t inputs_num = names.size(); + if (inputs_num != ort_values.size()) { + ORT_CXX_API_THROW("Expecting names and ort_values to have the same length", ORT_INVALID_ARGUMENT); + } + std::vector names_ptr; + std::vector ort_values_ptrs; + names_ptr.reserve(inputs_num); + ort_values_ptrs.reserve(inputs_num); + for (size_t i = 0; i < inputs_num; ++i) { + names_ptr.push_back(names[i].c_str()); + ort_values_ptrs.push_back(ort_values[i]); + } + ThrowOnError(GetApi().AddExternalInitializers(this->p_, names_ptr.data(), ort_values_ptrs.data(), inputs_num)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_CUDA(const OrtCUDAProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_CUDA(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_CUDA_V2(const OrtCUDAProviderOptionsV2& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_CUDA_V2(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_ROCM(const OrtROCMProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_ROCM(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_TensorRT(const OrtTensorRTProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_TensorRT(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_TensorRT_V2(const OrtTensorRTProviderOptionsV2& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_TensorRT_V2(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_MIGraphX(const OrtMIGraphXProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_MIGraphX(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_CANN(const OrtCANNProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_CANN(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_Dnnl(const OrtDnnlProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_Dnnl(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider( + const std::string& provider_name, + const std::unordered_map& provider_options) { + auto num_entries = provider_options.size(); + std::vector keys, values; + if (num_entries > 0) { + keys.reserve(num_entries); + values.reserve(num_entries); + + for (const auto& entry : provider_options) { + keys.push_back(entry.first.c_str()); + values.push_back(entry.second.c_str()); + } + } + + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider(this->p_, provider_name.c_str(), + keys.data(), values.data(), num_entries)); + + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetCustomCreateThreadFn(OrtCustomCreateThreadFn ort_custom_create_thread_fn) { + ThrowOnError(GetApi().SessionOptionsSetCustomCreateThreadFn(this->p_, ort_custom_create_thread_fn)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetCustomThreadCreationOptions(void* ort_custom_thread_creation_options) { + ThrowOnError(GetApi().SessionOptionsSetCustomThreadCreationOptions(this->p_, ort_custom_thread_creation_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::SetCustomJoinThreadFn(OrtCustomJoinThreadFn ort_custom_join_thread_fn) { + ThrowOnError(GetApi().SessionOptionsSetCustomJoinThreadFn(this->p_, ort_custom_join_thread_fn)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::AppendExecutionProvider_OpenVINO(const OrtOpenVINOProviderOptions& provider_options) { + ThrowOnError(GetApi().SessionOptionsAppendExecutionProvider_OpenVINO(this->p_, &provider_options)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::RegisterCustomOpsLibrary(const ORTCHAR_T* library_name, + const CustomOpConfigs& custom_op_configs) { + // Add custom op config entries before registering the custom op library. Otherwise, the config entries _may_ be ignored by + // the custom op library. + for (const auto& config_iter : custom_op_configs.GetFlattenedConfigs()) { + AddConfigEntry(config_iter.first.c_str(), config_iter.second.c_str()); + } + + ThrowOnError(GetApi().RegisterCustomOpsLibrary_V2(this->p_, library_name)); + return *this; +} + +template +inline SessionOptionsImpl& SessionOptionsImpl::RegisterCustomOpsUsingFunction(const char* registration_function_name) { + ThrowOnError(GetApi().RegisterCustomOpsUsingFunction(this->p_, registration_function_name)); + return *this; +} + +/// Session +template +inline size_t ConstSessionImpl::GetInputCount() const { + size_t out; + ThrowOnError(GetApi().SessionGetInputCount(this->p_, &out)); + return out; +} + +template +inline size_t ConstSessionImpl::GetOutputCount() const { + size_t out; + ThrowOnError(GetApi().SessionGetOutputCount(this->p_, &out)); + return out; +} + +template +inline size_t ConstSessionImpl::GetOverridableInitializerCount() const { + size_t out; + ThrowOnError(GetApi().SessionGetOverridableInitializerCount(this->p_, &out)); + return out; +} + +template +inline AllocatedStringPtr ConstSessionImpl::GetInputNameAllocated(size_t index, OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().SessionGetInputName(this->p_, index, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +template +inline AllocatedStringPtr ConstSessionImpl::GetOutputNameAllocated(size_t index, OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().SessionGetOutputName(this->p_, index, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +template +inline AllocatedStringPtr ConstSessionImpl::GetOverridableInitializerNameAllocated(size_t index, OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().SessionGetOverridableInitializerName(this->p_, index, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +template +inline uint64_t ConstSessionImpl::GetProfilingStartTimeNs() const { + uint64_t out; + ThrowOnError(GetApi().SessionGetProfilingStartTimeNs(this->p_, &out)); + return out; +} + +template +inline ModelMetadata ConstSessionImpl::GetModelMetadata() const { + OrtModelMetadata* out; + ThrowOnError(GetApi().SessionGetModelMetadata(this->p_, &out)); + return ModelMetadata{out}; +} + +template +inline TypeInfo ConstSessionImpl::GetInputTypeInfo(size_t index) const { + OrtTypeInfo* out; + ThrowOnError(GetApi().SessionGetInputTypeInfo(this->p_, index, &out)); + return TypeInfo{out}; +} + +template +inline TypeInfo ConstSessionImpl::GetOutputTypeInfo(size_t index) const { + OrtTypeInfo* out; + ThrowOnError(GetApi().SessionGetOutputTypeInfo(this->p_, index, &out)); + return TypeInfo{out}; +} + +template +inline TypeInfo ConstSessionImpl::GetOverridableInitializerTypeInfo(size_t index) const { + OrtTypeInfo* out; + ThrowOnError(GetApi().SessionGetOverridableInitializerTypeInfo(this->p_, index, &out)); + return TypeInfo{out}; +} + +template +inline std::vector SessionImpl::Run(const RunOptions& run_options, const char* const* input_names, const Value* input_values, size_t input_count, + const char* const* output_names, size_t output_count) { + std::vector output_values; + output_values.reserve(output_count); + for (size_t i = 0; i < output_count; i++) + output_values.emplace_back(nullptr); + Run(run_options, input_names, input_values, input_count, output_names, output_values.data(), output_count); + return output_values; +} + +template +inline void SessionImpl::Run(const RunOptions& run_options, const char* const* input_names, const Value* input_values, size_t input_count, + const char* const* output_names, Value* output_values, size_t output_count) { + static_assert(sizeof(Value) == sizeof(OrtValue*), "Value is really just an array of OrtValue* in memory, so we can reinterpret_cast safely"); + auto ort_input_values = reinterpret_cast(input_values); + auto ort_output_values = reinterpret_cast(output_values); + ThrowOnError(GetApi().Run(this->p_, run_options, input_names, ort_input_values, input_count, output_names, output_count, ort_output_values)); +} + +template +inline void SessionImpl::Run(const RunOptions& run_options, const IoBinding& io_binding) { + ThrowOnError(GetApi().RunWithBinding(this->p_, run_options, io_binding)); +} + +template +inline AllocatedStringPtr SessionImpl::EndProfilingAllocated(OrtAllocator* allocator) { + char* out = nullptr; + ThrowOnError(GetApi().SessionEndProfiling(this->p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +} // namespace detail + +inline SessionOptions::SessionOptions() { + ThrowOnError(GetApi().CreateSessionOptions(&this->p_)); +} + +/// CustomOpConfigs +inline std::string detail::MakeCustomOpConfigEntryKey(const char* custom_op_name, const char* config) { + std::string config_key = "custom_op."; + + config_key += custom_op_name; + config_key += "."; + config_key += config; + + return config_key; +} + +inline CustomOpConfigs& CustomOpConfigs::AddConfig(const char* custom_op_name, const char* config_key, const char* config_value) { + const std::string full_flat_key = detail::MakeCustomOpConfigEntryKey(custom_op_name, config_key); + flat_configs_[full_flat_key] = config_value; + return *this; +} + +inline const std::unordered_map& CustomOpConfigs::GetFlattenedConfigs() const { + return flat_configs_; +} + +inline Session::Session(const Env& env, const ORTCHAR_T* model_path, const SessionOptions& options) { + ThrowOnError(GetApi().CreateSession(env, model_path, options, &this->p_)); +} + +inline Session::Session(const Env& env, const ORTCHAR_T* model_path, const SessionOptions& options, + OrtPrepackedWeightsContainer* prepacked_weights_container) { + ThrowOnError(GetApi().CreateSessionWithPrepackedWeightsContainer(env, model_path, options, prepacked_weights_container, &this->p_)); +} + +inline Session::Session(const Env& env, const void* model_data, size_t model_data_length, const SessionOptions& options) { + ThrowOnError(GetApi().CreateSessionFromArray(env, model_data, model_data_length, options, &this->p_)); +} + +inline Session::Session(const Env& env, const void* model_data, size_t model_data_length, + const SessionOptions& options, OrtPrepackedWeightsContainer* prepacked_weights_container) { + ThrowOnError(GetApi().CreateSessionFromArrayWithPrepackedWeightsContainer(env, model_data, model_data_length, options, + prepacked_weights_container, &this->p_)); +} + +inline AllocatedStringPtr ModelMetadata::GetProducerNameAllocated(OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataGetProducerName(p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline AllocatedStringPtr ModelMetadata::GetGraphNameAllocated(OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataGetGraphName(p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline AllocatedStringPtr ModelMetadata::GetDomainAllocated(OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataGetDomain(p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline AllocatedStringPtr Ort::ModelMetadata::GetDescriptionAllocated(OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataGetDescription(p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline AllocatedStringPtr ModelMetadata::GetGraphDescriptionAllocated(OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataGetGraphDescription(p_, allocator, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline AllocatedStringPtr ModelMetadata::LookupCustomMetadataMapAllocated(const char* key, OrtAllocator* allocator) const { + char* out; + ThrowOnError(GetApi().ModelMetadataLookupCustomMetadataMap(p_, allocator, key, &out)); + return AllocatedStringPtr(out, detail::AllocatedFree(allocator)); +} + +inline std::vector ModelMetadata::GetCustomMetadataMapKeysAllocated(OrtAllocator* allocator) const { + auto deletor = detail::AllocatedFree(allocator); + std::vector result; + + char** out = nullptr; + int64_t num_keys = 0; + ThrowOnError(GetApi().ModelMetadataGetCustomMetadataMapKeys(p_, allocator, &out, &num_keys)); + if (num_keys <= 0) { + return result; + } + + // array of pointers will be freed + std::unique_ptr array_guard(out, deletor); + // reserve may throw + auto strings_deletor = [&deletor, num_keys](char** out) { for(int64_t i = 0; i < num_keys; ++i) deletor(out[i]); }; + std::unique_ptr strings_guard(out, strings_deletor); + result.reserve(static_cast(num_keys)); + strings_guard.release(); + for (int64_t i = 0; i < num_keys; ++i) { + result.push_back(AllocatedStringPtr(out[i], deletor)); + } + + return result; +} + +inline int64_t ModelMetadata::GetVersion() const { + int64_t out; + ThrowOnError(GetApi().ModelMetadataGetVersion(p_, &out)); + return out; +} + +namespace detail { + +template +inline ONNXTensorElementDataType TensorTypeAndShapeInfoImpl::GetElementType() const { + ONNXTensorElementDataType out; + ThrowOnError(GetApi().GetTensorElementType(this->p_, &out)); + return out; +} + +template +inline size_t TensorTypeAndShapeInfoImpl::GetElementCount() const { + size_t out; + ThrowOnError(GetApi().GetTensorShapeElementCount(this->p_, &out)); + return static_cast(out); +} + +template +inline size_t TensorTypeAndShapeInfoImpl::GetDimensionsCount() const { + size_t out; + ThrowOnError(GetApi().GetDimensionsCount(this->p_, &out)); + return out; +} + +template +inline void TensorTypeAndShapeInfoImpl::GetDimensions(int64_t* values, size_t values_count) const { + ThrowOnError(GetApi().GetDimensions(this->p_, values, values_count)); +} + +template +inline void TensorTypeAndShapeInfoImpl::GetSymbolicDimensions(const char** values, size_t values_count) const { + ThrowOnError(GetApi().GetSymbolicDimensions(this->p_, values, values_count)); +} + +template +inline std::vector TensorTypeAndShapeInfoImpl::GetShape() const { + std::vector out(GetDimensionsCount(), 0); + ThrowOnError(GetApi().GetDimensions(this->p_, out.data(), out.size())); + return out; +} + +template +inline ConstTensorTypeAndShapeInfo TypeInfoImpl::GetTensorTypeAndShapeInfo() const { + const OrtTensorTypeAndShapeInfo* out; + ThrowOnError(GetApi().CastTypeInfoToTensorInfo(this->p_, &out)); + return ConstTensorTypeAndShapeInfo{out}; +} + +template +inline ConstSequenceTypeInfo TypeInfoImpl::GetSequenceTypeInfo() const { + const OrtSequenceTypeInfo* out; + ThrowOnError(GetApi().CastTypeInfoToSequenceTypeInfo(this->p_, &out)); + return ConstSequenceTypeInfo{out}; +} + +template +inline ConstMapTypeInfo TypeInfoImpl::GetMapTypeInfo() const { + const OrtMapTypeInfo* out; + ThrowOnError(GetApi().CastTypeInfoToMapTypeInfo(this->p_, &out)); + return ConstMapTypeInfo{out}; +} + +template +inline ONNXType TypeInfoImpl::GetONNXType() const { + ONNXType out; + ThrowOnError(GetApi().GetOnnxTypeFromTypeInfo(this->p_, &out)); + return out; +} + +template +inline TypeInfo SequenceTypeInfoImpl::GetSequenceElementType() const { + OrtTypeInfo* output; + ThrowOnError(GetApi().GetSequenceElementType(this->p_, &output)); + return TypeInfo{output}; +} + +template +inline TypeInfo OptionalTypeInfoImpl::GetOptionalElementType() const { + OrtTypeInfo* info; + ThrowOnError(GetApi().GetOptionalContainedTypeInfo(this->p_, &info)); + return TypeInfo{info}; +} + +template +inline ONNXTensorElementDataType MapTypeInfoImpl::GetMapKeyType() const { + ONNXTensorElementDataType out; + ThrowOnError(GetApi().GetMapKeyType(this->p_, &out)); + return out; +} + +template +inline TypeInfo MapTypeInfoImpl::GetMapValueType() const { + OrtTypeInfo* output; + ThrowOnError(GetApi().GetMapValueType(this->p_, &output)); + return TypeInfo{output}; +} + +template +inline ConstOptionalTypeInfo TypeInfoImpl::GetOptionalTypeInfo() const { + const OrtOptionalTypeInfo* info; + ThrowOnError(GetApi().CastTypeInfoToOptionalTypeInfo(this->p_, &info)); + return ConstOptionalTypeInfo{info}; +} + +} // namespace detail + +namespace detail { + +template +template +inline void ConstValueImpl::GetOpaqueData(const char* domain, const char* type_name, R& out) const { + ThrowOnError(GetApi().GetOpaqueValue(domain, type_name, this->p_, &out, sizeof(R))); +} + +template +inline bool ConstValueImpl::IsTensor() const { + int out; + ThrowOnError(GetApi().IsTensor(this->p_, &out)); + return out != 0; +} + +template +inline bool ConstValueImpl::HasValue() const { + int out; + ThrowOnError(GetApi().HasValue(this->p_, &out)); + return out != 0; +} + +template +inline size_t ConstValueImpl::GetCount() const { + size_t out; + ThrowOnError(GetApi().GetValueCount(this->p_, &out)); + return out; +} + +template +inline Value ConstValueImpl::GetValue(int index, OrtAllocator* allocator) const { + OrtValue* out; + ThrowOnError(GetApi().GetValue(this->p_, index, allocator, &out)); + return Value{out}; +} + +template +inline size_t ConstValueImpl::GetStringTensorDataLength() const { + size_t out; + ThrowOnError(GetApi().GetStringTensorDataLength(this->p_, &out)); + return out; +} + +template +inline size_t ConstValueImpl::GetStringTensorElementLength(size_t element_index) const { + size_t out; + ThrowOnError(GetApi().GetStringTensorElementLength(this->p_, element_index, &out)); + return out; +} + +template +template +inline const R* ConstValueImpl::GetTensorData() const { + R* out; + ThrowOnError(GetApi().GetTensorMutableData(const_cast(this->p_), (void**)&out)); + return out; +} + +template +inline const void* ConstValueImpl::GetTensorRawData() const { + void* out; + ThrowOnError(GetApi().GetTensorMutableData(const_cast(this->p_), &out)); + return out; +} + +template +inline TypeInfo ConstValueImpl::GetTypeInfo() const { + OrtTypeInfo* output; + ThrowOnError(GetApi().GetTypeInfo(this->p_, &output)); + return TypeInfo{output}; +} + +template +inline TensorTypeAndShapeInfo ConstValueImpl::GetTensorTypeAndShapeInfo() const { + OrtTensorTypeAndShapeInfo* output; + ThrowOnError(GetApi().GetTensorTypeAndShape(this->p_, &output)); + return TensorTypeAndShapeInfo{output}; +} + +template +inline ConstMemoryInfo ConstValueImpl::GetTensorMemoryInfo() const { + const OrtMemoryInfo* mem_info; + ThrowOnError(GetApi().GetTensorMemoryInfo(this->p_, &mem_info)); + return ConstMemoryInfo(mem_info); +} + +template +inline void ConstValueImpl::GetStringTensorElement(size_t buffer_length, size_t element_index, void* buffer) const { + ThrowOnError(GetApi().GetStringTensorElement(this->p_, buffer_length, element_index, buffer)); +} + +template +inline std::string ConstValueImpl::GetStringTensorElement(size_t element_index) const { + size_t buffer_length; + ThrowOnError(GetApi().GetStringTensorElementLength(this->p_, element_index, &buffer_length)); + + std::string s; + s.resize(buffer_length); + ThrowOnError(GetApi().GetStringTensorElement(this->p_, buffer_length, element_index, &s[0])); + return s; +} + +template +inline void ConstValueImpl::GetStringTensorContent(void* buffer, size_t buffer_length, size_t* offsets, size_t offsets_count) const { + ThrowOnError(GetApi().GetStringTensorContent(this->p_, buffer, buffer_length, offsets, offsets_count)); +} + +#if !defined(DISABLE_SPARSE_TENSORS) +template +inline OrtSparseFormat ConstValueImpl::GetSparseFormat() const { + OrtSparseFormat format; + ThrowOnError(GetApi().GetSparseTensorFormat(this->p_, &format)); + return format; +} + +template +inline TensorTypeAndShapeInfo ConstValueImpl::GetSparseTensorValuesTypeAndShapeInfo() const { + OrtTensorTypeAndShapeInfo* output; + ThrowOnError(GetApi().GetSparseTensorValuesTypeAndShape(this->p_, &output)); + return TensorTypeAndShapeInfo{output}; +} + +template +inline TensorTypeAndShapeInfo ConstValueImpl::GetSparseTensorIndicesTypeShapeInfo(OrtSparseIndicesFormat indices_format) const { + OrtTensorTypeAndShapeInfo* output; + ThrowOnError(GetApi().GetSparseTensorIndicesTypeShape(this->p_, indices_format, &output)); + return TensorTypeAndShapeInfo{output}; +} + +template +template +inline const R* ConstValueImpl::GetSparseTensorIndicesData(OrtSparseIndicesFormat indices_format, size_t& num_indices) const { + const void* out; + ThrowOnError(GetApi().GetSparseTensorIndices(this->p_, indices_format, &num_indices, &out)); + return reinterpret_cast(out); +} + +template +inline bool ConstValueImpl::IsSparseTensor() const { + int out; + ThrowOnError(GetApi().IsSparseTensor(this->p_, &out)); + return out != 0; +} + +template +template +inline const R* ConstValueImpl::GetSparseTensorValues() const { + const void* out; + ThrowOnError(GetApi().GetSparseTensorValues(this->p_, &out)); + return reinterpret_cast(out); +} + +#endif + +template +void ValueImpl::FillStringTensor(const char* const* s, size_t s_len) { + ThrowOnError(GetApi().FillStringTensor(this->p_, s, s_len)); +} + +template +void ValueImpl::FillStringTensorElement(const char* s, size_t index) { + ThrowOnError(GetApi().FillStringTensorElement(this->p_, s, index)); +} + +template +inline char* ValueImpl::GetResizedStringTensorElementBuffer(size_t index, size_t buffer_length) { + char* result; + ThrowOnError(GetApi().GetResizedStringTensorElementBuffer(this->p_, index, buffer_length, &result)); + return result; +} + +template +void* ValueImpl::GetTensorMutableRawData() { + void* out; + ThrowOnError(GetApi().GetTensorMutableData(this->p_, &out)); + return out; +} + +template +template +R* ValueImpl::GetTensorMutableData() { + R* out; + ThrowOnError(GetApi().GetTensorMutableData(this->p_, (void**)&out)); + return out; +} + +template +template +R& ValueImpl::At(const std::vector& location) { + static_assert(!std::is_same::value, "this api does not support std::string"); + R* out; + ThrowOnError(GetApi().TensorAt(this->p_, location.data(), location.size(), (void**)&out)); + return *out; +} + +#if !defined(DISABLE_SPARSE_TENSORS) +template +void ValueImpl::UseCooIndices(int64_t* indices_data, size_t indices_num) { + ThrowOnError(GetApi().UseCooIndices(this->p_, indices_data, indices_num)); +} + +template +void ValueImpl::UseCsrIndices(int64_t* inner_data, size_t inner_num, int64_t* outer_data, size_t outer_num) { + ThrowOnError(GetApi().UseCsrIndices(this->p_, inner_data, inner_num, outer_data, outer_num)); +} + +template +void ValueImpl::UseBlockSparseIndices(const Shape& indices_shape, int32_t* indices_data) { + ThrowOnError(GetApi().UseBlockSparseIndices(this->p_, indices_shape.shape, indices_shape.shape_len, indices_data)); +} + +template +void ValueImpl::FillSparseTensorCoo(const OrtMemoryInfo* mem_info, const OrtSparseValuesParam& values_param, + const int64_t* indices_data, size_t indices_num) { + ThrowOnError(GetApi().FillSparseTensorCoo(this->p_, mem_info, values_param.values_shape, + values_param.values_shape_len, values_param.data.p_data, + indices_data, indices_num)); +} + +template +void ValueImpl::FillSparseTensorCsr(const OrtMemoryInfo* data_mem_info, + const OrtSparseValuesParam& values, + const int64_t* inner_indices_data, size_t inner_indices_num, + const int64_t* outer_indices_data, size_t outer_indices_num) { + ThrowOnError(GetApi().FillSparseTensorCsr(this->p_, data_mem_info, values.values_shape, values.values_shape_len, values.data.p_data, + inner_indices_data, inner_indices_num, + outer_indices_data, outer_indices_num)); +} + +template +void ValueImpl::FillSparseTensorBlockSparse(const OrtMemoryInfo* data_mem_info, + const OrtSparseValuesParam& values, + const Shape& indices_shape, + const int32_t* indices_data) { + ThrowOnError(GetApi().FillSparseTensorBlockSparse(this->p_, data_mem_info, values.values_shape, values.values_shape_len, values.data.p_data, + indices_shape.shape, indices_shape.shape_len, + indices_data)); +} + +#endif // !defined(DISABLE_SPARSE_TENSORS) + +} // namespace detail + +template +inline Value Value::CreateTensor(const OrtMemoryInfo* info, T* p_data, size_t p_data_element_count, const int64_t* shape, size_t shape_len) { + return CreateTensor(info, p_data, p_data_element_count * sizeof(T), shape, shape_len, TypeToTensorType::type); +} + +inline Value Value::CreateTensor(const OrtMemoryInfo* info, void* p_data, size_t p_data_byte_count, const int64_t* shape, size_t shape_len, + ONNXTensorElementDataType type) { + OrtValue* out; + ThrowOnError(GetApi().CreateTensorWithDataAsOrtValue(info, p_data, p_data_byte_count, shape, shape_len, type, &out)); + return Value{out}; +} + +template +inline Value Value::CreateTensor(OrtAllocator* allocator, const int64_t* shape, size_t shape_len) { + return CreateTensor(allocator, shape, shape_len, TypeToTensorType::type); +} + +inline Value Value::CreateTensor(OrtAllocator* allocator, const int64_t* shape, size_t shape_len, ONNXTensorElementDataType type) { + OrtValue* out; + ThrowOnError(GetApi().CreateTensorAsOrtValue(allocator, shape, shape_len, type, &out)); + return Value{out}; +} + +#if !defined(DISABLE_SPARSE_TENSORS) + +template +inline Value Value::CreateSparseTensor(const OrtMemoryInfo* info, T* p_data, const Shape& dense_shape, + const Shape& values_shape) { + return CreateSparseTensor(info, p_data, dense_shape, values_shape, TypeToTensorType::type); +} + +inline Value Value::CreateSparseTensor(const OrtMemoryInfo* info, void* p_data, const Shape& dense_shape, + const Shape& values_shape, ONNXTensorElementDataType type) { + OrtValue* out; + ThrowOnError(GetApi().CreateSparseTensorWithValuesAsOrtValue(info, p_data, dense_shape.shape, dense_shape.shape_len, + values_shape.shape, values_shape.shape_len, type, &out)); + return Value{out}; +} + +template +inline Value Value::CreateSparseTensor(OrtAllocator* allocator, const Shape& dense_shape) { + return CreateSparseTensor(allocator, dense_shape, TypeToTensorType::type); +} + +inline Value Value::CreateSparseTensor(OrtAllocator* allocator, const Shape& dense_shape, + ONNXTensorElementDataType type) { + OrtValue* out; + ThrowOnError(GetApi().CreateSparseTensorAsOrtValue(allocator, dense_shape.shape, dense_shape.shape_len, type, &out)); + return Value{out}; +} +#endif // !defined(DISABLE_SPARSE_TENSORS) + +inline Value Value::CreateMap(Value& keys, Value& values) { + OrtValue* out; + OrtValue* inputs[2] = {keys, values}; + ThrowOnError(GetApi().CreateValue(inputs, 2, ONNX_TYPE_MAP, &out)); + return Value{out}; +} + +inline Value Value::CreateSequence(std::vector& values) { + OrtValue* out; + std::vector values_ort{values.data(), values.data() + values.size()}; + ThrowOnError(GetApi().CreateValue(values_ort.data(), values_ort.size(), ONNX_TYPE_SEQUENCE, &out)); + return Value{out}; +} + +template +inline Value Value::CreateOpaque(const char* domain, const char* type_name, const T& data_container) { + OrtValue* out; + ThrowOnError(GetApi().CreateOpaqueValue(domain, type_name, &data_container, sizeof(T), &out)); + return Value{out}; +} + +// +// Custom OP Inlines +// +inline Logger::Logger(const OrtLogger* logger) : logger_(logger) { + Ort::ThrowOnError(GetApi().Logger_GetLoggingSeverityLevel(this->logger_, &this->cached_severity_level_)); +} + +inline OrtLoggingLevel Logger::GetLoggingSeverityLevel() const noexcept { + return cached_severity_level_; +} + +inline Status Logger::LogMessage(OrtLoggingLevel log_severity_level, const ORTCHAR_T* file_path, int line_number, + const char* func_name, const char* message) const noexcept { + OrtStatus* status = GetApi().Logger_LogMessage(logger_, log_severity_level, message, file_path, line_number, + func_name); + return Status{status}; +} + +// Disable warnings about the format string not being a literal (-Wformat-nonliteral and -Wformat-security) +// for gcc and clang. The alternative is to use actual C-style variadic parameters and apply +// __attribute__(format(printf...)), which does not work with variadic templates. +#if defined(__GNUC__) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wformat-nonliteral" +#pragma GCC diagnostic ignored "-Wformat-security" +#elif defined(__clang__) +#pragma clang diagnostic push +#pragma clang diagnostic ignored "-Wformat-nonliteral" +#pragma clang diagnostic ignored "-Wformat-security" +#endif +template +inline Status Logger::LogFormattedMessage(OrtLoggingLevel log_severity_level, const ORTCHAR_T* file_path, + int line_number, const char* func_name, const char* format, + Args&&... args) const noexcept { + int msg_len = std::snprintf(nullptr, 0U, format, std::forward(args)...); + + if (msg_len < 0) { // Formatting error + return Status("Failed to log message due to formatting error", OrtErrorCode::ORT_FAIL); + } + + OrtStatus* status = nullptr; + const size_t buffer_size = static_cast(msg_len) + 1U; + + constexpr size_t kStackBufferSize = 1024; + + if (buffer_size < kStackBufferSize) { + char buffer[kStackBufferSize]; + snprintf(buffer, kStackBufferSize, format, std::forward(args)...); + status = GetApi().Logger_LogMessage(logger_, log_severity_level, buffer, file_path, line_number, func_name); + } else { + // std::make_unique is only supported starting at C++14. +#if (__cplusplus >= 201402L) || (_MSC_VER >= 1900) + auto buffer = std::make_unique(buffer_size); +#else + std::unique_ptr buffer(new char[buffer_size]); +#endif + std::snprintf(buffer.get(), buffer_size, format, std::forward(args)...); + status = GetApi().Logger_LogMessage(logger_, log_severity_level, buffer.get(), file_path, line_number, func_name); + } + + return Status{status}; +} +// Re-enable -Wformat-nonliteral and -Wformat-security +#if defined(__GNUC__) +#pragma GCC diagnostic pop +#elif defined(__clang__) +#pragma clang diagnostic pop +#endif + +inline KernelContext::KernelContext(OrtKernelContext* context) : ctx_(context) { +} + +inline size_t KernelContext::GetInputCount() const { + size_t out = 0; + Ort::ThrowOnError(GetApi().KernelContext_GetInputCount(ctx_, &out)); + return out; +} + +inline size_t KernelContext::GetOutputCount() const { + size_t out = 0; + Ort::ThrowOnError(GetApi().KernelContext_GetOutputCount(ctx_, &out)); + return out; +} + +inline ConstValue KernelContext::GetInput(size_t index) const { + const OrtValue* out = nullptr; + Ort::ThrowOnError(GetApi().KernelContext_GetInput(ctx_, index, &out)); + return ConstValue{out}; +} + +inline UnownedValue KernelContext::GetOutput(size_t index, const int64_t* dim_values, size_t dim_count) const { + OrtValue* out = nullptr; + Ort::ThrowOnError(GetApi().KernelContext_GetOutput(ctx_, index, dim_values, dim_count, &out)); + return UnownedValue(out); +} + +inline UnownedValue KernelContext::GetOutput(size_t index, const std::vector& dims) const { + OrtValue* out = nullptr; + Ort::ThrowOnError(GetApi().KernelContext_GetOutput(ctx_, index, dims.data(), dims.size(), &out)); + return UnownedValue(out); +} + +inline void* KernelContext::GetGPUComputeStream() const { + void* out = nullptr; + Ort::ThrowOnError(GetApi().KernelContext_GetGPUComputeStream(ctx_, &out)); + return out; +} + +inline OrtAllocator* KernelContext::GetAllocator(const OrtMemoryInfo& memory_info) const { + OrtAllocator* out = nullptr; + Ort::ThrowOnError(GetApi().KernelContext_GetAllocator(ctx_, &memory_info, &out)); + return out; +} + +inline Logger KernelContext::GetLogger() const { + const OrtLogger* out = nullptr; + ThrowOnError(GetApi().KernelContext_GetLogger(this->ctx_, &out)); + return Logger{out}; +} + +inline OpAttr::OpAttr(const char* name, const void* data, int len, OrtOpAttrType type) { + Ort::ThrowOnError(GetApi().CreateOpAttr(name, data, len, type, &p_)); +} + +namespace detail { +template +inline KernelInfo KernelInfoImpl::Copy() const { + OrtKernelInfo* info_copy = nullptr; + Ort::ThrowOnError(GetApi().CopyKernelInfo(this->p_, &info_copy)); + return KernelInfo{info_copy}; +} + +template +inline size_t KernelInfoImpl::GetInputCount() const { + size_t out = 0; + ThrowOnError(GetApi().KernelInfo_GetInputCount(this->p_, &out)); + return out; +} + +template +inline size_t KernelInfoImpl::GetOutputCount() const { + size_t out = 0; + ThrowOnError(GetApi().KernelInfo_GetOutputCount(this->p_, &out)); + return out; +} + +template +inline std::string KernelInfoImpl::GetInputName(size_t index) const { + size_t size = 0; + + // Feed nullptr for the data buffer to query the true size of the string value + Ort::ThrowOnError(GetApi().KernelInfo_GetInputName(this->p_, index, nullptr, &size)); + + std::string out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfo_GetInputName(this->p_, index, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + + return out; +} + +template +inline std::string KernelInfoImpl::GetOutputName(size_t index) const { + size_t size = 0; + + // Feed nullptr for the data buffer to query the true size of the string value + Ort::ThrowOnError(GetApi().KernelInfo_GetOutputName(this->p_, index, nullptr, &size)); + + std::string out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfo_GetOutputName(this->p_, index, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + + return out; +} + +template +inline TypeInfo KernelInfoImpl::GetInputTypeInfo(size_t index) const { + OrtTypeInfo* out = nullptr; + ThrowOnError(GetApi().KernelInfo_GetInputTypeInfo(this->p_, index, &out)); + return TypeInfo{out}; +} + +template +inline TypeInfo KernelInfoImpl::GetOutputTypeInfo(size_t index) const { + OrtTypeInfo* out = nullptr; + ThrowOnError(GetApi().KernelInfo_GetOutputTypeInfo(this->p_, index, &out)); + return TypeInfo{out}; +} + +template +inline Value KernelInfoImpl::GetTensorAttribute(const char* name, OrtAllocator* allocator) const { + OrtValue* out = nullptr; + ThrowOnError(GetApi().KernelInfoGetAttribute_tensor(this->p_, name, allocator, &out)); + return Value{out}; +} + +template +inline ConstValue KernelInfoImpl::GetTensorConstantInput(size_t index, int* is_constant) const { + const OrtValue* out = nullptr; + ThrowOnError(GetApi().KernelInfoGetConstantInput_tensor(this->p_, index, is_constant, &out)); + return ConstValue{out}; +} + +template +inline std::string KernelInfoImpl::GetNodeName() const { + size_t size = 0; + + // Feed nullptr for the data buffer to query the true size of the string value + Ort::ThrowOnError(GetApi().KernelInfo_GetNodeName(this->p_, nullptr, &size)); + + std::string out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfo_GetNodeName(this->p_, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + + return out; +} + +template +inline Logger KernelInfoImpl::GetLogger() const { + const OrtLogger* out = nullptr; + ThrowOnError(GetApi().KernelInfo_GetLogger(this->p_, &out)); + return Logger{out}; +} + +inline void attr_utils::GetAttr(const OrtKernelInfo* p, const char* name, float& out) { + Ort::ThrowOnError(GetApi().KernelInfoGetAttribute_float(p, name, &out)); +} + +inline void attr_utils::GetAttr(const OrtKernelInfo* p, const char* name, int64_t& out) { + Ort::ThrowOnError(GetApi().KernelInfoGetAttribute_int64(p, name, &out)); +} + +inline void attr_utils::GetAttr(const OrtKernelInfo* p, const char* name, std::string& result) { + size_t size = 0; + // Feed nullptr for the data buffer to query the true size of the string attribute + Ort::ThrowOnError(GetApi().KernelInfoGetAttribute_string(p, name, nullptr, &size)); + + std::string out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfoGetAttribute_string(p, name, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + out.swap(result); +} + +inline void attr_utils::GetAttrs(const OrtKernelInfo* p, const char* name, std::vector& result) { + size_t size = 0; + // Feed nullptr for the data buffer to query the true size of the attribute + Ort::ThrowOnError(GetApi().KernelInfoGetAttributeArray_float(p, name, nullptr, &size)); + + std::vector out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfoGetAttributeArray_float(p, name, out.data(), &size)); + out.swap(result); +} + +inline void attr_utils::GetAttrs(const OrtKernelInfo* p, const char* name, std::vector& result) { + size_t size = 0; + + // Feed nullptr for the data buffer to query the true size of the attribute + Ort::ThrowOnError(GetApi().KernelInfoGetAttributeArray_int64(p, name, nullptr, &size)); + + std::vector out; + out.resize(size); + Ort::ThrowOnError(GetApi().KernelInfoGetAttributeArray_int64(p, name, out.data(), &size)); + out.swap(result); +} +} // namespace detail + +inline KernelInfo::KernelInfo(OrtKernelInfo* info) : detail::KernelInfoImpl{info} {} + +inline Op::Op(OrtOp* p) : Base(p) {} + +inline Op Op::Create(const OrtKernelInfo* info, const char* op_name, const char* domain, int version, + const char** type_constraint_names, + const ONNXTensorElementDataType* type_constraint_values, + size_t type_constraint_count, + const OpAttr* attr_values, size_t attr_count, + size_t input_count, size_t output_count) { + static_assert(sizeof(OpAttr) == sizeof(OrtOpAttr*), + "OpAttr's is expected to be just an array of OrtOpAttr in memory so we can reinterpret safely"); + auto attr_input_values = reinterpret_cast(attr_values); + OrtOp* op; + Ort::ThrowOnError(GetApi().CreateOp(info, op_name, domain, version, type_constraint_names, type_constraint_values, + static_cast(type_constraint_count), + attr_input_values, + static_cast(attr_count), + static_cast(input_count), + static_cast(output_count), &op)); + return Op{op}; +} + +inline void Op::Invoke(const OrtKernelContext* context, + const Value* input_values, + size_t input_count, + Value* output_values, + size_t output_count) { + static_assert(sizeof(Value) == sizeof(OrtValue*), + "Value is really just an array of OrtValue* in memory, so we can reinterpret_cast safely"); + auto ort_input_values = reinterpret_cast(input_values); + auto ort_output_values = reinterpret_cast(output_values); + Ort::ThrowOnError(GetApi().InvokeOp(context, p_, ort_input_values, static_cast(input_count), + ort_output_values, static_cast(output_count))); +} + +inline void Op::Invoke(const OrtKernelContext* context, + const OrtValue* const* input_values, + size_t input_count, + OrtValue* const* output_values, + size_t output_count) { + Ort::ThrowOnError(GetApi().InvokeOp(context, p_, input_values, static_cast(input_count), + output_values, static_cast(output_count))); +} + +inline void CustomOpApi::ThrowOnError(OrtStatus* status) { + Ort::ThrowOnError(status); +} + +template <> +inline float CustomOpApi::KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name) { + float out; + Ort::ThrowOnError(api_.KernelInfoGetAttribute_float(info, name, &out)); + return out; +} + +template <> +inline int64_t CustomOpApi::KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name) { + int64_t out; + Ort::ThrowOnError(api_.KernelInfoGetAttribute_int64(info, name, &out)); + return out; +} + +template <> +inline std::string CustomOpApi::KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name) { + size_t size = 0; + std::string out; + + // Feed nullptr for the data buffer to query the true size of the string attribute + OrtStatus* status = api_.KernelInfoGetAttribute_string(info, name, nullptr, &size); + + if (status == nullptr) { + out.resize(size); + Ort::ThrowOnError(api_.KernelInfoGetAttribute_string(info, name, &out[0], &size)); + out.resize(size - 1); // remove the terminating character '\0' + } else { + Ort::ThrowOnError(status); + } + return out; +} + +template <> +inline std::vector CustomOpApi::KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name) { + size_t size = 0; + std::vector out; + + // Feed nullptr for the data buffer to query the true size of the attribute + OrtStatus* status = api_.KernelInfoGetAttributeArray_float(info, name, nullptr, &size); + + if (status == nullptr) { + out.resize(size); + Ort::ThrowOnError(api_.KernelInfoGetAttributeArray_float(info, name, out.data(), &size)); + } else { + Ort::ThrowOnError(status); + } + return out; +} + +template <> +inline std::vector CustomOpApi::KernelInfoGetAttribute(_In_ const OrtKernelInfo* info, _In_ const char* name) { + size_t size = 0; + std::vector out; + + // Feed nullptr for the data buffer to query the true size of the attribute + OrtStatus* status = api_.KernelInfoGetAttributeArray_int64(info, name, nullptr, &size); + + if (status == nullptr) { + out.resize(size); + Ort::ThrowOnError(api_.KernelInfoGetAttributeArray_int64(info, name, out.data(), &size)); + } else { + Ort::ThrowOnError(status); + } + return out; +} +inline OrtTensorTypeAndShapeInfo* CustomOpApi::GetTensorTypeAndShape(_In_ const OrtValue* value) { + OrtTensorTypeAndShapeInfo* out; + Ort::ThrowOnError(api_.GetTensorTypeAndShape(value, &out)); + return out; +} + +inline size_t CustomOpApi::GetTensorShapeElementCount(_In_ const OrtTensorTypeAndShapeInfo* info) { + size_t out; + Ort::ThrowOnError(api_.GetTensorShapeElementCount(info, &out)); + return out; +} + +inline ONNXTensorElementDataType CustomOpApi::GetTensorElementType(const OrtTensorTypeAndShapeInfo* info) { + ONNXTensorElementDataType out; + Ort::ThrowOnError(api_.GetTensorElementType(info, &out)); + return out; +} + +inline size_t CustomOpApi::GetDimensionsCount(_In_ const OrtTensorTypeAndShapeInfo* info) { + size_t out; + Ort::ThrowOnError(api_.GetDimensionsCount(info, &out)); + return out; +} + +inline void CustomOpApi::GetDimensions(_In_ const OrtTensorTypeAndShapeInfo* info, _Out_ int64_t* dim_values, size_t dim_values_length) { + Ort::ThrowOnError(api_.GetDimensions(info, dim_values, dim_values_length)); +} + +inline void CustomOpApi::SetDimensions(OrtTensorTypeAndShapeInfo* info, _In_ const int64_t* dim_values, size_t dim_count) { + Ort::ThrowOnError(api_.SetDimensions(info, dim_values, dim_count)); +} + +template +inline T* CustomOpApi::GetTensorMutableData(_Inout_ OrtValue* value) { + T* data; + Ort::ThrowOnError(api_.GetTensorMutableData(value, reinterpret_cast(&data))); + return data; +} + +inline const OrtMemoryInfo* CustomOpApi::GetTensorMemoryInfo(_In_ const OrtValue* value) { + const OrtMemoryInfo* mem_info; + Ort::ThrowOnError(api_.GetTensorMemoryInfo(value, &mem_info)); + return mem_info; +} + +template +inline const T* CustomOpApi::GetTensorData(_Inout_ const OrtValue* value) { + T* data = nullptr; + Ort::ThrowOnError(api_.GetTensorMutableData(const_cast(value), reinterpret_cast(&data))); + return data; +} + +inline std::vector CustomOpApi::GetTensorShape(const OrtTensorTypeAndShapeInfo* info) { + size_t out; + Ort::ThrowOnError(api_.GetDimensionsCount(info, &out)); + std::vector output(out); + Ort::ThrowOnError(api_.GetDimensions(info, output.data(), out)); + return output; +} + +inline void CustomOpApi::ReleaseTensorTypeAndShapeInfo(OrtTensorTypeAndShapeInfo* input) { + api_.ReleaseTensorTypeAndShapeInfo(input); +} + +inline size_t CustomOpApi::KernelContext_GetInputCount(const OrtKernelContext* context) { + size_t out; + Ort::ThrowOnError(api_.KernelContext_GetInputCount(context, &out)); + return out; +} + +inline const OrtValue* CustomOpApi::KernelContext_GetInput(const OrtKernelContext* context, _In_ size_t index) { + const OrtValue* out; + Ort::ThrowOnError(api_.KernelContext_GetInput(context, index, &out)); + return out; +} + +inline size_t CustomOpApi::KernelContext_GetOutputCount(const OrtKernelContext* context) { + size_t out; + Ort::ThrowOnError(api_.KernelContext_GetOutputCount(context, &out)); + return out; +} + +inline OrtValue* CustomOpApi::KernelContext_GetOutput(OrtKernelContext* context, _In_ size_t index, + _In_ const int64_t* dim_values, size_t dim_count) { + OrtValue* out; + Ort::ThrowOnError(api_.KernelContext_GetOutput(context, index, dim_values, dim_count, &out)); + return out; +} + +inline void* CustomOpApi::KernelContext_GetGPUComputeStream(const OrtKernelContext* context) { + void* out; + Ort::ThrowOnError(api_.KernelContext_GetGPUComputeStream(context, &out)); + return out; +} + +inline OrtOpAttr* CustomOpApi::CreateOpAttr(_In_ const char* name, + _In_ const void* data, + _In_ int len, + _In_ OrtOpAttrType type) { + OrtOpAttr* op_attr{}; + Ort::ThrowOnError(api_.CreateOpAttr(name, data, len, type, &op_attr)); + return op_attr; +} + +inline void CustomOpApi::ReleaseOpAttr(_Frees_ptr_opt_ OrtOpAttr* op_attr) { + api_.ReleaseOpAttr(op_attr); +} + +inline OrtOp* CustomOpApi::CreateOp(_In_ const OrtKernelInfo* info, + _In_z_ const char* op_name, + _In_z_ const char* domain, + int version, + _In_reads_(type_constraint_count) const char** type_constraint_names, + _In_reads_(type_constraint_count) const ONNXTensorElementDataType* type_constraint_values, + int type_constraint_count, + _In_reads_(attr_count) const OrtOpAttr* const* attr_values, + int attr_count, + int input_count, + int output_count) { + OrtOp* ort_op{}; + Ort::ThrowOnError(api_.CreateOp(info, op_name, domain, version, type_constraint_names, type_constraint_values, + type_constraint_count, attr_values, attr_count, input_count, output_count, &ort_op)); + return ort_op; +} + +inline void CustomOpApi::InvokeOp(_In_ const OrtKernelContext* context, + _In_ const OrtOp* ort_op, + _In_ const OrtValue* const* input_values, + _In_ int input_count, + _Inout_ OrtValue* const* output_values, + _In_ int output_count) { + Ort::ThrowOnError(api_.InvokeOp(context, ort_op, input_values, input_count, output_values, output_count)); +} + +inline void CustomOpApi::ReleaseOp(_Frees_ptr_opt_ OrtOp* ort_op) { + api_.ReleaseOp(ort_op); +} + +inline OrtKernelInfo* CustomOpApi::CopyKernelInfo(_In_ const OrtKernelInfo* info) { + OrtKernelInfo* info_copy{}; + Ort::ThrowOnError(api_.CopyKernelInfo(info, &info_copy)); + return info_copy; +} + +inline void CustomOpApi::ReleaseKernelInfo(_Frees_ptr_opt_ OrtKernelInfo* info_copy) { + api_.ReleaseKernelInfo(info_copy); +} + +inline std::string GetVersionString() { + return OrtGetApiBase()->GetVersionString(); +} + +inline std::string GetBuildInfoString() { + return GetApi().GetBuildInfoString(); +} + +inline std::vector GetAvailableProviders() { + char** providers; + int len; + + auto release_fn = [&len](char** providers) { + // This should always return nullptr. + ThrowOnError(GetApi().ReleaseAvailableProviders(providers, len)); + }; + + ThrowOnError(GetApi().GetAvailableProviders(&providers, &len)); + std::unique_ptr guard(providers, release_fn); + std::vector available_providers; + available_providers.reserve(static_cast(len)); + for (int i = 0; i < len; ++i) { + available_providers.emplace_back(providers[i]); + } + return available_providers; +} + +template +void CustomOpBase::GetSessionConfigs(std::unordered_map& out, + ConstSessionOptions options) const { + const TOp* derived = static_cast(this); + std::vector keys = derived->GetSessionConfigKeys(); + + out.reserve(keys.size()); + + std::string config_entry_key = detail::MakeCustomOpConfigEntryKey(derived->GetName(), ""); + const size_t prefix_size = config_entry_key.length(); + + for (const auto& key : keys) { + config_entry_key.resize(prefix_size); + config_entry_key.append(key); + out[key] = options.GetConfigEntryOrDefault(config_entry_key.c_str(), ""); + } +} + +} // namespace Ort diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_run_options_config_keys.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_run_options_config_keys.h new file mode 100644 index 0000000..1f5fcd5 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_run_options_config_keys.h @@ -0,0 +1,32 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +#pragma once + +/* + * This file defines RunOptions Config Keys and format of the Config Values. + * + * The Naming Convention for a RunOptions Config Key, + * "[Area][.[SubArea1].[SubArea2]...].[Keyname]" + * Such as "ep.cuda.use_arena" + * The Config Key cannot be empty + * The maximum length of the Config Key is 128 + * + * The string format of a RunOptions Config Value is defined individually for each Config. + * The maximum length of the Config Value is 1024 + */ + +// Key for enabling shrinkages of user listed device memory arenas. +// Expects a list of semi-colon separated key value pairs separated by colon in the following format: +// "device_0:device_id_0;device_1:device_id_1" +// No white-spaces allowed in the provided list string. +// Currently, the only supported devices are : "cpu", "gpu" (case sensitive). +// If "cpu" is included in the list, DisableCpuMemArena() API must not be called (i.e.) arena for cpu should be enabled. +// Example usage: "cpu:0;gpu:0" (or) "gpu:0" +// By default, the value for this key is empty (i.e.) no memory arenas are shrunk +static const char* const kOrtRunOptionsConfigEnableMemoryArenaShrinkage = "memory.enable_memory_arena_shrinkage"; + +// Set to '1' to not synchronize execution providers with CPU at the end of session run. +// Per default it will be set to '0' +// Taking CUDA EP as an example, it omit triggering cudaStreamSynchronize on the compute stream. +static const char* const kOrtRunOptionsConfigDisableSynchronizeExecutionProviders = "disable_synchronize_execution_providers"; diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_session_options_config_keys.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_session_options_config_keys.h new file mode 100644 index 0000000..a457dc7 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/onnxruntime_session_options_config_keys.h @@ -0,0 +1,199 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +#pragma once + +/* + * This file defines SessionOptions Config Keys and format of the Config Values. + * + * The Naming Convention for a SessionOptions Config Key, + * "[Area][.[SubArea1].[SubArea2]...].[Keyname]" + * Such as "ep.cuda.use_arena" + * The Config Key cannot be empty + * The maximum length of the Config Key is 128 + * + * The string format of a SessionOptions Config Value is defined individually for each Config. + * The maximum length of the Config Value is 1024 + */ + +// Key for disable PrePacking, +// If the config value is set to "1" then the prepacking is disabled, otherwise prepacking is enabled (default value) +static const char* const kOrtSessionOptionsConfigDisablePrepacking = "session.disable_prepacking"; + +// A value of "1" means allocators registered in the env will be used. "0" means the allocators created in the session +// will be used. Use this to override the usage of env allocators on a per session level. +static const char* const kOrtSessionOptionsConfigUseEnvAllocators = "session.use_env_allocators"; + +// Set to 'ORT' (case sensitive) to load an ORT format model. +// If unset, model type will default to ONNX unless inferred from filename ('.ort' == ORT format) or bytes to be ORT +static const char* const kOrtSessionOptionsConfigLoadModelFormat = "session.load_model_format"; + +// Set to 'ORT' (case sensitive) to save optimized model in ORT format when SessionOptions.optimized_model_path is set. +// If unset, format will default to ONNX unless optimized_model_filepath ends in '.ort'. +static const char* const kOrtSessionOptionsConfigSaveModelFormat = "session.save_model_format"; + +// If a value is "1", flush-to-zero and denormal-as-zero are applied. The default is "0". +// When multiple sessions are created, a main thread doesn't override changes from succeeding session options, +// but threads in session thread pools follow option changes. +// When ORT runs with OpenMP, the same rule is applied, i.e. the first session option to flush-to-zero and +// denormal-as-zero is only applied to global OpenMP thread pool, which doesn't support per-session thread pool. +// Note that an alternative way not using this option at runtime is to train and export a model without denormals +// and that's recommended because turning this option on may hurt model accuracy. +static const char* const kOrtSessionOptionsConfigSetDenormalAsZero = "session.set_denormal_as_zero"; + +// It controls to run quantization model in QDQ (QuantizelinearDeQuantizelinear) format or not. +// "0": enable. ORT does fusion logic for QDQ format. +// "1": disable. ORT doesn't do fusion logic for QDQ format. +// Its default value is "0" unless the DirectML execution provider is registered, in which case it defaults to "1". +static const char* const kOrtSessionOptionsDisableQuantQDQ = "session.disable_quant_qdq"; + +// It controls whether to enable Double QDQ remover and Identical Children Consolidation +// "0": not to disable. ORT does remove the middle 2 Nodes from a Q->(QD->Q)->QD pairs +// "1": disable. ORT doesn't remove the middle 2 Nodes from a Q->(QD->Q)->QD pairs +// Its default value is "0" +static const char* const kOrtSessionOptionsDisableDoubleQDQRemover = "session.disable_double_qdq_remover"; + +// If set to "1", enables the removal of QuantizeLinear/DequantizeLinear node pairs once all QDQ handling has been +// completed. e.g. If after all QDQ handling has completed and we have -> FloatOp -> Q -> DQ -> FloatOp -> the +// Q -> DQ could potentially be removed. This will provide a performance benefit by avoiding going from float to +// 8-bit and back to float, but could impact accuracy. The impact on accuracy will be model specific and depend on +// other factors like whether the model was created using Quantization Aware Training or Post Training Quantization. +// As such, it's best to test to determine if enabling this works well for your scenario. +// The default value is "0" +// Available since version 1.11. +static const char* const kOrtSessionOptionsEnableQuantQDQCleanup = "session.enable_quant_qdq_cleanup"; + +// Enable or disable gelu approximation in graph optimization. "0": disable; "1": enable. The default is "0". +// GeluApproximation has side effects which may change the inference results. It is disabled by default due to this. +static const char* const kOrtSessionOptionsEnableGeluApproximation = "optimization.enable_gelu_approximation"; + +#ifdef ENABLE_TRAINING +// Specifies a list of op types for memory footprint reduction. +// The value should be a ","-delimited list of pair of +// . +// For example, "Gelu+Cast+:1:0,Dropout+:1:1". +// A valid "subgraph string" should be one subgraph representation output by ORT graph transformations. +// "optimization strategy" currently has valid values: 0 - disabled, 1 - recompute. +// "number of subgraph to apply" is used to control how many subgraphs to apply optimization, to avoid "oversaving" +// the memory. +static const char* const kOrtSessionOptionsMemoryOptimizerEnabler = "optimization.enable_memory_optimizer"; + +// Specifies the level for detecting subgraphs for memory footprint reduction. +// The value should be an integer. The default value is 0. +static const char* const kOrtSessionOptionsMemoryOptimizerProbeLevel = "optimization.enable_memory_probe_recompute_level"; +#endif + +// Enable or disable using device allocator for allocating initialized tensor memory. "1": enable; "0": disable. The default is "0". +// Using device allocators means the memory allocation is made using malloc/new. +static const char* const kOrtSessionOptionsUseDeviceAllocatorForInitializers = "session.use_device_allocator_for_initializers"; + +// Configure whether to allow the inter_op/intra_op threads spinning a number of times before blocking +// "0": thread will block if found no job to run +// "1": default, thread will spin a number of times before blocking +static const char* const kOrtSessionOptionsConfigAllowInterOpSpinning = "session.inter_op.allow_spinning"; +static const char* const kOrtSessionOptionsConfigAllowIntraOpSpinning = "session.intra_op.allow_spinning"; + +// Key for using model bytes directly for ORT format +// If a session is created using an input byte array contains the ORT format model data, +// By default we will copy the model bytes at the time of session creation to ensure the model bytes +// buffer is valid. +// Setting this option to "1" will disable copy the model bytes, and use the model bytes directly. The caller +// has to guarantee that the model bytes are valid until the ORT session using the model bytes is destroyed. +static const char* const kOrtSessionOptionsConfigUseORTModelBytesDirectly = "session.use_ort_model_bytes_directly"; + +/// +/// Key for using the ORT format model flatbuffer bytes directly for initializers. +/// This avoids copying the bytes and reduces peak memory usage during model loading and initialization. +/// Requires `session.use_ort_model_bytes_directly` to be true. +/// If set, the flatbuffer bytes provided when creating the InferenceSession MUST remain valid for the entire +/// duration of the InferenceSession. +/// +static const char* const kOrtSessionOptionsConfigUseORTModelBytesForInitializers = + "session.use_ort_model_bytes_for_initializers"; + +// This should only be specified when exporting an ORT format model for use on a different platform. +// If the ORT format model will be used on ARM platforms set to "1". For other platforms set to "0" +// Available since version 1.11. +static const char* const kOrtSessionOptionsQDQIsInt8Allowed = "session.qdqisint8allowed"; + +// x64 SSE4.1/AVX2/AVX512(with no VNNI) has overflow problem with quantizied matrix multiplication with U8S8. +// To avoid this we need to use slower U8U8 matrix multiplication instead. This option, if +// turned on, use slower U8U8 matrix multiplications. Only effective with AVX2 or AVX512 +// platforms. +static const char* const kOrtSessionOptionsAvx2PrecisionMode = "session.x64quantprecision"; + +// Specifies how minimal build graph optimizations are handled in a full build. +// These optimizations are at the extended level or higher. +// Possible values and their effects are: +// "save": Save runtime optimizations when saving an ORT format model. +// "apply": Only apply optimizations available in a minimal build. +// ""/: Apply optimizations available in a full build. +// Available since version 1.11. +static const char* const kOrtSessionOptionsConfigMinimalBuildOptimizations = + "optimization.minimal_build_optimizations"; + +// Note: The options specific to an EP should be specified prior to appending that EP to the session options object in +// order for them to take effect. + +// Specifies a list of stop op types. Nodes of a type in the stop op types and nodes downstream from them will not be +// run by the NNAPI EP. +// The value should be a ","-delimited list of op types. For example, "Add,Sub". +// If not specified, the default set of stop ops is used. To specify an empty stop ops types list and disable stop op +// exclusion, set the value to "". +static const char* const kOrtSessionOptionsConfigNnapiEpPartitioningStopOps = "ep.nnapi.partitioning_stop_ops"; + +// Enabling dynamic block-sizing for multithreading. +// With a positive value, thread pool will split a task of N iterations to blocks of size starting from: +// N / (num_of_threads * dynamic_block_base) +// As execution progresses, the size will decrease according to the diminishing residual of N, +// meaning the task will be distributed in smaller granularity for better parallelism. +// For some models, it helps to reduce the variance of E2E inference latency and boost performance. +// The feature will not function by default, specify any positive integer, e.g. "4", to enable it. +// Available since version 1.11. +static const char* const kOrtSessionOptionsConfigDynamicBlockBase = "session.dynamic_block_base"; + +// This option allows to decrease CPU usage between infrequent +// requests and forces any TP threads spinning stop immediately when the last of +// concurrent Run() call returns. +// Spinning is restarted on the next Run() call. +// Applies only to internal thread-pools +static const char* const kOrtSessionOptionsConfigForceSpinningStop = "session.force_spinning_stop"; + +// "1": all inconsistencies encountered during shape and type inference +// will result in failures. +// "0": in some cases warnings will be logged but processing will continue. The default. +// May be useful to expose bugs in models. +static const char* const kOrtSessionOptionsConfigStrictShapeTypeInference = "session.strict_shape_type_inference"; + +// The file saves configuration for partitioning node among logic streams +static const char* const kNodePartitionConfigFile = "session.node_partition_config_file"; + +// This Option allows setting affinities for intra op threads. +// Affinity string follows format: +// logical_processor_id,logical_processor_id;logical_processor_id,logical_processor_id +// Semicolon isolates configurations among threads, while comma split processors where ith thread expected to attach to. +// e.g.1,2,3;4,5 +// specifies affinities for two threads, with the 1st thread attach to the 1st, 2nd, and 3rd processor, and 2nd thread to the 4th and 5th. +// To ease the configuration, an "interval" is also allowed: +// e.g. 1-8;8-16;17-24 +// orders that the 1st thread runs on first eight processors, 2nd thread runs on next eight processors, and so forth. +// Note: +// 1. Once set, the number of thread affinities must equal to intra_op_num_threads - 1, since ort does not set affinity on the main thread which +// is started and managed by the calling app; +// 2. For windows, ort will infer the group id from a logical processor id, for example, assuming there are two groups with each has 64 logical processors, +// an id of 64 will be inferred as the last processor of the 1st group, while 65 will be interpreted as the 1st processor of the second group. +// Hence 64-65 is an invalid configuration, because a windows thread cannot be attached to processors across group boundary. +static const char* const kOrtSessionOptionsConfigIntraOpThreadAffinities = "session.intra_op_thread_affinities"; + +// This option will dump out the model to assist debugging any issues with layout transformation, +// and is primarily intended for developer usage. It is only relevant if an execution provider that requests +// NHWC layout is enabled such as NNAPI, XNNPACK or QNN. +// +// Default is off. Set to "1" to enable. +// +// If modified by layout transformation the model will be dumped after these steps: +// 1) insertion of the layout transformation Transpose nodes +// 2) after those are optimized using the transpose optimizer, +// 3) after the L1 transformers are applied to the updated graph. +// The model will be saved to filename post_layout_transform_step_.onnx. +static const char* const kDebugLayoutTransformation = "session.debug_layout_transformation"; diff --git a/Lib/OnnxRuntimeDmlProvider/build/native/include/provider_options.h b/Lib/OnnxRuntimeDmlProvider/build/native/include/provider_options.h new file mode 100644 index 0000000..aab13e8 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/native/include/provider_options.h @@ -0,0 +1,18 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. + +#pragma once + +#include +#include +#include + +namespace onnxruntime { + +// data types for execution provider options + +using ProviderOptions = std::unordered_map; +using ProviderOptionsVector = std::vector; +using ProviderOptionsMap = std::unordered_map; + +} // namespace onnxruntime diff --git a/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.props b/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.props new file mode 100644 index 0000000..9376d98 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.props @@ -0,0 +1,179 @@ + + + + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x86/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + x86 + arm64 + arm + $(Platform) + + + + $(MSBuildThisFileDirectory)..\..\runtimes\win-$(EnginePlatform)\native\onnxruntime.dll + + + + + true + true + true + + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + onnxruntime_providers_cuda.dll + PreserveNewest + false + + + onnxruntime_providers_dnnl.dll + PreserveNewest + false + + + onnxruntime_providers_tensorrt.dll + PreserveNewest + false + + + onnxruntime_providers_openvino.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + diff --git a/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.targets b/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.targets new file mode 100644 index 0000000..5702bc6 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/netstandard1.1/Microsoft.ML.OnnxRuntime.DirectML.targets @@ -0,0 +1,17 @@ + + + + + + + diff --git a/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.props b/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.props new file mode 100644 index 0000000..9376d98 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.props @@ -0,0 +1,179 @@ + + + + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + $(MSBuildThisFileDirectory)../../build/native/include/;%(AdditionalIncludeDirectories) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-arm/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x64/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + + $(MSBuildThisFileDirectory)../../runtimes/win-x86/native/onnxruntime.lib;%(AdditionalDependencies) + + + + + x86 + arm64 + arm + $(Platform) + + + + $(MSBuildThisFileDirectory)..\..\runtimes\win-$(EnginePlatform)\native\onnxruntime.dll + + + + + true + true + true + + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + onnxruntime_providers_cuda.dll + PreserveNewest + false + + + onnxruntime_providers_dnnl.dll + PreserveNewest + false + + + onnxruntime_providers_tensorrt.dll + PreserveNewest + false + + + onnxruntime_providers_openvino.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + onnxruntime_providers_shared.dll + PreserveNewest + false + + + + + onnxruntime.dll + PreserveNewest + false + + + dnnl.dll + PreserveNewest + false + + + mklml.dll + PreserveNewest + false + + + libiomp5md.dll + PreserveNewest + false + + + diff --git a/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.targets b/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.targets new file mode 100644 index 0000000..5702bc6 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/build/netstandard2.0/Microsoft.ML.OnnxRuntime.DirectML.targets @@ -0,0 +1,17 @@ + + + + + + + diff --git a/Lib/OnnxRuntimeDmlProvider/package/services/metadata/core-properties/c7795757db2346b9bcfb932f99cdb33f.psmdcp b/Lib/OnnxRuntimeDmlProvider/package/services/metadata/core-properties/c7795757db2346b9bcfb932f99cdb33f.psmdcp new file mode 100644 index 0000000..8f181b2 --- /dev/null +++ b/Lib/OnnxRuntimeDmlProvider/package/services/metadata/core-properties/c7795757db2346b9bcfb932f99cdb33f.psmdcp @@ -0,0 +1,9 @@ + + + Microsoft + This package contains native shared library artifacts for all supported platforms of ONNX Runtime. + Microsoft.ML.OnnxRuntime.DirectML + 1.15.0 + native ONNX ONNXRuntime-Training Learning-on-The-Edge On-Device-Training MachineLearning + NuGet, Version=5.7.0.7, Culture=neutral, PublicKeyToken=31bf3856ad364e35;Microsoft Windows NT 10.0.20348.0;.NET Framework 4.7.2 + \ No newline at end of file diff --git a/Lib/OnnxRuntimeDmlProvider/runtimes/win-arm/native/onnxruntime.dll b/Lib/OnnxRuntimeDmlProvider/runtimes/win-arm/native/onnxruntime.dll new file mode 100644 index 0000000000000000000000000000000000000000..8975dab3c37406688d9ae3a92dabfa86a76d1ce1 GIT binary patch literal 10488240 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

%Jra^xPl+b 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±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∾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≤SvInqd+@VeKOE_xST59eN>L< zYT;=)(0O5%*7@Snzhq3XooVN4rdsQuhkYUJb?f$t4Oe!C2A`+@YdrOp4d7&~eN(OJ zh{`=BW%gJtpBEA4e%_!j`8a4xM&S9Ei?rf6Zj4opykBG5UMj-5(z~;0l4WPny_Q3W zAcB7F3P|2Qz6)h8r{F7JpuJ>fZqq??u*v7yqrB$bC~ii~A;Qs{D;5r12Yb zNXs`bg;aeL6;k%ix{&T~+Csv=ML z4SmzCtE_)P{uTu`VkcmOJK*I38+G?z$j@H?KKz34SDnL01IsTlOLXri(2L&Y<(ZEG zkBKrz38eZevUX%^!E$hYHHy|EdcmChpMDo?A`9JV|=6_F=`2U!D6Ywai ztbe$ww{#XlLjvinbkYel1ht`2BS9y0k|HcKqJV>>PBKh6HEQ-5MS=C(z7wC^(@XHccEj!uHQnuUJdBAalu^H9G5 zlrq%02*^Z=`9H(`rSrytA|J1tCR#}ML$!u?+jMvt@G{~RgI640!|=NJ8Y0q=tApgj zBFgqFa#m`!grgip!7Tpowwduh1+O$m^KI|8nQqw8nLcO}5`6-pJi()1hyMS0n`ttB z37%PpUyq$keX-#;6Y!dd*QI#b@tO>bmB+rLvma7(4J6Z6z66r?-9Wy1ARmvB$HGz? ziLM?ar!xx<;k3i(>V0?6y{2xBH4P}WeU)1a>9et$$7j8VB9_!|hPph(51bSKduG5k zr>-s4psT4gyUDISM*eOup;W?WzD}?#rPjXb3iIPJ@)uoH9RWPqngyGhilOl_T+lvc z|InMDlc0S}@_s8p_LsVC1;E0;U*q%L>Dmu0AcK3~J-P`$P@ znyUovY00+_m9p)E&UeqyG~{#I&ipMRkR4;>m54B~vB-Y?yqslY3&`)>3Cx# z#(}lWL%i)FWyWAAjtJktUgg_`Y_f$7`;^J#zbAc^&D;L-<_zA0@xSt5<|ff-wJo12 zU-ukh;~j_b=6v}Hq@7P_#AEsOx~}K$#E74fd_Tj8bzP&Yb-w<=tEIc$^=!-%8#B+w zY!lvY)0bb0G54H981q$J$2$VqBYP{I0kf|^3oukh^rfbB3*~tg?8d8Y+u3`uwLj9EtWCzlgN0w z@ovnd-XJ7eCrbHcW2{reDrsd|V&+}qF6o-mJ&@Zv#ax#IJ`Ts-A1eL5_eok>Cyfp^ z)FedY9#brSvY>tf3o2f!1vQ7V|D2-iKXWaacHy9i^*@&n39A5W_6C0~aImO5R#R9! z?<9Cfrn-ww*u{ooRHRtP`F8m~ZyR}D)wwyLs&jMBuR50t`K&y@ipwlUewF=Y=o6kX z4Lb1WzHcCTP2*lu7WLU1`zs@*kTG&Dq9Y=ukTHn=-|PIWWq;Lu5>=fm!CD>khx=@l zdE-7=JN(Ko4@z~X3%XN7*bT0>q(hAkr{{8(+kqqLLu^bOaEQI-q!}QaOQ6LKeyZ2L z)g7qS9#MIZ>hPUkc@MSP?FB*xkcw!@x>*S77}NsQ?qk*7|4j>2>%Bn8#xD48LL&rX z!h`3`K4s&;?$CZ%1)0h0AmsUD!c}6j#94UciO{Y(fm}SPEc3(w)s$ZX%aVc5ozQZ^ zZ-Rv&kNX?qkp`9`8%o*R7-63FS*HnEMsAjZc^*jes+-}*s^oD;lu^C?6$4APtrLZT zGA?J}RV zQuFm0-Zx33yOgs|pc4o(_i>DsGODC|-YQOLp}cw*TEganYB!=UxSK0LPLYp$w5@nw zcf_B~4J_@ipeKKhSXo$)S~buG->{GNnTAJu&=YQ~&t%|yi9NyIjYhtCtLJ)DR2=Iw z8q$taO~v$dP5Ose6}3*K5w#?PmN;730^o_Mwjx!O9M7s%4lL~}<5>;D(a2Sw;6X)Xz?i(hBk1C=gqsB}p+8T)S4!pp4Q%cKFsm&_G3@)<2(djb`gqNV=H zl(lf9_5Pi{Fa@-=is2Yk-ZKO)Yl*!>Ffa+`wK6*Yp@oPg9UEAbyl5XLIK)}VvP>3A z)p}&h#(N!)yRs$3xn~*R5g@CjLmH15eG@D`u>CO&xb`{+EPdNyk#bNjrHOnN?;9M# z=|kMlc#A)=FMtV^QrS7H^C?a0Ig2y+2mgir&%E!}=Ai#sBgG=;)`fLsiMP@zPTBHq z@#~r|exBC%;%mWkT|IBsfoAmrRo+Ztb5C_Qt13cuH^+_%<)6X4kIe&(5PeJ%_F;`H z%ZR758kH(v4`gS%L(sF?y&7^9&2BurU&~$V1S8JyE2NT+C)iBuq3z}Vhnd!6rYYl1 zE@pTiygQ3@_y#tIo3G1d^IWaTRp;54JXC_L0h5sN%>+rep?7XmF6_jMq=m_|I*d5M zZqjNpsqgf=3xADjv$Q_Z>U{NsLd>yx;ZvXrHajgxLB+S>_fff0a{73&QrhGk?J+_c zs6p)6IZy7rE8Xo_jT$7lAKNt=q@F0P0dmSRtDy}%-G!}`_% zrMv>YcA?iQRjmasBv#T$ROv8Abh2uPv&7ZX8u2lfnUTg8>=Vu1)|3~V+N1N#mAGnO zn|y+_r%lf26Pui2&B@?92-}i_a#&p8qZ}hGYqfme)W(srinJ;c`UF;WmE37d8kn&L z6WJPM$hW^5Ij%z&jcYU;*LGJpz934Q%xB2gN8k-Ib*b!cAaWNP~O$&;jy zmG~bW=_PG`;EF7)r8Edlhu-{x~fi{$Z`hUo{ zY=0o_dFKbLzj&4@KnqxzR|b!?ahs2{X?7m*o9Ygp@jn^lCqx4d%+(~;gILVbJbz9B z)g*}WwXn(@SpV)x60Q8RPH$)~Kx1h4vB4mXIY49YfX3bl(HNa-+Q6Bq@jb9Vc!mY} z%>;?doF^rVCduyBVFzc(zwfpn64&2i!zbc<8S;a#1lLqAKx1g+#s+D1y!1F`GVNp~ zXq93^qI|o0PQi1oJyr+5d4_x&{O>WKSu@M4qvjRKkZ&fhJfr0Cl2^JXt>jA7{cbS_ zXqofA0n0T}azkk3v0qh(&qR5mH-MRL$+WXG#~qvX#c8) zALhs(NRNqc!Ok4(dSBGIw52hne8a1#;~AW{|HLaTj8|sJp01z9D|Nm96JEIq(L^e* z+};1vc%{0|uz#iK1rO{>^%B{@p8w9o>`G(@BfHq7@41v3*v0z4f0OKCvn=wrzMws9 zJM2kmg4eaxsXdViYZ343hsI$CZzsD}x{y=5gXr zoJXdvK>3RYofqi(%E8Xr~C>~`>?%qVujCS zoj@|nW>ib!V7ItQt7np&*^M)*oaSLxM+uXXUMvrKW!T(Aoax@GQ;-$Dyhv7n_5+>8 z1l(nuXI96zkb`g1o~a^Pi?eCJz*UaTvqhclpp1|R88NxZT4;P-mxUaVS!b$NxUIsh zj^mK>Zqj8-bu;ps+N$_0TB-UT8+`WYPoNETWa?jLPhb+$tIDduH4R_2#TQ2*qv*)w z%IP0L3hAp_)5yc7EH%#RIK%qpuX3qUY_n;LUy72aY4R73*s^l57N>Mn3ssWWh<&aU zv9IE>loXNM0vjIe0}hej0vuuHa>ko94lVZ60>TaZ-VA=^S=}?kEb~ z5$rQ~5W|YTs!SMsupvt5cX9GGeYW(KKd)}1u*>-r`fhC5kJ;3>9H>ldY62FbT;_~@ zRke+XKZ3qr-FRa=a`>`)Vlm@B;AC#%{Z+GsXsJ-3X!*4>S`p*^Nno^^muM|E0xQe= z9`kEL=Y$Bzor5Z$&y7hE+u5ArK^!VYDY zOz!;3Gzmzt>}%VJl|Wj(BxQ-r8MrO` zy?U%BcS_}L%Oh$H9c@BQl`J3knRLo_%JxmF<$z@6?lD~wWtd9yS6XkkXI2#dUBgfu%X zL3|1_+~wb#00uFk2{dE84DaK(XpE0`Qgq7+wv)($pMqaaw9{@n0sqlT(B@%AoA@pB z2h*<$V9_7G>eszB{#az3&M(hj439VPeXzUOFT7s^?UFN26`lCa_ee`ZR?8%Le0-8@ zi@|Qa6<4Rf?2J9SJS~4QvLk8<6_a1-C`zfmxjMgce(U3@JWz2T*BFp#d6sXu<}qj= zal*Y~?C}@83t-crPx|9}?*iR6=K<07dZHkvX+0V8%#Ip?Rl_vG-v1}lB}vCj)_T%h zawzBCw93g?kxbCQZ@Z>SMz2B3W!_i~Y?5H~8!Q=eQAb=WhZ#%k(2 zjiXRNHntiX4UG|_xgNjJY1f%1(D_BbrgzDBhx)IupJby-PcC%axrwv`F~3|4=r&p| z;6L&kTkB?^TDR?zmi&r&#aFc4SB2keOcS|dQ!7_iY)Z+mLMFR}$DMhsJv&EN@+udl z+?2)__PSQ6?cr*yt?2ut zyvlpwi?-|Nd!4W)C9Q~?IQ*+w9j$Er7iWM1Om#P~vtlCu)x8xmTFa~aqu+)cZ2Ohc ze)?n@uQ@goQrMs50%0_0d2;}bpmJ2~Z^r#0)45Wlso0mPQbG}IBS%duNXBOtE2h7H z=~DG_+R^a1g2QTCFvmEZ=&rQTRnmQ755~7D|4`3gYCjJ9;eEFkF}$_TQAbBm3!agF ze%f|td`mmH)FSK(+U<)nC_(}DlI#SLyud5gwpGn+r0>Rh>MLi1{?+lf?xvAbPrNPP zyTBQEhx9lqRGg6>@=q(!;=SIJd#kr11-8nBqRLx&a0@=mA|!)jq=?k6+W!@-r{~Yd zt4eS0Qw{Opb<|IN3uhUDx$7sN_1avtxZa&xsm|0eSUBc0YnNIt+5n_H-TO~=ueXZJ zy#+lYzNMa!#J4mNd}~ML^4;s2%-})0*s8X%v!6!A)BGCL)?R0={oZf3>*}?&rg}V+ zQLLucSkKpHOZs}Qc9@*3HSE-bcCiAWTb)O18`JV^kD2qF)@?EFd_HA_2dEoJa@;uD zaluo-TQwCl&u1EU)XjLrX=vfC5BaaQ>$ezo);c$`HKy_Wj`cv5o!_Xkfz#hyh&{t> zd|?}0WiV5iAW>@l;i%yH(PK=IIkQPp81&Pci0#>^ z(rq)_8RuI$P~y|Tc4kZGeF;53#c~$>ZKUNaENcz}%3+r?%k#d{-=7QZ+X|~$nN%*; zOBLcaX*>KiJH@|Cr{J?`2Ljw$TIrflTIMPT=BA=_n`?Wi*R>O9@KdGjr6lzQ<;I}p zmMlAzA6?^!LwyCH*2m^qpjln zbr8KE=Eb1`(r*V6ef;njWsx&@c4Vf@3lw@E+27#()wsV~xw2QizZ&=N!~Iv|{_2SP z)!iGOL!3aukn+wT{R*?}S%}|Q6;%$Vr-b_>q5ZSUxFNND3GFxF-eG88ifI3mw%5QX z&9Hpa{E-brBY{(auRL41;0JAhWC47Q(d8iMl5FOxRrerl=A2`^7%Qz47D=&1&sE;w z{$W(_td2Pew8Lz`Mi8g7Eu;Pq2JEasy=IE^q5E!Wm($>}pcd)S;KC`poINd5P)mpG zHeZ;cSlr3NEN!1gPM2SR-q<_(4ch%U@8+h5isYld4|AZJ;Q0(+dAnml5J=MGMQKlK6)Y9zAOGnL)ku)Byuekp;7Z4o9yMVDlYpH)?zxc(_E~kPu zxl8;-D?k3{_ziLtGOP2k=H`lx7{LaNKwF(vxmql(d{cZ7BRGr^tf(;AS6~E$h=6Aq zgA|#;(CTPg~pxDXAlp`E>c=u9sw9 z6E$Hv^Ks}B(+cqKQmjUSRmuc1?IyIcZ@?nuVdqo>ea~^m%<;6Qz-fMg%4r-ImzhbQ zVPy+umQ9xzu?&SeWGF=bTHIsK9M0~sNF~floi5KpUI7l4H6vX|K)ppsmkYY$8eUPZ zWKsKJ`TL=U^}t5x1^(&z#o88=>XCS|Qu-bzijn)MO>;##{0pb>bnaN4^n&Ys)cUJ; zX$w%zA^HZt!@eEfpld_9o8S|zK7cAK{8;EHV{?QZOS54wNS8HTUe^B|zyhSpeaycs z!dm)vn_+V9o#}GNIsVyt$S?Kc?M?HGziJ`>-Xtq$@ z4?F??>+JK33q4=?b?X>jgJH(ieopB-fm2_*Sz7>mm=V^>AMDxQbCErJ`J$e^cn%&u z`=X5Z@b?Dv?aLPUnlI>;X7l`F*e0_Mww&MFpnXy=fiqn3bPs2zDABwxs-*E!xuLMV zCE;Y@9qpftj4jM6w6+`g-G$e+YqT*f1=f?M^deviHHCryGC z9dT-uafnffbpj~lo6aDG{I2PM6Wmqvbqhr`^B!Qv3V@%Bpc49?sDuz@L?!QoN)9-G zMpROFA(dqIei5b;)DzLwT-+;dpjXd#sp5GhI<^#_6 zKpk(koc}%TLDl|uSb{A^V`bX82hv-XcnH$lAtt@4ewS+IV|qoIGw?)%UZ}6+a&G|d zz8XB~de6VNjZK54rie+rJ1RBx@FUm8)$0PXt_WFo7-ZcEpbU~+c?)rfvC!G85nVyw zXtwBfKF6frMv{KVo-h4QX40(j)*HkzF)j&6?u&nRk- z(GjMD_Y@%yBjGXVok@2B*t@BsDVIM6WXw9~TZNk;xunS_l+9$B$RbMF*{Jgww1(VC z9uv-=ei&D?n%Ux6I*g!FI6V`%)>Lp z+=>{%`1)iaMa-=vYmObdFqcKYARAVONQg`1$+y;*pDhn)1`N>?Tw`F!?jkM3APj>~ z8&X`MEqzjYBjon|$b!-et!5FlnnVtD4|oT(1o(fZ(0zJGy8IIEuwdO6X<>_nUO+l; zaNp{L?d((|RA0Kh4jFPHy`bsxBXSUnt@@D?Fuw+mr;SHWFygZ5@;!vc2+7o=z+rbm z_a=Gt)gDzIRb_7a{X(lzK;~&#{pF4BFb$u7zD)iP=Zg{N%NM3XX;e}0Z29JNX~fxb z{oY9$TQm^g<8Cp|ZE9puPDRJXXxg?$`tyYs9# zy*T}-5h!Z2e`8bbz0Dy+L$mlh$o5+$LS0d=K*UQjv=ndCx2SlCZ%(JlzwEZb+Wm_1 z5oy@5grcB1QTNs>$}7DaLi>wz=!NLIeGBws#?72FXYMr%fp4(9i~4fu@`*^E%dEs)>?P^4eI8pp%Yn&xrUIl+QzROw-sg$#t18v;n z3$$P-I?#xk>Nl`QLTLKZnCdHAE%jGDDiy#+kz(eMx%O7{#wxCmr$~Ck!N`@@Ea4dy5 zgm3M3?=elI6#g8v>Rr+{2p^0sc9p=dbIUcq<~p9LnVnGxy_n{pSULnv2sz<slat6p?(~dKzua^}^n#qMBcdXrbPDy##4?e47V>rhwYC5B&f-kZQYo^vNXcrOtKPNQdA21(9^b*)&a{Y-c)x1n zZZx39WN{W+oGn(P#b-{dPf15CRH9fJdJ4y$^2lju?N3hcD47d-=hEc1PQnC5+GA9t z&8aG?60`u zpJY^P@T3iTB=ZEXvJaRXhNT0qR%JFFWP*?TXLNAobT*K!iFOImpo-&CPj;32O_cVy zZwFc=tl17K-wf@6W;;=;XVwPN7SoXbkF$aYIO@?>KWi&!JE4<7l@vI~E@xCoLmpHP zG7Xt5CSm$F2+*V_#|fXOkX2x-(|mj@oylw;T6nD|O}2Ey7llj;xR0NJoxRm>6{e1$ znM0jRio96cq-^%9xUr!8k8C$39)H}r)dIKSO+*@9LlZf{4-8}dO zs1F!ZlTOeGnjNX~wH=!0@SO$U&FvhcZP$QLMQL=t2Xv;QT?>j9KobB$75=cTTJJmB z6cKtFw@`c_?b>1^@UJZ`(V-pro+cAHff@%?O)z-28-xxia@T%@xaxnmXS;mhBHD7c zZ}n{7s=IbYVAlpe1>66>Ia}X?-u7c>D_#4cvz5NT@N5n8jXQ)*j0%EOMLCT&Ttr!W z1}~;8C#0>I1klzRqc=K%=xY#ON|lEjg%R*tawTc&1`>};ivCs?`W4%B$ZdW5*b0_nh!|*@IdISWSJXJ z=Q;DiH6Xr#Z}Fm5*g@%PSUuC_bDe~ehLnJv6^zv`44Um4#$wopNrf&Qd#6J*TP!$IRLgkm|8)6p6qRnFQ-x=LRg7-%MAJ3AuDle& zybhqoq6vBp=7=EyNM6fe`b%-g8T9cMSmC+a;tu0-de7HZ3j9l2-|vBiJa{I9bRA}0 z->cj{_)I_^A+8ng$dbrzGE5lRZX6!vDVLC`#kdld;%kIvF{;&?o?nX3rSXUuMNEMq z{;zbV$G@?^;%VpQCx9=2HFTr{+1PI-31%Lr#x3QS-{C7Ld=`>8;$Q~Jqp11_cW|`p za}e=|T|aguEO|w+yQ76$d0+bw^3kFXdYmgHnWh2%ZxUF{#f#!-%y1gb@S|bg zhhIRJ<#9%Et(oaJ8MVGcl+~8Wx6}&7LsCnIbE^Kzr3&EVZ%54~fy!-{$q`I9-@ogN*|@3YD)cwgnQ6K@}Kq|kkc@3R?CtVUED zXCa-&oIa$yFoapOtVwQdq&xNxy=}hIL)f0P%6$BOjt4Pe$cLTFe*ZXrKk|ewYc=W5 zp%!X}3f!dM7DK#psf*TEAfK1 zqJ|ctE!{+Ype^f|3tJ-IquS=<1@2P4FcYUYjcg}YPzbEgKk>c*>vL8q9`d;-N_^@F zpB8kO`#^njg`}G>`9#8)P0q`X4=Mi|B%O4lbNo?l`a*N9Gw0|rpn$WE&&$~89CO@y zv$x5>Bn8fQy?>wE$X5T=!F8C+@09O)b?nK%#GKlI5BXlXx8LSg?UOW*&;i-sOWJ-1 zK46X|Z|BISb-)_TZZv^@-((fbb(v?CntsBBo>jhu&D5Cr7r#zSO{p(U6F+U!BSQ6P zO0Me@^I7H7zIGSCU4f`5Fc6!#u) z432Qwzz#OT&H=NVu3gzHfhVXVEFZ{Y*P;gZxvkQhDe4}uK5(juW;2=1=4j03(t(2F zkw*`4sp+-Ocs84{$F~D9O1vRYYEqW=KkR(wN9N&C#z&WcHm(I8q)GWDX5!cIP;s+# zInlBX9DXgEhx~ze&E$zn}>(aqmF@onukLH z>KKiAIG;M^G3pq{#*>Zl=m+K&TR#5LK!TtR-4x1Sw2tZddr^<& zr3m{9*-wnDvT2%J*h%l3QG>0xJC0@fq0dK@yAjp7)j_S(=Va-KQZ-oEy)O`VOLr_r zW}ba^x=NnGA!Q2kIK{#L*sL7GJF<6tG=wNINF>Lg^RHtvU$EaClfPUmjTukvya$+M6kfk?PXhYa(G?%bpg+F!E~OHSDaOd1XxyKaUJvg&>FNCG7}Gv8J3 z))9h#o*h|1??5IU4zqNV78#)+4clO$I{$u>N>`(YEWVcEE+PN*ti|(HODy(O^t&uF zoWJf}=u|PnZg__{WGUK)N)+=`riqKB+@fP`M&xUX1N!iKH;{v<-m%-ec)0Ea{u&6I z37hBG2F$ye8!x=3EbPmFfXn@*$0l9dJ#=p&e!s}2J=eOtAlK|6zgYs>`2#%e)N-T0 zz_bzdA9pcnnnpOc_!7@O84_AObJ`|NlM19V)2xoI4A+5d3Pm-Q*-{hGvH4Piw|sa~ zi@S;19ECQY`!{WBLv4b0Myt=}vJSNwv-A|Zx$b_6{6TbOCVZi@I(D%B%uPm2Q`W{A zsj_&^j&-PG-|mC&cjJuxgmVIVK=uA#7(qn703df;*QecZ+K4rHgJls2o}D`330S&f z(RPfOBU#1EaZW7trJb{5#Z%=5AorP_iTw@hLF@g0>596a;)TgiO7xP{RaebrZiGKS z&XFd6DAQ++&yT7%b=8?ziGw{Qff_m*A3tOe(&U|88evvREOe*6iq8LTTM-Y8LOD@T zQrFsLNnKB{j7SBI6kB^l8Ae&(5Ec3^^2n8R%w;99@4euDiE zhA!cCWiBj$)vykd1yF?i{h*A9!o@`I#ocz6hZxUVo()WYQrFpP?sa%h5M7vG8ikCn zcvtgk&v9gTI(uiTdvcHFXIySy3qCDBmU5E`|07GqYsxtPRgjHdQ)Xj~9NW1Xq}^TV zGQxM42PE2!Tq^SafhLiOY+Lm~W6!F|4l=~)z;WCCB(Ar4DZJH6vU z>|D~zw6(@9T&<>FyAv^N;2dN-FyUS`c4&|Cr=h1CxSSX%`e}pUQF21I>4l9mIttLn zBJEOv8}|{cDV0L>(+PjHHj-`{v`X8An3w8iL_ZrPB>eFpcEK1|rSPniu2N)b9()#D zHq~9oq^QN5gy*B5*0nCLXmrkO;l?HW@iTums~?f%X(%=k5(II%!IleH3}5s*yKq=B z_D4UP@H}NwT3%KRoOO219gQ*d&pWeQ@+10^$71IawpN$zflM&Q6;r>}8BJBT?7&|K zVr%!Iufto_?}G8R^qs!-H)Yz^bRoKyo}tGW)sYMf{ysDcyD+L@k1~qZ>G4227hH>C z*VOxX_MXm`;C!DQe7d2fjmzY6XvRNQs^C>qy#XR-e8mMbu6gSJt2zHg-~Zp{d=Y8j zKQiY(XV=s@pTXX#(c9S?HvG5)mEQ;50Y!6mv=6MN4aE6nC${cfot^$31F| z@=26Iidk%gKyE;_l`6C!$4wXZE2qFGs0Uy56$m!a*eQ6BeUH*O8nCb9V)rP29iVXp z`%k=>ezB2GU^ynxe?PJftNnep7hE8szgMFF`yynK%aHjmENKh^|0Q&9h`2tc*V)m( zEIgK^-hyub^zi55tmos=^M?aHuj#X~o#O7}X9%GEfbh#l`SjX&huZPnFG`vB!^{;K{ehooD7 zZ&i+Tpi;YjYE`y$9V){2R-)af`Sr74O@6EMnVx)j8W6(<{_I0spDMFGhQ6xt@>9@P zBWN~NKGdNX4&tmLJ2_(7@Y3OBz{`kNj3c+4&NE>6aZk2nvE)~$$}e>!TW568xp)ho zUpfZYVv*fEOQ4A2Lh*4#5`VyA*0iOwU4^Bwzq?A%-osf7?}0VackR%KL7h3Ce#I=ss0o?gl6CVTf)Qov88 z`A`|(JEP;VP2k21FZiG~>+$03E>qBUiG)D|;& zc6S40gk>7oc&#zJj5{<>>z?8^{8f2=Km-5Hr;yi37hK(bT|#vGv7|eEgAT+*YT%PT zx2;cW)jk!oA!-=}E|z>Lm-jc1vuLR*VB5dY+;FbsGsgMW6r3J`es) zqtOfw4Gs>5E5DMWt$e9vq2q3wKpTbExS${&W!Fv)~;%A*7z2%2z|0Q2k$jm)!tlu@6Rr}ckYkg zJ3e%;%0KofF@67U+Oc0%ZsATpD{kif5ax+ERu~X%DedpV;_bB@aDF8cm za1Z>ccVpm8F<_UO9Ft+~;A2Jte`543hgV~su}^HIvr7jVxz&;044Zr(q~&~MZ87WO zKSVSPZ1VY)`rMgExvYDEuSv}M+;3Z_&$@+!b$!$RTdx)m!X_^k>Mzk8)#qF-YFo)V z|El8c4Ug&!tn;bz4ZdKMPe1JQb2QTh)PZkHd`RPar1xfbwD+(c+0){T?$?w*4lT|w zUd>JHZn>HwG|*c;^2PDUK$t53+~3dl42r#m#vBnVjbAX^{hhGgPfowt z80$eb-B8=EP}}N#x=_m&pNd@y`d?MfTmw$0aSRhu$ZV7qD@?*{-;#3W?1%caQ>-Jj-eW74OOxkJDp|zpYv?-H z09CqADFXh5k8YF#-*(h_uV)r%9nPG%R*m<1-JD|W(K(1^(yilAfAv8&*O&J`81jEE zwCeh_KASs5eh!sUxK`B<3T#cEcHw|%^lDL8)l`S<&vnZXRmJ;$-wPk<$bHC1&(-7# z>wtZvdY!xaV_G%PgLvPtfjglW&%^txkp<8&fLKywv7swf{RKiaJI^lNe?~)i@wRP` zUm85y_9#nw$bLd{Sx}})#Az3nY3e%Y{eI;Sy)(Kuh9r}Bm7|E_P^GHOkW@9Jdsj%- zc^CF)`sH|JZ%jc=m?t8x?7@{dZW5%HTxL&cQgVg{|aViSU}b@ zIw&LS&)uo=e|Pc1h8_+cQ|MMgI8fr zZCsx+t$!s$Yvlp0l_EF6*B+D;@~bI>zD;+Flq%nk*fYvlg}g271cr4ddE<-$*Nf2a zpsTPfPg}9;!WB%f#+9_tH+&}P)PF`+y;&W0)=rY_fy``U(r+*ycY@C_+|)9wgH8LMyl}*S^gWWi!$T&+WH%*FspevZ0M&)O!ZrZ3kH}pv0EFg|H&t(wS z!FLQ#vcMfPNym}Z>s=+LAGMXy-c`Ub{#BXOvl6)>av`JTF8f34ZfWN1&4?zL-m#eB zRZ`@qIvnuga#qo@vNT0r(uG)f`*h*H()~&=qB(%p$uc6BsFfl5==!l0%RgEJw{mxR(;RKoI@5) z`Fm4u_R&?}TVm4Wx=AwTdQr&fwQ>~vgfqx3i6G8UyZitq`y>cqbS2h`~5kd{f1o>;z#1Vjz; zEs3I`bvaPoi8$xxNo$;3%Y5iJxyvR3hZfb)sQ8(7x^w4FP0$Br5bQvU;e?!SO}V!H zlySK^m1F7>WOD zXBX$aJ{$K`A8$X+jf?UgF+ygI2Ri@zN-5u+l79UeZp_Ry=NT>m@f=zle-MJ5!`5SOij(M?{pwYf62e5iv;qPz(~)e@&4W zpNsOoN9XzS7)Y;;VgdN2|H)UC*M?qEjtr_89oi4b$RU`d1X1;z2X#a)d!E}Qafl2- z|6@(k;xsPZByM$f9V4!bXQG9mJk$t3KiR0&^N999jqnuqKzv{iP-eS#m9@RAu?Gsk z9Zmc!cm`e`TIou46VlGH?7`OKexv0M-+e#>NA83;*$AIeGxkD(r4M_dwUdKPrH70# zQy3_{Pi#__4L$$el`&U={>1OmK&H{9jNek(UGOVZ+KMEAT9h5&RMDYti@s4GeL+&wx;vXP82I`X0 z35j`T2-!wO8u-t==98W{!_BywDMzoy!M*`n>SI zC4SfG2tH}?OPdAXI%3!@j;;ww}ePNUM%_n-T|A)@b=AMJZWMBn2e8C;AbJEN=& z_1)w9pZ5JF((NJ5hOz8PkRlE`Ghi`G@!%YZhL)B1f^(Q>;)=NHUD6ZcS?NRZA;dqx z618c$WO6JA7np$a6tT@crppgH|4GqejAMuK>FT`9hGdi>#sL{Rd|cg9%Bqth-yxr3 z5^5cjP$gMpIf4zhjlDBPE|n?MP8)Likxx;TbJRA5NpHJ9Z8K;mN+~H%nI6T7FlY%pC#hg z|MJlozYC1<{CT>#Z^x07KiIcDezAf^`Bz`$48H4&?Asfx^>E+l%q*-(a7QBhSf82Q zyis|kw=Q%RnjO#wwVMi42-<8?D$Nhh~-jh>b31w z*Z`}G>WZgAF5-F4w{bu(yy(3A_=_Qwq7B&OWceuU2&DOJh6bebMkQrIkE1BNW|6SP zeULLA!IN5?&*uHq$<*3aLA#NstYOP+MT4aEXLCW0Ov{bN!00r<~241v8f{ zKdt033O1tRt!Z7d{CnkT7AyRnKc6eW2WHkub;Y5qGR$&oo7d0UK6kB|se z5bK$ZoC)b7?lQfJyXHxSMe{`J8C^|6rMlbc8on8BoG6@fT@vCb$?`|tk>h-)oA^l# zsI!?g=Ww29#`lH^JDgUuHhdf>$LT(4i`S;4)FNMFvb+;H_Tra}U7T6@zVfF*OJ!bW zvRv0)&bYG$oGV%0L|OQ5)A<)x{z;D0)+57W#M!|RAC1c05m^Cr$V1PqgExTiNCkx4 zo>TlwkEb|`v;MPAQP_x>VKYV1fzx#(n!}Uz!PUfE9GkD z6rXIF#OS~sq=TGDIw-Fk%jU;|+I-3K)#!KJ!Uz49xnWM3EKlxMso1bE2h@?BQ3zG+FK3VSRB5B?LX&z(Y;jIt`vEFNYNR}rJw+UDn z@^Qp0nJiG1K|Y%L{jNWI-MylxxUV$LlV=%3JD;+4NGqUr21@&(7u*`r%CDhsPY@24 zr6W>=vr@ITFHXNET@4HgG7^j(FHtl?G-zkJm?4f3XCeE??4nAdn`pX{>EUwj7Dq9v znIe=|UJ)@XyAdyc@vQv0D{@xqy0}aK-V)caTX~xN+96uHFgMFuRFL7aO@33p2CuoO zR9u`w1VVf_iG7U6D?#g55k zYV-{0j^VR1DBqDSSL2|4dW|?tcmr#U^9ebQ99W6vV!hND%9vm2S`HswW$By9NVy94 zneFCDeag&%`bvYGrz@cNyF6qssJTx}mft@IKdG8GckN++Vofkp?mNh@?yaQ!F1c0h z<&@v0vTDL&%I{KNRk4`zyLhX1E~fl0xl7v@M`ca8b$e;$Qe#%dt*1)uA)n^OmP_>; z)qbf)!}lr~uU(wS1R4>tRfJ=4`V?h=vQ?ZPi&Kcqw}&9>{YqSe7}vL@?;rzB1of#r zOWl*p&w=`G!=4l)_oQ?#Kz)$^lI7BK+$EIJS@k!nvQeS*fjhG8r&-(Q^TXnE0e;9@ zxdyESdSf|L4XArL^~zp+1rzljXk7$ac?lvR2E-vQ`Ul-3yPk z8fP2s%b(nJr~{HLe|6q(KVx|U!hI6)>ksj3>XSxeCF6u!n24nS98bn-qlgR^y`)iZd5KMJ{yQbCHwBu3>hooe^iUS z=Rt2sAi^3^85+m*jv{6o<;GqkQl_MRZ0F2HwE)^j*(@6W;#^6#bjs(h?#g-B5mt_N zq?#*fR!0MCgIW**k>TH$SBg4o?&3hEAmoFL>!Upxlx;=_Bn{4y(Wvn{wHR3ibfy^I zyGDOcM%>k(Vt>(j8t?fOCzHxM3DdJxq8b5Y-!6e|ux^F~-Q=KhOD}inDU4c;8&d5U zB;##_g=o02E0jscuiVskVJ4mEh)g=ka(~A{YjmG>Ia#!r-(@-F)FC@SWKNykz!Q_S zq((f^tkMZWb#$U?-}Rf<<&~`$t}8A9Hrs6EvUfnfE`isFTenY{GZ>9?XS(pVGNbP} z>P{bU(q4MJEp}3c^j^xNrni+( zVL8c0J$j1V3+nxp7j(@~wsh{aQC?`obG6a(!svOZ&5=glaa|Lnjor$Fqy>j?47-); ze&Ug8L^S#OX)IL#M_YJ6%qtxYEpsoPK|Zq~W&XgzDGM*}7xy~5TgXSe8yMfh=Zml!w=vqQsXOgAVh?9m}yA~Pu)EE@{ zM6?pzU-c5Q+s2#)E-zqJhE2#4lOor2{bzd`%MDf1udG8pq+ok54K)|J zp*CV?4#_XdbFuHjxwV2kh;on<5BlCsJ-eiBnyQy}*A)VffcmL=;Ng(Ltaea&bijtQ z-;(ZPpH`#l6=%iTaO&rK2X?T}ae>cw4xC}1O@Yr91GZA??=(C^^+oPhw)LsFT*`n- zvN@e!TsB!n%p4DlC)ID_7f!40Q}*@}!nWA6+%=iWVUtmn!BLt}oh$vi_t9R$)e@$5 z8nddm>aYoe9x7j&1o)!~|5Y&tr9w;eu>fApSzAK?hp z`%aujZU$g}N!Hdt;z6HQ#5Eyfr0Qkdr}$w2)xTelahP@a$RCxP z-dqNcf0+i_KRj{F<8S2R-+<0Dc4he{v|zqMtQKTK`Jron&N;S`n-Vz-!L*B#M{KZaz zyoVcj-uGue{?}NA>%hB?`KL-(RlSWGVZ`xG9-=lYq?k_wQF|w#{p7-OW-SEAyy|6< zYvr@?si3gE1n8m^%;{*FQzrewj}!Cn}H?=J86xyMOwh9ZqVVDS}Ku=onc@qXp&KI~4!hg}kgHX6@j zEXJ~EBkS?}n`4_PnuJ=~)py)Y|6kfqkvQ#2>)=LrOyJsch_3n( z{b{TkP>P36`3v#$b8+6U7HZsD$UKl2%4t`t68~Ie1FoCFYU{9X={blqxQlukj5A1K zaRy1~@yl+yPS-AuG^j(yFkR05u#~Ft2H&3k9C^y7f|qia6t{4>HpDqly`pS}K3?C$ znO3-{r7e{dWo!(MCm6lJ3;U26b>oaWcwwmBK543iJk~LYkkDSAHdX8skDg|BgP+i^ zVxLYQ?iX8+EP6IYEa+PA2d^*zSE9?ID?u~>ReKo^gc{AZ8o$7}x~z$eU8rCjnR2zV z%!ik|srpG6MNlG;Ug=`d3QVtJexlvVd_VEx44_1g)DX`i9=Qr9lZty)dE^ta%46@P zOdu>)X3T)fiQiTZ^apw5tBf;F2ep_O24p6<<#>kfeO0jzmN4!-o}T|Wdp@&Z>{b%} zDu1TufA0TqU9b&TmO88U=_GMY<8d*H4*EBnrQ}+IC&KU|!~epSzXgq)!4JE@BEe4^E8?#%4!Yw4lVr4;#6=nZ zg2YO?fGV%Lac2DI`TW+W&gW5oa4gBxUmzoH(x_ueKyQO%i4D!`V%BS#*ZTv#{>=c* zt6RB0go9Ug5?IB+&1U%zNq^t%@Q<`7_)3N&QzUo=v}*M)`3l(?=~k{E`uAt#6M_ET z8|v?yeWCSdD4$7K^--*MbVgnp=$&nV&Pca%DfJGRxN4mLaj}oU{$NEc)J;ZyJ>kT( zh)m~dw@VsCq;s`V)}=r<#($*S5&y8LblJcN?X#b zViXWi)oTe)%-$he%wG=%^(~UOxWeb0I>B~4d=h?wXp3!Lt&#H`>yHw~xXto==Twx| zrA4T-}RAF%~t-)&)5qqBzEu2t=Dyndk^`JuA!R zW)=u$dGk4jA=${~9*3QmGQMNInEbT10a<6H;Suw<9P`(R`Ey|YG}bDbzYl}+ca^Z& z8Sl|;g?^^jdEe%c3x5b`X}sH#<`9jTJKtLJBjbO}oSWgOe#$zU17FpuE5^0jeE;lrS$vn03GVdxKOf8nC1g0-5NSbg>y7Tj!Bg zFjg#-jKXZpS+HI8dSSPx`p2H9X6udJS}ctLrXPEV#huwu`5;?b3%Md@O96J#RAI*q zLa+=Xo*?pH@c9!9|K0O5-BeYFD>2I_c8B{$?F8rJ3Db}DFJK2vj}v@Kb|9KH+=Jly z&0tyn7HNm2>(XPzVIK~An{;P7Luh_7-Eo2EZ~BqvfBU2Bq4Ec}Qh}U@!TPk634{ZB z7CAFU@~8l`4psoN@>9h+vhwd&?&wF34QsQ=cQu#uUHi+XOrq1trz~UV&a2AGo^?$H z9jS$g54@gmeq624P5J6rj4jVumiTU0nx$MZvGo9~katB`^vv>=9h76!BEWtI>zi4= z3>eB>@ls&5^f(u?0#*lgj)LoRbBI1>!=h;v9uLrndcClF!;jL3dIl4AJXq_2Y&r~s zSq5uZncZ3}<*z0!yhgBF%<^AlE9!{0GXHA+t(RF>-fETd7E_&6Eh1x}jq!!Zma+yp zwGSbmwidax3rn}7uKg+3p;GG;+6OoIvrx%C%g$MAmXQFLX}s_rPmPzD-Wz zC&U1+r<;WN;`uE29?x+$WTVXHV8QRJWIj%KP0aE(8EXLlZy#bg9zn+8mCUc22fwOW z-XO1JyEza3K(qXNnJ_{aPxXD(Eq>jUwGuqcT{UI!XlCVOA8Km(by#W5Y=Q6E2|M&C z-&~q!m&bfRPA~WQ zBI)IB-w)DDIq1cT3M}inb+d#ilZZ~{cH0GWh)#m^u_v^C7xHU${SUKRexEDl1J|D0 zu*?G4Wtva5d8^lpShl9HeLPvdrsHD!xO%Tnnu0n4?{$8IN_W&!5^E{QdsVw62fO6| zja4#;Z9yI*!41i9;&FHA%zjTf*9-3;%W|!H7?R{qQCSaCAL=pgMV_<0AuPdPI3x0K zB+2!tg~xHZW|9fvQy|Y$=o9i9^&t)lh=AZ29&U)0f>BVK+S!ukCGIJ0Ei8;XKES=4 zWWfBBeNv@O;#ED@T8@p5TY<8n#cxJP=?nT~vGsYm~e_}g+Zj{R1cS_g0Yn{fUW(Rr1%~v*xM~c4!Ce!!$0p**X!M}y^@MJkwEo5XfPK4+9 zx8)onN%lIkj%G<6Zc%D=zaTy4Ogg>_8GQ8KVpxF=L6SVuYn2v3GMtkb&jI8^IH2spYiAG3sK!v`G!Lp>)QwoPVE#<<>%}8B=21blll}C_80=S( zY-0J9h>EGZg`-HAXPxi1nRebU@+bBvQqTEOFiG;U?r;J7D43 zk_IUfQ8IZ_BF?*=O#2Rx{~14>Rgsp$tHh92Ek5PMz+IXWDqol za>Vci#{VlWb2dh_^EpJN>`~hNVVx&v{Y#SPMU4L{>355D-lAxu_dP@tB|eN=SkT?( zV6>F+v1A|%7QI8tKZh>1;U&p4yUB*PB@I@*yq6Kz@*X!DW6Wb?B)eUBoLPRVzeM9C zX(Ud~OBRE*MqE*3Ub3ryC@+~l{-Y$8mrTt_W2l%-{AR0@_ckao==jW>mqqRdci-+zHuEvEsj=T>yqT!uCNA^ zBtM~M=bx8T{X_D4+K-%f!E-bCzsldabdq-erPRUytjgzVj6BKbKYU&<{89N+^{GT{ z<e&zH2Qz8FxlFW65J<&;W&$&oEqpI`hgjR{mS?kVpK}YeoqIM`D|KphV zknG$ifUf%rIzH9UMO{kpw%{pnlr;YZFM`M0*AD)z9t5tAhh~rS@%tEG3)PF=eoyK-KXD?3Nmoz)L zr#RoceHw7@&-`(9G3!^i&r67DKL#9ODDv2c$m0Z@z|pbmKWa0Y9MX+*5LtZrJioD8 z>osbQ`gN_pEr?C7X^#g#;wL+&KVG;RwHEZctaiO#_s5U?X{{7{oXUK!r<9F-hAl=G zdmO`SYEffdtF2uwMIn=^*1HOr#c%ss&x<&2J+0duwK0F@u|kSCUR9_G#TzFgbEz>p z8a|n?(65+wt+C;>(fhep|2)MH=-4#s(c0ij<(j} z%5Qc^sW&8`PE3|ZmZF>Z%#p3e@$n}br7z+a^2yd0`m{i~8;YUo+ggNfRXlHXb zrqTNcdZK0TYiJa$Xtf5p-T5riNFM+#PqKM{!{{m+}8~ZNGl@zYq;khZU0q*vHjS{rj%_d*A?){1L^=hL?Z`w zbc?awpfNJ)h=-P|^~akgw`TN2+2j3DCZef7%ZRUUH?n&YTM~-sj!INx&bDlBEcB1F z&@&ClQLSZd@P1vL*3Z|OS|jc>$?kc$^9y$&epM+g&bTK7zchIfxpYt3R_7+v3W&