16. Apêndice A: Referência da DTML

call: Chamando um Método

A tag call permite você inserir de fora o resultado dentro do produto DTML.

Sintaxe

sintaxe da tag call

<dtml-call Variavel|expr="Expressao">

Se a tag call usa uma variável, o método que os argumentos são transferidos automaticamente pelo DTML da mesma forma que var tag. Se o método é especificado na expressão, então você deve passar o argumento você mesmo.

Exemplos

   <dtml-call AtualizarInformacao>

Esta chamada a AtualizarInformacao objeto automático de documento passageiro.

Chamando por Expressão

   <dtml-call expr="RESPONSE.setHeader(content-type, text/plain)">

Veja Também

comment: Comentários do DTML

A tag Comment permite você fazer comentários em seu documento DTML. Você pode além disso usar temporariamente desativando tags no DTML comentando -as e deizando de fora.

Sintaxe

   <dtml-comment>

   </dtml-comment>

A tag comment é um bloco tag.O conteúdo deste bloco não são executaveis nem são inseridos no produto DTML.

Exemplos

                <dtml-comment>
                Isto é um comentário não executável e aparece no documento final.               
                </dtml-comment>

Comentando out DTML

                <dtml-comment> 
                Este  DTML é incapacitado e não dispõe de ser executado. 
                <dtml-call someMethod> 
                </dtml-comment>

functions: Funções do DTML

Funções

abs(número)

Devolve o valor absoluto de um número. O argumento pode ser um inteiro smples ou longo ou um número de ponto flutuante. Se o argumento é um número complexo, sua magnitude é devolvida.

chr(inteiro)

Devolve uma string de um caráter cujo código ASCII é um inteiro, por exemplo, chr(97) retorna a string a. Este é o inverso de ord (). O argumento deve estar no alcance 0 a 255, inclusive;ValueError será elevado se o inteiro está fora deste alcance.

DateTime ()

Retorna um Zope DateTime objeto que determina argumentos de constução. Veja o DateTime referência de API para mais informação em argumentos de construção.

divmod(número, número)

Tendo dois números como argumentos devolve um par de números que consistem no quociente deles e resto quando usando divisão longa. Com tipos de operações misturados, se aplicam as regras para operadores de aritmética binários. Para planície e inteiros longos, o resultado é igual a (a / b, a % b). Para números de ponto flutuantes é o resultado (q, a % b), onde q normalmente é math.floor(a / b) mas pode ser 1 menos que isso. math.floor(a / b) mas pode ser 1 menos que isso. ath.floor(a / b) mas pode ser 1 menos que isso. th.floor(a / b) mas pode ser 1 menos que isso. Em todo caso q * b + a % b é muito perto de a, se a% b é diferente de zero isto tem o mesmo sinal como b, e 0 <= abs(a% b) <abs(b).

float(number)

Converte uma string ou um número para ponto flutuante. Se o argumento é uma string, tem que conter um decimal possivelmente válido ou número de ponto flutuante, possivelmente embutido em whitespace,; isto se comporta idêntico a string.atof(number). Caso contrário, o argumento pode ser um inteiro claro ou longo ou um número de ponto flutuante, e um número de ponto flutuante com o mesmo valor (dentro de Python o ponto flutuante é preciso) é devolvido.

getattr(object, string)

Devolve o valor do nome atribuído do objeto. nome deve ser uma string. Se a string é o nome de um do objeto atributos, o resultado é o valor daquele atributo. Por exemplo, getattr(x, foobar ") é equivalente a x.foobar. Se o atributo nomeado não existe, se determinado é devolvido default, caso contrário AttributeError é elevado.

getitem(variável, render=0)

Retorna o valor de uma variável de DTML. Se render é verdadeiro, a variável é renderizada. Veja a função render.

hasattr(objeto, string)

Os argumentos são um objeto e uma string. O resultado é 1 se a string for o nome de um dos atributos do objeto, 0 se não. (Isto é implementado chamando getattr(objeto, nome) e vendo se eleva uma exceção ou não.) hash(objeto) Devolva o valor hash do objeto (se tem um). valores hash são inteiros. Eles são usados pararapidamente comparar dicionário chave durante um lookup de dicionário. Valores numéricos que comparam igual têm o mesmo valor de hash (até mesmo se eles são de tipos diferentes, por exemplo 1 e 1.0).

has_key(variável)

Retorna verdadeiro se a DTML contém variável nomeada.

hex(inteiro)

Retorna um número inteiro (de qualquer tamanho) para uma string de hexadecimal. O resultado é uma expressão de Python válida. Nota: isto sempre rendimentos um literal não assinado, por exemplo em uma máquina 32-bit , hex(-1) se rende 0xffffffff. Quando avaliou em uma máquina com o mesmo palavra tamanho, este literal é avaliado como -1; com uma palavra de tamanho diferente, pode virar para cima como um número positivo grande ou eleva uma exceção de OflowError.

int(número)

Converte uma string ou número para um inteiro claro. Se o argumento é uma string, tem que conter um número decimal possivelmente válido representado como um inteiro de Python, possivelmente encaixado em whitespace; isto se comporta idêntico para string.atoi(number [, radix] ). O parâmetro de radix dá a base para a conversão e pode ser qualquer inteiro entre 2 a 36. Se radix é especificado e o número não é uma string, TypeError é elevado. Caso contrário, o argumento pode ser um inteiro claro ou longo ou um número de ponto flutuante. Conversão de números de ponto flutuantes para inteiros é definida pela semântica de C; normalmente a conversão trunca para zero.

len(sequecia)

Devolve o tamanho (o número de itens) de um objeto. O argumento pode ser uma série de (string, tuple ou lista) ou um mapeamento (dicionário).

max(s)

Com um único argumento s, devolve o maior item de uma sequência não vazia (por exemplo, uma string, tuple ou lista). Com mais de um argumento, devolve o maior dos argumentos.

min(s)

Com um único argumento s, devolva o menor item de uma sequência nã vazia (por exemplo, uma string, tuple ou lista). Com mais que um argumento, devolve o menor dos argumentos.

namespace([name=value]...)

Retorna um DTML namespace objeto novo. São empurrados Keyword argumento name=value pares no namespace novo.

oct(inteiro)

Converte um número de inteiro (de qualquer tamanho) para uma string de octal. O resultado é uma expressão de Python válida. Nota: isto sempre produz um literal não válido , por exemplo em uma máquina 32-bit , oct(-1) se rende 037777777777. Quando avaliou em uma máquina com o mesmo tamanho de palavra , este literal é avaliado como -1; a um palavra de tamanho diferente, pode virar para cima como um número positivo grande ou eleva uma exceção de OverflowError.

ord(character)

Devolva o valor de ASCII de uma string de um caracter. Por exemplo, ord ("a ") retorna o inteiro 97. Este é o inverso de chr ().

pow(x, y [,z])

Devolve x ao power y; se z está presente, retorna x para o power y, modulo z (processo mais eficiente que pow(x, y)%z). Os argumentos têm que ter tipos numéricos. Com tipos de operand misturados, se aplicam as regras para operadores de aritmética binários. O tipo de operand efetivo também é o tipo do resultado; se o resultado não é nenhum expressible neste tipo, a função eleva uma exceção; por exemplo, pow(2, -1) ou pow(2, 35000) não é permitido.

range([start,] stop [,step])

Esta é uma função versátil para criar listas que contêm progressões de aritmética. Os argumentos devem ser inteiros claros. Se o argumento step é omitido, o default é 1. Se o argumento start é omitido, o default é 0. Retorna de forma completa uma lista de inteiros claros [start, start + step, start + 2 * step, ...]. Se step é positivo, o último elemento é o maior start + i step menor que stop; se step é negativo, o último elemento é o maior start + i step maior que stop. step não deve ser nenhum zero (ou então ValueError é elevado).

round(x [,n])

Devolve o valor de ponto flutuante que x arredondou a dígitos de n depois do ponto de fração decimal. Se n é omitido, o default recebe zero. O resultado é um número de ponto flutuante. São arredondados valores ao múltiplo de 10 para superioridade menos n; se dois múltiplos são igualmente arredonda equivalente a diferente de 0 (assim por exemplo round(0.5) é 1.0 e round(-0.5) é -1.0).

render(object)

Objeto render. Para DTML este objeto avalia o DTML codifica com o namespace atual. Para outros objetos, isto é equivalente a str(object).

reorder(s [,with] [,without])

Reordena os itens em s de acordo com a ordem dada em with e without os itens mencionados em without. Os itens de s não mencionados em with é removido. s, with, e without são todos qualquer sequência de string ou sequência de key-value tuples, with ordena e mostra nas keys. Esta função é útil para construir listas selecionadas ordenadas.

SecurityCalledByExecutable()

Retorna verdadeiro se o objeto atual (por exemplo DTML documento ou método) está sendo chamado por um executável (por exemplo, outro DTML documento ou método, uma escritura ou um método de SQL).

SecurityCheckPermission(permission, objeto)

Confira se o contexto de segurança permite a determinada permissão no determinado objeto. Por exemplo, SecurityCheckPermission (" Adiciona Documentos, Imagens, e Arquivos ", isto ()) devolveria verdadeiro se o usuário atual estivesse autorizado para criar documentos, imagens, e arquivos na localização atual.

SecurityGetUser()

Retorna o objeto do usuário atual. Isto normalmente está igual ao objeto REQUEST.AUTHENTICATED_USER. Porém, o Objeto de AUTHENTICATED_USER é inseguro desde que pode ser substituído.

SecurityValidate([object] [,parent] [,name] [,value])

Retorna verdadeiro se o valor é acessível ao usuário atual. objeto é o objeto no que o valor teve acesso, o pai é o recipiente do valor, e nome é nomeado usado para o acesso do valor (por exemplo, se fosse obtido por getattr). Você pode omitir alguns dos argumentos, porém é melhor fornecer todos os argumentos disponíveis.

SecurityValidateValue(object)

Retorna verdadeiro se o objeto é acessível ao usuário atual. Esta função é o mesmo que chamar SecurityValidate(None, None, None, objeto).

str(object)

Devolve uma string que contém um bem representado de um objeto. Para string, isto devolve a própria string.

test(condição, resultado [,condição, resultado]... [,default])

Objetos capturados em uma ou mais condição, resulta par e retorna o resultado da primeira condição verdadeira. Só um resultado é devolvido, mesmo que mais de uma condição for verdade. Se nenhuma condição é verdade e um default é determinado, o default é devolvido. Se não a condição é verdade e não há nenhum default, Nenhum é devolvido.

unichr(número)

Devolve uma string de unicode que representa o valor de número como um caracter de unicode. Este é o inverso de ord () para unicode caracter.

unicode(string [, codificando [, erros]])

Decodifica string que usa o codec pora codificar. Reparação de erros é acabado de acordo com os erros. O comportamento do default é para decodificar UTF-8 em modo rígido, significado que codificando erros elevam ValueError.

Próximo: Apêndice C: Referência de Modelos de Página do Zope Anterior: Estendendo o Zope