distrib/lib/CGI.pm

168 # This is the default class for the CGI object to use when all else fails.
171 # This is where to look for autoloaded routines.
181 # This no longer seems to be necessary
289     # This causes modules to clash.
329 # The new routine.  This will check the current environment
752     # again, we initialize ourselves in exactly the same way.  This allows
920 	# This is probably extremely evil code -- to be deleted some day.
1376 # This has to be NPH on most web servers, and it is advisable to set $| = 1
2491 #               This defaults to the content of the <option> element, but the label
2675 # This is provided as a synonym to self_url() for people unfortunate
2935 # This handles MIME type globs correctly.
3681 # This was an extremely clever patch that allowed "use strict refs".
3771 	$boundary = <STDIN>;      # BUG: This won't work correctly under mod_perl
3847 # This reads and returns the body as a single scalar value.
3869 # This will read $bytes or until the boundary is hit, whichever happens
3933 # This fills up our internal buffer in such a way that the
4067 # warnings.  This is ugly and I hate it.
4122 This perl library uses perl5 objects to make it easy to create Web
4123 fill-out forms and parse their contents.  This package defines CGI
4171 on.  This provides you with a cleaner programming interface, but
4284 This will produce the following nonstandard HTTP header:
4296 This feature allows you to keep up with the rapidly changing HTTP and
4303 This will parse the input (from both POST and GET methods) and store
4331 B<restore_parameters()>.  This will (re)initialize the
4404 string.  This feature is new in 2.63.
4415 This sets the value for the named parameter 'foo' to an array of
4416 values.  This is one way to change the value of a field AFTER
4434 This adds a value or list of values to the named parameter.  The
4443 This creates a series of variables in the 'R' namespace.  For example,
4462 This completely clears a list of parameters.  It sometimes useful for
4473 This clears the CGI object completely.  It might be useful to ensure
4504 calling the B<param_fetch()> method with the name of the .  This
4526 parameter list as an ordinary hash.  This allows you to read the
4533 packed string in order to get at the individual values.  This is the
4544 This will write the current state of the form to the provided
4627 call them directly without creating a CGI object first.  This example
4688 subroutine.  You can then use it like any other HTML tag.  This is to
4699 the standard L<Exporter> syntax for specifying load symbols.  This may
4705 one to be present.  This includes B<param()>, B<textfield()>,
4755 doesn't recognize will be interpreted as a new HTML tag.  This allows
4757 extension.  This lets you go wild with new and unsupported tags:
4769 This causes the indicated autoloaded methods to be compiled up front,
4770 rather than deferred to later.  This is useful for scripts that run
4789 This is particularly useful in a mod_perl environment, in which you
4814 This keeps CGI.pm from including undef params in the parameter list.
4829 This makes CGI.pm treat all parameters as UTF-8 strings. Use this with
4839 This makes CGI.pm produce a header appropriate for an NPH (no
4855 This became the default in version 2.64.
4860 ampersands rather than semicolons.  This is no longer the default.
4864 This overrides the autoloader so that any function in your program
4866 This allows you to use all the CGI.pm functions without adding them to
4876 This turns off the command-line processing features.  If you want to
4885 This turns on full debugging.  In addition to reading CGI arguments
4985 HTTP header.  This tells the browser what type of document to expect,
5051 headers to work with a NPH (no-parse-header) script.  This is important
5097 headers to work with a NPH (no-parse-header) script.  This is important
5129 This method returns a canned HTML header and the opening <body> tag.
5145 for all the links and fill-out forms on the page.  B<This is a
5154 argument.  This argument expects a reference to an associative array
5216 This block will be placed within a <script> block inside the HTML (not
5314 A 'true' flag if you want to include a <base> tag in the header.  This
5320 Any other parameters you want to include in the <body> tag.  This is a good
5329 This ends an HTML document by printing the </body></html> tags.
5337 this script with all its state information intact.  This is most
5382 Produce a relative URL.  This is useful if you want to reinvoke your
5390 This overrides the -relative and -absolute arguments.
5394 Append the additional path information to the URL.  This can be
5400 Append the query string to the URL.  This can be combined with
5448 This example shows how to use the HTML methods:
5458 This results in the following HTML code (extra newlines have been
5535 This example will result in HTML output that looks like this:
5544 This is extremely useful for creating tables.  For example:
5654 long line without carriage returns or indentation. This is yuck, but
5678 This forces the default value to be used, regardless of the previous value:
5687 escaped according to HTML rules.  This means that you can safely use
5750 B<Note:> This method was previously named startform(), and startform()
5757 This is the older type of encoding used by all browsers prior to
5765 This is the newer type of encoding introduced by Netscape 2.0.
6020 This makes it possible to create forms that use the same name for
6023 This is the recommended idiom.
6050 This usually happens when the user presses "Stop" before the upload is
6053 (malformed multipart POST)".  This error message is designed so that
6067 is being read during the form processing. This is much like the
6094 This method is not exported by default.  You will have to import it
6222 ("eenie", "meenie" and "minie" in this example).  This is equivalent
6613 The second argument (-value) is also optional.  This gives the button
6764 This is a time/date string (in a special GMT format) that indicates
6772 This is a partial or complete domain name for which the cookie is
6816 The name of the cookie (required).  This can be any string at all.
6823 The value of the cookie.  This can be any scalar value,
6869 without the B<-value> parameter. This example uses the object-oriented
6926 This will tell the browser to load the output of your script into the
6996 The user has pressed the submit button of a form. This event happens
7086 This example assumes that you've already declared the validateAge()
7181 This will generate an HTML header that contains this:
7194 This will give:
7241 pragma.  This will allow you to feed newline-delimited name=value
7259 name/value pairs formatted nicely as a nested list.  This is useful
7401 techniques.  This only works with older browsers such as Mosaic.
7440 sending the complete HTTP header directly to the browser.  This has
7518 This script initializes server push by calling B<multipart_init()>.
7574 dramatically.  This is a form of denial of service attack.
7601 message.  This value will affect both ordinary POSTs and
7642 This error message is actually defined by the HTTP protocol, and is
7684 This allows you to start using the more interesting features
7691 This library is free software; you can redistribute it and/or modify