$Web Type: Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
mNo edit summary |
||
| Line 3: | Line 3: | ||
$Web_Type sets the content type for the response. | $Web_Type sets the content type for the response. | ||
$Web_Type is a [[Calling_Sirius_Mods_$functions|callable]] $function, and it takes a single required string argument and returns a status code. | |||
==Syntax== | ==Syntax== | ||
<p class="syntax"><section begin="syntax" /> %RC = $Web_Type( type ) | <p class="syntax"><section begin="syntax" /> %RC = $Web_Type( type ) | ||
<section end="syntax" /></p> | <section end="syntax" /></p> | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>type</th> | <tr><th>type</th> | ||
<td>The content type indicator. It must be non-null. <var class="product">[[Janus Web Server]]</var> makes no assumptions about what a valid type is, and it will set content type to any user-specified string. The HTTP specification (browsable at | <td>The content type indicator. It must be non-null. <var class="product">[[Janus Web Server]]</var> makes no assumptions about what a valid type is, and it will set content type to any user-specified string. The HTTP specification (browsable at http://www.w3.org) states that content type should be case insensitive. | ||
</td></tr></table> | </td></tr></table> | ||
<table | ===Status codes=== | ||
<table> | |||
<tr><th>Code</th> | <tr><th>Code</th> | ||
< | <th>Meaning</th></tr> | ||
<tr><th>0</th> | <tr><th>0</th> | ||
<td>Content type set</td></tr> | <td>Content type set</td></tr> | ||
| Line 25: | Line 26: | ||
<td>Missing argument</td></tr> | <td>Missing argument</td></tr> | ||
</table> | </table> | ||
==Examples== | |||
Sample code follows: | Sample code follows: | ||
<p class="code"> % | <p class="code">%x = $Web_Type('image/gif') | ||
</p> | </p> | ||
<p> | |||
The above line sets the content type to CompuServe GIF format (a binary image). </p> | |||
<p> | |||
'''Note:''' You can also set the content type for all output presented in response to a given URL or pattern, if it is not already set, by using the <var>TYPE</var> subcommand of the <var>[[JANUS WEB]]</var> command. In this case, a $Web_Type call would not be needed unless the type was being changed from that default. </p> | |||
==See also== | |||
<ul> | |||
<li><var>[[$Web_Output_Type]]</var> | |||
[[Category:Janus Web Server $functions|$Web_Type]] | [[Category:Janus Web Server $functions|$Web_Type]] | ||
Revision as of 23:21, 12 October 2012
<section begin="desc" />Set response content type<section end="desc" />
$Web_Type sets the content type for the response.
$Web_Type is a callable $function, and it takes a single required string argument and returns a status code.
Syntax
<section begin="syntax" /> %RC = $Web_Type( type ) <section end="syntax" />
| type | The content type indicator. It must be non-null. Janus Web Server makes no assumptions about what a valid type is, and it will set content type to any user-specified string. The HTTP specification (browsable at http://www.w3.org) states that content type should be case insensitive. |
|---|
Status codes
| Code | Meaning |
|---|---|
| 0 | Content type set |
| -1 | Invalid call, not a Web thread |
| -4 | Missing argument |
Examples
Sample code follows:
%x = $Web_Type('image/gif')
The above line sets the content type to CompuServe GIF format (a binary image).
Note: You can also set the content type for all output presented in response to a given URL or pattern, if it is not already set, by using the TYPE subcommand of the JANUS WEB command. In this case, a $Web_Type call would not be needed unless the type was being changed from that default.