Метод getall

Метод getall применяется к объекту FormsDict, который хранит данные формы. Первым параметром передаётся имя ключа. Метод возвращает список всех значений, связанных с этим ключом. Если ключ отсутствует, возвращается пустой список.

В отличие от метода get, который возвращает только первое значение, метод getall позволяет получить все значения, переданные под одним именем, например при отправке нескольких одинаковых полей формы.

Синтаксис

forms.getall(key)

Пример

Давайте получим все значения ключа 'user' из данных формы:

from bottle import Bottle, request

app = Bottle()

@app.route('/')
def index():
	forms = request.forms
	res = forms.getall('user')
	return str(res)

Результат выполнения кода для формы с полями user=abcde и user=hello:

['abcde', 'hello']

Пример

Давайте обработаем случай, когда ключ отсутствует в данных формы:

from bottle import Bottle, request

app = Bottle()

@app.route('/')
def index():
	forms = request.forms
	res = forms.getall('unknown')
	return str(res)

Результат выполнения кода:

[]

Пример

Давайте выведем все значения ключа 'user' в шаблоне:

from bottle import Bottle, template, request

app = Bottle()

@app.route('/')
def index():
	forms = request.forms
	res = forms.getall('user')
	return template('index', res=res)

Содержимое шаблона index.tpl:

% for item in res:
	{{ item }}
% end

Результат выполнения кода для формы с полями user=abcde и user=hello:

abcde
hello

Смотрите также

класс FormsDict,
который хранит данные формы
метод get,
который возвращает первое значение по ключу
метод getunicode,
который возвращает значение в виде строки Unicode
метод getlist,
который возвращает список значений по ключу