diff options
Diffstat (limited to 'tde-i18n-pt/docs/tdewebdev/kommander/specials.docbook')
| -rw-r--r-- | tde-i18n-pt/docs/tdewebdev/kommander/specials.docbook | 717 |
1 files changed, 717 insertions, 0 deletions
diff --git a/tde-i18n-pt/docs/tdewebdev/kommander/specials.docbook b/tde-i18n-pt/docs/tdewebdev/kommander/specials.docbook new file mode 100644 index 00000000000..d35c08ab564 --- /dev/null +++ b/tde-i18n-pt/docs/tdewebdev/kommander/specials.docbook @@ -0,0 +1,717 @@ +<?xml version="1.0" encoding="UTF-8" ?> + +<sect1 id="specials"> +<sect1info> +<title +>Especiais e Variáveis Globais Incorporadas</title> +<authorgroup> +<author +><firstname +></firstname +> <surname +></surname +> <affiliation +><address +> <email +></email> +</address +></affiliation> +</author> + +<othercredit role="translator" +><firstname +>José</firstname +><surname +>Pires</surname +><affiliation +><address +><email +>[email protected]</email +></address +></affiliation +><contrib +>Tradução</contrib +></othercredit +> + +</authorgroup> +</sect1info> + +<title +>Especiais e Variáveis Globais Incorporadas</title> + +<para +>Os especiais são funções que são processadas pelo &kommander;. Você deverá saber que, até o &kommander; ter um processador completo, todos os especiais do &kommander; serão executados primeiro e só então o programa será executado. Na maioria dos casos isto não será um problema, mas em alguns deles será. </para> + +<variablelist> +<varlistentry> +<term +><function +>@dcop(<parameter +>idApl</parameter +>, <parameter +>objecto</parameter +>, <parameter +>função</parameter +>, <parameter +>argumentos</parameter +>)</function +></term> +<listitem> +<para +>Faz uma chamada de &DCOP;. @dcop(<quote +>kmail</quote +>, <quote +>KMailIface</quote +>, <quote +>checkMail()</quote +>, <quote +></quote +>) </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@dcopid</function +></term> +<listitem> +<para +>O ID de &DCOP; do processo. (kmdr-executor-@pid) </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@dialog(<parameter +>janela</parameter +>[,<parameter +>parâmetros</parameter +>])</function +></term> +<listitem> +<para +>Lança a janela do Kommander indicada. A janela é vista na pasta da janela e na pasta actual - por esta ordem. Isto antecede a chamada ao executor e muda a pasta por omissão para a pasta onde o ficheiro do Kommander se encontra. Os parâmetros podem ser passados da forma normal do Unix ou você poderá passar parâmetros com nomes no formato <quote +>variavel=valor</quote +>. Você poderá então encontrar os parâmetros passados na lista de variáveis globais. O @global(variavel) iria devolver <quote +>valor</quote +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@env(<parameter +>variavelAmbiente</parameter +>)</function +></term> +<listitem> +<para +>Expande-se para a variável de ambiente. O @env(PWD) expande-se para o $PWD. Lembre-se que o <quote +>$</quote +> faz parte da linha de comandos e não deverá ser usado. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@exec(<parameter +>comando</parameter +>)</function +></term> +<listitem> +<para +>devolve o resultado de executar o comando indicado. @exec(ls -l). </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@execBegin ... @execEnd</function +></term> +<listitem> +<para +>o mesmo que o <function +>@exec</function +>, mas suporta o 'shebang' e 'scripts' de várias linhas. Isto serve para várias linguagens de programação, declarando-as ou utilizando um 'shebang'. </para> +<itemizedlist> +<listitem +><para +><function +>@execBegin(php)</function +></para +></listitem> +<listitem +><para +><function +>@execBegin</function +>#!/usr/bin/php</para +></listitem> +</itemizedlist> +<para +>O primeiro usa o nome do executável do <acronym +>PHP</acronym +>. O &kommander; procura na PATH pelo <application +>php</application +> e, se não for encontrado, verifica se está registado no &kommander; numa localização fora da sua PATH. Se não estiver, diz ao utilizador que não pôde ser encontrado. O segundo exemplo usa o clássico <quote +>shebang</quote +>, o qual poderá ter alguns benefícios, assim como alguns problemas. Se você tiver uma versão beta do <acronym +>PHP5</acronym +>, por exemplo, no <filename +>/usr/local/bin</filename +>, a mesma não seria encontrada porque iria obter primeiro a versão em <filename +>/usr/bin</filename +>. Se, por outro lado, você distribuir a janela para alguém que tenha o <acronym +>PHP</acronym +> no <filename +>/usr/local/bin</filename +> apenas, ela não seria encontrada com o 'shebang' usado. Por isso, usar 'shebangs' deverá necessitar de cuidado e a utilização do executável é recomendada se estiver a partilhar ficheiros.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@global(<parameter +>variável</parameter +>)</function +></term> +<listitem> +<para +>expande para o valor da variável global indicada. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@null</function +></term> +<listitem> +<para +>Devolve um valor nulo. Agora que o Kommander verifica pelo 'widgetText' vazio durante a execução, isto irá evitar erros no caso de um estado indefinido de um elemento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@parentPid</function +></term> +<listitem> +<para +>O &PID; do processo-pai. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@pid</function +></term> +<listitem> +<para +>O &PID; do processo. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@readSetting(<parameter +>chave</parameter +>, <parameter +>valorPorOmissao</parameter +>)</function +></term> +<listitem> +<para +>lê um valor do <filename +>kommanderrc</filename +> </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@selectedWidgetText</function +></term> +<listitem> +<para +>O conteúdo seleccionado de um elemento gráfico que possa mostrar mais do que um valor, como por exemplo as listas </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@setGlobal(<parameter +>variável</parameter +>, <parameter +>valor</parameter +>)</function +></term> +<listitem> +<para +>Configura a variável global para o valor indicado. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@widgetText</function +></term> +<listitem> +<para +>o conteúdo de um elemento </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@writeSetting(<parameter +>chave</parameter +>, <parameter +>valor</parameter +>)</function +></term> +<listitem> +<para +>grava o valor no <filename +>kommanderrc</filename +> </para> +</listitem> +</varlistentry> +</variablelist> + +<sect2 id="arrays"> +<title +>Grupo de Funções de Listas</title> + +<variablelist> +<varlistentry> +<term +><function +>@Array.values(<parameter +>lista</parameter +>)</function +></term> +<listitem> +<para +>Devolve uma lista separada por EOL's de todos os valores da lista. Pode ser usada para percorrer uma lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.keys(<parameter +>lista</parameter +>)</function +></term> +<listitem> +<para +>Devolve uma lista separada por EOL's de todas as chaves da lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.setValue(<parameter +>lista</parameter +>, <parameter +>chave</parameter +>, <parameter +>valor</parameter +>)</function +></term> +<listitem> +<para +>Define um chave e um valor para um elemento da lista. Se não existir nenhuma lista, esta é criada.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.clear(<parameter +>lista</parameter +>)</function +></term> +<listitem> +<para +>Remove todos os elementos da lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.count(<parameter +>lista</parameter +>)</function +></term> +<listitem> +<para +>Devolve o número de elementos na lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.value(<parameter +>lista</parameter +>,<parameter +>chave</parameter +>)</function +></term> +<listitem> +<para +>Devolve o valor associado à chave indicado.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.remove(<parameter +>lista</parameter +>,<parameter +>chave</parameter +>)</function +></term> +<listitem> +<para +>Remove o elemento com a chave indicada da lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.fromString(<parameter +>lista</parameter +>,<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Adiciona todos os elementos do texto na lista. O texto deverá ter o formato <emphasis +>chave\tvalor\n</emphasis +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@Array.toString(<parameter +>lista</parameter +>,<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Devolve todos os elementos na lista num formato <emphasis +>chave\tvalor\n</emphasis +>.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="files"> +<title +>Grupo de Funções de Ficheiros</title> +<variablelist> + +<varlistentry> +<term +><function +>@File.read(<parameter +>ficheiro</parameter +>)</function +></term> +<listitem> +<para +>Devolve o conteúdo do ficheiro indicado.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@File.write(<parameter +>ficheiro</parameter +><parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Escreve o texto indicado num ficheiro.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@File.append(<parameter +>ficheiro</parameter +><parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Adiciona o texto indicado ao fim de um ficheiro.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="strings"> +<title +>Grupo de Funções de Cadeias de Caracteres</title> +<variablelist> + +<varlistentry> +<term +><function +>@String.length(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Devolve o número de caracteres no texto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.contains(<parameter +>texto</parameter +>,<parameter +>sub-texto</parameter +>)</function +></term> +<listitem> +<para +>Verifica se o texto contém o sub-texto indicado.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.find(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Devlve a posição de um sub-texto no texto ou -1 se não for encontrado.</para> +<note +><para +>Este terá um parâmetro opcional de posição inicial para procurar as próximas instâncias na versão Alpha 6.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.left(<parameter +>texto</parameter +>, <parameter +>num</parameter +>)</function +></term> +<listitem> +<para +>Devolve os primeiros 'num' caracteres do texto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.right(<parameter +>texto</parameter +>, <parameter +>num</parameter +>)</function +></term> +<listitem> +<para +>Devolve os últimos 'num' caracteres do texto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.mid(<parameter +>texto</parameter +>, <parameter +>inicio</parameter +>, <parameter +>fim</parameter +>)</function +></term> +<listitem> +<para +>Devolve uma sub-sequência do texto, delimitada pelas posições indicadas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.remove(<parameter +>texto</parameter +>, <parameter +>sub-texto</parameter +>)</function +></term> +<listitem> +<para +>Remove todas as ocorrências de um dado sub-texto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.replace(<parameter +>texto</parameter +>, <parameter +>original</parameter +>, <parameter +>substituicao</parameter +>)</function +></term> +<listitem> +<para +>Substitui todas as ocorrências de um dado sub-texto por outro de substituição.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.upper(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Converte o texto para maiúsculas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.lower(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Converte o texto para minúsculas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.compare(<parameter +>texto1</parameter +>, <parameter +>texto2</parameter +>)</function +></term> +<listitem> +<para +>Compara dois textos. Devolve 0 se forem iguais, -1 se o primeiro texto for menor ou 1 se o primeiro texto for maior</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.isEmpty(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Verifica se o texto está em branco.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>@String.isNumber(<parameter +>texto</parameter +>)</function +></term> +<listitem> +<para +>Verifica se o texto é um número válido.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="builtins"> +<title +>Globais Incorporados</title> +<para +>Os globais incorporados são acedidos como se fossem variáveis globais normais com o <function +>@global</function +>.</para> +<variablelist> +<varlistentry> +<term +><function +>@global(_KDDIR)</function +></term> +<listitem> +<para +>A directoria onde o diálogo actual se encontra.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><function +>@global(_NAME)</function +></term> +<listitem +><para +>O nome do diálogo</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +</sect1> |