Skip to content

Commit f5dc45a

Browse files
committed
DOC-9636 gardening
Mostly minor formatting. Removed 4th column, as it leads to odd line-wrapping, and seems to be largely redundant (the Common Flag is *always* Binary, except if an error is thrown)
1 parent dbf4f92 commit f5dc45a

1 file changed

Lines changed: 10 additions & 15 deletions

File tree

modules/howtos/pages/transcoders-nonjson.adoc

Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -143,44 +143,40 @@ include::example$Transcoding.cs[tag=string,indent=0]
143143

144144
=== RawBinaryTranscoder
145145
The RawBinaryTranscoder provides the ability for the user to explicitly store and retrieve raw byte data to Couchbase.
146-
The transcoder does not perform any form of real transcoding, and does not take a serializer, but rather passes the data through and assigns the appropriate binary Common Flag.
146+
The transcoder does not perform any form of real transcoding, and does not take a serializer, but rather passes the data through and assigns the appropriate `Binary` Common Flag (except in the case of an exception).
147147

148-
[cols="4", options="header"]
148+
[cols="3", options="header"]
149149
|===
150150
|Item
151151
|Encoding Result
152152
|Decoding Result
153-
|Common Flag
154153

155154
|String
156155
|InvalidArgumentException
157156
|InvalidArgumentException
158-
|-
159157

160158
|byte[]
161159
|Passthrough
162160
|Passthrough
163-
|Binary
164161

165162
|Memory<byte>
166-
|Passthrough (≥ 3.2.6)
163+
|Passthrough +
164+
(from 3.2.6)
167165
|InvalidArgumentException
168-
|Binary
169166

170167
|ReadOnlyMemory<byte>
171-
|Passthrough (≥ 3.2.6)
168+
|Passthrough +
169+
(from 3.2.6)
172170
|InvalidArgumentException
173-
|Binary
174171

175172
|IMemoryOwner<byte>
176173
|InvalidArgumentException
177-
|Passthrough (≥ 3.2.6)
178-
|Binary
174+
|Passthrough +
175+
(from 3.2.6)
179176

180177
|Other `Object`
181178
|InvalidArgumentException
182179
|InvalidArgumentException
183-
|-
184180
|===
185181

186182
Here’s an example of using the `RawBinaryTranscoder`:
@@ -190,9 +186,8 @@ Here’s an example of using the `RawBinaryTranscoder`:
190186
include::example$Transcoding.cs[tag=binary,indent=0]
191187
----
192188

193-
From version 3.2.6, the `RawBinaryTranscoder` will accept `Memory<byte>` and `ReadOnlyMemory<byte>` inputs
194-
and can return `IMemoryOwner<byte>` outputs. Using these types may improve performace by not allocating
195-
large, temporary `byte[]` arrays on the heap.
189+
From version 3.2.6, the `RawBinaryTranscoder` will accept `Memory<byte>` and `ReadOnlyMemory<byte>` inputs and can return `IMemoryOwner<byte>` outputs.
190+
Using these types may improve performance by not allocating large, temporary `byte[]` arrays on the heap.
196191

197192
[source,csharp]
198193
----

0 commit comments

Comments
 (0)