summaryrefslogtreecommitdiff
path: root/lib/stdlib/test/shell_docs_SUITE_data/unknown_erlang_term_to_iovec_2_func.txt
blob: 176c8eef096923b5c6f3950dd289ce1b03845872 (plain)
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

  -spec term_to_iovec(Term, Options) -> ext_iovec()
                         when
                             Term :: term(),
                             Options ::
                                 [compressed |
                                  {compressed, Level :: 0..9} |
                                  {minor_version, Version :: 0..2}].

Since:
  OTP 23.0

  Returns the encoding of Term according to the Erlang external
  term format as ext_iovec().

  This function produce the same encoding as term_to_binary/2, but
  with another return type. The call 
  iolist_to_binary(term_to_iovec(Term, Opts)) will produce exactly
  the same result as term_to_binary(Term, Opts).

  Currently recognised options are all options recognised by 
  term_to_binary/2.

  term_to_iovec() is a pure optimization of the functionality 
  term_to_binary() provide. term_to_iovec() can for example refer
  directly to off heap binaries instead of copying the binary data
  into the result.

  See also term_to_binary/2.