English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
A continuación se muestra una lista de métodos de la clase CGI:
| 序号 | 方法描述 |
|---|---|
| 1 | CGI::new([ level="query"]) Crea un objeto CGI. query puede ser uno de los siguientes valores:
|
| 2 | CGI::escape( str) Usa la codificación URL para escapar la cadena. |
| 3 | CGI::unescape( str) Decodifica la cadena codificada por escape(). |
| 4 | CGI::escapeHTML( str) Codifica los caracteres especiales de HTML, incluyendo: & < >. |
| 5 | CGI::unescapeHTML( str) Decodifica los caracteres especiales de HTML, incluyendo: & < >. |
| 6 | CGI::escapeElement( str[, element...]) Codifica los caracteres especiales de HTML en el elemento HTML especificado. |
| 7 | CGI::unescapeElement( str, element[, element...]) 在指定的 HTML 元素中解码 HTML 特殊字符。 |
| 8 | CGI::parse( query) 解析查询字符串，并返回包含哈希的 键=》值 对。 |
| 9 | CGI::pretty( string[, leader=" "]) 返回整齐的HTML格式。 如果指定了 leader ，它将写入到每一行的开头。 leader 默认值为两个空格。 |
| 10 | CGI::rfc1123_date( time) 根据 RFC-1123 来格式化时间 (例如, Tue, 2 Jun 2008 00:00:00 GMT)。 |
以下示例中我们将 CGI::new 的对象赋值给 c 变量，方法列表如下：
| 序号 | 方法描述 |
|---|---|
| 1 | c[ name] 返回一个数组，包含了对应字段名为 name 的值。 |
| 2 | c.checkbox( name[, value[, check=false]]) c.checkbox( options) 返回 HTML 字符串用于定义 checkbox 字段。标签的属性可以以一个哈希函数作为参数传递。 |
| 3 | c.checkbox_group( name, value...) c.checkbox_group( options) >返回 HTML 字符串用于定义 checkbox 组。标签的属性可以以一个哈希函数作为参数传递。 |
| 4 | c.file_field( name[, size=20[, max]]) c.file_field( options) 返回定义 file 字段的HTML字符串。 |
| 5 | c.form([ method="post"[, url]]) { ...} c.form( options) 返回定义 form 表单的HTML字符串。 如果指定了代码块，将作为表单内容输出。标签的属性可以以一个哈希函数作为参数传递。 |
| 6 | c.cookies 返回 CGI::Cookie 对象，包含了cookie 中的键值对。 |
| 7 | c.header([ header]) 返回 CGI 头部的信息。如果 header 参数是哈希值，其键 - 值对，用于创建头部信息。 |
| 8 | c.hidden( name[, value]) c.hidden( options) Devuelve una cadena de HTML para definir un campo oculto. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 9 | c.image_button( url[, nombre[, alt]]) c.image_button( opciones) Devuelve una cadena de HTML para definir un botón de imagen. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 10 | c.keys Devuelve un array que contiene los nombres de los campos del formulario. |
| 11 | c.key?( nombre) c.has_key?( nombre) c.include?( nombre) Si el formulario contiene el nombre de campo especificado, devuelve true. |
| 12 | c.multipart_form([ url[, codificar]]) { ...} c.multipart_form( opciones) { ...} Devuelve una cadena de HTML para definir un formulario de tipo multimedia (multipart). Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 13 | c.out([ encabezado]) { ...} Genera HTML y salida. Usa la cadena generada por la salida del bloque para crear el cuerpo de la página. |
| 14 | c.params Devuelve un valor de hash que contiene los nombres y valores de los campos del formulario. |
| 15 | c.params= hash Establece el uso de nombre de campo y valor. |
| 16 | c.password_field( nombre[, valor[, tamaño=)40[, máximo]]]) c.password_field( opciones) Devuelve una cadena de HTML para definir un campo de contraseña. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 17 | c.popup_menu( nombre, valor...) c.popup_menu( opciones) c.scrolling_list( nombre, valor...) c.scrolling_list( opciones) Devuelve una cadena de HTML para definir un menú deslizante. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 18 | c.radio_button( nombre[, valor[, comprobado=false]]) c.radio_button( opciones) Devuelve una cadena de HTML para definir un campo de radio. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 19 | c.radio_group( nombre, valor...) c.radio_group( opciones) Devuelve una cadena de HTML para definir un grupo de botones de radio. Las propiedades de la etiqueta se pueden pasar como una función de hash. |
| 20 | c.reset( nombre[, valor])}} c.reset( opciones) devuelve una cadena HTML que define un botón de reinicio. Los atributos de la etiqueta pueden ser pasados como una función hash como parámetro. |
| 21 | c.text_field( nombre[, valor[, tamaño=40[, máximo]]]) c.text_field( opciones) devuelve una cadena HTML que define un campo texto. Los atributos de la etiqueta pueden ser pasados como una función hash como parámetro. |
| 22 | c.textarea( nombre[, columnas=70[, filas=10]]) { ...} c.textarea( options) { ...} devuelve una cadena HTML que define un campo textarea. Si se especifica un bloque, la cadena de salida del bloque de código se utilizará como contenido del textarea. Los atributos de la etiqueta pueden ser pasados como una función hash como parámetro. |
Puedes usar los nombres de etiquetas HTML correspondientes en el ejemplo de CGI para crear etiquetas HTML, ejemplo a continuación:
#!/usr/bin/ruby
require "cgi"
cgi = CGI.new("html4")
cgi.out{
cgi.html{
cgi.head{ "\n"+cgi.title{"This Is a Test"} } +
cgi.body{ "\n"+
cgi.form{"\n"+
cgi.hr +
cgi.h1 { "A Form: " } + "\n"+
cgi.textarea("get_text") +"\n"+
cgi.br +
cgi.submit
}
}
}
}Puedes usar las siguientes propiedades en el ejemplo de CGI:
| propiedad | valor de retorno |
|---|---|
| accept | tipos MIME aceptados |
| accept_charset | conjuntos de caracteres aceptados |
| accept_encoding | codificaciones aceptadas |
| accept_language | idiomas aceptados |
| auth_type | tipos aceptados |
| raw_cookie | datos de Cookie (cadena original) |
| content_length | longitud del contenido (Content length) |
| content_type | tipo de contenido (Content type) |
| de | cliente e-dirección de correo |
| interface de gateway | Versión CGI |
| path_info | Ruta |
| path_translated | Ruta traducida |
| Query_string | Cadena de consulta |
| referer | URL de acceso anterior |
| remote_addr | Dirección de host del cliente (IP) |
| remote_host | Nombre del host del cliente |
| remote_ident | Nombre del cliente |
| remote_user | Usuario autenticado |
| request_method | Método de solicitud (GET, POST, etc.) |
| script_name | Nombre del parámetro |
| server_name | Nombre del servidor |
| server_port | Puerto del servidor |
| server_protocol | Protocolo del servidor |
| server_software | Software del servidor |
| user_agent | Agente de usuario (User agent) |