English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Ruby CGI メソッド

Ruby CGI メソッド

以下はCGIクラスのメソッドリストです:

番号メソッドの説明
1CGI::new([ level="query"])
CGIオブジェクトを作成します。queryは以下の値のいずれかです:
  • query: HTML生成出力はありません

  • html3: HTML3.2

  • html4:  HTML4.0 Strict

  • html4Tr: HTML4.0 Transitional

  • html4Fr:  HTML4.0 Frameset

2CGI::escape( str)
URLエンコードを使用して文字列をエスケープします。
3CGI::unescape( str)
escape()でエンコードされた文字列をデコードします。
4CGI::escapeHTML( str)
HTML特殊文字、包括: & < > をエンコードします。
5CGI::unescapeHTML( str)
HTML特殊文字、包括: & < > をデコードします。
6CGI::escapeElement( str[, element...])
指定されたHTML要素内でHTML特殊文字をエンコードします。
7CGI::unescapeElement(str, element[, element...])
指定されたHTML要素内でHTML特殊文字をデコードします。
8CGI::parse(query)
クエリ文字列を解析し、ハッシュのキー=》値対を含むハッシュを返します。
9CGI::pretty(string[, leader=" "])
整然としたHTML形式を返します。指定された場合 leader 、各行の先頭に書き込まれます。 leader デフォルト値は2つのスペースです。
10CGI::rfc1123_date(time)
RFCに基づいて-1123 時間をフォーマットするために使用されます(例:Tue, 2 Jun 2008 00:00:00 GMT)。

CGIの例示方法

以下の例では、CGI::newのオブジェクトをc変数に割り当て、メソッドリストは以下の通りです:

番号メソッドの説明
1c[name]
対応するフィールド名が含まれる配列を返します。 name の値。
2c.checkbox(name[, value[, check=false]])
c.checkbox(options)

チェックボックスフィールドを定義するためのHTML文字列を返します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
3c.checkbox_group(name, value...)
c.checkbox_group(options)

>チェックボックスグループを定義するためのHTML文字列を返します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
4c.file_field(name[, size=20[, max]])
c.file_field(options)

fileフィールドを定義するHTML文字列を返します。
5c.form([method="post"[, url]]) { ...}
c.form(options)

フォームフォームを定義するHTML文字列を返します。指定されたコードブロックがあれば、フォームの内容として出力されます。タグの属性はハッシュ関数としてパラメータを渡すことができます。
6c.cookies
CGI::Cookie オブジェクトを返します。cookie内のキー値対を含んでいます。
7c.header([header])
CGIヘッダ情報を返します。headerパラメータがハッシュ値の場合、そのキー - 値対、ヘッダ情報を作成するために使用されます。
8c.hidden(name[, value])
c.hidden(options)

隠しフィールドのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
9c.image_button( url[, name[, alt]])
c.image_button( options)

画像ボタンのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
10c.keys
フォームのフィールド名を含む配列を返します。
11c.key?( name)
c.has_key?( name)
c.include?( name)

フォームに指定されたフィールド名が含まれている場合、trueを返します。
12c.multipart_form([ url[, encode]]) { ...}
c.multipart_form( options) { ...}

マルチパートフォームのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
13c.out([ header]) { ...}
HTMLを生成し出力します。ブロックの出力を使用してページの本文を生成する文字列。
14c.params
フォームのフィールド名と値を含むハッシュ値を返します。
15c.params= hash
フィールド名と値を使用して設定します。
16c.password_field( name[, value[, size=40[, max]]])
c.password_field( options)

パスワードフィールドのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
17c.popup_menu( name, value...)
c.popup_menu( options)
c.scrolling_list( name, value...)
c.scrolling_list( options)

ポップアップメニューのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
18c.radio_button( name[, value[, checked=false]])
c.radio_button( options)

ラジオフィールドのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
19c.radio_group( name, value...)
c.radio_group( options)

ラジオボタングループのHTML文字列を定義します。タグの属性はハッシュ関数としてパラメータを渡すことができます。
20c.reset( name[, value])}}
c.reset( options)

reset ボタンの HTML 字符列を定義する。タグの属性はハッシュ関数としてパラメータとして渡されます。
21c.text_field( name[, value[, size=40[, max]]])
c.text_field( options)

text フィールドを定義する HTML 字符列を返します。タグの属性はハッシュ関数としてパラメータとして渡されます。
22c.textarea( name[, cols=70[, rows=10]]) { ...}
c.textarea( options) { ...}

textarea フィールドを定義する HTML 字符列を返します。ブロックが指定された場合、ブロック出力の文字列が textarea の内容として使用されます。タグの属性はハッシュ関数としてパラメータとして渡されます。

HTML 生成方法

以下の HTML タグ名を使用して、HTML タグを作成できます。以下に例を示します:

オンラインサンプル

#!/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
         }
      }
   }
}

CGI オブジェクト属性

以下の属性は CGI 示例で使用できます:

属性返り値
accept受け入れ可能な MIME タイプ
accept_charset受け入れ可能な文字セット
accept_encoding受け入れ可能なエンコーディング
accept_language受け入れ可能な言語
auth_type受け入れ可能なタイプ
raw_cookieCookie データ(原文字列)
content_length内容長(Content length)
content_type内容タイプ(Content type)
Fromクライアント エ-メール アドレス
ゲートウェイインターフェースCGI バージョン
path_infoパス
path_translated変換されたパス
Query_stringクエリストリング
referer前回のアクセスURL
remote_addrクライアントホストアドレス(IP)
remote_hostクライアントホスト名
remote_identクライアント名
remote_user認証済みユーザー
request_methodリクエストメソッド(GET, POST, など)
script_nameパラメータ名
server_nameサーバー名
server_portサーバーポート
server_protocolサーバープロトコル
server_softwareサーバーソフトウェア
user_agentユーザーエージェント(User agent)