copy : truefalse

Indicates whether a new rtable should be allocated when converting from other rtable types such as Vector or Matrix. The default is false, meaning that convert will attempt to provide a reference to the existing rtable instead of allocating a new one.

format : string

The option behaves identically to targetformat, but is only valid when expr is not itself a string or ByteArray.

sourceformat : string

A string corresponding to one of the file formats described in Formats. The input expr will be decoded using the specified format and the data returned as a ByteArray.

If the format specified is not one for which a ByteArray is a valid output type and no target format is specified, an error is issued.

targetformat : string

A string corresponding to one of the file formats described in Formats. The input expr will be encoded in the specified format and the encoded data returned as a ByteArray.

Note that this can be used in conjunction with sourceformat to decode data from a source to an arbitrary intermediate expression then encode it to ByteArray output in a different format.

convert(expr, ByteArray) takes a string or container object and produces a ByteArray object with content equivalent to the input.

If expr is a string, it can always be converted to a ByteArray.

If expr is an Array, list, or set and no source format is specified, it will be converted to a ByteArray if all the contents of expr are integers between -128 and 127.  Otherwise, an error will be issued.

$\mathrm{convert}\left(\left[1\,2\,3\right]\,\mathrm{ByteArray}\right)$

$\left[\begin{array}{ccc}1& 2& 3\end{array}\right]$

$\mathrm{convert}\left(''Hello,\; world''\,\mathrm{ByteArray}\right)$

$\left[\begin{array}{cccccccccccc}72& 101& 108& 108& 111& 44& 32& 119& 111& 114& 108& 100\end{array}\right]$

$\mathrm{knot}≔\mathrm{algcurves}\left[\mathrm{plot\_knot}\right]\left(\left(-x^7+y^3\right)\left(-2x^5+y^2\right)\,x\,y\,\mathrm{\epsilon }=0.8\,\mathrm{radius}=0.1\,\mathrm{tubepoints}=9\right)$

$\mathrm{convert}\left(\mathrm{knot}\,\mathrm{ByteArray}\,\mathrm{format}=''STL''\right)$

The convert/ByteArray command was introduced in Maple 2015.

For more information on Maple 2015 changes, see Updates in Maple 2015.

The convert/ByteArray command was updated in Maple 2022.

The copy, format, sourceformat and targetformat options were introduced in Maple 2022.

For more information on Maple 2022 changes, see Updates in Maple 2022.