$Web Put Binary
$Web_Put_Binary: Add binary string to response buffer
$Web_Put_Binary sends a binary string to the client buffer.
Note: $Web_Put_Bin is a synonym for the $Web_Put_Binary function.
$Web_Put_Bin is a callable $function.
$Web_Put_Bin takes a single required string argument and returns a status code.
Syntax
%rc = $Web_Put_Binary( bin_string )
| %rc | A numeric variable to contain the returned status code. |
|---|---|
| bin_string | A "binary" string that is added to the client buffer without any translation. Since the client buffer is always sent to the browser without translation, the binary contents of bin_string will be received by the browser. Under Sirius Mods Version 6.7 and later, $Web_Put_Bin is longstring capable: it can send a longstring with a length greater than 255 bytes. |
These are the $Web_Put_Bin return codes:
| Code | Meaning |
|---|---|
| 0 | Binary string sent to the client buffer |
| -1 | Invalid call, not a Web thread |
| -4 | Missing argument |
This sample shows a binary image in .jpg format being sent from a %variable to the client buffer (the image would have to be pretty small, given the 255 byte limitation on %variables):
%X = $Web_Type('binary/jpeg') %X = $Web_Put_Bin( %companyx_logo ) Stop
See also
binary data is to store it in a Model 204 procedure and send it to the client using
- $Web_Proc_Send can be used to send the contents of a Model 204 procedure, either as binary (that is, without translation) or translating from EBCDIC to ASCII.
- $Web_Put_Text can be used to translated translate and send a string from EBCDIC to ASCII.