grap - Online na nuvem

PROGRAMA:

NOME

piada - Linguagem de Kernighan e Bentley para gráficos de composição

SINOPSE

piada [-d define_file] [-D] [-l] [-M incluir caminho] [-R] [-r] [-v] [-u] [-C] [-c] [-h]
[nome do arquivo ...]

DESCRIÇÃO

piada é uma implementação da linguagem de Kernighan e Bentley para gráficos de composição, como
descrito em `` Linguagem Grap-A para gráficos de composição, tutorial e manual do usuário, '' por Jon L.
Bentley e Brian W. Kernighan, revisado em maio de 1991, que é a principal fonte de
informações sobre como usar piada. No momento da redação deste documento, ele está disponível eletronicamente em
http://www.kohala.com/start/troff/cstr114.ps. Documentação adicional e exemplos,
embalado com piada, pode ter sido instalado localmente também. Se disponível, caminhos para eles
pode ser exibido usando piada -h or piada -v (ou piada --Socorro / piada --versão)

Esta versão é uma implementação de caixa preta de piada, e algumas inconsistências devem ser
esperado. O restante desta página do manual irá descrever brevemente o piada linguagem como
implementado aqui.

piada é um foto(1) pré-processador. Leva comandos embutidos em um troff(1) arquivo de origem que
estão rodeados por .G1 e .G2 macros e as reescreve em comandos pic para exibir o
gráfico. Outras linhas são copiadas. A saída é sempre para a saída padrão, que geralmente é
redirecionado. A entrada é do dado nome do arquivos, que são lidos em ordem. UMA nome do arquivo of - is
a entrada padrão. Se não nome do arquivos são fornecidos, a entrada é lida a partir da entrada padrão.

Porque piada é um pré-processador pic, e GNU pic irá gerar TeX, é possível usar piada
com TeX.

A -d opção especifica um arquivo de definições de macro a serem lidos na inicialização, e o padrão é
/usr/share/grap/grap.defines. o -D opção inibe a leitura de quaisquer macros iniciais
arquivo (o -l bandeira é sinônimo de -D, embora eu não me lembre por quê). O arquivo de definições pode
também pode ser fornecido usando a variável de ambiente GRAP_DEFINES. (Veja abaixo).

-v imprime as informações da versão na saída padrão e sai. --versão é um sinônimo
para -v.

-u torna os rótulos desalinhados por padrão. Esta versão de piada usa novos recursos do GNU pic para
alinhe os rótulos esquerdo e direito com os eixos, ou seja, os rótulos esquerdo e direito são executados em
ângulos retos com o texto do artigo. Isso pode ser útil para portar piada programas. -c
torna as sequências de plotagem não cortadas por padrão. Algumas versões de piada permitir que os usuários coloquem um
string em qualquer lugar no espaço de coordenadas, em vez de apenas no quadro. Por padrão,
versão do piada não plota nenhuma string centralizada fora do quadro. -c permite strings para
ser colocado em qualquer lugar. Veja também o cortado e não cortado modificadores de string descritos no
enredo declaração.

-M é seguido por uma lista separada por dois pontos de diretórios usados ​​para pesquisar por
nomes de caminho incluídos via cópia. O caminho também é usado para localizar o arquivo de definição, portanto, se o -d
muda o nome do arquivo de definição para um nome relativo, ele será pesquisado no caminho fornecido
by -M. O caminho de pesquisa sempre inclui o diretório atual e, por padrão, esse diretório
é pesquisado por último.

Todos os números usados ​​internamente por piada são valores de ponto flutuante de precisão dupla. As vezes
usar números de ponto flutuante tem consequências indesejadas. Para ajudar a evitar esses problemas,
piada pode usar dois limites para comparação de números de ponto flutuante, definidos por -R or -r. O
-R sinalizador define o modo de comparação grosseira, que é adequado para a maioria dos aplicativos. Se você é
traçar valores pequenos - menos de 1e-6 ou mais - considere usar -r que usa muito bem
comparações entre números. Você também pode querer redimensionar seus valores plotados para serem maiores
em magnitude. As comarisons grosseiras são usadas por padrão.

Para ser mais preciso, o valor pelo qual dois números devem diferir para piada para considerá-los não
igual é chamado de limite de comparação e o menor número diferente de zero é chamado de mínimo
valor. Os valores de uma determinada versão de piada usos para estes estão incluídos na saída de -v
or -h.

Todos os Produtos piada comandos são incluídos entre .G1 e .G2 macros, que são consumidas por piada. O
saída contém imagem entre . PS e .EDUCAÇAO FISICA macros. Quaisquer argumentos para o .G1 macro na entrada
são argumentos para o . PS macro na saída, para que os gráficos possam ser escalados exatamente como pic
diagramas. Se -C for fornecido, qualquer macro começando com .G1 ou .G2 é tratada como .G1 ou .G2
macro, para compatibilidade com versões antigas do troff. Usando -C também força a sintaxe troff pura
em comandos de mudança de fonte incorporada quando as strings têm o tamanho atributo, e todas as strings devem ser
não cortado.

A -h flag imprime uma breve mensagem de ajuda e sai. --Socorro é sinônimo de -h.

É possível que alguém cause piada falhar, passando uma string de formato incorreto e dados para
que o corrida comando. Se piada é integrado como parte do sistema de impressão, isso poderia
concebivelmente, forneceu um caminho para violar a segurança da máquina. Se você escolher usar piada
como parte de um sistema de impressão executado pelo superusuário, você deve desativar corrida comandos.
Isso pode ser feito chamando piada com o -S sinalizador, definindo o ambiente GRAP_SAFER
variável ou compilando com o símbolo de pré-processador GRAP_SAFER definido. (O GNU configurar
script incluído com piada irá definir aquele símbolo de pré-processador se o --com-grap-seguro
opção é fornecida.)

A piada os comandos são esboçados abaixo. Consulte o artigo de Kernighan e Bentley para o
Detalhes.

Novas versões de Groff(1) irá invocar piada if -G é dada.

comandos
Os comandos são separados uns dos outros por novas linhas ou ponto e vírgula (;).

quadro [descrição_linha] [ht altura | wid largura] [[(topo|fundo|esquerda| certo)
descrição_linha] ...]

quadro [ht altura | wid largura] [descrição_linha] [[(topo|fundo|esquerda| certo)
descrição_linha] ...]

Descreve como os eixos do gráfico são desenhados. UMA descrição_linha é uma linha de imagem
descrição, por exemplo, 0.5 tracejado ou o sólido literal. Também pode incluir um cor
palavra-chave seguida pela cor para desenhar a string entre aspas duplas. Qualquer cor
compreendido pelo sistema groff subjacente pode ser usado. A cor só pode ser usada em
GNU pic, e não está disponível no modo de compatibilidade. Da mesma forma, para foto
implementações que entendem espessura, esse atributo pode ser usado com um verdadeiro
parâmetro com valor. Espessura não está disponível no modo de compatibilidade.

Se o primeiro descrição_linha é fornecido, o quadro é desenhado com esse estilo. o
o padrão é sólido. A altura e a largura da moldura também podem ser especificadas em polegadas.
O estilo de linha padrão pode ser substituído pelos lados da moldura, especificando
parâmetros adicionais para quadro.

Se nenhum comando de plotagem foi dado antes do quadro comando é emitido, o quadro
será a saída naquele ponto no fluxo de plotagem em relação ao troff ou pic embutido
comandos. Caso contrário, o quadro é gerado antes do primeiro objeto plotado (mesmo
invisíveis).

ht e wid estão em polegadas por padrão, mas podem ser qualquer unidade groff. Se omitido, o
as dimensões são 2 polegadas de altura por 3 polegadas de largura.

coordenar [nome] [x expr, expr] [y expr, expr] [log x | log y | log log]

A coordenar comando especifica um novo sistema de coordenadas ou define limites no padrão
sistema. Ele define os maiores e menores valores que podem ser plotados e, portanto,
a escala dos dados no quadro. Os limites para os sistemas de coordenadas xey podem
ser administrado separadamente. Se um nome é fornecido, esse sistema de coordenadas é definido, se não
o sistema padrão é modificado.

Um sistema de coordenadas criado por um coordenar o comando pode ser modificado por coordenar
comandos. UMA piada programa pode declarar um espaço de coordenadas usando coordenar, cópia um arquivo de
dados por meio de uma macro que plota os dados e encontra seus máximos e mínimos, e então
definir o tamanho do sistema de coordenadas com um segundo coordenar declaração.

Este comando também determina se uma escala é plotada logaritmicamente. log log significa o
mesma coisa que log x log y.

desenhar [nome_linha] [descrição_linha] [plot_string]

A desenhar O comando define o estilo com o qual uma determinada linha será plotada. Se
nome_linha é fornecido, o estilo é associado a esse nome, caso contrário, o padrão
o estilo está definido. descrição_linha é uma descrição de linha de imagem, e o opcional
plot_string é uma string a ser centralizada em cada ponto. A descrição de linha padrão é
invis, e a string de plotagem padrão é um marcador centralizado, então, por padrão, cada ponto
é um círculo preenchido e eles estão desconectados. Se os pontos estão sendo conectados, cada
desenhar comando termina qualquer linha atual e começa uma nova.

Ao definir um estilo de linha, esse é o primeiro desenhar comando para um determinado nome de linha,
especificar nenhuma sequência de plotagem significa que não deve haver sequências de plotagem. Omitindo o
seqüência de enredo no subseqüente desenhar comandos endereçando a mesma linha nomeada significa não
mude a seqüência de enredo. Se uma linha foi definida com uma seqüência de plotagem, e o formato
é alterado por um subsequente desenhar declaração, a seqüência de plotagem pode ser removida por
especificando "" no desenhar declaração.

A sequência de plotagem pode ter seu formato alterado por meio de vários modificadores de sequência.
String_modifiers são descritos na descrição do enredo comando.

O arquivo de definição padrão inclui várias macros úteis como sequências de plotagem, incluindo
bala, quadrado e delta.

novo é sinônimo de desenhar.

Próximo [nome_linha] at [nome_coordenadas] expr, expr [descrição_linha]

A Próximo o comando plota o ponto dado usando o estilo de linha dado por nome_linha, Ou o
padrão se nenhum for fornecido. Se nome_linha é fornecido, deveria ter sido definido por um
mais cedo desenhar comando, se não for criado um novo estilo de linha com esse nome, inicializado
da mesma forma que o estilo padrão. As duas expressões fornecem os pontos x e y
valores, relativos ao sistema de coordenadas opcional. Esse sistema deveria ter sido
definido por um anterior coordenar comando, se não, grap sairá. Se o opcional
descrição_linha é fornecido, ele substitui a descrição de linha padrão do estilo. Vocês
não pode ultrapassar a seqüência de plotagem. Para usar uma seqüência de plotagem diferente, use o enredo
comando.

As coordenadas podem, opcionalmente, ser colocadas entre parênteses: (expr, expr)

Quote_string [string_modifiers][, Quote_string [string_modifiers]] ... at
[nome_coordenadas] expr, expr

enredo expr [string_de_formato] at [nome_coordenadas] expr, expr

Ambos os comandos traçam uma string em um determinado ponto. No primeiro caso, o literal
strings são empilhadas umas sobre as outras. Os string_modifiers incluem a imagem
modificadores de justificação (apenas, justo, acima e abaixo), e absoluto e relativo
modificadores de tamanho. Veja a documentação da foto para a descrição da justificativa
modificadores. piada também suporta o alinhado e desalinhado modificadores que são brevemente
anotado na descrição do rótulo comando.

O arquivo de definição padrão inclui várias macros úteis como sequências de plotagem, incluindo
bala, quadrado e delta.

Strings colocados por qualquer formato do enredo comando estão restritos a estar dentro do
quadro. Isso pode ser substituído usando o não cortado atributo, que permite uma string
para ser plotado dentro ou fora do quadro. o -c e -C conjunto de bandeiras não cortado em todos
strings, e para evitar que uma string seja plotada fora do quadro quando essas sinalizações
estão ativos, o cortado atributo pode ser usado para restaurar o comportamento de recorte. No entanto
cortado or não cortado pode ser aplicado a qualquer string, só tem significado para enredo
afirmações.

tamanho expr define o tamanho da string para expr pontos. Se expr é precedido por um + ou -, o
o tamanho é aumentado ou diminuído em muitos pontos.

If cor e um nome de cor entre aspas duplas aparecer, a string será renderizada em
essa cor em uma versão do GNU troff que suporta cores. Cor não disponível
no modo de compatibilidade.

Na segunda versão, o expr é convertido em uma string e colocado no gráfico.
string_de_formato é um printf(3) string de formato. Apenas a formatação escapa para impressão
números de ponto flutuante fazem sentido. A string de formato só é respeitada se o corrida
comando também está ativo. Veja a descrição de corrida para as várias maneiras de
desative-o. Enredo e corrida responder de forma diferente quando piada está funcionando com segurança.
Sprint ignora quaisquer argumentos, passando a string de formato sem substituição.
enredo ignora a string de formato completamente, plotando expr usando o formato "% g".

Os pontos são especificados da mesma forma que para Próximo comandos, com as mesmas consequências para
sistemas de coordenadas indefinidas.

A segunda forma deste comando é porque a primeira forma pode ser usada com um piada
corrida expressão (ver Expressões).

Carrapatos (esquerda|certo|topo|fundo) [(in|Fora) [expr]] [on | auto coord_name]

Carrapatos (esquerda|certo|topo|fundo) (in|Fora) [expr] [up expr | down expr | esquerda expr | certo expr]
at [coord_name] expr [string_de_formato] [[, expr [string_de_formato]] ...]

Carrapatos (esquerda|certo|topo|fundo) (in|Fora) [expr] [up expr | down expr | esquerda expr | certo expr]
da [coord_name] start_expr para end_expr [by [+ | - | * | /] por_expr] [string_formato]

Carrapatos [esquerda|certo|topo|fundo] WOW!

Este comando controla a colocação de marcas no quadro. Por padrão, os ticks são
gerado automaticamente nos lados esquerdo e inferior do quadro.

A primeira versão deste comando ativa a geração automática de ticks para um determinado
lado. o in or Fora parâmetro controla a direção e comprimento dos tiques. Se um
coord_name é especificado, os tiques são gerados automaticamente usando essa coordenada
sistema. Se nenhum sistema for especificado, o sistema de coordenadas padrão será usado. Como com
Próximo e enredo, o sistema de coordenadas deve ser declarado antes do Carrapatos declaração que
faz referência a ele. Esta sintaxe para solicitar ticks gerados automaticamente é um
extensão, e não irá portar para mais antigo piada implementações.

A segunda versão do Carrapatos comando substitui a colocação automática dos ticks
especificando uma lista de coordenadas nas quais colocar os tiques. Se os carrapatos não forem
definido em relação ao sistema de coordenadas padrão, o coord_name parâmetro deve
seja dado. Para cada carrapato um printf(3) string de formato de estilo pode ser fornecida. o
string_de_formato o padrão é "% g". A string de formato também pode ter modificadores de string como
descrito no enredo comando. Para colocar carrapatos sem rótulos, especifique string_de_formato
Como "".

If corrida está desabilitado, Carrapatos se comporta como enredo em relação à string de formato.

Os rótulos nas marcações podem ser deslocados especificando uma direção e a distância em
polegadas para compensar o rótulo. Essa é a direção opcional e a expressão imediatamente
precedendo o at.

O terceiro formato do Carrapatos comando substitui a geração de tick padrão com um
conjunto de tiques em intervalos regulares. A sintaxe é uma reminiscência da linguagem de programação
para loops. Os carrapatos são colocados começando em start_expr terminando em end_expr uma unidade à parte.
Se o by cláusula é especificada, ticks são por_expr unidades separadas. Se uma operadora aparecer
antes por_expr cada marca é operada por esse operador em vez de +. Por exemplo

carrapatos deixados de 2 a 32 por * 2

colocará marcas em 2, 4, 8, 16 e 32. Se string_de_formato é especificado, todos os tiques são
formatado usando-o.

Os parâmetros que precedem o da agir conforme descrito acima.

A at e para formas de comando tick podem ser emitidas no mesmo lado de um quadro.
Por exemplo:

carrapatos deixados de 2 a 32 por * 2
carrapatos restantes em 3, 5, 7

colocará marcas no lado esquerdo do quadro apontando para 2, 4, 8, 16 e 32 e
em 3, 5 e 7.

A forma final de Carrapatos desativa carrapatos em um determinado lado. Se nenhum lado for dado o
ticks para todos os lados são cancelados.

carrapato é sinônimo de Carrapatos.

grade (esquerda|certo|topo|fundo) [tiquetaqueia] [descrição_linha] [up expr | down expr | esquerda expr
| certo expr] [on | auto [coord_name]]

grade (esquerda|certo|topo|fundo) [tiquetaqueia] [descrição_linha] [up expr | down expr | esquerda expr
| certo expr] at [coord_name] expr [string_de_formato] [[, expr [string_de_formato]] ...]

grade (esquerda|certo|topo|fundo) [tiquetaqueia] [descrição_linha] [up expr | down expr | esquerda expr
| certo expr] da [coord_name] start_expr para end_expr [by [+ | - | * | /] por_expr]
[formato_string]

A grade comando é semelhante ao Carrapatos comando exceto que grade especifica o
colocação de linhas na moldura. A sintaxe é semelhante a Carrapatos tão bem.

Ao especificar marcações no comando, nenhuma marcação é desenhada nesse lado do quadro.
Se os carrapatos aparecem em um lado por padrão, ou foram declarados por um anterior Carrapatos
comando, grade não os cancela, a menos que os ticks off sejam especificados.

Em vez de uma direção para os carrapatos, grade permite que o usuário escolha uma descrição de linha para
as linhas de grade. As descrições usuais de linhas de imagem são permitidas.

As grades são rotuladas por padrão. Para omitir rótulos, especifique a string de formato como "".

If corrida está desabilitado, grade se comporta como enredo em relação à string de formato.

rótulo (esquerda|certo|topo|fundo) Quote_string [string_modifiers][, Quote_string
[string_modifiers]] ... [up expr | down expr | esquerda expr | certo expr]

A rótulo comando coloca um rótulo no eixo determinado. É possível especificar vários
etiquetas, que serão empilhadas umas sobre as outras como na foto. O argumento final, se
presente, especifica quantas polegadas o rótulo é deslocado do eixo.

Por padrão, os rótulos dos rótulos esquerdo e direito são executados paralelamente ao quadro. Você pode
cancele isso especificando desalinhado como um string_modifier.

círculo at [nome_coordenada] expr, expr [raio expr] [linha desc]

Isso desenha um círculo no ponto indicado. Por padrão, o círculo é pequeno, 0.025
polegadas. Isso pode ser anulado especificando um raio. As coordenadas do ponto
são relativos ao sistema de coordenadas nomeado, ou o sistema padrão se nenhum for
Especificadas.

Este comando foi estendido para obter uma descrição de linha, por exemplo, pontilhada. Isso também
aceita as extensões de preenchimento descritas abaixo no Barra comando. Também vai
aceitar um cor palavra-chave que dá a cor do contorno do círculo em dobro
citações e um cor de preenchimento comando que define a cor para preencher o círculo de forma semelhante.
As cores só estão disponíveis quando o modo de compatibilidade está desativado e usando uma versão do GNU
foto que suporta cor.

linha [descrição_linha] da [nome_coordenada] expr, expr para [nome_coordenada] expr, expr
[descrição_linha]

flecha [descrição_linha] da [nome_coordenada] expr, expr para [nome_coordenada] expr, expr
[descrição_linha]

Isso desenha uma linha ou seta do primeiro ponto ao segundo usando o estilo fornecido.
O estilo de linha padrão é sólido. o descrição_linha pode ser dado antes do
da ou depois do para cláusula. Se ambos forem fornecidos, o segundo será usado. É possível
especificar um ponto em um sistema de coordenadas e um em outro, observe que se ambos
os pontos estão em um sistema de coordenadas nomeadas (mesmo se eles estiverem na mesma coordenada nomeada
sistema), ambos os pontos devem ter nome_coordenada dado.

cópia ["nome do arquivo"] [até "corda"] [através macro]

A cópia comando importa dados de outro arquivo para o gráfico atual. O formulário com
apenas um nome de arquivo fornecido é uma inclusão de arquivo simples; o arquivo incluído é simplesmente lido
no fluxo de entrada e pode conter piada comandos. O caso mais comum
é que é uma lista de números; Vejo Sessão listas abaixo.

A segunda forma pega linhas do arquivo, divide-as em palavras delimitadas por um ou
mais espaços e chama a macro fornecida com essas palavras como parâmetros. A macro pode
pode ser definido aqui ou ser uma macro definida anteriormente. Ver Macros para mais
informações sobre macros.

A nome do arquivo pode ser omitido se o até cláusula está presente. Nesse caso, o arquivo atual é
tratado como o arquivo de entrada até corda é encontrado no início da linha.

cópia é um dos cavalos de batalha de piada. Confira o jornal e
/ usr / share / doc / grap / examples para mais detalhes. Confirme a localização dos exemplos
diretório usando o -v bandeira.
impressão (expr | string)

Imprime seu argumento para o erro padrão.

sh quadra

Isso passa quadra para sh(1). Ao contrário de K&B piada nenhuma expansão macro ou variável é feita.
Eu acredito que isso também é verdade para GNU pic versão 1.10. Veja o Macros seção para
informações sobre a definição de blocos.

foto declaração_foto

Isso emite as declarações pic fornecidas no anexo . PS e .EDUCAÇAO FISICA no ponto onde
o comando é emitido.

As declarações que começam com um ponto são consideradas troff (declarações) e são
saída no invólucro . PS e .EDUCAÇAO FISICA no ponto onde o comando aparece.

Para fins de posicionamento relativo de comandos pic ou troff, o quadro é gerado
imediatamente antes do primeiro objeto plotado, ou o quadro declaração, se houver. Se o
o usuário especifica os comandos pic ou troff e nenhum objeto plotável nem um quadro
comando, os comandos não serão produzidos.

gráfico Nome pic_commands

Este comando é usado para posicionar gráficos em relação uns aos outros. O gráfico atual
é dado o nome da foto Nome (nomes usados ​​por pic começam com letras maiúsculas). Qualquer foto
comandos após o gráfico são usados ​​para posicionar o próximo gráfico. A moldura do
O gráfico está disponível para uso com o nome da imagem Frame. O seguinte coloca um segundo gráfico
abaixo do primeiro:

gráfico linear
[descrição do gráfico]
gráfico exponencial com .Frame.n em \
Linear.Frame.s - (0, 05)
[descrição do gráfico]

nome = expr

Isso atribui expr para a variável nome. piada tem apenas variáveis ​​numéricas (duplas).

A atribuição cria uma variável se ela não existir. As variáveis ​​persistem nos gráficos.
As atribuições podem ser propagadas; a = b = 35 atribui 35 a a e b.

Barra (up|certo) [nome_coordenadas] compensar ht altura [wid largura] [base deslocamento_base]
[descrição_linha]

Barra [nome_coordenadas] expr, expr, [nome_coordenadas] expr, expr, [descrição_linha]

A Barra comando facilita o desenho de gráficos de barras. A primeira forma do comando
descreve o bar de forma geral e tem piada coloque-o. A barra pode se estender para cima ou
à direita, está centrado em compensar e se estende para cima ou para a direita altura unidades (no dado
sistema de coordenadas). Por exemplo

bar até 3 ht 2

desenha uma barra de 2 unidades de altura no eixo x, centrada em x = 3. Por padrão, as barras são 1
unidade de largura, mas isso pode ser alterado com o wid palavra-chave. Por padrão, as barras ficam no
eixo da base, ou seja, as barras direcionadas para cima se estenderão de y = 0. Isso pode ser substituído pelo
base palavra-chave. (A barra descrita acima tem cantos (2.5, 0) e (3.5, 2).)

A descrição da linha foi estendida para incluir um preencher expr palavra-chave que especifica
o sombreamento dentro da barra. As barras podem ser desenhadas em qualquer estilo de linha. Eles apóiam o
cor e cor de preenchimento palavras-chave descritas em círculo.

A segunda forma do comando desenha uma caixa com os dois pontos como cantos. Isso pode
ser usado para desenhar caixas destacando certos dados, bem como gráficos de barras. Observe que
as barras preenchidas cobrirão os dados desenhados abaixo delas.

Control Fluxo
if expr então quadra [outro quadra]

A if declaração fornece execução condicional simples. Se expr é diferente de zero, o
quadra depois de então declaração é executada. Se não o quadra depois de outro is
executado, se presente. Ver Macros para a definição de blocos. Versões anteriores de
esta implementação de piada tratou os blocos como macros que foram definidas e
expandido no local. Isso levou a uma confusão desnecessária porque separadores explícitos eram
às vezes chamado. Agora, piada insere um separador (;) após o último caractere em
quadra, então constrói como

if (x == 3) {y = y + 1}
x = x + 1

comporte-se conforme o esperado. Um separador também é anexado ao final de um para bloquear.

para nome da de_expr para para_expr [by [+ | - | * | /] por_expr] do quadra

Este comando executa quadra iterativamente. A variável nome está definido para de_expr e
incrementado por por_expr até que exceda para_expr. A iteração tem a semântica
definido no Carrapatos comando. A definição de quadra é discutido em Marcos. Ver
também a nota sobre separadores implícitos na descrição do if comando.

An = pode ser usado no lugar de da.

Expressões
piada suporta a maioria dos operadores aritméticos padrão: + - / * ^. O quilate (^) é
exponenciação. Em um if afirmação piada também suporta os operadores lógicos C ==,! =, &&,
|| e unário! Também em um if, == e! = estão sobrecarregados para a comparação entre aspas
cordas. Os parênteses são usados ​​para agrupamento.

A atribuição não é permitida em uma expressão em qualquer contexto, exceto para simples cascata de
atribuições. a = b = 35 funciona conforme o esperado; a = 3.5 * (b = 10) não executa.

piada suporta as seguintes funções que possuem um argumento: log, exp, int, sem, carrinho, sqrt,
rand, andar, teto. Os logaritmos são de base 10 e as funções trigonométricas estão em
radianos. eexp retorna o número de Euler para a potência fornecida e ln retorna o natural
logaritmo. O tronco natural, funções de exponenciação e piso e teto são extensões e
provavelmente não estão disponíveis em outro piada implementações.

rand retorna um número aleatório uniformemente distribuído em [0,1). Os dois argumentos a seguir
funções são suportadas: atan2, minutos, max. atan2 funciona exatamente como atan2(3). O aleatório
gerador de número pode ser propagado chamando areia com um único parâmetro (convertido
internamente para um número inteiro). Como seu valor de retorno é inútil, você deve usar areia como um
declaração separada, não faz parte de uma expressão válida. areia não é portátil.

A enlouquecer função não recebe argumentos e retorna o id do processo. Isso pode ser usado para semear
o gerador de número aleatório, mas não espere resultados criptograficamente aleatórios.

Além da comparação de strings, nenhuma expressão pode usar strings. Função com valor de uma string
existe: corrida (formato, [expr [, expr]]). Funciona como corrida(3), exceto devolução
O valor que. Ele pode ser usado em qualquer lugar em que uma string entre aspas seja usada. Se piada é executado com -S,
variável de ambiente GRAP_SAFER é definida, ou piada foi compilado para uma operação mais segura,
que o corrida comando irá retornar a string de formato. Este modo de operação é apenas intencional
para ser usado somente se piada está sendo usado como parte de um sistema de impressão habilitado para superusuário.

piada a versão 1.44 e posteriores suportam duas funções para manipulação de data e hora, tempo de strp
e tempo de strp. tempo de strp analisa um tempo usando o tempo de strp(3) função. Leva dois
parâmetros, ambas as strings, o formato e uma string para analisar usando esse formato e retorna um
número que pode ser classificado diretamente - o número de segundos desde a época do UNIX. horário de trabalho
faz o inverso. Ele pega uma string e um número e formata o número em uma data. No
ambas as funções, o formato é o primeiro parâmetro. Os formatos são definidos no
documentação para horário de trabalho(3).

Macros
piada tem um recurso de macro simples, mas poderoso. As macros são definidas usando o definir comando
:

definir nome quadra
indefinir nome

Cada ocorrência de nome no texto do programa é substituído pelo conteúdo de quadra.
quadra é definido por uma série de declarações em {} aninhados, ou uma série de declarações
rodeado pela mesma letra. Um exemplo deste último é

definir foo X coord x 1,3 X
Cada vez que foo aparecer no texto, ele será substituído por coord x 1,3. Macros são
literal e pode conter novas linhas. Se uma macro não abranger várias linhas, ela deve
termine com ponto-e-vírgula para evitar erros de análise.

As macros também podem aceitar parâmetros. Se uma chamada de macro for seguida por um parêntese,
lista separada por vírgulas, os valores começando com $ 1 serão substituídos na macro por
os elementos da lista. Um $ não seguido por um dígito permanece inalterado. Esse
a análise é muito rudimentar; nenhum aninhamento, parênteses ou escape de vírgulas é
permitido. Além disso, não há como dizer o argumento 1 seguido por um dígito ($ {1} 0 em
sh(1)).

O seguinte desenhará uma linha com inclinação 1.

definir foo {próximo em $ 1, $ 2}
para i de 1 a 5 {foo (i, i)}
As macros persistem nos gráficos. O arquivo /usr/share/grap/grap.defines contém simples
macros para traçar personagens comuns. o indefinir comando exclui uma macro.

Veja o diretório / usr / share / doc / grap / examples para mais exemplos de macros. confirme
a localização do diretório de exemplos usando o -v bandeira.

Sessão listas
Uma lista de números separados por espaços em branco é tratada de maneira especial. A lista é considerada como pontos
a ser plotado usando o estilo de linha padrão no sistema de coordenadas padrão. Se mais que
dois números são dados, os números extras são considerados valores y adicionais para traçar no
primeiro valor x. Listas de números em DWB piada pode ser separado por vírgulas, e este piada apóia isso
também. Mais precisamente, os números nas listas de números podem ser separados por qualquer um dos espaços em branco,
vírgulas ou ambos.

1 2 3
4 5 6

Traçará pontos usando o estilo de linha padrão em (1,2), (1,3), (4,5) e (4,6). Um jeito simples
para traçar um conjunto de números em um arquivo chamado ./dados é:

.G1
copiar "./data"
.G2

Pic Macros
piada define macros pic que podem ser usadas no código pic embutido para colocar elementos no
gráfico. As macros são x_gg, a_gg e xy_gg. Essas macros definem distâncias de imagem que
correspondem ao argumento fornecido. Eles podem ser usados ​​para dimensionar caixas ou para traçar construções de imagens
no gráfico. Para colocar uma determinada construção no gráfico, você deve adicionar Frame.Origin a ele.
Outros espaços de coordenadas podem ser usados ​​substituindo gg com o nome do espaço de coordenadas.
Um espaço de coordenadas chamado gg não pode ser acessado de forma confiável por essas macros.

As macros são emitidas imediatamente antes de o quadro ser desenhado.

DWB piada pode usá-los como parte de sua implementação. Esse piada fornece-os apenas para
compatibilidade. Observe que essas são macros muito simples e podem não fazer o que você espera em
condições complexas.

MEIO AMBIENTE VARIÁVEIS

Se a variável de ambiente GRAP_DEFINES for definida, piada irá procurar pelo seu arquivo de definição
lá. Se esse valor for um nome de caminho relativo, o caminho especificado no -M opção será
procurou por ele. GRAP_DEFINES substitui o compilado na localização do arquivo de definição, mas
pode ser substituído pelo -d or -D bandeiras.

Se GRAP_SAFER estiver definido, corrida está desabilitado para evitar forçar piada para despejar o núcleo ou destruir o
pilha.

Use o grap online usando os serviços onworks.net