1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
|
/*
* Copyright 2017-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
*/
@file:Suppress("DEPRECATION_ERROR", "FunctionName")
package kotlinx.serialization.builtins
import kotlinx.serialization.*
import kotlinx.serialization.internal.*
import kotlin.reflect.*
import kotlinx.serialization.descriptors.*
import kotlin.time.Duration
/**
* Returns a nullable serializer for the given serializer of non-null type.
*/
@OptIn(ExperimentalSerializationApi::class)
public val <T : Any> KSerializer<T>.nullable: KSerializer<T?>
get() {
@Suppress("UNCHECKED_CAST")
return if (descriptor.isNullable) (this as KSerializer<T?>) else NullableSerializer(this)
}
/**
* Returns built-in serializer for Kotlin [Pair].
* Resulting serializer represents pair as a structure of two key-value pairs.
*/
public fun <K, V> PairSerializer(
keySerializer: KSerializer<K>,
valueSerializer: KSerializer<V>
): KSerializer<Pair<K, V>> = kotlinx.serialization.internal.PairSerializer(keySerializer, valueSerializer)
/**
* Returns built-in serializer for [Map.Entry].
* Resulting serializer represents entry as a structure with a single key-value pair.
* E.g. `Pair(1, 2)` and `Map.Entry(1, 2)` will be serialized to JSON as
* `{"first": 1, "second": 2}` and `{"1": 2}` respectively.
*/
public fun <K, V> MapEntrySerializer(
keySerializer: KSerializer<K>,
valueSerializer: KSerializer<V>
): KSerializer<Map.Entry<K, V>> = kotlinx.serialization.internal.MapEntrySerializer(keySerializer, valueSerializer)
/**
* Returns built-in serializer for Kotlin [Triple].
* Resulting serializer represents triple as a structure of three key-value pairs.
*/
public fun <A, B, C> TripleSerializer(
aSerializer: KSerializer<A>,
bSerializer: KSerializer<B>,
cSerializer: KSerializer<C>
): KSerializer<Triple<A, B, C>> = kotlinx.serialization.internal.TripleSerializer(aSerializer, bSerializer, cSerializer)
/**
* Returns serializer for [Char] with [descriptor][SerialDescriptor] of [PrimitiveKind.CHAR] kind.
*/
public fun Char.Companion.serializer(): KSerializer<Char> = CharSerializer
/**
* Returns serializer for [CharArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Char.Companion.serializer].
*/
@Suppress("UNCHECKED_CAST")
public fun CharArraySerializer(): KSerializer<CharArray> = CharArraySerializer
/**
* Returns serializer for [Byte] with [descriptor][SerialDescriptor] of [PrimitiveKind.BYTE] kind.
*/
public fun Byte.Companion.serializer(): KSerializer<Byte> = ByteSerializer
/**
* Returns serializer for [ByteArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Byte.Companion.serializer].
*/
public fun ByteArraySerializer(): KSerializer<ByteArray> = ByteArraySerializer
/**
* Returns serializer for [UByteArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [UByte.Companion.serializer].
*/
@ExperimentalSerializationApi
@ExperimentalUnsignedTypes
public fun UByteArraySerializer(): KSerializer<UByteArray> = UByteArraySerializer
/**
* Returns serializer for [Short] with [descriptor][SerialDescriptor] of [PrimitiveKind.SHORT] kind.
*/
public fun Short.Companion.serializer(): KSerializer<Short> = ShortSerializer
/**
* Returns serializer for [ShortArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Short.Companion.serializer].
*/
public fun ShortArraySerializer(): KSerializer<ShortArray> = ShortArraySerializer
/**
* Returns serializer for [UShortArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [UShort.Companion.serializer].
*/
@ExperimentalSerializationApi
@ExperimentalUnsignedTypes
public fun UShortArraySerializer(): KSerializer<UShortArray> = UShortArraySerializer
/**
* Returns serializer for [Int] with [descriptor][SerialDescriptor] of [PrimitiveKind.INT] kind.
*/
public fun Int.Companion.serializer(): KSerializer<Int> = IntSerializer
/**
* Returns serializer for [IntArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Int.Companion.serializer].
*/
public fun IntArraySerializer(): KSerializer<IntArray> = IntArraySerializer
/**
* Returns serializer for [UIntArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [UInt.Companion.serializer].
*/
@ExperimentalSerializationApi
@ExperimentalUnsignedTypes
public fun UIntArraySerializer(): KSerializer<UIntArray> = UIntArraySerializer
/**
* Returns serializer for [Long] with [descriptor][SerialDescriptor] of [PrimitiveKind.LONG] kind.
*/
public fun Long.Companion.serializer(): KSerializer<Long> = LongSerializer
/**
* Returns serializer for [LongArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Long.Companion.serializer].
*/
public fun LongArraySerializer(): KSerializer<LongArray> = LongArraySerializer
/**
* Returns serializer for [ULongArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [ULong.Companion.serializer].
*/
@ExperimentalSerializationApi
@ExperimentalUnsignedTypes
public fun ULongArraySerializer(): KSerializer<ULongArray> = ULongArraySerializer
/**
* Returns serializer for [Float] with [descriptor][SerialDescriptor] of [PrimitiveKind.FLOAT] kind.
*/
public fun Float.Companion.serializer(): KSerializer<Float> = FloatSerializer
/**
* Returns serializer for [FloatArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Float.Companion.serializer].
*/
public fun FloatArraySerializer(): KSerializer<FloatArray> = FloatArraySerializer
/**
* Returns serializer for [Double] with [descriptor][SerialDescriptor] of [PrimitiveKind.DOUBLE] kind.
*/
public fun Double.Companion.serializer(): KSerializer<Double> = DoubleSerializer
/**
* Returns serializer for [DoubleArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Double.Companion.serializer].
*/
public fun DoubleArraySerializer(): KSerializer<DoubleArray> = DoubleArraySerializer
/**
* Returns serializer for [Boolean] with [descriptor][SerialDescriptor] of [PrimitiveKind.BOOLEAN] kind.
*/
public fun Boolean.Companion.serializer(): KSerializer<Boolean> = BooleanSerializer
/**
* Returns serializer for [BooleanArray] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized one by one with [Boolean.Companion.serializer].
*/
public fun BooleanArraySerializer(): KSerializer<BooleanArray> = BooleanArraySerializer
/**
* Returns serializer for [Unit] with [descriptor][SerialDescriptor] of [StructureKind.OBJECT] kind.
*/
@Suppress("unused")
public fun Unit.serializer(): KSerializer<Unit> = UnitSerializer
/**
* Returns serializer for [String] with [descriptor][SerialDescriptor] of [PrimitiveKind.STRING] kind.
*/
public fun String.Companion.serializer(): KSerializer<String> = StringSerializer
/**
* Returns serializer for reference [Array] of type [E] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized with the given [elementSerializer].
*/
@Suppress("UNCHECKED_CAST")
@ExperimentalSerializationApi
public inline fun <reified T : Any, reified E : T?> ArraySerializer(elementSerializer: KSerializer<E>): KSerializer<Array<E>> =
ArraySerializer<T, E>(T::class, elementSerializer)
/**
* Returns serializer for reference [Array] of type [E] with [descriptor][SerialDescriptor] of [StructureKind.LIST] kind.
* Each element of the array is serialized with the given [elementSerializer].
*/
@ExperimentalSerializationApi
public fun <T : Any, E : T?> ArraySerializer(
kClass: KClass<T>,
elementSerializer: KSerializer<E>
): KSerializer<Array<E>> = ReferenceArraySerializer<T, E>(kClass, elementSerializer)
/**
* Creates a serializer for [`List<T>`][List] for the given serializer of type [T].
*/
public fun <T> ListSerializer(elementSerializer: KSerializer<T>): KSerializer<List<T>> =
ArrayListSerializer(elementSerializer)
/**
* Creates a serializer for [`Set<T>`][Set] for the given serializer of type [T].
*/
public fun <T> SetSerializer(elementSerializer: KSerializer<T>): KSerializer<Set<T>> =
LinkedHashSetSerializer(elementSerializer)
/**
* Creates a serializer for [`Map<K, V>`][Map] for the given serializers for
* its ket type [K] and value type [V].
*/
public fun <K, V> MapSerializer(
keySerializer: KSerializer<K>,
valueSerializer: KSerializer<V>
): KSerializer<Map<K, V>> = LinkedHashMapSerializer(keySerializer, valueSerializer)
/**
* Returns serializer for [UInt].
*/
public fun UInt.Companion.serializer(): KSerializer<UInt> = UIntSerializer
/**
* Returns serializer for [ULong].
*/
public fun ULong.Companion.serializer(): KSerializer<ULong> = ULongSerializer
/**
* Returns serializer for [UByte].
*/
public fun UByte.Companion.serializer(): KSerializer<UByte> = UByteSerializer
/**
* Returns serializer for [UShort].
*/
public fun UShort.Companion.serializer(): KSerializer<UShort> = UShortSerializer
/**
* Returns serializer for [Duration].
* It is serialized as a string that represents a duration in the ISO-8601-2 format.
*
* The result of serialization is similar to calling [Duration.toIsoString], for deserialization is [Duration.parseIsoString].
*/
public fun Duration.Companion.serializer(): KSerializer<Duration> = DurationSerializer
/**
* Returns serializer for [Nothing].
* Throws an exception when trying to encode or decode.
*
* It is used as a dummy in case it is necessary to pass a type to a parameterized class. At the same time, it is expected that this generic type will not participate in serialization.
*/
@ExperimentalSerializationApi
public fun NothingSerializer(): KSerializer<Nothing> = NothingSerializer
|
