Wiki**3 - User contributions [en]

Programação com Objectos/Projecto de Programação com Objectos/Enunciado do Projecto de 2026-2027 (rascunho)

2026-07-04T16:28:50Z

Root:

{{PRJPOAvisosEN20262027}}
{{PRJPOMandatory20262027}}
{{TOCright}}

'''EM PREPARAÇÃO'''

'''ÉPOCA NORMAL'''

O objectivo do projecto é desenvolver um sistema de gestão de '''entregas rápidas de produtos''' (ERP). O sistema deverá permitir, entre outras operações, (i) registar dados de empresas; (ii) registar dados de clientes; (iii) consultar e pesquisar produtos; e (iv) efectuar compras e gerir as entregas correspondentes.

Neste texto, o tipo '''negrito''' indica um literal (i.e., é exactamente como apresentado); o símbolo ␣ indica um espaço; e o tipo ''itálico'' indica uma parte variável (i.e., uma descrição).

= Conceitos e Relações do Modelo =

Existem vários conceitos importantes neste contexto: [[#Empresas|empresas]], [[#Produtos|produtos]], [[#Clientes|clientes]], [[#Compras|compras]] e [[#Entregas|entregas]].

Os conceitos listados não são os únicos possíveis no modelo e as suas relações (assim como relações com outros conceitos não mencionados) podem depender das escolhas do projecto.

Os '''clientes''' e os '''produtos''' são independentes das empresas: existem por si e podem relacionar-se com várias empresas. Cada '''empresa''', no entanto, mantém registo dos clientes com que interage, dos produtos que vende e das entregas que efectua.

== Empresas ==

O sistema mantém um registo das empresas que operam na plataforma. Cada empresa é identificada por um número de empresa. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Cada empresa tem ainda um nome (cadeia de caracteres não vazia).

Cada empresa é responsável por manter actualizada informação sobre:
* os '''produtos''' que vende;
* os '''clientes''' com que já interagiu (i.e., que lhe fizeram compras);
* as '''entregas''' que efectuou.

Note-se que a mesma informação global (produtos e clientes) pode ser partilhada por várias empresas. Deve ser possível adicionar outras propriedades às empresas sem impacto para o código já desenvolvido.

== Produtos ==

O sistema mantém um registo de produtos. Cada produto é identificado por um número de produto. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Todos os produtos têm um nome/descrição (cadeia de caracteres), um preço unitário (número inteiro, por simplicidade), um prazo de entrega (número inteiro de dias) e um número de exemplares em ''stock''.

Cada produto tem uma categoria, de acordo com a sua natureza. Inicialmente, consideram-se as seguintes categorias: (i) alimentar; (ii) electrónica; e (iii) vestuário. Deve ser possível adicionar novas categorias com impacto mínimo na aplicação já desenvolvida.

Os produtos a considerar inicialmente são de dois tipos. As propriedades específicas de cada um (além das gerais) são as seguintes:
* Produto fabricado – nome do fabricante (cadeia de caracteres) e um código de fabrico (cadeia de caracteres).
* Produto importado – país de origem (cadeia de caracteres) e uma taxa alfandegária (número inteiro).

Deve ser possível criar novos tipos de produto. O impacto da introdução dos novos tipos na implementação desenvolvida deve ser mínimo.

== Clientes ==

O sistema mantém um registo de clientes. Cada cliente é identificado por um número de cliente. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Cada cliente tem ainda informação sobre o seu nome e endereço de correio electrónico. Estes campos não podem ser vazios.

Assume-se que '''os clientes têm sempre dinheiro''', i.e., uma compra nunca é recusada por falta de fundos. Deve, no entanto, ser possível discriminar os clientes segundo outros critérios (por exemplo, o volume de compras), com um impacto mínimo na implementação desenvolvida.

== Compras ==

O sistema regista as compras efectuadas pelos clientes. Cada compra é identificada por um número de compra, atribuído automaticamente e incrementalmente. Uma compra é sempre feita por um único '''cliente''' a uma única '''empresa''' e regista a data em que foi efectuada.

Uma compra é constituída por um conjunto de linhas (um "cabaz"). Cada linha corresponde a:
* um '''produto''';
* uma '''quantidade''' (número de exemplares adquiridos desse produto);
* um '''preço unitário''' (o preço do produto no momento da compra);
* um '''preço total da linha''' (quantidade × preço unitário).

O '''preço total dos itens''' de uma compra é a soma dos preços totais das suas linhas. A cada compra está ainda associada uma '''sobretaxa de entrega''', correspondente a '''10% do preço total dos itens''' (i.e., 10% por item). O '''preço total da compra''' é, assim, o preço total dos itens acrescido da sobretaxa de entrega.

Como se descreve na secção seguinte, uma compra pode dar origem a mais do que uma entrega. A divisão de uma compra em várias entregas '''não acrescenta qualquer custo''': a sobretaxa de entrega é sempre 10% do preço total dos itens, independentemente do número de entregas.

== Entregas ==

A cada compra correspondem uma ou mais '''entregas'''. As entregas são determinadas a partir dos prazos de entrega dos produtos que constam da compra.

Calcula-se a '''média dos prazos de entrega''' dos produtos das linhas da compra. Então:
* todas as linhas cujo produto tem prazo '''menor ou igual à média''' são agrupadas numa única entrega (a entrega "conjunta");
* cada linha cujo produto tem prazo '''estritamente maior do que a média''' é enviada '''separadamente''', numa entrega própria (uma entrega "conjunta" pode não existir se todas as linhas forem enviadas separadamente).

Cada entrega tem uma data de chegada, calculada a partir da data da compra e do prazo aplicável: uma entrega separada usa o prazo do respectivo produto; a entrega conjunta usa o maior dos prazos dos seus produtos. Como referido acima, o envio separado é feito '''sem custo adicional'''.

Por exemplo, considere-se uma compra com três linhas cujos produtos têm os prazos de entrega 3 (P1), 8 (P2) e 2 (P3). A média dos prazos é (3 + 8 + 2) / 3 ≈ 4,33. Logo, P1 e P3 (prazos ≤ 4,33) seguem juntos numa entrega e P2 (prazo > 4,33) segue numa entrega separada:

Entrega A: {P1, P3} (prazo = 3)
Entrega B: {P2} (prazo = 8) -- enviada separadamente

== Pesquisas ==

Para permitir que o sistema ajude os clientes a determinar a existência de um produto, deverá ser possível efectuar pesquisas. As pesquisas consideram os campos relevantes dos vários produtos (por exemplo, o nome e a categoria). O termo de pesquisa deve ser comparado sem distinção entre letras maiúsculas e minúsculas. Deve ser possível introduzir novos métodos de pesquisa de um produto com um impacto mínimo na implementação desenvolvida.

== Alterações de Inventário de Produtos ==

O ''stock'' de um produto pode ser alterado, através da especificação de um valor a somar/subtrair ao número de exemplares: se a quantidade indicada for um valor positivo, aumenta-se o número de exemplares disponíveis; se for um valor negativo, decrementa-se o número de exemplares disponíveis desde que o número de exemplares disponíveis não fique negativo.

Caso o número de exemplares de um produto chegue a 0, então o produto deve ser removido do sistema.

{{Suggestion|Note-se que a remoção de um produto tem impacto na gestão das empresas que o vendiam.}}

== Gestão de Tempo ==

A unidade de tempo do sistema é o dia. A data do sistema começa no dia 1 (um) e faz parte do estado persistente. Sempre que a data é alterada, deve ser verificada a situação das entregas: uma entrega considera-se '''entregue''' quando a data actual atinge (ou ultrapassa) a sua data de chegada. Devem ainda ser actualizados outros aspectos que da data dependam.

== Notificações ==

Deve existir um mecanismo de notificações que permita avisar eventuais interessados quando os produtos ficam em determinadas situações:
* Quando um produto sem qualquer exemplar disponível passa a ter pelo menos um exemplar disponível, quer-se enviar uma notificação a todas as entidades que demonstraram interesse nesta situação.

As notificações de um cliente apenas devem ser apresentadas uma única vez. Após esta visualização, considera-se que o cliente fica sem notificações. As notificações devem ser apresentadas pela mesma ordem em que foram enviadas pelo sistema.

No caso de uma entidade interessada em ser avisada da disponibilidade de um produto, isto significa que, sempre que o produto em causa passar da situação de indisponível (todos os exemplares esgotados) para disponível (pelo menos um exemplar), a entidade deve receber uma notificação. Deve ser possível definir novas entidades interessadas e novos tipos de notificação, com impacto mínimo no código do domínio da aplicação.

= Requisitos de Desenho =

A aplicação a desenvolver deve seguir o princípio de desenho aberto-fechado, por forma a aumentar a extensibilidade do seu código. Por exemplo, deve ser possível adicionar novos tipos de produto com um impacto mínimo no código já existente da aplicação.

Devem ser possíveis extensões ou alterações de funcionalidade com impacto mínimo no código já produzido para a aplicação. O objectivo é aumentar a flexibilidade da aplicação relativamente ao suporte de novas funções. Assim, deve ser possível:
* Adicionar novos tipos de produto (e.g., produtos digitais ou perecíveis);
* Adicionar novas categorias de produto;
* Definir novas entidades que desejem ser notificadas da disponibilidade de produtos;
* Introduzir novos critérios de discriminação/classificação dos clientes;
* Introduzir novos métodos de pesquisa de produtos;
* Alterar a regra de cálculo das entregas e da sobretaxa de entrega com um impacto mínimo no código existente.

= Funcionalidade da aplicação =

A aplicação permite manter informação sobre as entidades do modelo, permitindo, em particular, gerir empresas, produtos, clientes e compras. Possui ainda a capacidade de preservar o seu estado (não é possível manter várias versões do estado da aplicação em simultâneo).

A aplicação deve estar preparada para que se possa remover qualquer entidade (não apenas produtos).

No [[#Leitura de Dados a Partir de Ficheiros Textuais|início]], a aplicação está vazia, mas pode ser carregada uma base de dados textual com conceitos pré-definidos. Neste caso, a aplicação começará com um estado referente às entidades que foram carregadas no arranque da aplicação.

{{Suggestion|Note-se que não é necessário implementar de raiz a aplicação: já existem classes que representam e definem a interface geral da funcionalidade do ''core'' da aplicação, tal como é visível pelos comandos da aplicação.}}
{{CVSCode|A interface geral do ''core'' já está parcialmente implementada na classe '''erp.ErpManager''' e outras fornecidas (cujos nomes devem ser mantidos), devendo ser adaptadas onde necessário. É ainda necessário criar e implementar as restantes classes que suportam a operação da aplicação.}}
{{Suggestion|O esqueleto actualmente fornecido no repositório ainda contém nomes herdados do projecto anterior (por exemplo, '''erp.LibraryManager''' e as ''packages'' '''erp.app.{work,user,request}'''), que devem ser adaptados aos conceitos deste enunciado ('''erp.app.{company,product,client,purchase}'''). Os nomes das classes de apoio de uso obrigatório não podem ser alterados.}}

== Serialização ==

É possível guardar e recuperar o estado actual da aplicação, preservando toda a informação relacionada com o ERP e que foi descrita [[#Conceitos e Relações do Modelo|acima]].

= Interacção com o utilizador =

Descreve-se nesta secção a '''funcionalidade máxima''' da interface com o utilizador. Em geral, os comandos pedem toda a informação antes de procederem à sua validação (excepto onde indicado). Todos os menus têm automaticamente a opção '''Sair''' (fecha o menu).

As operações de pedido e apresentação de informação ao utilizador '''devem''' realizar-se através dos objectos ''form'' e ''display'', respectivamente, presentes em cada comando. As mensagens são produzidas pelos métodos das [[Programação com Objectos/Projecto de Programação com Objectos/Material de Apoio ao Desenvolvimento|bibliotecas de suporte]] ('''po-uilib''' e '''erp-app'''). As mensagens não podem ser usadas no núcleo da aplicação ('''erp-core'''). Além disso, não podem ser definidas novas. Potenciais omissões devem ser esclarecidas antes de qualquer implementação.

De um modo geral, sempre que no contexto de uma operação com o utilizador aconteça alguma excepção, então a operação não deve ter qualquer efeito no estado da aplicação, excepto em caso de indicação contrária na operação em causa. As excepções estão na package '''erp.app.exceptions''', excepto em caso de indicação contrária.

As excepções usadas na interacção (subclasses de '''pt.tecnico.uilib.menus.CommandException'''), excepto em caso de indicação contrária, são lançadas pelos comandos (subclasses de '''pt.tecnico.uilib.menus.Command''') e tratadas pelos menus (instâncias de subclasses de '''pt.tecnico.uilib.menus.Menu'''). Outras excepções não devem substituir as fornecidas nos casos descritos.

Nos pedidos e usos dos vários identificadores, podem ocorrer as seguintes excepções, caso o identificador indicado não corresponda a um objecto conhecido (excepto no processo de registo ou em caso de indicação contrária). Note-se que estas excepções não são utilizáveis no núcleo da aplicação.
{|
! style="background: #ebebeb;" | '''Tipo de dados'''
! style="background: #ebebeb;" | '''Classe'''
! style="background: #ebebeb;" | '''Pedido a apresentar'''
! style="background: #ebebeb;" | '''Excepção a lançar se desconhecido'''
|-
| Empresa
| '''Company'''
| '''erp.app.company.Prompt.companyId()'''
| '''erp.app.exceptions.UnknownCompanyKeyException'''
|-
| Produto
| '''Product'''
| '''erp.app.product.Prompt.productId()'''
| '''erp.app.exceptions.UnknownProductKeyException'''
|-
| Cliente
| '''Client'''
| '''erp.app.client.Prompt.clientId()'''
| '''erp.app.exceptions.UnknownClientKeyException'''
|-
| Compra
| '''Purchase'''
| '''erp.app.purchase.Prompt.purchaseId()'''
| '''erp.app.exceptions.UnknownPurchaseKeyException'''
|}

Alguns casos particulares podem usar pedidos específicos não apresentados nesta tabela.

{{CVSCode|Note-se que o programa principal e os comandos e menus, a seguir descritos, já estão parcial ou completamente implementados nas ''packages'' '''erp.app''', '''erp.app.main''', '''erp.app.company''', '''erp.app.product''', '''erp.app.client''', '''erp.app.purchase'''. Estas classes são de uso obrigatório e estão disponíveis no [[Programação com Objectos/Projecto de Programação com Objectos/Repositório GIT|GIT]] (módulo '''erp-app''').}}

== Menu Principal ==

As acções deste menu permitem gerir a salvaguarda do estado da aplicação e abrir submenus. A lista completa é a seguinte: [[#Salvaguarda do estado actual da aplicação|Abrir]], [[#Salvaguarda do estado actual da aplicação|Guardar]], [[#Mostrar data actual|Mostrar data actual]], [[#Avançar data actual|Avançar data actual]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Empresas]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Produtos]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Clientes]] e [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Compras]]. Inicialmente, a aplicação apenas tem informação sobre as entidades que foram carregadas no arranque.

{{CVSCode|As etiquetas das opções deste menu estão definidas na classe '''erp.app.main.Label'''. Todos os métodos correspondentes às mensagens de diálogo para este menu estão definidos na classe '''erp.app.main.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.main''', respectivamente: '''DoOpenFile''', '''DoSaveFile''', '''DoDisplayDate''', '''DoAdvanceDate''', '''DoOpenMenuCompanies''', '''DoOpenMenuProducts''', '''DoOpenMenuClients''', '''DoOpenMenuPurchases'''.}}

=== Salvaguarda do estado actual da aplicação ===

O conteúdo da aplicação (toda a informação detida pelo ERP actualmente em memória) pode ser guardado para posterior recuperação (via serialização Java: '''java.io.Serializable'''). Na leitura e escrita do estado da aplicação, devem ser tratadas as excepções associadas. A funcionalidade é a seguinte:

* '''Abrir''' -- Carrega os dados de uma sessão anterior a partir de um ficheiro previamente guardado (ficando este ficheiro associado à aplicação, para futuras operações de salvaguarda). Pede-se o nome do ficheiro a abrir ('''Prompt.openFile()'''). Caso ocorra um problema na abertura ou processamento do ficheiro, deve ser lançada a excepção '''FileOpenFailedException'''. A execução bem-sucedida desta opção substitui toda a informação da aplicação. Quando se abandona uma aplicação com modificações não guardadas (porque se abre outra e existem alterações não guardadas), deve perguntar-se ao utilizador se quer guardar a informação actual antes de a abandonar, através de '''Prompt.saveBeforeExit()''' (a resposta é obtida via '''Form.confirm()''').

* '''Guardar''' -- Guarda o estado actual da aplicação no ficheiro associado. Se não existir associação, pede-se o nome do ficheiro a utilizar, ficando a ele associado (para operações de salvaguarda subsequentes). Esta interacção realiza-se através do método '''Prompt.newSaveAs()'''. Não é executada nenhuma acção se não existirem alterações desde a última salvaguarda.

{{Suggestion|Note-se que a opção '''Abrir''' não permite a leitura de ficheiros de texto (estes apenas podem ser utilizados no início da aplicação).}}
{{Suggestion|A opção '''Sair''' nunca implica a salvaguarda do estado da aplicação, mesmo que existam alterações.}}

=== Mostrar data actual ===

A data actual do sistema é apresentada através da mensagem '''Message.currentDate()'''.

=== Avançar data actual ===

O número de dias a avançar é pedido através de '''Prompt.daysToAdvance()'''. O valor indicado deve ser positivo. Caso contrário, a operação não tem efeito.

Além da data, o sistema deve actualizar, caso seja necessário, outros aspectos que dela dependam, designadamente, a situação das entregas relativa às suas datas de chegada.

=== Gestão e consulta de dados da aplicação ===

* '''Menu de Gestão de Empresas''' -- Abre o menu de gestão de empresas e operações associadas.
* '''Menu de Gestão de Produtos''' -- Abre o menu de gestão de produtos e operações associadas.
* '''Menu de Gestão de Clientes''' -- Abre o menu de gestão de clientes e operações associadas.
* '''Menu de Gestão de Compras''' -- Abre o menu de gestão de compras e operações associadas.

== Menu de Gestão de Empresas ==

Este menu permite efectuar operações sobre a base de dados de empresas. A lista completa é a seguinte: [[#Registar empresa|Registar empresa]], [[#Mostrar empresa|Mostrar empresa]], [[#Mostrar empresas|Mostrar empresas]], [[#Mostrar produtos de uma empresa|Mostrar produtos de uma empresa]], [[#Mostrar clientes de uma empresa|Mostrar clientes de uma empresa]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.company.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.company.Prompt''' e '''erp.app.company.Message'''.}}

=== Registar empresa ===

Pede o nome ('''Prompt.companyName()'''). O registo bem sucedido é assinalado através da mensagem '''Message.registrationSuccessful()'''; caso contrário, é lançada a excepção '''CompanyRegistrationFailedException'''.

Note-se que a atribuição do identificador da empresa é automática.

=== Mostrar empresa ===

É pedido o identificador da empresa, sendo apresentadas as informações sobre essa empresa, de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação de uma empresa|
''id'' - ''nome''
}}

=== Mostrar empresas ===

Apresenta informações sobre todas as empresas, ordenando-as pelos seus identificadores. O formato é o descrito em [[#Mostrar empresa|Mostrar empresa]].

=== Mostrar produtos de uma empresa ===

É pedido o identificador da empresa e apresentam-se os produtos que essa empresa vende, ordenados pelos seus identificadores, utilizando o formato descrito em [[#Mostrar produto|Mostrar produto]].

=== Mostrar clientes de uma empresa ===

É pedido o identificador da empresa e apresentam-se os clientes que já interagiram com essa empresa, ordenados pelos seus identificadores, utilizando o formato descrito em [[#Mostrar cliente|Mostrar cliente]].

== Menu de Gestão de Produtos ==

Este menu apresenta as operações disponíveis sobre produtos. A lista completa é a seguinte: [[#Mostrar produto|Mostrar produto]], [[#Mostrar produtos|Mostrar produtos]], [[#Alterar inventário de um produto|Alterar inventário de um produto]] e [[#Efectuar pesquisa|Efectuar pesquisa]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.product.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.product.Prompt''' e '''erp.app.product.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.product''' (disponível no GIT), respectivamente: '''DoShowProduct''', '''DoShowProducts''', '''DoChangeProductInventory''', '''DoPerformSearch'''.}}

=== Mostrar produto ===

É pedido o identificador do produto. Se o produto existir, é apresentado de acordo com o seguinte formato. O formato genérico de apresentação de um produto é como se segue:
{{CollapsedCode|Formato de apresentação de produtos|
''id'' - ''stock'' - ''tipo'' - ''nome'' - ''preço'' - ''categoria'' - ''informação adicional''
}}

Para produtos fabricados, a informação adicional corresponde ao nome do fabricante e ao código de fabrico (separados pelo carácter ''';'''); para produtos importados, a informação adicional corresponde ao país de origem e à taxa alfandegária.

{{CollapsedCode|Exemplos de apresentação de produtos|
<syntaxhighlight lang="text">
3 - 20 - FABRICADO - Farinha - 15 - ALIMENTAR - Moageira Nacional; F-0091
4 - 2 - IMPORTADO - Telemóvel - 200 - ELECTRONICA - China - 30
5 - 0 - FABRICADO - Camisa - 45 - VESTUARIO - Confeccoes Sul; C-1120
</syntaxhighlight>
}}

=== Mostrar produtos ===

Apresenta informações sobre todos os produtos, ordenando-os pelos seus identificadores. O formato de apresentação é como descrito em [[#Mostrar produto|Mostrar produto]].

=== Alterar inventário de um produto ===

É pedido o identificador de um produto e uma quantidade ('''Prompt.amountToUpdate()''') e actualizado o número de exemplares disponíveis do produto indicado somando a quantidade indicada ao número de exemplares disponíveis. No caso de não ser possível actualizar o número de exemplares devido ao facto de a quantidade indicada ser inválida, então a operação não deve ter qualquer efeito e deve ser apresentada a mensagem '''Message.notEnoughInventory()'''.

=== Efectuar pesquisa ===

Esta opção realiza uma procura por termo (cadeia de caracteres), pedido através de '''Prompt.searchTerm()'''. Como resultado, deve ser apresentada uma lista dos produtos encontrados pela pesquisa, ordenados por ordem crescente do seu identificador, utilizando o formato descrito para [[#Mostrar produto|Mostrar produto]].

O termo de pesquisa deve ser comparado (sem distinção entre letras maiúsculas e minúsculas) com os campos relevantes de cada produto: o nome e a categoria. Só devem ser apresentados produtos que contenham o termo de pesquisa num dos campos relevantes. Caso não sejam encontrados produtos, não deve ser produzido qualquer resultado.

== Menu de Gestão de Clientes ==

Este menu permite efectuar operações sobre a base de dados de clientes. A lista completa é a seguinte: [[#Registar cliente|Registar cliente]], [[#Mostrar cliente|Mostrar cliente]], [[#Mostrar clientes|Mostrar clientes]], [[#Mostrar notificações do cliente|Mostrar notificações do cliente]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.client.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.client.Prompt''' e '''erp.app.client.Message'''.}}

=== Registar cliente ===

Pede o nome ('''Prompt.clientName()''') e o endereço de correio electrónico ('''Prompt.clientEMail()'''). O registo bem sucedido é assinalado através da mensagem '''Message.registrationSuccessful()'''; caso contrário, é lançada a excepção '''ClientRegistrationFailedException'''.

Note-se que a atribuição do identificador do cliente é automática e que clientes diferentes são registados em cada operação de registo.

=== Mostrar cliente ===

É pedido o identificador do cliente, sendo apresentadas as informações sobre esse cliente, de acordo com o seguinte formato. O valor apresentado após o email corresponde ao total gasto pelo cliente em compras (um valor inteiro).
{{CollapsedCode|Formato de apresentação de um cliente|
''id'' - ''nome'' - ''email'' - ''gasto total''
}}
{{CollapsedCode|Exemplos de apresentação de clientes|
<syntaxhighlight lang="text">
2 - Alberto Meireles - ameireles@mymail.com - 275
1 - Fernando Meireles - fmeireles@mymail.com - 0
</syntaxhighlight>
}}

=== Mostrar clientes ===

Apresenta informações sobre todos os clientes, ordenando-os lexicograficamente pelo nome. Caso existam clientes com o mesmo nome, devem ser ordenados por ordem crescente dos seus identificadores. O formato é o descrito em [[#Mostrar cliente|Mostrar cliente]].

=== Mostrar notificações do cliente ===

É pedido o identificador do cliente, sendo apresentadas as notificações para esse cliente, de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação das notificações de um cliente|
DISPONIBILIDADE: ''descrição de produto disponível''
}}
{{CollapsedCode|Exemplos de notificações|
<syntaxhighlight lang="text">
DISPONIBILIDADE: 5 - 4 - FABRICADO - Camisa - 45 - VESTUARIO - Confeccoes Sul; C-1120
</syntaxhighlight>
}}

Note-se que a descrição é idêntica à que é realizada para mostrar cada produto. No entanto, a solução deve ser suficientemente flexível para permitir outros formatos de apresentação das notificações (sem impacto no código do domínio da aplicação).

== Menu de Gestão de Compras ==

Este menu apresenta as operações relacionadas com compras e entregas. A lista completa é a seguinte: [[#Efectuar compra|Efectuar compra]], [[#Mostrar compra|Mostrar compra]], [[#Mostrar compras|Mostrar compras]], [[#Mostrar entregas de uma compra|Mostrar entregas de uma compra]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.purchase.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.purchase.Prompt''' e '''erp.app.purchase.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.purchase''' (disponível no GIT), respectivamente: '''DoDoPurchase''', '''DoShowPurchase''', '''DoShowPurchases''', '''DoShowPurchaseDeliveries'''.}}

=== Efectuar compra ===

No processo de efectuar uma compra, o sistema pede, primeiro, a identificação do cliente; de seguida, a identificação da empresa a que a compra é feita; e, finalmente, para cada linha, o identificador do produto e a quantidade pretendida ('''Prompt.productId()''' e '''Prompt.amountToBuy()'''). O processo de adição de linhas termina de acordo com a interacção definida no comando.

Se não houver exemplares suficientes de um produto para satisfazer a quantidade pretendida, deve ser apresentada a mensagem '''Message.notEnoughInventory()''' e essa linha não é adicionada. Concluída a compra, o ''stock'' dos produtos é decrementado, a empresa passa a seguir o cliente e são determinadas as entregas correspondentes. A data limite de chegada de cada entrega é comunicada através da mensagem '''Message.deliveryDate()'''.

=== Mostrar compra ===

É pedido o identificador da compra. Na primeira linha apresenta-se a informação da compra; de seguida, apresentam-se as suas entregas '''em detalhe''' — cada entrega (identificador da compra e data de chegada) seguida da descrição completa de cada um dos seus produtos (o mesmo formato de [[#Mostrar produto|Mostrar produto]]). O formato é o seguinte:
{{CollapsedCode|Formato de apresentação de uma compra (com entregas em detalhe)|
''id'' - ''idCliente'' - ''idEmpresa'' - ''data'' - ''preço total dos itens'' - ''sobretaxa de entrega'' - ''preço total''
''idCompra'' - ''data de chegada''
''descrição de produto''
...
}}
{{CollapsedCode|Exemplos de apresentação de compras|
<syntaxhighlight lang="text">
7 - 3 - 1 - 4 - 90 - 9 - 99
7 - 7
1 - 18 - FABRICADO - Farinha - 15 - ALIMENTAR - Moageira Nacional; F-0091
3 - 2 - FABRICADO - Camisa - 45 - VESTUARIO - Confeccoes Sul; C-1120
7 - 12
2 - 1 - IMPORTADO - Telemovel - 200 - ELECTRONICA - China - 30
</syntaxhighlight>
}}

=== Mostrar compras ===

Apresenta informações sobre todas as compras, ordenando-as pelos seus identificadores. O formato é o descrito em [[#Mostrar compra|Mostrar compra]].

=== Mostrar entregas de uma compra ===

É pedido o identificador da compra e são apresentadas as entregas correspondentes, ordenadas pela data de chegada e, em caso de empate, pelos identificadores dos produtos. Ao contrário de [[#Mostrar compra|Mostrar compra]] (que apresenta as entregas em detalhe), aqui cada entrega é apresentada '''de forma resumida''' (uma linha, apenas com os identificadores dos produtos), de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação de uma entrega|
''idCompra'' - ''data de chegada'' - ''lista de identificadores de produtos''
}}
{{CollapsedCode|Exemplos de apresentação de entregas (compra do exemplo da secção Entregas)|
<syntaxhighlight lang="text">
7 - 7 - 1, 3
7 - 12 - 2
</syntaxhighlight>
}}

= Leitura de Dados a Partir de Ficheiros Textuais =

Além das opções de manipulação de ficheiros descritas no [[#Menu Principal|menu principal]], é possível iniciar a aplicação com um ficheiro de texto especificado pela propriedade Java '''[[#Execução do Programa e Testes Automáticos|import]]'''.

Cada linha tem uma descrição distinta mas que segue o seguinte formato geral. É possível registar empresas, clientes e produtos, e definir os produtos que cada empresa vende. Assume-se que os campos de texto não podem conter o carácter ''':''' e que os preços são números inteiros. Não existem entradas mal-formadas.

Os produtos têm o formato descrito abaixo, respectivamente, para produtos fabricados e importados. O campo ''stock'' indica o número de exemplares disponíveis do produto.

MANUFACTURED:''idEmpresa'':''nome'':''preço'':''categoria'':''prazo'':''stock'':''fabricante'':''codigo''
IMPORTED:''idEmpresa'':''nome'':''preço'':''categoria'':''prazo'':''stock'':''paisOrigem'':''taxa''

O registo de empresas e de clientes segue os formatos:

COMPANY:''nome''
CLIENT:''nome'':''email''

Um exemplo de conteúdo do ficheiro inicial é como se segue:

{{CollapsedCode|Exemplo de ficheiro de entrada textual|
<syntaxhighlight lang="text">
COMPANY:Moageira Nacional
COMPANY:Importadora Atlantico
CLIENT:Obi-Wan Kenobi:obiwan@jedi.org
MANUFACTURED:1:Farinha:15:ALIMENTAR:3:23:Moageira Nacional:F-0091
IMPORTED:2:Telemovel:200:ELECTRONICA:8:2:China:30
MANUFACTURED:1:Camisa:45:VESTUARIO:2:4:Confeccoes Sul:C-1120
</syntaxhighlight>
}}
A codificação dos ficheiros a ler é garantidamente [[wp:UTF-8|UTF-8]].

{{Suggestion|Usar o método '''String.split()''' para partir cadeias de caracteres e '''String.trim()''' para remover espaços no início e no final.}}
{{Suggestion|Note-se que o programa nunca produz ficheiros com este formato (é apenas um formato para ficheiros de entrada).}}

= Execução do Programa e Testes Automáticos =

Usando os ficheiros '''test.import''', '''test.in''' e '''test.out''', é possível verificar automaticamente o resultado correcto do programa. Note-se que é necessária a definição apropriada da variável '''CLASSPATH''' (ou da opção equivalente '''-cp''' do comando '''java'''), para localizar as classes do programa, incluindo a que contém o método correspondente ao ponto de entrada da aplicação ('''erp.app.App.main'''). As propriedades são tratadas automaticamente pelo código de apoio.

java -Dimport=test.import -Din=test.in -Dout=test.outhyp erp.app.App

Assumindo que aqueles ficheiros estão no directório onde é dado o comando de execução, o programa produz o ficheiro de saída '''test.outhyp'''. Em caso de sucesso, os ficheiros das saídas esperada ('''test.out''') e obtida ('''test.outhyp''') devem ser iguais. A comparação pode ser feita com o comando:

diff -b test.out test.outhyp

Este comando não deve produzir qualquer resultado quando os ficheiros são iguais. Note-se, contudo, que este teste não garante o correcto funcionamento do código desenvolvido, apenas verificando alguns aspectos da sua funcionalidade.

= Notas de Implementação =

Tal como indicado acima, algumas classes fornecidas como [[Programação com Objectos/Projecto de Programação com Objectos/Material de Apoio ao Desenvolvimento|material de apoio]], são de uso obrigatório e não podem ser alteradas. Outras dessas classes são de uso obrigatório e têm de ser alteradas.

A serialização Java usa as classes da ''package'' [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/package-summary.html java.io], em particular, a interface [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/Serializable.html java.io.Serializable] e as classes de leitura [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/ObjectInputStream.html java.io.ObjectInputStream] e escrita [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/ObjectOutputStream.html java.io.ObjectOutputStream] (entre outras).

[[category: Ensino]]
[[category:PO]]
[[category: Projecto de PO]]
[[en:Object-Oriented Programming]]

Template:PRJPOMandatory20262027

2026-07-03T14:43:32Z

Root: Created page with "{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #ffdb24;" ! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #ffdb24;" | '''Material de Uso Obrigatório''' |- ! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; bor..."

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #ffdb24;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #ffdb24;" | '''Material de Uso Obrigatório'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 0px; border-color: #bbbbaa; " | As bibliotecas po-uilib e o conteúdo inicial do repositório GIT são de uso obrigatório:
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 0px; border-color: #bbbbaa; " |
* po-uilib (classes de base) [[media:po-uilib-202608310000.tar.bz2|po-uilib-202608310000.tar.bz2]] (não pode ser alterada) - [https://www.hlt.inesc-id.pt/~david/ist/docencia/po/2026-2027/javadoc/ javadoc]
* ewrp-core (classes do "core") (via GIT) (deve ser completada -- os nomes das classes fornecidas não podem ser alterados)
* erp-app (classes de interacção) (via GIT) (deve ser completada -- os nomes das classes fornecidas não podem ser alterados)
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 0px; border-color: #bbbbaa; " | A [[Programação com Objectos/Projecto de Programação com Objectos/Máquina Virtual|máquina virtual]], fornecida para desenvolvimento do projecto, já contém todo o material de apoio.
|-
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 1px; border-bottom-width: 0px; border-color: #bbbbaa; background: #ffdb24;" | '''Uso Obrigatório: Repositório GIT'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 0px; border-color: #bbbbaa; " | '''Apenas se consideram para avaliação os projectos existentes no [[Programação com Objectos/Projecto de Programação com Objectos/Repositório GIT|repositório GIT oficial]]'''.

Trabalhos não presentes no repositório no final do prazo têm classificação 0 (zero) (não são aceites outras formas de entrega). Não são admitidas justificações para atrasos em sincronizações do repositório. A indisponibilidade temporária do repositório, desde que inferior a 24 horas, não justifica atrasos na submissão de um trabalho.
|}

Template:PRJPOAvisosEN20262027

2026-07-03T14:41:55Z

Root: Created page with "{{PRJPOAvisos|po26@inesc-id.pt|2026/10/16 12:00|2026/11/20 12:00|2026/12/18 12:00|2026/12/18 (early bird) 2027/01/06 (normal)}}"

{{PRJPOAvisos|po26@inesc-id.pt|2026/10/16 12:00|2026/11/20 12:00|2026/12/18 12:00|2026/12/18 (early bird) 2027/01/06 (normal)}}

Programação com Objectos/Projecto de Programação com Objectos/Enunciado do Projecto de 2026-2027 (rascunho)

2026-07-03T14:39:15Z

Root: Created page with "{{PRJPOAvisosEN20262027}} {{PRJPOMandatory20262027}} {{TOCright}} '''EM PREPARAÇÃO''' '''ÉPOCA NORMAL''' O objectivo do projecto é desenvolver um sistema de gestão de '''entregas rápidas de produtos''' (ERP). O sistema deverá permitir, entre outras operações, (i) registar dados de empresas; (ii) registar dados de clientes; (iii) consultar e pesquisar produtos; e (iv) efectuar compras e gerir as entregas corres..."

{{PRJPOAvisosEN20262027}}
{{PRJPOMandatory20262027}}
{{TOCright}}

'''EM PREPARAÇÃO'''

'''ÉPOCA NORMAL'''

O objectivo do projecto é desenvolver um sistema de gestão de '''entregas rápidas de produtos''' (ERP). O sistema deverá permitir, entre outras operações, (i) registar dados de empresas; (ii) registar dados de clientes; (iii) consultar e pesquisar produtos; e (iv) efectuar compras e gerir as entregas correspondentes.

Neste texto, o tipo '''negrito''' indica um literal (i.e., é exactamente como apresentado); o símbolo ␣ indica um espaço; e o tipo ''itálico'' indica uma parte variável (i.e., uma descrição).

= Conceitos e Relações do Modelo =

Existem vários conceitos importantes neste contexto: [[#Empresas|empresas]], [[#Produtos|produtos]], [[#Clientes|clientes]], [[#Compras|compras]] e [[#Entregas|entregas]].

Os conceitos listados não são os únicos possíveis no modelo e as suas relações (assim como relações com outros conceitos não mencionados) podem depender das escolhas do projecto.

Os '''clientes''' e os '''produtos''' são independentes das empresas: existem por si e podem relacionar-se com várias empresas. Cada '''empresa''', no entanto, mantém registo dos clientes com que interage, dos produtos que vende e das entregas que efectua.

== Empresas ==

O sistema mantém um registo das empresas que operam na plataforma. Cada empresa é identificada por um número de empresa. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Cada empresa tem ainda um nome (cadeia de caracteres não vazia).

Cada empresa é responsável por manter actualizada informação sobre:
* os '''produtos''' que vende;
* os '''clientes''' com que já interagiu (i.e., que lhe fizeram compras);
* as '''entregas''' que efectuou.

Note-se que a mesma informação global (produtos e clientes) pode ser partilhada por várias empresas. Deve ser possível adicionar outras propriedades às empresas sem impacto para o código já desenvolvido.

== Produtos ==

O sistema mantém um registo de produtos. Cada produto é identificado por um número de produto. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Todos os produtos têm um nome/descrição (cadeia de caracteres), um preço unitário (número inteiro, por simplicidade), um prazo de entrega (número inteiro de dias) e um número de exemplares em ''stock''.

Cada produto tem uma categoria, de acordo com a sua natureza. Inicialmente, consideram-se as seguintes categorias: (i) alimentar; (ii) electrónica; e (iii) vestuário. Deve ser possível adicionar novas categorias com impacto mínimo na aplicação já desenvolvida.

Os produtos a considerar inicialmente são de dois tipos. As propriedades específicas de cada um (além das gerais) são as seguintes:
* Produto fabricado – nome do fabricante (cadeia de caracteres) e um código de fabrico (cadeia de caracteres).
* Produto importado – país de origem (cadeia de caracteres) e uma taxa alfandegária (número inteiro).

Deve ser possível criar novos tipos de produto. O impacto da introdução dos novos tipos na implementação desenvolvida deve ser mínimo.

== Clientes ==

O sistema mantém um registo de clientes. Cada cliente é identificado por um número de cliente. O identificador é atribuído automaticamente e incrementalmente (a partir de 1 ou do último valor atribuído, caso o estado do sistema tenha sido recuperado). Cada cliente tem ainda informação sobre o seu nome e endereço de correio electrónico. Estes campos não podem ser vazios.

Assume-se que '''os clientes têm sempre dinheiro''', i.e., uma compra nunca é recusada por falta de fundos. Deve, no entanto, ser possível discriminar os clientes segundo outros critérios (por exemplo, o volume de compras), com um impacto mínimo na implementação desenvolvida.

== Compras ==
O sistema regista as compras efectuadas pelos clientes. Cada compra é identificada por um número de compra, atribuído automaticamente e incrementalmente. Uma compra é sempre feita por um único '''cliente''' a uma única '''empresa''' e regista a data em que foi efectuada.

Uma compra é constituída por um conjunto de linhas (um "cabaz"). Cada linha corresponde a:
* um '''produto''';
* uma '''quantidade''' (número de exemplares adquiridos desse produto);
* um '''preço unitário''' (o preço do produto no momento da compra);
* um '''preço total da linha''' (quantidade × preço unitário).

O '''preço total dos itens''' de uma compra é a soma dos preços totais das suas linhas. A cada compra está ainda associada uma '''sobretaxa de entrega''', correspondente a '''10% do preço total dos itens''' (i.e., 10% por item). O '''preço total da compra''' é, assim, o preço total dos itens acrescido da sobretaxa de entrega.

Como se descreve na secção seguinte, uma compra pode dar origem a mais do que uma entrega. A divisão de uma compra em várias entregas '''não acrescenta qualquer custo''': a sobretaxa de entrega é sempre 10% do preço total dos itens, independentemente do número de entregas.

== Entregas ==

A cada compra correspondem uma ou mais '''entregas'''. As entregas são determinadas a partir dos prazos de entrega dos produtos que constam da compra.

Calcula-se a '''média dos prazos de entrega''' dos produtos das linhas da compra. Então:
* todas as linhas cujo produto tem prazo '''menor ou igual à média''' são agrupadas numa única entrega (a entrega "conjunta");
* cada linha cujo produto tem prazo '''estritamente maior do que a média''' é enviada '''separadamente''', numa entrega própria (uma entrega "conjunta" pode não existir se todas as linhas forem enviadas separadamente).

Cada entrega tem uma data de chegada, calculada a partir da data da compra e do prazo aplicável: uma entrega separada usa o prazo do respectivo produto; a entrega conjunta usa o maior dos prazos dos seus produtos. Como referido acima, o envio separado é feito '''sem custo adicional'''.

Por exemplo, considere-se uma compra com três linhas cujos produtos têm os prazos de entrega 3 (P1), 8 (P2) e 2 (P3). A média dos prazos é (3 + 8 + 2) / 3 ≈ 4,33. Logo, P1 e P3 (prazos ≤ 4,33) seguem juntos numa entrega e P2 (prazo > 4,33) segue numa entrega separada:

Entrega A: {P1, P3} (prazo = 3)
Entrega B: {P2} (prazo = 8) -- enviada separadamente

== Pesquisas ==

Para permitir que o sistema ajude os clientes a determinar a existência de um produto, deverá ser possível efectuar pesquisas. As pesquisas consideram os campos relevantes dos vários produtos (por exemplo, o nome e a categoria). O termo de pesquisa deve ser comparado sem distinção entre letras maiúsculas e minúsculas. Deve ser possível introduzir novos métodos de pesquisa de um produto com um impacto mínimo na implementação desenvolvida.

== Alterações de Inventário de Produtos ==

O ''stock'' de um produto pode ser alterado, através da especificação de um valor a somar/subtrair ao número de exemplares: se a quantidade indicada for um valor positivo, aumenta-se o número de exemplares disponíveis; se for um valor negativo, decrementa-se o número de exemplares disponíveis desde que o número de exemplares disponíveis não fique negativo.

Caso o número de exemplares de um produto chegue a 0, então o produto deve ser removido do sistema.

{{Suggestion|Note-se que a remoção de um produto tem impacto na gestão das empresas que o vendiam.}}

== Gestão de Tempo ==

A unidade de tempo do sistema é o dia. A data do sistema começa no dia 1 (um) e faz parte do estado persistente. Sempre que a data é alterada, deve ser verificada a situação das entregas: uma entrega considera-se '''entregue''' quando a data actual atinge (ou ultrapassa) a sua data de chegada. Devem ainda ser actualizados outros aspectos que da data dependam.

== Notificações ==
Deve existir um mecanismo de notificações que permita avisar eventuais interessados quando os produtos ficam em determinadas situações:
* Quando um produto sem qualquer exemplar disponível passa a ter pelo menos um exemplar disponível, quer-se enviar uma notificação a todas as entidades que demonstraram interesse nesta situação.

As notificações de um cliente apenas devem ser apresentadas uma única vez. Após esta visualização, considera-se que o cliente fica sem notificações. As notificações devem ser apresentadas pela mesma ordem em que foram enviadas pelo sistema.

No caso de uma entidade interessada em ser avisada da disponibilidade de um produto, isto significa que, sempre que o produto em causa passar da situação de indisponível (todos os exemplares esgotados) para disponível (pelo menos um exemplar), a entidade deve receber uma notificação. Deve ser possível definir novas entidades interessadas e novos tipos de notificação, com impacto mínimo no código do domínio da aplicação.

= Requisitos de Desenho =

A aplicação a desenvolver deve seguir o princípio de desenho aberto-fechado, por forma a aumentar a extensibilidade do seu código. Por exemplo, deve ser possível adicionar novos tipos de produto com um impacto mínimo no código já existente da aplicação.

Devem ser possíveis extensões ou alterações de funcionalidade com impacto mínimo no código já produzido para a aplicação. O objectivo é aumentar a flexibilidade da aplicação relativamente ao suporte de novas funções. Assim, deve ser possível:
* Adicionar novos tipos de produto (e.g., produtos digitais ou perecíveis);
* Adicionar novas categorias de produto;
* Definir novas entidades que desejem ser notificadas da disponibilidade de produtos;
* Introduzir novos critérios de discriminação/classificação dos clientes;
* Introduzir novos métodos de pesquisa de produtos;
* Alterar a regra de cálculo das entregas e da sobretaxa de entrega com um impacto mínimo no código existente.

= Funcionalidade da aplicação =

A aplicação permite manter informação sobre as entidades do modelo, permitindo, em particular, gerir empresas, produtos, clientes e compras. Possui ainda a capacidade de preservar o seu estado (não é possível manter várias versões do estado da aplicação em simultâneo).

A aplicação deve estar preparada para que se possa remover qualquer entidade (não apenas produtos).

No [[#Leitura de Dados a Partir de Ficheiros Textuais|início]], a aplicação está vazia, mas pode ser carregada uma base de dados textual com conceitos pré-definidos. Neste caso, a aplicação começará com um estado referente às entidades que foram carregadas no arranque da aplicação.

{{Suggestion|Note-se que não é necessário implementar de raiz a aplicação: já existem classes que representam e definem a interface geral da funcionalidade do ''core'' da aplicação, tal como é visível pelos comandos da aplicação.}}
{{CVSCode|A interface geral do ''core'' já está parcialmente implementada na classe '''erp.ErpManager''' e outras fornecidas (cujos nomes devem ser mantidos), devendo ser adaptadas onde necessário. É ainda necessário criar e implementar as restantes classes que suportam a operação da aplicação.}}
{{Suggestion|O esqueleto actualmente fornecido no repositório ainda contém nomes herdados do projecto anterior (por exemplo, '''erp.LibraryManager''' e as ''packages'' '''erp.app.{work,user,request}'''), que devem ser adaptados aos conceitos deste enunciado ('''erp.app.{company,product,client,purchase}'''). Os nomes das classes de apoio de uso obrigatório não podem ser alterados.}}

== Serialização ==

É possível guardar e recuperar o estado actual da aplicação, preservando toda a informação relacionada com o ERP e que foi descrita [[#Conceitos e Relações do Modelo|acima]].

= Interacção com o utilizador =

Descreve-se nesta secção a '''funcionalidade máxima''' da interface com o utilizador. Em geral, os comandos pedem toda a informação antes de procederem à sua validação (excepto onde indicado). Todos os menus têm automaticamente a opção '''Sair''' (fecha o menu).

As operações de pedido e apresentação de informação ao utilizador '''devem''' realizar-se através dos objectos ''form'' e ''display'', respectivamente, presentes em cada comando. As mensagens são produzidas pelos métodos das [[Programação com Objectos/Projecto de Programação com Objectos/Material de Apoio ao Desenvolvimento|bibliotecas de suporte]] ('''po-uilib''' e '''erp-app'''). As mensagens não podem ser usadas no núcleo da aplicação ('''erp-core'''). Além disso, não podem ser definidas novas. Potenciais omissões devem ser esclarecidas antes de qualquer implementação.

De um modo geral, sempre que no contexto de uma operação com o utilizador aconteça alguma excepção, então a operação não deve ter qualquer efeito no estado da aplicação, excepto em caso de indicação contrária na operação em causa. As excepções estão na package '''erp.app.exceptions''', excepto em caso de indicação contrária.

As excepções usadas na interacção (subclasses de '''pt.tecnico.uilib.menus.CommandException'''), excepto em caso de indicação contrária, são lançadas pelos comandos (subclasses de '''pt.tecnico.uilib.menus.Command''') e tratadas pelos menus (instâncias de subclasses de '''pt.tecnico.uilib.menus.Menu'''). Outras excepções não devem substituir as fornecidas nos casos descritos.

Nos pedidos e usos dos vários identificadores, podem ocorrer as seguintes excepções, caso o identificador indicado não corresponda a um objecto conhecido (excepto no processo de registo ou em caso de indicação contrária). Note-se que estas excepções não são utilizáveis no núcleo da aplicação.
{|
! style="background: #ebebeb;" | '''Tipo de dados'''
! style="background: #ebebeb;" | '''Classe'''
! style="background: #ebebeb;" | '''Pedido a apresentar'''
! style="background: #ebebeb;" | '''Excepção a lançar se desconhecido'''
|-
| Empresa
| '''Company'''
| '''erp.app.company.Prompt.companyId()'''
| '''erp.app.exceptions.UnknownCompanyKeyException'''
|-
| Produto
| '''Product'''
| '''erp.app.product.Prompt.productId()'''
| '''erp.app.exceptions.UnknownProductKeyException'''
|-
| Cliente
| '''Client'''
| '''erp.app.client.Prompt.clientId()'''
| '''erp.app.exceptions.UnknownClientKeyException'''
|-
| Compra
| '''Purchase'''
| '''erp.app.purchase.Prompt.purchaseId()'''
| '''erp.app.exceptions.UnknownPurchaseKeyException'''
|}

Alguns casos particulares podem usar pedidos específicos não apresentados nesta tabela.

{{CVSCode|Note-se que o programa principal e os comandos e menus, a seguir descritos, já estão parcial ou completamente implementados nas ''packages'' '''erp.app''', '''erp.app.main''', '''erp.app.company''', '''erp.app.product''', '''erp.app.client''', '''erp.app.purchase'''. Estas classes são de uso obrigatório e estão disponíveis no [[Programação com Objectos/Projecto de Programação com Objectos/Repositório GIT|GIT]] (módulo '''erp-app''').}}

== Menu Principal ==

As acções deste menu permitem gerir a salvaguarda do estado da aplicação e abrir submenus. A lista completa é a seguinte: [[#Salvaguarda do estado actual da aplicação|Abrir]], [[#Salvaguarda do estado actual da aplicação|Guardar]], [[#Mostrar data actual|Mostrar data actual]], [[#Avançar data actual|Avançar data actual]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Empresas]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Produtos]], [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Clientes]] e [[#Gestão e consulta de dados da aplicação|Menu de Gestão de Compras]]. Inicialmente, a aplicação apenas tem informação sobre as entidades que foram carregadas no arranque.

{{CVSCode|As etiquetas das opções deste menu estão definidas na classe '''erp.app.main.Label'''. Todos os métodos correspondentes às mensagens de diálogo para este menu estão definidos na classe '''erp.app.main.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.main''', respectivamente: '''DoOpenFile''', '''DoSaveFile''', '''DoDisplayDate''', '''DoAdvanceDate''', '''DoOpenMenuCompanies''', '''DoOpenMenuProducts''', '''DoOpenMenuClients''', '''DoOpenMenuPurchases'''.}}

=== Salvaguarda do estado actual da aplicação ===
O conteúdo da aplicação (toda a informação detida pelo ERP actualmente em memória) pode ser guardado para posterior recuperação (via serialização Java: '''java.io.Serializable'''). Na leitura e escrita do estado da aplicação, devem ser tratadas as excepções associadas. A funcionalidade é a seguinte:

* '''Abrir''' -- Carrega os dados de uma sessão anterior a partir de um ficheiro previamente guardado (ficando este ficheiro associado à aplicação, para futuras operações de salvaguarda). Pede-se o nome do ficheiro a abrir ('''Prompt.openFile()'''). Caso ocorra um problema na abertura ou processamento do ficheiro, deve ser lançada a excepção '''FileOpenFailedException'''. A execução bem-sucedida desta opção substitui toda a informação da aplicação. Quando se abandona uma aplicação com modificações não guardadas (porque se abre outra e existem alterações não guardadas), deve perguntar-se ao utilizador se quer guardar a informação actual antes de a abandonar, através de '''Prompt.saveBeforeExit()''' (a resposta é obtida via '''Form.confirm()''').

* '''Guardar''' -- Guarda o estado actual da aplicação no ficheiro associado. Se não existir associação, pede-se o nome do ficheiro a utilizar, ficando a ele associado (para operações de salvaguarda subsequentes). Esta interacção realiza-se através do método '''Prompt.newSaveAs()'''. Não é executada nenhuma acção se não existirem alterações desde a última salvaguarda.

{{Suggestion|Note-se que a opção '''Abrir''' não permite a leitura de ficheiros de texto (estes apenas podem ser utilizados no início da aplicação).}}
{{Suggestion|A opção '''Sair''' nunca implica a salvaguarda do estado da aplicação, mesmo que existam alterações.}}

=== Mostrar data actual ===

A data actual do sistema é apresentada através da mensagem '''Message.currentDate()'''.

=== Avançar data actual ===

O número de dias a avançar é pedido através de '''Prompt.daysToAdvance()'''. O valor indicado deve ser positivo. Caso contrário, a operação não tem efeito.

Além da data, o sistema deve actualizar, caso seja necessário, outros aspectos que dela dependam, designadamente, a situação das entregas relativa às suas datas de chegada.

=== Gestão e consulta de dados da aplicação ===

* '''Menu de Gestão de Empresas''' -- Abre o menu de gestão de empresas e operações associadas.
* '''Menu de Gestão de Produtos''' -- Abre o menu de gestão de produtos e operações associadas.
* '''Menu de Gestão de Clientes''' -- Abre o menu de gestão de clientes e operações associadas.
* '''Menu de Gestão de Compras''' -- Abre o menu de gestão de compras e operações associadas.

== Menu de Gestão de Empresas ==

Este menu permite efectuar operações sobre a base de dados de empresas. A lista completa é a seguinte: [[#Registar empresa|Registar empresa]], [[#Mostrar empresa|Mostrar empresa]], [[#Mostrar empresas|Mostrar empresas]], [[#Mostrar produtos de uma empresa|Mostrar produtos de uma empresa]], [[#Mostrar clientes de uma empresa|Mostrar clientes de uma empresa]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.company.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.company.Prompt''' e '''erp.app.company.Message'''.}}

=== Registar empresa ===

Pede o nome ('''Prompt.companyName()'''). O registo bem sucedido é assinalado através da mensagem '''Message.registrationSuccessful()'''; caso contrário, é lançada a excepção '''CompanyRegistrationFailedException'''.

Note-se que a atribuição do identificador da empresa é automática.

=== Mostrar empresa ===

É pedido o identificador da empresa, sendo apresentadas as informações sobre essa empresa, de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação de uma empresa|
''id'' - ''nome''
}}

=== Mostrar empresas ===

Apresenta informações sobre todas as empresas, ordenando-as pelos seus identificadores. O formato é o descrito em [[#Mostrar empresa|Mostrar empresa]].

=== Mostrar produtos de uma empresa ===

É pedido o identificador da empresa e apresentam-se os produtos que essa empresa vende, ordenados pelos seus identificadores, utilizando o formato descrito em [[#Mostrar produto|Mostrar produto]].

=== Mostrar clientes de uma empresa ===

É pedido o identificador da empresa e apresentam-se os clientes que já interagiram com essa empresa, ordenados pelos seus identificadores, utilizando o formato descrito em [[#Mostrar cliente|Mostrar cliente]].

== Menu de Gestão de Produtos ==

Este menu apresenta as operações disponíveis sobre produtos. A lista completa é a seguinte: [[#Mostrar produto|Mostrar produto]], [[#Mostrar produtos|Mostrar produtos]], [[#Alterar inventário de um produto|Alterar inventário de um produto]] e [[#Efectuar pesquisa|Efectuar pesquisa]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.product.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.product.Prompt''' e '''erp.app.product.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.product''' (disponível no GIT), respectivamente: '''DoShowProduct''', '''DoShowProducts''', '''DoChangeProductInventory''', '''DoPerformSearch'''.}}

=== Mostrar produto ===

É pedido o identificador do produto. Se o produto existir, é apresentado de acordo com o seguinte formato. O formato genérico de apresentação de um produto é como se segue:
{{CollapsedCode|Formato de apresentação de produtos|
''id'' - ''stock'' - ''tipo'' - ''nome'' - ''preço'' - ''categoria'' - ''informação adicional''
}}

Para produtos fabricados, a informação adicional corresponde ao nome do fabricante e ao código de fabrico (separados pelo carácter ''';'''); para produtos importados, a informação adicional corresponde ao país de origem e à taxa alfandegária.

{{CollapsedCode|Exemplos de apresentação de produtos|
<syntaxhighlight lang="text">
3 - 20 - FABRICADO - Farinha - 15 - ALIMENTAR - Moageira Nacional; F-0091
4 - 2 - IMPORTADO - Telemóvel - 200 - ELECTRONICA - China - 30
5 - 0 - FABRICADO - Camisa - 45 - VESTUARIO - Confeccoes Sul; C-1120
</syntaxhighlight>
}}

=== Mostrar produtos ===

Apresenta informações sobre todos os produtos, ordenando-os pelos seus identificadores. O formato de apresentação é como descrito em [[#Mostrar produto|Mostrar produto]].

=== Alterar inventário de um produto ===

É pedido o identificador de um produto e uma quantidade ('''Prompt.amountToUpdate()''') e actualizado o número de exemplares disponíveis do produto indicado somando a quantidade indicada ao número de exemplares disponíveis. No caso de não ser possível actualizar o número de exemplares devido ao facto de a quantidade indicada ser inválida, então a operação não deve ter qualquer efeito e deve ser apresentada a mensagem '''Message.notEnoughInventory()'''.

=== Efectuar pesquisa ===

Esta opção realiza uma procura por termo (cadeia de caracteres), pedido através de '''Prompt.searchTerm()'''. Como resultado, deve ser apresentada uma lista dos produtos encontrados pela pesquisa, ordenados por ordem crescente do seu identificador, utilizando o formato descrito para [[#Mostrar produto|Mostrar produto]].

O termo de pesquisa deve ser comparado (sem distinção entre letras maiúsculas e minúsculas) com os campos relevantes de cada produto: o nome e a categoria. Só devem ser apresentados produtos que contenham o termo de pesquisa num dos campos relevantes. Caso não sejam encontrados produtos, não deve ser produzido qualquer resultado.

== Menu de Gestão de Clientes ==

Este menu permite efectuar operações sobre a base de dados de clientes. A lista completa é a seguinte: [[#Registar cliente|Registar cliente]], [[#Mostrar cliente|Mostrar cliente]], [[#Mostrar clientes|Mostrar clientes]], [[#Mostrar notificações do cliente|Mostrar notificações do cliente]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.client.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.client.Prompt''' e '''erp.app.client.Message'''.}}

=== Registar cliente ===

Pede o nome ('''Prompt.clientName()''') e o endereço de correio electrónico ('''Prompt.clientEMail()'''). O registo bem sucedido é assinalado através da mensagem '''Message.registrationSuccessful()'''; caso contrário, é lançada a excepção '''ClientRegistrationFailedException'''.

Note-se que a atribuição do identificador do cliente é automática e que clientes diferentes são registados em cada operação de registo.

=== Mostrar cliente ===

É pedido o identificador do cliente, sendo apresentadas as informações sobre esse cliente, de acordo com o seguinte formato. O valor apresentado após o email corresponde ao total gasto pelo cliente em compras (um valor inteiro).
{{CollapsedCode|Formato de apresentação de um cliente|
''id'' - ''nome'' - ''email'' - ''gasto total''
}}
{{CollapsedCode|Exemplos de apresentação de clientes|
<syntaxhighlight lang="text">
2 - Alberto Meireles - ameireles@mymail.com - 275
1 - Fernando Meireles - fmeireles@mymail.com - 0
</syntaxhighlight>
}}

=== Mostrar clientes ===

Apresenta informações sobre todos os clientes, ordenando-os lexicograficamente pelo nome. Caso existam clientes com o mesmo nome, devem ser ordenados por ordem crescente dos seus identificadores. O formato é o descrito em [[#Mostrar cliente|Mostrar cliente]].

=== Mostrar notificações do cliente ===

É pedido o identificador do cliente, sendo apresentadas as notificações para esse cliente, de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação das notificações de um cliente|
DISPONIBILIDADE: ''descrição de produto disponível''
}}
{{CollapsedCode|Exemplos de notificações|
<syntaxhighlight lang="text">
DISPONIBILIDADE: 5 - 4 - FABRICADO - Camisa - 45 - VESTUARIO - Confeccoes Sul; C-1120
</syntaxhighlight>
}}

Note-se que a descrição é idêntica à que é realizada para mostrar cada produto. No entanto, a solução deve ser suficientemente flexível para permitir outros formatos de apresentação das notificações (sem impacto no código do domínio da aplicação).

== Menu de Gestão de Compras ==

Este menu apresenta as operações relacionadas com compras e entregas. A lista completa é a seguinte: [[#Efectuar compra|Efectuar compra]], [[#Mostrar compra|Mostrar compra]], [[#Mostrar compras|Mostrar compras]], [[#Mostrar entregas de uma compra|Mostrar entregas de uma compra]].

{{CVSCode|As etiquetas das opções deste menu estão definidas em '''erp.app.purchase.Label'''. Os métodos correspondentes às mensagens de diálogo para este menu estão definidos em '''erp.app.purchase.Prompt''' e '''erp.app.purchase.Message'''.}}
{{CVSCode|Estes comandos já estão implementados nas classes da ''package'' '''erp.app.purchase''' (disponível no GIT), respectivamente: '''DoDoPurchase''', '''DoShowPurchase''', '''DoShowPurchases''', '''DoShowPurchaseDeliveries'''.}}

=== Efectuar compra ===

No processo de efectuar uma compra, o sistema pede, primeiro, a identificação do cliente; de seguida, a identificação da empresa a que a compra é feita; e, finalmente, para cada linha, o identificador do produto e a quantidade pretendida ('''Prompt.productId()''' e '''Prompt.amountToBuy()'''). O processo de adição de linhas termina de acordo com a interacção definida no comando.

Se não houver exemplares suficientes de um produto para satisfazer a quantidade pretendida, deve ser apresentada a mensagem '''Message.notEnoughInventory()''' e essa linha não é adicionada. Concluída a compra, o ''stock'' dos produtos é decrementado, a empresa passa a seguir o cliente e são determinadas as entregas correspondentes. A data limite de chegada de cada entrega é comunicada através da mensagem '''Message.deliveryDate()'''.

=== Mostrar compra ===

É pedido o identificador da compra, sendo apresentadas as informações sobre essa compra, de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação de uma compra|
''id'' - ''idCliente'' - ''idEmpresa'' - ''data'' - ''preço total dos itens'' - ''sobretaxa de entrega'' - ''preço total''
}}
{{CollapsedCode|Exemplos de apresentação de compras|
<syntaxhighlight lang="text">
7 - 3 - 1 - 4 - 90 - 9 - 99
</syntaxhighlight>
}}

=== Mostrar compras ===

Apresenta informações sobre todas as compras, ordenando-as pelos seus identificadores. O formato é o descrito em [[#Mostrar compra|Mostrar compra]].

=== Mostrar entregas de uma compra ===

É pedido o identificador da compra e são apresentadas as entregas correspondentes, ordenadas pela data de chegada e, em caso de empate, pelos identificadores dos produtos. Cada entrega é apresentada de acordo com o seguinte formato:
{{CollapsedCode|Formato de apresentação de uma entrega|
''idCompra'' - ''data de chegada'' - ''lista de identificadores de produtos''
}}
{{CollapsedCode|Exemplos de apresentação de entregas (compra do exemplo da secção Entregas)|
<syntaxhighlight lang="text">
7 - 7 - 1, 3
7 - 12 - 2
</syntaxhighlight>
}}

= Leitura de Dados a Partir de Ficheiros Textuais =

Além das opções de manipulação de ficheiros descritas no [[#Menu Principal|menu principal]], é possível iniciar a aplicação com um ficheiro de texto especificado pela propriedade Java '''[[#Execução do Programa e Testes Automáticos|import]]'''.

Cada linha tem uma descrição distinta mas que segue o seguinte formato geral. É possível registar empresas, clientes e produtos, e definir os produtos que cada empresa vende. Assume-se que os campos de texto não podem conter o carácter ''':''' e que os preços são números inteiros. Não existem entradas mal-formadas.

Os produtos têm o formato descrito abaixo, respectivamente, para produtos fabricados e importados. O campo ''stock'' indica o número de exemplares disponíveis do produto.

MANUFACTURED:''idEmpresa'':''nome'':''preço'':''categoria'':''prazo'':''stock'':''fabricante'':''codigo''
IMPORTED:''idEmpresa'':''nome'':''preço'':''categoria'':''prazo'':''stock'':''paisOrigem'':''taxa''

O registo de empresas e de clientes segue os formatos:

COMPANY:''nome''
CLIENT:''nome'':''email''

Um exemplo de conteúdo do ficheiro inicial é como se segue:

{{CollapsedCode|Exemplo de ficheiro de entrada textual|
<syntaxhighlight lang="text">
COMPANY:Moageira Nacional
COMPANY:Importadora Atlantico
CLIENT:Obi-Wan Kenobi:obiwan@jedi.org
MANUFACTURED:1:Farinha:15:ALIMENTAR:3:23:Moageira Nacional:F-0091
IMPORTED:2:Telemovel:200:ELECTRONICA:8:2:China:30
MANUFACTURED:1:Camisa:45:VESTUARIO:2:4:Confeccoes Sul:C-1120
</syntaxhighlight>
}}
A codificação dos ficheiros a ler é garantidamente [[wp:UTF-8|UTF-8]].

{{Suggestion|Usar o método '''String.split()''' para partir cadeias de caracteres e '''String.trim()''' para remover espaços no início e no final.}}
{{Suggestion|Note-se que o programa nunca produz ficheiros com este formato (é apenas um formato para ficheiros de entrada).}}

= Execução do Programa e Testes Automáticos =

Usando os ficheiros '''test.import''', '''test.in''' e '''test.out''', é possível verificar automaticamente o resultado correcto do programa. Note-se que é necessária a definição apropriada da variável '''CLASSPATH''' (ou da opção equivalente '''-cp''' do comando '''java'''), para localizar as classes do programa, incluindo a que contém o método correspondente ao ponto de entrada da aplicação ('''erp.app.App.main'''). As propriedades são tratadas automaticamente pelo código de apoio.

java -Dimport=test.import -Din=test.in -Dout=test.outhyp erp.app.App

Assumindo que aqueles ficheiros estão no directório onde é dado o comando de execução, o programa produz o ficheiro de saída '''test.outhyp'''. Em caso de sucesso, os ficheiros das saídas esperada ('''test.out''') e obtida ('''test.outhyp''') devem ser iguais. A comparação pode ser feita com o comando:

diff -b test.out test.outhyp

Este comando não deve produzir qualquer resultado quando os ficheiros são iguais. Note-se, contudo, que este teste não garante o correcto funcionamento do código desenvolvido, apenas verificando alguns aspectos da sua funcionalidade.

= Notas de Implementação =

Tal como indicado acima, algumas classes fornecidas como [[Programação com Objectos/Projecto de Programação com Objectos/Material de Apoio ao Desenvolvimento|material de apoio]], são de uso obrigatório e não podem ser alteradas. Outras dessas classes são de uso obrigatório e têm de ser alteradas.

A serialização Java usa as classes da ''package'' [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/package-summary.html java.io], em particular, a interface [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/Serializable.html java.io.Serializable] e as classes de leitura [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/ObjectInputStream.html java.io.ObjectInputStream] e escrita [https://docs.oracle.com/en/java/javase/24/docs/api/java.base/java/io/ObjectOutputStream.html java.io.ObjectOutputStream] (entre outras).

[[category: Ensino]]
[[category:PO]]
[[category: Projecto de PO]]
[[en:Object-Oriented Programming]]

Compiladores/Pautas 2025-2026/Pauta Global do Projecto

2026-06-12T09:50:31Z

Root: /* Prazo de Revisão */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}



== Pauta ==
Ver Fénix.

== Prazo de Revisão ==
* Época Normal: '''PAUTA FECHADA''' (ver prazo da entrega em curso ou data do teste prático)
* Época Especial:  (teste prático a realizar em Julho de 2026 -- ver Fénix)

== Legenda da Pauta Global do Projecto ==

Períodos de avaliação:
* EN - época normal
* EE - época especial

Componentes de avaliação:
* PRJ - nota final do projecto
* PRJ EN - nota final do projecto (época normal)
* PRJ EE - nota final do projecto (época especial)
* E0 - nota da entrega do diagrama UML
* EI- nota da entrega intermédia
* EF- nota da entrega final
* TP - nota do teste prático (EN ou EE)

A nota do teste prático condiciona a distância ao mínimo entre as notas do teste prático e a do projecto: desde um mínimo de 12.5% de acréscimo à menor das duas (abaixo de 7.5 valores no TP), até um máximo de 25% (para 20 valores no TP). O acréscimo é linear entre 7.5 e 20.

Ou seja:

* PRJ EN = E0 + EI + EF
* PRJ = min(PRJ EN, TP) + | TP - PRJ EN | * max(12.5, TP+5) / 100

(para EE, PRJ EE é apenas uma entrega e TP é TP EE)

Condições necessárias para aprovação à disciplina (necessárias todas):

* PRJ >= 9.5 (sem arredondamento)
* PRJ != NA
* TP > 0
* TP != NA

Linhas sombreadas correspondem a alunos excluídos da avaliação em Época Normal, por não terem realizado componentes obrigatórias do projecto. Alunos que tenham realizado todas as componentes podem estar em linhas sombreadas se não for possível a aprovação (critérios mínimos).

Se o projecto não obtiver aprovação em Época Normal, então tem de ser realizado um teste prático sobre projecto a fornecer em Época Especial.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final

2026-06-12T09:49:50Z

Root: /* Prazo de Revisão */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Ver Fénix.

== Prazo de Revisão ==


'''PAUTA FECHADA'''

Ver anúncio na página da disciplina (Fénix).

== Critérios de Avaliação ==
'''A entrega final é obrigatória.'''

São considerados os das entregas anteriores (adaptados).

== Legenda ==

A entrega final vale 12 valores em 20 (7 qualidade; 5 automáticos).

* Qualidade (7 valores): análise lexical (0.75) + análise sintáctica (0.75) + nós (AST) (0.75) + análise semântica e geração de código (0.75) + avaliação global (0.50) + repositório e compilação (0.50). Os pesos são relativos ao total 4 (i.e., o valor final multiplica por 7/4).
* Testes automáticos (5 valores).


'''Os alunos são encorajados a compreender/verificar os problemas reportados.'''

Quaisquer dúvidas ou sugestões, relativas a esta informação, devem ser enviadas ao responsável pela disciplina ou esclarecidas nos horários de dúvidas.

'''Recorda-se que a classificação global do projecto não se limita à soma das classificações das várias entregas: a classificação final é ainda influenciada pela classificação do teste prático. Este teste é obrigatório e eliminatório (i.e., a classificação deve ser maior que zero).'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Descrição dos problemas assinalados na pauta'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
'''Problemas na análise lexical'''
* .* - uso indevido do padrão
* chars - definição indevida (não existem na linguagem)
* comments - problemas com comentários (em excesso ou em falta)
* real - problemas com reais (definições incompletas ou excessivas)
* ints - problemas com inteiros (definições incompletas ou excessivas)
* keywords - problemas com palavras chave (a mais ou a menos)
* strings - problemas na definição de strings (composição, concatenação indevida, etc.)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise sintáctica'''

* conflicts - conflitos no analisador LALR(1)
* exprs - problemas nas expressões (em falta ou com inclusão de casos errados)
* lvals - problemas na definição de left-values (e.g. ausência de definições ou incompletas)
* precs - problemas na definição de precedências (tipicamente, em excesso ou sem correspondência com o manual)
* strings - problemas na definção de cadeias de caracteres
* syntax - problemas na definição da gramática (relativamente ao manual de referência)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas nos nós'''

* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise semântica e na geração de código'''

* symbol - problemas na definição dos símbolos (atributos em excesso ou em falta)
* stack - problemas na definição do stack das funções
* types - problemas na verificação de tipos
* postfix - problemas na geração de código
* [outras anotações] - casos específicos (contactar professor responsável)

'''Outros problemas'''

* empty methods - métodos vazios nos visitors (não deviam ser vazios)
* types - problemas com o visitor de verificação de tipos
* [outras anotações] - casos específicos (contactar professor responsável)

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026

2026-06-12T09:49:29Z

Root: /* Pautas do Projecto (época normal) */

{{TOCright}}
Além dos resultados de avaliação, as páginas das pautas contêm também os critérios de avaliação e aprovação.
* {{PautaAberta}} indica avaliação em curso
* {{PautaFechada}} indica avaliação terminada (classificações definitivas)
* {{ProvaPorRealizar}} indica avaliação prevista

== Pautas da Disciplina ==

* [[Compiladores/Pautas 2025-2026/Pauta Global da Disciplina|Pauta Global da Disciplina]] -- próxima avaliação: (ver Fénix)
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas|Pauta das Aulas Práticas]] (época nornal)

== Pautas do Projecto (época normal) ==

* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"|Pauta do Projecto: Entrega "zero"]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia|Pauta do Projecto: Entrega Intermédia]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final|Pauta do Projecto: Entrega Final]]
* [[Compiladores/Pautas 2025-2026/Pauta Global do Projecto|Pauta Global do Projecto]]

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026

2026-06-12T09:49:02Z

Root: /* Pautas do Projecto (época normal) */

{{TOCright}}
Além dos resultados de avaliação, as páginas das pautas contêm também os critérios de avaliação e aprovação.
* {{PautaAberta}} indica avaliação em curso
* {{PautaFechada}} indica avaliação terminada (classificações definitivas)
* {{ProvaPorRealizar}} indica avaliação prevista

== Pautas da Disciplina ==

* [[Compiladores/Pautas 2025-2026/Pauta Global da Disciplina|Pauta Global da Disciplina]] -- próxima avaliação: (ver Fénix)
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas|Pauta das Aulas Práticas]] (época nornal)

== Pautas do Projecto (época normal) ==

* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"|Pauta do Projecto: Entrega "zero"]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia|Pauta do Projecto: Entrega Intermédia]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final|Pauta do Projecto: Entrega Final]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta Global do Projecto|Pauta Global do Projecto]]

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026

2026-06-12T09:48:46Z

Root: /* Pautas do Projecto (época normal) */

Compiladores/Pautas 2025-2026/Pauta Global do Projecto

2026-06-11T08:15:27Z

Root: /* Pauta */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}



== Pauta ==
Ver Fénix.

== Prazo de Revisão ==
* Época Normal:  (ver prazo da entrega em curso ou data do teste prático)
* Época Especial:  (teste prático a realizar em Julho de 2026 -- ver Fénix)

== Legenda da Pauta Global do Projecto ==

Períodos de avaliação:
* EN - época normal
* EE - época especial

Componentes de avaliação:
* PRJ - nota final do projecto
* PRJ EN - nota final do projecto (época normal)
* PRJ EE - nota final do projecto (época especial)
* E0 - nota da entrega do diagrama UML
* EI- nota da entrega intermédia
* EF- nota da entrega final
* TP - nota do teste prático (EN ou EE)

A nota do teste prático condiciona a distância ao mínimo entre as notas do teste prático e a do projecto: desde um mínimo de 12.5% de acréscimo à menor das duas (abaixo de 7.5 valores no TP), até um máximo de 25% (para 20 valores no TP). O acréscimo é linear entre 7.5 e 20.

Ou seja:

* PRJ EN = E0 + EI + EF
* PRJ = min(PRJ EN, TP) + | TP - PRJ EN | * max(12.5, TP+5) / 100

(para EE, PRJ EE é apenas uma entrega e TP é TP EE)

Condições necessárias para aprovação à disciplina (necessárias todas):

* PRJ >= 9.5 (sem arredondamento)
* PRJ != NA
* TP > 0
* TP != NA

Linhas sombreadas correspondem a alunos excluídos da avaliação em Época Normal, por não terem realizado componentes obrigatórias do projecto. Alunos que tenham realizado todas as componentes podem estar em linhas sombreadas se não for possível a aprovação (critérios mínimos).

Se o projecto não obtiver aprovação em Época Normal, então tem de ser realizado um teste prático sobre projecto a fornecer em Época Especial.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final

2026-06-11T08:15:00Z

Root: /* Pauta */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Ver Fénix.

== Prazo de Revisão ==




Ver anúncio na página da disciplina (Fénix).

== Critérios de Avaliação ==
'''A entrega final é obrigatória.'''

São considerados os das entregas anteriores (adaptados).

== Legenda ==

A entrega final vale 12 valores em 20 (7 qualidade; 5 automáticos).

* Qualidade (7 valores): análise lexical (0.75) + análise sintáctica (0.75) + nós (AST) (0.75) + análise semântica e geração de código (0.75) + avaliação global (0.50) + repositório e compilação (0.50). Os pesos são relativos ao total 4 (i.e., o valor final multiplica por 7/4).
* Testes automáticos (5 valores).


'''Os alunos são encorajados a compreender/verificar os problemas reportados.'''

Quaisquer dúvidas ou sugestões, relativas a esta informação, devem ser enviadas ao responsável pela disciplina ou esclarecidas nos horários de dúvidas.

'''Recorda-se que a classificação global do projecto não se limita à soma das classificações das várias entregas: a classificação final é ainda influenciada pela classificação do teste prático. Este teste é obrigatório e eliminatório (i.e., a classificação deve ser maior que zero).'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Descrição dos problemas assinalados na pauta'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
'''Problemas na análise lexical'''
* .* - uso indevido do padrão
* chars - definição indevida (não existem na linguagem)
* comments - problemas com comentários (em excesso ou em falta)
* real - problemas com reais (definições incompletas ou excessivas)
* ints - problemas com inteiros (definições incompletas ou excessivas)
* keywords - problemas com palavras chave (a mais ou a menos)
* strings - problemas na definição de strings (composição, concatenação indevida, etc.)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise sintáctica'''

* conflicts - conflitos no analisador LALR(1)
* exprs - problemas nas expressões (em falta ou com inclusão de casos errados)
* lvals - problemas na definição de left-values (e.g. ausência de definições ou incompletas)
* precs - problemas na definição de precedências (tipicamente, em excesso ou sem correspondência com o manual)
* strings - problemas na definção de cadeias de caracteres
* syntax - problemas na definição da gramática (relativamente ao manual de referência)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas nos nós'''

* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise semântica e na geração de código'''

* symbol - problemas na definição dos símbolos (atributos em excesso ou em falta)
* stack - problemas na definição do stack das funções
* types - problemas na verificação de tipos
* postfix - problemas na geração de código
* [outras anotações] - casos específicos (contactar professor responsável)

'''Outros problemas'''

* empty methods - métodos vazios nos visitors (não deviam ser vazios)
* types - problemas com o visitor de verificação de tipos
* [outras anotações] - casos específicos (contactar professor responsável)

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta Global da Disciplina

2026-06-11T08:14:37Z

Root: /* Pauta */

== Pauta ==
Ver Fénix.

== Prazo de Revisão ==



Ver prazos de revisão nas páginas correspondentes às provas em curso.

* Época Normal:  (ver prazos nas pautas de cada prova)
* Época Especial:   (provas a realizar em Julho de 2026 -- ver Fénix)

Note-se que a coluna FINAL apenas tem significado no final da avaliação.

== Legenda ==

Não há arredondamentos (excepto na coluna '''FINAL''').

Condições de aprovação: '''NOTA''', '''EXR'''. '''PRJ''', '''EE''' têm de ser iguais ou superiores a 9.5.

Legenda:

* '''FINAL''' - resultado da avaliação (será lançado na secretaria)
* '''NOTA''' - resultado numérico da avaliação (quando aplicável)
* '''EXR''' - nota final dos exercícios de programação (deve ser superior a 9.5)
* '''PRJ''' - nota final do projecto (inclui nota do teste prático) (deve ser superior a 9.5)
* '''EE''' - época especial (exercícios) (deve ser superior a 9.5)

As notações especiais têm o seguinte significado:
* '''NA''' - "não avaliado"
* '''RE''' - "reprovado"

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Category:Compiladores 2025-2026

2026-06-11T08:13:35Z

Root: Created blank page

Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas

2026-06-11T08:13:19Z

Root: /* Pauta */

{{TOCright}}
'''PAUTA FECHADA'''


A avaliação nestas aulas é obrigatória e não é repetível fora da semana em que cada exercício é realizado. 
Não se avaliam alunos fora do turno de inscrição.

Alunos que compareçam atrasados a estas aulas não são avaliados. 
É admitido um limite máximo de 20 minutos para entrada, após a hora definida para a aula (i.e., já contabilizando os 10 minutos do início).

Não são considerados casos especiais na avaliação das aulas práticas. Alunos que considerem ter direito a tratamento especial e que não consigam comparecer com aproveitamento nestas aulas poderão requerer avaliação em época especial.

== Pauta ==
Ver Fénix.

== Prazos de revisão ==
Ver anúncio correspondente no Fénix.

As revisões decorrem exclusivamente via Classroom (ver Fénix).

== Legenda ==
Na pauta:
* ''Nota'' indica a nota final (são contabilizados os 9 melhores exercícios)
* ''Média'' indica a média dos exercícios apresentados (são contabilizados todos os exercícios)

As classificações possíveis para cada exercício são:

* 0.00 - ignorância (quase) completa da matéria em avaliação ou não inscrito no turno
* 0.25 - erros graves ou solução muito incompleta ou inadequada
* 0.50 - erros importantes ou solução incompleta
* 0.75 - erros pouco graves ou solução quase completa
* 1.00 - solução completa

=== IMPORTANTE ===

Obter classificações abaixo de 0.75 deve constituir motivo de preocupação, especialmente nos casos 0 e 0.25, sendo os alunos fortemente encorajados a contactar o responsável pela disciplina para compreensão dos problemas em causa.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"

2026-06-11T08:13:02Z

Root: /* Pauta */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Ver Fénix.

== Prazo de Revisão ==
'''PAUTA FECHADA'''


Os resultados da entrega inicial podem ser revistos, nos horários de dúvidas, até à data da entrega intermédia.

== Critérios de Avaliação ==
'''A entrega inicial é obrigatória.'''

'''LER COM ATENÇÃO'''

'''A avaliação é realizada sobre a versão existente no repositório no final do prazo para a entrega inicial. Projectos que não apresentem alterações relativamente ao conteúdo inicial do repositório não serão considerados.'''

'''Considerando que é um passo crucial na concepção do projecto, a não realização desta entrega conduz automaticamente a uma classificação de 0 (zero) na componente de avaliação relativa ao Projecto e consequente exclusão da avaliação da disciplina no ano lectivo actual.'''

Ver também: [[Compiladores/Projecto de Compiladores/Avaliação do Projecto (Época Normal)]].

Advertem-se os alunos sobre a consulta de colegas de anos anteriores. Estas consultas podem ser positivas, mas comportam algum risco, pois o processo e critérios de avaliação podem ter mudado. Além disso, a proficiência do colega pode majorar negativamente o resultado da avaliação em curso. Não são admitidas quaisquer justificações com base na história da disciplina.

Estas condições são aplicáveis à data da entrega inicial.

'''Em caso de dúvidas suscitadas por qualquer elemento neste texto, no projecto, ou na disciplina em geral, os alunos são fortemente encorajados a consultar o corpo docente.'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #BDDD8D;" | '''VALORAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem '''2 valores''' (dos 20 disponíveis para o projecto) associados a esta entrega:

* '''gestão do projecto: 0.5 valores'''
** projecto com a estrutura correcta no repositório GIT: 0.25 valores (i.e., código que não apresente a estrutura canónica de um compilador desenvolvido com a CDK é considerado sem a estrutura correcta -- consultar estas páginas sobre o desenvolvimento do projecto com base no repositório GIT)
** projecto compila e produz compilador "p6" ("p6", com letras minúsculas: variações correspondem a "não compilação"): 0.25 valores

'''Se o projecto compilar''', poderão ser atribuídos mais '''1.5 valores''' (desenvolvimento do compilador), distribuídos como se segue:

* '''Classes dos nós do compilador (completo): 1.0 valores'''
** Reutilização dos nós da CDK (simples ajuste do Simple)
** Definição ou extensão de elementos existentes (simples ajuste do Simple)
** Definição de novas declarações/definições (variáveis/funções) (completo)
** Definição de novas instruções (completo)
** Definição de novas expressões (completo)
** Definição de outros elementos (completo)
** Sugere-se (por simplicidade de gestão do código) a separação das várias classes de nós em namespaces coerentes (à la Simple)
** Não é necessário criar as regras na especificação Bison para criar os nós (se for feito, é conveniente para o progresso do projecto, mas não é avaliado nesta entrega)

* '''Métodos dos "visitors" (completo): 0.5 valores'''
** Reutilização de métodos já definidos (simples ajuste do Simple)
** Definição de todos os métodos do_X (correspondentes ao nó da class X) em todos os visitors (simples extensão do Simple)
** Métodos novos podem estar vazios, mas devem existir
** Métodos correspondentes a acções semelhantes às existentes devem ser modelados nos existentes (mesmo que não modificados numa primeira instância)
** A presença de implementações de semântica no postfix_writer (tabela de símbolos, validação de tipos, etc.) não é penalizada, mas não será avaliada nesta entrega
|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #FFCC99;" | '''PENALIZAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem penalizações relativas à (deficiente) execução do projecto.

São considerados os seguintes aspectos preliminares:

# A linguagem do projecto contém a linguagem Simple, pelo que não há razão para não utilizar completamente o compilador Simple, eventualmente com pequenas alterações (incluindo a passagem de binário para ternário).
# A semântica da linguagem do projecto contém a da linguagem Simple, pelo que a implementação de alguns aspectos da linguagem do projecto não requer qualquer reimplementação relativamente ao Simple.
# O compilador Simple foi fornecido completamente funcional, assim como a versão inicial do compilador do projecto no respositório GIT (igual ao Simple e apenas alterado, para ter um nome apropriado).
# A criação de novos nós não apresenta quaisquer dificuldades (são classes muito simples).
# Os métodos (na sua maioria, vazios) dos "visitors" são simples paralelos com as classes dos nós e os que não estão vazios são quase 100% reutilizáveis na nova linguagem.
# O compilador é obrigatoriamente desenvolvido em C++, fazendo-se uso do material de apoio.

Considerando os aspectos 1. a 6., são aplicadas as seguintes penalizações:

* Destruição de funcionalidade do compilador Simple sem substituição por funcionalidade equivalente do compilador do projecto: '''2 valores'''
* Utilização de funções e estruturas C, quando existem alternativas directas C++ (malloc em lugar de new, por exemplo; strcmp, etc. em lugar da classe std::string; e outras): '''penalização máxima de 1 valor'''
* Não utilização de qualquer material obrigatório ou não satisfação dos critérios mínimos: '''2 valores e considera-se entrega não realizada (implica exclusão da avaliação)'''
|}

== Legenda ==



'''Os alunos são encorajados a compreender/verificar/corrigir os problemas reportados, especialmente nos casos em que exista anotação explícita na pauta.'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Anotações da tabela'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
* dups: cópia de código que já está disponível na CDK (não devem existir estas cópias: devem ser usadas as classes da CDK)
* pointer: este nó não deve existir
* loop/while: problemas vários com o nó de iteração
* lvals: más utilizações de left-values (um left-value é a designação de um endereço de escrita)
* index: problemas com os nós de indexação (e.g. não são lvalues, faltam expressões)
* decls: faltam nós correspondentes a declarações ou têm problemas (e.g. confundidas com expressões, problemas com tipos, etc.)
* func decls: problemas com declarações de funções
* function/func defs: faltam nós correspondentes a definições de funções ou têm problemas: e.g. faltam tipos, têm relações com lvalues (não devem existir)
* vars: faltam nós correspondentes a declarações/definições de variáveis ou têm problemas: e.g. faltam tipos, têm relações com lvalues (não devem existir)
* exprs: faltam expressões (tipicamente, faltam operadores, chamadas a funções)
* file/public/use/qualifier: nós que não devem existir
* print/write: problemas com o nó de escrita
* read/input: o nó de leitura deve ser uma expressão e não uma instrução; ao contário do que acontece no Simple, não tem um left-value associado
* call: este nó tem de ser uma expressão que tem como atributos um nome de função e uma sequência de argumentos
* alloc/objects: este nó tem de ser uma expressão
* address: este nó é uma expressão aplicável a um left-value
* types: não foram os usados os tipos da CDK (basic_type e subclasses) para representar os tipos de dados da linguagem
* [outras anotações específicas]: contactar o professor responsável

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia

2026-06-11T08:12:47Z

Root: /* Pauta */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Ver Fénix.

== Prazo de Revisão ==

'''PAUTA FECHADA'''

A entrega intermédia pode ser revista até à data da entrega final do projecto.

== Critérios de Avaliação ==
'''LER COM ATENÇÃO'''

'''A entrega intermédia é obrigatória.'''

A entrega intermédia vale 6 valores em 20.

'''A avaliação é realizada sobre a versão existente no repositório no final do prazo para a entrega intermédia. Projectos que não apresentem alterações relevantes relativamente ao conteúdo inicial do repositório ou relativamente à entrega inicial não serão considerados.'''

A avaliação da entrega intermédia considera a execução de intervenções em várias regiões do código do compilador em desenvolvimento, assim como a gestão do projecto correspondente.

Advertem-se os alunos sobre a consulta de colegas de anos anteriores. Estas consultas podem ser positivas, mas comportam algum risco, pois o processo e critérios de avaliação podem ter mudado. Além disso, a proficiência do colega pode majorar negativamente o resultado da avaliação em curso. Não são admitidas quaisquer justificações com base na história da disciplina. De forma semelhante, a reciclagem de código de compiladores exemplo deve ser feita criteriosamente, por forma a evitar inclusão de código errado ou inútil.

Estas condições são aplicáveis à data da entrega intermédia.

'''Em caso de dúvidas suscitadas por qualquer elemento neste texto, no projecto, ou na disciplina em geral, os alunos são fortemente encorajados a consultar o corpo docente.'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #BDDD8D;" | '''VALORAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem '''6 valores''' (dos 20 disponíveis para o projecto) associados a esta entrega:

* '''gestão do projecto: 1 valor'''
** projecto com a estrutura correcta no repositório: '''0.5 valores''' (i.e., código que não apresente a estrutura canónica de um compilador desenvolvido com a CDK é considerado sem a estrutura correcta -- consultar estas páginas sobre o desenvolvimento do projecto com base no repositório)
** projecto compila e produz compilador "p6" ("p6", com letras minúsculas: variações correspondem a "não compilação"): '''0.5 valores'''

'''Se o projecto compilar''', poderão ser atribuídos mais 5 valores (desenvolvimento do compilador), distribuídos como se segue:

* '''Flex (completo): 1.5 valores'''
** Tokens correspondentes aos símbolos e palavras-chave (simples ajuste do Simple/Tritak)
** Identificadores (simples ajuste do Simple/Tritak)
** Inteiros (a base 10 já está implementada no Simple/Tritak)
** Reais (extensão dos inteiros)
** Strings (extensão do Simple/Tritak)
** O Flex deve retornar os tokens ao byacc (sobre DEBUG, ver abaixo) -- o não retorno de tokens penaliza fortemente toda a componente Flex (ver penalizações)

* '''Bison (completo): 1 valor'''
** Regras correspondentes a literais de reais e strings (simples extensão do Simple/Tritak)
** Regras correspondentes a ciclos, etc. (simples extensão e adaptação do Simple/Tritak)
** Regras correspondentes a declarações de variáveis
** Regras correspondentes a declarações/definições de funções
** As acções correspondentes às regras definidas no Bison devem estar implementadas (simples criação de nós) -- a não implementação corresponde a penalizações (var abaixo)

* '''Nós (nodes) (completo): 1 valor'''
** Todos os nós necessários para a linguagem (utilizados na especificação Bison e em passos subsequentes) devem ser criados
** A não criação de nós motivada pela ausência de definição de acções no Bison é penalizada (ver abaixo)

* '''Semântica (visitors) ('''xml_writer''' completo; '''postfix_writer''' ver a seguir): 1.5 valores'''
** O "visitor" '''xml_writer''' deve estar completamente implementado (ver também DEBUG abaixo)
** O "visitor" '''type_checker''' deve ter todos os métodos (correspondentes aos nós, tal como o '''xml_writer'''), embora alguns possam estar ainda vazios (i.e., podem não executar qualquer acção)
** O "visitor" '''postfix_writer''' deve ter todos os métodos (correspondentes aos nós, tal como o '''xml_writer'''), embora alguns possam estar ainda vazios (i.e., podem não executar qualquer acção)
** Métodos correspondentes a acções semelhantes às existentes devem ser modelados nos existentes (mesmo que não modificados numa primeira instância)
** A presença de implementações de semântica no '''postfix_writer''' (tabela de símbolos, validação de tipos, etc.) não é penalizada, mas não será avaliada nesta entrega

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #FFCC99;" | '''PENALIZAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem penalizações relativas à (deficiente) execução do projecto.

São considerados os seguintes aspectos preliminares:

# A linguagem do projecto contém a linguagem Simple, pelo que não há razão para não utilizar completamente o compilador Simple, eventualmente com pequenas alterações (including a passagem de binário para ternário).
# A semântica da linguagem do projecto contém a da linguagem Simple, pelo que a implementação de alguns aspectos da linguagem do projecto não requer qualquer reimplementação relativamente ao Simple.
# O compilador Simple foi fornecido completamente funcional, assim como a versão inicial do compilador do projecto no respositório (igual ao Simple e apenas alterado para ter o nome apropriado).
# A criação de novos nós não apresenta quaisquer dificuldades (são classes muito simples)
# O código dos métodos do visitor '''xml_writer''' corresponde a uma simples impressão dos atributos dos nós, através de uma travessia da árvore que formam e que os contém.
# O compilador é obrigatoriamente desenvolvido em C++.

Considerando os aspectos 1. a 6., são aplicadas as seguintes penalizações:

* Destruição de funcionalidade do compilador Simple sem substituição por funcionalidade equivalente do compilador do projecto: '''4 valores'''
Não definição dos nós para regras Bison em avaliação (ver acima) ou não utilização de nós definidos para a escrita dessas acções: '''2 valores'''
* A utilização de funções e estruturas C, quando existem alternativas directas C++ (malloc em lugar de new, por exemplo; strcmp, etc. em lugar da classe std::string; e outras) terá uma '''penalização máxima de 1 valor'''
* Não utilização de qualquer material obrigatório: '''6 valores (e considera-se projecto não realizado)'''

|}

=== DEBUG ===

O despiste de problemas em especificações Flex pode ser realizado de forma simples utilizando os métodos descritos em [[The Flex Lexical Analyzer#How to Debug a Flex Specification|How to Debug a Flex Specification]].

O visitor '''xml_writer''' foi concebido para produzir uma representação textual hierárquica (árvore XML) correspondente ao programa em compilação.
É muito útil para inspeccionar a construção da árvore de nós por parte do Bison, permitindo, inclusivamente, a apresentação gráfica.

== Legenda ==
As questões relativas às colunas "Problemas" devem ser resolvidas quanto antes (nos horários de dúvidas ou, sendo possível, por correio electrónico).

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise lexical'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
* .* - uso indevido do padrão
* chars - definição indevida (não existem na linguagem)
* comments - problemas com comentários (em excesso ou em falta)
* doubles - problemas com vírgula flutuante (definições incompletas)

* ids - problems com identificadores
* int - problemas com inteiros (definições incompletas ou excessivas)
* keywords - problemas com palavras-chave (a mais ou a menos)

* (bad) patterns - problemas genéricos com escrita de padrões lexicais
* string - problemas na definição de strings (composição, concatenação indevida, etc.)
* [outros] - casos específicos (contactar professor responsável)

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise sintáctica'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
* conflicts - conflitos no analisador LALR(1) (não avaliado nesta entrega)
* decls - problemas nas declarações (e.g. mistura com expressões ou com instruções)
* empty rules - regras sem semântica associada
* exprs - problemas nas expressões (em falta ou com inclusão de casos errados)
* calls - problemas nas chamadas a funções (e.g. não estão definidos como expressões)
* funcs - problemas (vários) nas definições de funções
* lvals - problemas na definição de left-values (e.g. ausência de definições ou incompletas)
* precs - problemas na definição de precedências (tipicamente, em excesso, deficientes, ou sem correspondência com o manual)
* precs* - problemas graves na definição de precedências (tipicamente, em excesso, deficientes, ou sem correspondência com o manual)
* tokens - problemas na definição de tokens (tipicamente, em excesso ou sem correspondência com o manual)
* read - problemas na definição da expressão de leitura (verificar manual de referência)
* semantics - problemas na definição de acções semânticas
* (simple) - contém apenas a definição original (linguagem Simple)
* strings - problemas na definção de cadeias de caracteres
* syntax - problemas na definição da gramática ou na semântica (nó) correspondente (verificar manual de referência)
* start - problemas na definição da raiz da árvore sintáctica (compiler->ast(...))
* [outras anotações] - casos específicos (contactar professor responsável)

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise semântica e na geração de código (nós e XML)'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Nos nós:

* [outros nós] - nós com problemas (nós excedentários ou em falta ou com problemas na definição)
* [outras anotações] - casos específicos (contactar professor responsável)

No visitor '''xml_writer''':
* ast - o método "ast" do compilador não foi chamado no parser (.y), pelo que a AST está indefinida
* empty - métodos vazios ou funcionalmente vazios
* (incomp) - código incompleto
* [outras anotações] - casos específicos (contactar professor responsável)

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia

2026-06-11T08:12:35Z

Root:

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Aqui: https://bit.ly/co26-pautas (ver Fénix)

== Prazo de Revisão ==

'''PAUTA FECHADA'''

A entrega intermédia pode ser revista até à data da entrega final do projecto.

== Critérios de Avaliação ==
'''LER COM ATENÇÃO'''

'''A entrega intermédia é obrigatória.'''

A entrega intermédia vale 6 valores em 20.

'''A avaliação é realizada sobre a versão existente no repositório no final do prazo para a entrega intermédia. Projectos que não apresentem alterações relevantes relativamente ao conteúdo inicial do repositório ou relativamente à entrega inicial não serão considerados.'''

A avaliação da entrega intermédia considera a execução de intervenções em várias regiões do código do compilador em desenvolvimento, assim como a gestão do projecto correspondente.

Advertem-se os alunos sobre a consulta de colegas de anos anteriores. Estas consultas podem ser positivas, mas comportam algum risco, pois o processo e critérios de avaliação podem ter mudado. Além disso, a proficiência do colega pode majorar negativamente o resultado da avaliação em curso. Não são admitidas quaisquer justificações com base na história da disciplina. De forma semelhante, a reciclagem de código de compiladores exemplo deve ser feita criteriosamente, por forma a evitar inclusão de código errado ou inútil.

Estas condições são aplicáveis à data da entrega intermédia.

'''Em caso de dúvidas suscitadas por qualquer elemento neste texto, no projecto, ou na disciplina em geral, os alunos são fortemente encorajados a consultar o corpo docente.'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #BDDD8D;" | '''VALORAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem '''6 valores''' (dos 20 disponíveis para o projecto) associados a esta entrega:

* '''gestão do projecto: 1 valor'''
** projecto com a estrutura correcta no repositório: '''0.5 valores''' (i.e., código que não apresente a estrutura canónica de um compilador desenvolvido com a CDK é considerado sem a estrutura correcta -- consultar estas páginas sobre o desenvolvimento do projecto com base no repositório)
** projecto compila e produz compilador "p6" ("p6", com letras minúsculas: variações correspondem a "não compilação"): '''0.5 valores'''

'''Se o projecto compilar''', poderão ser atribuídos mais 5 valores (desenvolvimento do compilador), distribuídos como se segue:

* '''Flex (completo): 1.5 valores'''
** Tokens correspondentes aos símbolos e palavras-chave (simples ajuste do Simple/Tritak)
** Identificadores (simples ajuste do Simple/Tritak)
** Inteiros (a base 10 já está implementada no Simple/Tritak)
** Reais (extensão dos inteiros)
** Strings (extensão do Simple/Tritak)
** O Flex deve retornar os tokens ao byacc (sobre DEBUG, ver abaixo) -- o não retorno de tokens penaliza fortemente toda a componente Flex (ver penalizações)

* '''Bison (completo): 1 valor'''
** Regras correspondentes a literais de reais e strings (simples extensão do Simple/Tritak)
** Regras correspondentes a ciclos, etc. (simples extensão e adaptação do Simple/Tritak)
** Regras correspondentes a declarações de variáveis
** Regras correspondentes a declarações/definições de funções
** As acções correspondentes às regras definidas no Bison devem estar implementadas (simples criação de nós) -- a não implementação corresponde a penalizações (var abaixo)

* '''Nós (nodes) (completo): 1 valor'''
** Todos os nós necessários para a linguagem (utilizados na especificação Bison e em passos subsequentes) devem ser criados
** A não criação de nós motivada pela ausência de definição de acções no Bison é penalizada (ver abaixo)

* '''Semântica (visitors) ('''xml_writer''' completo; '''postfix_writer''' ver a seguir): 1.5 valores'''
** O "visitor" '''xml_writer''' deve estar completamente implementado (ver também DEBUG abaixo)
** O "visitor" '''type_checker''' deve ter todos os métodos (correspondentes aos nós, tal como o '''xml_writer'''), embora alguns possam estar ainda vazios (i.e., podem não executar qualquer acção)
** O "visitor" '''postfix_writer''' deve ter todos os métodos (correspondentes aos nós, tal como o '''xml_writer'''), embora alguns possam estar ainda vazios (i.e., podem não executar qualquer acção)
** Métodos correspondentes a acções semelhantes às existentes devem ser modelados nos existentes (mesmo que não modificados numa primeira instância)
** A presença de implementações de semântica no '''postfix_writer''' (tabela de símbolos, validação de tipos, etc.) não é penalizada, mas não será avaliada nesta entrega

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #FFCC99;" | '''PENALIZAÇÕES'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Existem penalizações relativas à (deficiente) execução do projecto.

São considerados os seguintes aspectos preliminares:

# A linguagem do projecto contém a linguagem Simple, pelo que não há razão para não utilizar completamente o compilador Simple, eventualmente com pequenas alterações (including a passagem de binário para ternário).
# A semântica da linguagem do projecto contém a da linguagem Simple, pelo que a implementação de alguns aspectos da linguagem do projecto não requer qualquer reimplementação relativamente ao Simple.
# O compilador Simple foi fornecido completamente funcional, assim como a versão inicial do compilador do projecto no respositório (igual ao Simple e apenas alterado para ter o nome apropriado).
# A criação de novos nós não apresenta quaisquer dificuldades (são classes muito simples)
# O código dos métodos do visitor '''xml_writer''' corresponde a uma simples impressão dos atributos dos nós, através de uma travessia da árvore que formam e que os contém.
# O compilador é obrigatoriamente desenvolvido em C++.

Considerando os aspectos 1. a 6., são aplicadas as seguintes penalizações:

* Destruição de funcionalidade do compilador Simple sem substituição por funcionalidade equivalente do compilador do projecto: '''4 valores'''
Não definição dos nós para regras Bison em avaliação (ver acima) ou não utilização de nós definidos para a escrita dessas acções: '''2 valores'''
* A utilização de funções e estruturas C, quando existem alternativas directas C++ (malloc em lugar de new, por exemplo; strcmp, etc. em lugar da classe std::string; e outras) terá uma '''penalização máxima de 1 valor'''
* Não utilização de qualquer material obrigatório: '''6 valores (e considera-se projecto não realizado)'''

|}

=== DEBUG ===

O despiste de problemas em especificações Flex pode ser realizado de forma simples utilizando os métodos descritos em [[The Flex Lexical Analyzer#How to Debug a Flex Specification|How to Debug a Flex Specification]].

O visitor '''xml_writer''' foi concebido para produzir uma representação textual hierárquica (árvore XML) correspondente ao programa em compilação.
É muito útil para inspeccionar a construção da árvore de nós por parte do Bison, permitindo, inclusivamente, a apresentação gráfica.

== Legenda ==
As questões relativas às colunas "Problemas" devem ser resolvidas quanto antes (nos horários de dúvidas ou, sendo possível, por correio electrónico).

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise lexical'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
* .* - uso indevido do padrão
* chars - definição indevida (não existem na linguagem)
* comments - problemas com comentários (em excesso ou em falta)
* doubles - problemas com vírgula flutuante (definições incompletas)

* ids - problems com identificadores
* int - problemas com inteiros (definições incompletas ou excessivas)
* keywords - problemas com palavras-chave (a mais ou a menos)

* (bad) patterns - problemas genéricos com escrita de padrões lexicais
* string - problemas na definição de strings (composição, concatenação indevida, etc.)
* [outros] - casos específicos (contactar professor responsável)

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise sintáctica'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
* conflicts - conflitos no analisador LALR(1) (não avaliado nesta entrega)
* decls - problemas nas declarações (e.g. mistura com expressões ou com instruções)
* empty rules - regras sem semântica associada
* exprs - problemas nas expressões (em falta ou com inclusão de casos errados)
* calls - problemas nas chamadas a funções (e.g. não estão definidos como expressões)
* funcs - problemas (vários) nas definições de funções
* lvals - problemas na definição de left-values (e.g. ausência de definições ou incompletas)
* precs - problemas na definição de precedências (tipicamente, em excesso, deficientes, ou sem correspondência com o manual)
* precs* - problemas graves na definição de precedências (tipicamente, em excesso, deficientes, ou sem correspondência com o manual)
* tokens - problemas na definição de tokens (tipicamente, em excesso ou sem correspondência com o manual)
* read - problemas na definição da expressão de leitura (verificar manual de referência)
* semantics - problemas na definição de acções semânticas
* (simple) - contém apenas a definição original (linguagem Simple)
* strings - problemas na definção de cadeias de caracteres
* syntax - problemas na definição da gramática ou na semântica (nó) correspondente (verificar manual de referência)
* start - problemas na definição da raiz da árvore sintáctica (compiler->ast(...))
* [outras anotações] - casos específicos (contactar professor responsável)

|}

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Problemas na análise semântica e na geração de código (nós e XML)'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |

Nos nós:

* [outros nós] - nós com problemas (nós excedentários ou em falta ou com problemas na definição)
* [outras anotações] - casos específicos (contactar professor responsável)

No visitor '''xml_writer''':
* ast - o método "ast" do compilador não foi chamado no parser (.y), pelo que a AST está indefinida
* empty - métodos vazios ou funcionalmente vazios
* (incomp) - código incompleto
* [outras anotações] - casos específicos (contactar professor responsável)

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Pautas 2025-2026

2026-06-11T08:12:21Z

Root: /* Pautas do Projecto (época normal) */

{{TOCright}}
Além dos resultados de avaliação, as páginas das pautas contêm também os critérios de avaliação e aprovação.
* {{PautaAberta}} indica avaliação em curso
* {{PautaFechada}} indica avaliação terminada (classificações definitivas)
* {{ProvaPorRealizar}} indica avaliação prevista

== Pautas da Disciplina ==

* [[Compiladores/Pautas 2025-2026/Pauta Global da Disciplina|Pauta Global da Disciplina]] -- próxima avaliação: (ver Fénix)
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas|Pauta das Aulas Práticas]] (época nornal)

== Pautas do Projecto (época normal) ==

* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"|Pauta do Projecto: Entrega "zero"]]
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia|Pauta do Projecto: Entrega Intermédia]]
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final|Pauta do Projecto: Entrega Final]]
* [[Compiladores/Pautas 2025-2026/Pauta Global do Projecto|Pauta Global do Projecto]]

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T10:50:59Z

Root: /* Condições */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia. Alunos que não tenham activado estes serviços estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

(prova concluída)

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 <s>110421</s> 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 <s>111198</s> 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T10:47:42Z

Root: /* 2ª feira, 2026/06/08, 11:00 */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

(prova concluída)

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 <s>110421</s> 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 <s>111198</s> 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T10:17:43Z

Root: /* Realizados */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

(prova concluída)

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T10:17:25Z

Root: /* Calendário */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

(prova concluída)

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T09:44:04Z

Root: /* Realizados */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T09:43:48Z

Root: /* 2ª feira, 2026/06/08, 10:00 */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T08:26:46Z

Root: /* Realizados */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-08T08:26:35Z

Root: /* 2ª feira, 2026/06/08, 09:00 */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-05T23:41:06Z

Root: /* Realizados */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-05T23:40:57Z

Root: /* Calendário */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-05T23:27:14Z

Root: /* Calendário */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 <s>52327</s> 109797 106647 110274 <s>110600</s> 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas

2026-06-05T11:35:29Z

Root: /* Legenda */

{{TOCright}}
'''PAUTA FECHADA'''


A avaliação nestas aulas é obrigatória e não é repetível fora da semana em que cada exercício é realizado. 
Não se avaliam alunos fora do turno de inscrição.

Alunos que compareçam atrasados a estas aulas não são avaliados. 
É admitido um limite máximo de 20 minutos para entrada, após a hora definida para a aula (i.e., já contabilizando os 10 minutos do início).

Não são considerados casos especiais na avaliação das aulas práticas. Alunos que considerem ter direito a tratamento especial e que não consigam comparecer com aproveitamento nestas aulas poderão requerer avaliação em época especial.

== Pauta ==
Aqui: https://bit.ly/co26-pautas (ver Fénix)

== Prazos de revisão ==
Ver anúncio correspondente no Fénix.

As revisões decorrem exclusivamente via Classroom (ver Fénix).

== Legenda ==
Na pauta:
* ''Nota'' indica a nota final (são contabilizados os 9 melhores exercícios)
* ''Média'' indica a média dos exercícios apresentados (são contabilizados todos os exercícios)

As classificações possíveis para cada exercício são:

* 0.00 - ignorância (quase) completa da matéria em avaliação ou não inscrito no turno
* 0.25 - erros graves ou solução muito incompleta ou inadequada
* 0.50 - erros importantes ou solução incompleta
* 0.75 - erros pouco graves ou solução quase completa
* 1.00 - solução completa

=== IMPORTANTE ===

Obter classificações abaixo de 0.75 deve constituir motivo de preocupação, especialmente nos casos 0 e 0.25, sendo os alunos fortemente encorajados a contactar o responsável pela disciplina para compreensão dos problemas em causa.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas

2026-06-05T11:34:59Z

Root: /* Legenda */

{{TOCright}}
'''PAUTA FECHADA'''


A avaliação nestas aulas é obrigatória e não é repetível fora da semana em que cada exercício é realizado. 
Não se avaliam alunos fora do turno de inscrição.

Alunos que compareçam atrasados a estas aulas não são avaliados. 
É admitido um limite máximo de 20 minutos para entrada, após a hora definida para a aula (i.e., já contabilizando os 10 minutos do início).

Não são considerados casos especiais na avaliação das aulas práticas. Alunos que considerem ter direito a tratamento especial e que não consigam comparecer com aproveitamento nestas aulas poderão requerer avaliação em época especial.

== Pauta ==
Aqui: https://bit.ly/co26-pautas (ver Fénix)

== Prazos de revisão ==
Ver anúncio correspondente no Fénix.

As revisões decorrem exclusivamente via Classroom (ver Fénix).

== Legenda ==
* ''Nota'' indica a nota final (são contabilizados os 9 melhores exercícios)
* ''Média'' indica a média dos exercícios apresentados (são contabilizados todos os exercícios)

As classificações possíveis para cada exercício são:

* 0.00 - ignorância (quase) completa da matéria em avaliação ou não inscrito no turno
* 0.25 - erros graves ou solução muito incompleta ou inadequada
* 0.50 - erros importantes ou solução incompleta
* 0.75 - erros pouco graves ou solução quase completa
* 1.00 - solução completa

=== IMPORTANTE ===

Obter classificações abaixo de 0.75 deve constituir motivo de preocupação, especialmente nos casos 0 e 0.25, sendo os alunos fortemente encorajados a contactar o responsável pela disciplina para compreensão dos problemas em causa.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas

2026-06-05T11:34:18Z

Root:

{{TOCright}}
'''PAUTA FECHADA'''


A avaliação nestas aulas é obrigatória e não é repetível fora da semana em que cada exercício é realizado. 
Não se avaliam alunos fora do turno de inscrição.

Alunos que compareçam atrasados a estas aulas não são avaliados. 
É admitido um limite máximo de 20 minutos para entrada, após a hora definida para a aula (i.e., já contabilizando os 10 minutos do início).

Não são considerados casos especiais na avaliação das aulas práticas. Alunos que considerem ter direito a tratamento especial e que não consigam comparecer com aproveitamento nestas aulas poderão requerer avaliação em época especial.

== Pauta ==
Aqui: https://bit.ly/co26-pautas (ver Fénix)

== Prazos de revisão ==
Ver anúncio correspondente no Fénix.

As revisões decorrem exclusivamente via Classroom (ver Fénix).

== Legenda ==
* ''Nota'' indica a nota final (são contabilizados os 9 melhores exercícios)
* ''Média'' indica a média dos exercícios apresentados (são contabilizados todos os exercícios)

As classificações possíveis para cada exercício são:

* 0.00 - ignorância (quase) completa da matéria em avaliação ou não inscrito no turno
* 0.25 - erros graves ou solução muito incompleta ou inadequada
* 0.50 - erros importantes ou solução incompleta
* 0.75 - erros pouco graves ou solução quase completa
* 1.00 - solução completa

'''IMPORTANTE'''

Obter classificações abaixo de 0.75 deve constituir motivo de preocupação, especialmente nos casos 0 e 0.25, sendo os alunos fortemente encorajados a contactar o responsável pela disciplina para compreensão dos problemas em causa.

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026

2026-06-05T11:33:59Z

Root: /* Pautas da Disciplina */

{{TOCright}}
Além dos resultados de avaliação, as páginas das pautas contêm também os critérios de avaliação e aprovação.
* {{PautaAberta}} indica avaliação em curso
* {{PautaFechada}} indica avaliação terminada (classificações definitivas)
* {{ProvaPorRealizar}} indica avaliação prevista

== Pautas da Disciplina ==

* [[Compiladores/Pautas 2025-2026/Pauta Global da Disciplina|Pauta Global da Disciplina]] -- próxima avaliação: (ver Fénix)
* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas|Pauta das Aulas Práticas]] (época nornal)

== Pautas do Projecto (época normal) ==

* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"|Pauta do Projecto: Entrega "zero"]]
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia|Pauta do Projecto: Entrega Intermédia]]
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final|Pauta do Projecto: Entrega Final]]
* [[Compiladores/Pautas 2025-2026/Pauta Global do Projecto|Pauta Global do Projecto]]

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final

2026-06-05T11:32:12Z

Root: /* Legenda */

{{PRJCompiladoreAvisosEN20252026}}
{{PRJCOMandatory20252026}}
{{TOCright}}

== Pauta ==
Aqui: https://bit.ly/co26-pautas (ver Fénix)

== Prazo de Revisão ==




Ver anúncio na página da disciplina (Fénix).

== Critérios de Avaliação ==
'''A entrega final é obrigatória.'''

São considerados os das entregas anteriores (adaptados).

== Legenda ==

A entrega final vale 12 valores em 20 (7 qualidade; 5 automáticos).

* Qualidade (7 valores): análise lexical (0.75) + análise sintáctica (0.75) + nós (AST) (0.75) + análise semântica e geração de código (0.75) + avaliação global (0.50) + repositório e compilação (0.50). Os pesos são relativos ao total 4 (i.e., o valor final multiplica por 7/4).
* Testes automáticos (5 valores).


'''Os alunos são encorajados a compreender/verificar os problemas reportados.'''

Quaisquer dúvidas ou sugestões, relativas a esta informação, devem ser enviadas ao responsável pela disciplina ou esclarecidas nos horários de dúvidas.

'''Recorda-se que a classificação global do projecto não se limita à soma das classificações das várias entregas: a classificação final é ainda influenciada pela classificação do teste prático. Este teste é obrigatório e eliminatório (i.e., a classificação deve ser maior que zero).'''

{| class="mw-collapsible mw-collapsed wikitable" align="right" style="border-style: solid; border-width: 1px; border-color: #bbbbaa; background: #f7f8ff;"
! style="padding-left:10px; padding-right:10px; border-style: solid; border-width: 0px; border-bottom-width: 0px; border-color: #bbbbaa; background: #d7d8ed;" | '''Descrição dos problemas assinalados na pauta'''
|-
! style="padding-left:10px; padding-right:10px; font-weight: normal; border-style: solid; border-width: 1px; border-color: #bbbbaa; " |
'''Problemas na análise lexical'''
* .* - uso indevido do padrão
* chars - definição indevida (não existem na linguagem)
* comments - problemas com comentários (em excesso ou em falta)
* real - problemas com reais (definições incompletas ou excessivas)
* ints - problemas com inteiros (definições incompletas ou excessivas)
* keywords - problemas com palavras chave (a mais ou a menos)
* strings - problemas na definição de strings (composição, concatenação indevida, etc.)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise sintáctica'''

* conflicts - conflitos no analisador LALR(1)
* exprs - problemas nas expressões (em falta ou com inclusão de casos errados)
* lvals - problemas na definição de left-values (e.g. ausência de definições ou incompletas)
* precs - problemas na definição de precedências (tipicamente, em excesso ou sem correspondência com o manual)
* strings - problemas na definção de cadeias de caracteres
* syntax - problemas na definição da gramática (relativamente ao manual de referência)
* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas nos nós'''

* [outras anotações] - casos específicos (contactar professor responsável)

'''Problemas na análise semântica e na geração de código'''

* symbol - problemas na definição dos símbolos (atributos em excesso ou em falta)
* stack - problemas na definição do stack das funções
* types - problemas na verificação de tipos
* postfix - problemas na geração de código
* [outras anotações] - casos específicos (contactar professor responsável)

'''Outros problemas'''

* empty methods - métodos vazios nos visitors (não deviam ser vazios)
* types - problemas com o visitor de verificação de tipos
* [outras anotações] - casos específicos (contactar professor responsável)

|}

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Pautas 2025-2026

2026-06-05T11:31:00Z

Root: /* Pautas do Projecto (época normal) */

{{TOCright}}
Além dos resultados de avaliação, as páginas das pautas contêm também os critérios de avaliação e aprovação.
* {{PautaAberta}} indica avaliação em curso
* {{PautaFechada}} indica avaliação terminada (classificações definitivas)
* {{ProvaPorRealizar}} indica avaliação prevista

== Pautas da Disciplina ==

* [[Compiladores/Pautas 2025-2026/Pauta Global da Disciplina|Pauta Global da Disciplina]] -- próxima avaliação: (ver Fénix)
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta das Aulas Práticas|Pauta das Aulas Práticas]] (época nornal)

== Pautas do Projecto (época normal) ==

* {{PautaFechada}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega "zero"|Pauta do Projecto: Entrega "zero"]]
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Intermédia|Pauta do Projecto: Entrega Intermédia]]
* {{PautaAberta}} [[Compiladores/Pautas 2025-2026/Pauta do Projecto: Entrega Final|Pauta do Projecto: Entrega Final]]
* [[Compiladores/Pautas 2025-2026/Pauta Global do Projecto|Pauta Global do Projecto]]

[[category:Compiladores 2025-2026]]
[[category:Compiladores]]
[[category: Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-03T13:26:35Z

Root: /* Calendário */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963 109864 110409

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' (sem inscrições)

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 52327 109797 106647 110274 110600 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-03T13:11:51Z

Root: /* Condições */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita prévia aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' 109864 110409

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 52327 109797 106647 110274 110600 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-03T13:11:11Z

Root: /* Condições */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático.'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal (recomenda-se fortemente uma visita aos labs para testar a capacidade de login -- é da responsabilidade do aluno ser capaz de fazer login), pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' 109864 110409

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 52327 109797 106647 110274 110600 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Teste Prático (Época Normal)

2026-06-03T13:09:04Z

Root: /* Calendário */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
__NOTOC__
== Condições ==
Os períodos de realização do teste prático são como indicado abaixo. O teste prático tem a duração de 45 minutos.

'''A não realização do teste prático corresponde a uma classificação de 0 (zero) na componente de projecto e consequente reprovação à disciplina de Compiladores no ano lectivo em curso (época normal).'''

'''É necessário e da responsabilidade dos alunos [https://selfservice.dsi.tecnico.ulisboa.pt/ activar os serviços de Shell e AFS], para a realização do teste prático. A activação não é instantânea e não funciona no próprio dia: alunos nestas condições estão necessariamente excluídos da avaliação, pois não conseguirão realizar o teste prático'''


'''Alunos que não consigam fazer login nas máquinas dos labs da RNL estão automaticamente excluídos da avaliação da disciplina em época normal, pois isso significa que também não participaram na realização do projecto (o acesso ao Gitlab usa as mesmas credenciais). Não são admitidas participações "passivas" ou em modo "espectador", em que um elemento "acompanha" o desenvolvimento do código pelo colega. Além disso, alunos que não demonstrem competência activa serão reprovados.'''


== Calendário ==

=== 6ª feira, 2026/06/05, 18:00, Early Bird ===
* '''LAB 0:''' 109560 109724 109643 107413 110754 110647 114963

=== 6ª feira, 2026/06/05, 19:00, Early Bird ===
* '''LAB 2:''' 109864 110409

=== 2ª feira, 2026/06/08, 09:00 ===
* '''LAB 1:''' 106823 109247 109803 109939 110210 109493 109913 110020 110130 110462
* '''LAB 2:''' 110200 102707 106516 106507 107332 110597 110008 110144 109324 109685 109245 103151 109368 106495 109339 109886 109606 109762 109872 109404
* '''LAB 3:''' 52370 109485 109972 110005 109554 109662 110052 109593 109912 90634
* '''LAB 5:''' 110093 109389 110633 109947 102373 110246 110688 110720 110206 110488 109500 109293 110350 106095 106636 110124 110285 111141 107083 72984

=== 2ª feira, 2026/06/08, 10:00 ===
* '''LAB 1:''' 110080 109439 109733 109642 104016 110458 110263 111113 109974 109434
* '''LAB 2:''' 110208 109852 95776 109878 109371 110562 110375 110233 109901 110223 110245 109905 109601 57175 109634 110439 110186 109680 116424 109775
* '''LAB 3:''' 109635 106396 109257 109989 106426 109839 110199 109378 110355 106883
* '''LAB 5:''' 104013 110446 110483 97226 109483 109163 110729 110760 107316 110136 109481 109675 110148 107357 110054 109482 109955 110308 111111 110089

=== 2ª feira, 2026/06/08, 11:00 ===
* '''LAB 1:''' 109822 103316 92409 109236 52327 109797 106647 110274 110600 88077
* '''LAB 2:''' 109704 110213 109625 109333 109416 109851 110352 109695 110034 110421 106474 109585 109267 109260 110318 106674 109617 109358 109264 110580
* '''LAB 3:''' 109441 109834 102471 109512 110135 103623 109844 110442 83897 86465
* '''LAB 5:''' 109623 109746 109544 111198 109551 109981 110490 110703 111199 110628 109616 109308 110467 109490 109555 110468 110094 111056 110713 110386

== Realizados ==
(a realizar)

[[category:Compiladores]]
[[category:Ensino]]

Compiladores/Projecto de Compiladores/Projecto 2025-2026/Manual de Referência da Linguagem P6

2026-06-02T17:16:51Z

Root: /* Expressões */

{{PRJCompiladoreAvisosEN20252026}}

{{PRJCOMandatory20252026}}
{{TOCright}}


'''ÉPOCA NORMAL'''

'''P6''' é uma linguagem imperativa. Este manual apresenta de forma intuitiva as características da linguagem: [[#Tipos de Dados|tipos de dados]]; [[#Manipulação de Nomes|manipulação de nomes]]; [[#Convenções Lexicais|convenções lexicais]]; [[#Gramática|estrutura/sintaxe]]; [[#Funções|especificação das funções]]; [[#Instruções|semântica das instruções]]; [[#Expressões|semântica das expressões]]; e, finalmente, [[#Exemplos|alguns exemplos]].

= Tipos de Dados =

A linguagem é fracamente tipificada (são efectuadas algumas conversões implícitas). Existem 4 tipos de dados básicos, apenas alguns dos quais são compatíveis com a [https://en.wikipedia.org/wiki/C_(programming_language) linguagem C]. O alinhamento em memória binária é sempre a 32 bits. Note-se que alguns dos tipos de dados são ternários e devem ser manipulados com as funções das ALUs disponibilizadas.

* Tipos numéricos: os inteiros são [https://en.wikipedia.org/wiki/Balanced_ternary ternários equilibrados], ocupam 40 trits (empacotados em 64 bits); os reais são ternários e estão representados no formato [https://arxiv.org/abs/2404.18603 Takum] (note-se que a definição neste artigo é para uma representação binária e não é exactamente a que é implementada pelas ALUs ternárias em uso no projecto), ocupam 80 trits (empacotados em 128 bits).
* As cadeias de caracteres são vectores de caracteres binários terminados por [https://en.wikipedia.org/wiki/ASCII ASCII] NUL (carácter com o valor zero). Variáveis e literais deste tipo só podem ser utilizados em atribuições, impressões, ou como argumentos/retornos de funções. Os caracteres são valores de 8 bits não directamente manipuláveis.
* Os ponteiros representam endereços de objectos (de qualquer tipo) e ocupam 32 bits. Podem ser objecto de operações aritméticas (deslocamentos) e permitem aceder ao valor apontado. Note-se que não é possível usar inteiros ternários directamente em aritmética de ponteiros (têm de ser convertidos para isso).

Os tipos suportados por cada operador e a operação a realizar são indicados na [[#Expressões|definição das expressões]].

Existem ainda tipos associado a valores funcionais, i.e., tipos que descrevem a interface de funções (ver abaixo). Os valores em memória associados a estes tipos são efectivamente ponteiros, mas para funções e não para dados, podendo ser usados para invocar as funções correspondentes. Estes identificadores não podem ser usados como variáveis (e.g., passados como argumentos de outras funções, etc.).

= Manipulação de Nomes =

Os nomes (identificadores) correspondem a variáveis e funções. Nos pontos que se seguem, usa-se o termo entidade para as designar indiscriminadamente, explicitando-se quando a descrição for válida apenas para um dos casos. Existem ainda nomes para funções externas à linguagem P6. Tanto em P6, como em C, os nomes das funções referem directamente a posição do código dessas funções (à la C; ver '''extern''' abaixo).

== Espaço de nomes e visibilidade dos identificadores ==

O espaço de nomes global é único, pelo que um nome utilizado para designar uma entidade num dado contexto não pode ser utilizado para designar outras (ainda que de natureza diferente).

Os identificadores são visíveis desde a declaração até ao fim do alcance: ficheiro (globais) ou bloco (locais). A reutilização de identificadores em contextos inferiores encobre declarações em contextos superiores: redeclarações locais podem encobrir as globais até ao fim de um bloco. É possível utilizar símbolos globais nos contextos dos blocos das funções, mas não é possível declará-los (ver [[#Símbolos globais|símbolos globais]]).

== Validade das variáveis ==

As entidades globais (declaradas fora de qualquer função), existem durante toda a execução do programa. As variáveis locais a uma função existem apenas durante a sua execução. Os argumentos formais são válidos enquanto a função está activa.

= Convenções Lexicais =

Para cada grupo de elementos lexicais (tokens), considera-se a maior sequência de caracteres constituindo um elemento válido. Assim, por exemplo, a designação '''>=''' é sempre um único elemento lexical (por oposição à situação ilegal de se terem dois símbolos: '''>''' seguido de '''=''').

== Caracteres brancos ==

São considerados separadores e não representam nenhum elemento lexical: '''mudança de linha''' ASCII LF ('''0x0A''', '''\n'''), '''recuo do carreto''' ASCII CR ('''0x0D''', '''\r'''), '''espaço''' ASCII SP ('''0x20''', ⌴) e '''tabulação horizontal''' ASCII HT ('''0x09''', '''\t''').

== Comentários ==

Existem dois tipos de comentários, que também funcionam como elementos separadores:

* '''explicativos''' -- começam com '''//''' e acabam no fim da linha; e
* '''operacionais''' -- começam com '''/*''' e terminam com '''*/''', podendo estar aninhados.

Se as sequências de início fizerem parte de uma cadeia de caracteres, não iniciam um comentário (ver [[#Cadeias de caracteres|definição das cadeias de caracteres]]).

== Palavras-chave ==

As seguintes palavras-chave são reservadas, não constituindo identificadores (devem ser escritas exactamente como indicado):

* tipos: '''int real string void'''
* declarações: '''extern forward public auto'''
* instruções: '''if elif else while stop next return'''
* expressões: '''input null sizeof'''
* outras: '''begin end'''

== Tipos ==

Os seguintes elementos lexicais designam tipos em declarações (ver gramática): '''int''' (inteiro), '''real''' (real), '''string''' (cadeia de caracteres).

Os tipos correspondentes a ponteiros são outros tipos delimitados por '''[''' e ''']''', designando uma indirecção e não o objecto directo (ver gramática).

Note-se que, quando se tem uma declaração '''extern''', os tipos correspondem aos compatíveis com a linguagem C na mesma arquitectura ix86 de 32 bits, i.e., '''int''' corresponde a um número binário inteiro em [https://en.wikipedia.org/wiki/Two%27s_complement complemento para 2] (32 bits), '''real''' coresponde a uma representação segundo a norma [https://en.wikipedia.org/wiki/IEEE_754 IEEE 754] de dupla precisão (64 bits), devendo ser convertidos de e para os tipos nativos da linguage P6 sempre que necessário (ver RTS).

== Operadores de expressões ==

São considerados operadores os elementos lexicais apresentados na definição das expressões.

== Delimitadores e terminadores ==

Os seguintes elementos lexicais são delimitadores/terminadores:
* ''',''' (vírgula)
* ''';''' (ponto e vírgula)
* '''!''' e '''!!''' (operações de impressão)
* '''(''' e ''')''' (delimitadores de expressões)
* '''{''' e '''}''' (delimitadores de blocos)

== Identificadores (nomes) ==

São iniciados por uma letra, seguindo-se 0 (zero) ou mais letras ou dígitos. O comprimento do nome é ilimitado e dois nomes são distintos se houver alteração de maiúscula para minúscula, ou vice-versa, de pelo menos um carácter.

== Literais ==

São notações para valores constantes de alguns tipos da linguagem (não confundir com constantes, i.e., identificadores que, em algumas linguagens, designam elementos cujo valor não pode ser alterado durante a execução do programa).

=== Inteiros ===

Um literal inteiro é um número não negativo (mas ver a seguir). Números negativos podem ser construídos pela aplicação do operador de negação unária ('''-''') a um literal (sempre positivo).

Literais inteiros decimais são constituídos por sequências de 1 (um) ou mais dígitos de '''0''' a '''9''', em que o primeiro digito não é 0 (zero), excepto no caso do número 0 (zero). Neste caso, é composto apenas pelo dígito 0 (zero) (em qualquer base).

Literais inteiros em base 9 começam sempre pelo dígito 0 (zero), sendo seguidos de um ou mais dígitos de '''0''' a '''8''' (note-se que '''09''' é um literal inválido em base 9). Exemplo: '''086 = 78'''.

Literais inteiros em base 3 (equilibrada) começam sempre com a sequência '''0t''', seguida de um ou mais símbolos dessa base: '''-''' (valor '''-1'''), '''0''' (valor '''0''') e '''+''' (valor '''1'''). Estes literais podem ser intrinsecamente negativos. Exemplos: '''0t+0-0 = 24'''; '''0t-0+0 = -24'''

Se não for possível representar um literal na máquina, devido a overflow, deverá ser gerado um erro lexical.

=== Reais em formato Takum3 ===

Os literais reais (sempre positivos) são expressos tal como em C (exclusivamente em base 10).

Não existem literais negativos (números negativos resultam da operação unária '''-''').

Note-se que um literal sem '''.''' (ponto decimal) nem parte exponencial é do tipo inteiro.

Note-se que, apesar de C normalmente usar uma representação interna em binário no formato IEEE 754, a linguagem P6 usa um formato, representado em ternário, completamente diferente (embora a forma de escrita dos literais seja a mesma).

Exemplos: '''3.14''', '''1E3''' = 1000 (número inteiro representado como real). '''12.34e-24''' = 12.34 x 10-24 (notação cientifica).


=== Cadeias de caracteres ===

As cadeias de caracteres são delimitadas por aspas ('''"''') e podem conter quaisquer caracteres, excepto ASCII NUL (0x00) e ASCII LF (0x0A). Nas cadeias, os delimitadores de comentários não têm significado especial. Se for escrito um literal que contenha '''\0''', então a cadeia termina nessa posição. Exemplo: '''ab\0xy''' tem o mesmo significado que '''ab'''.

É possível designar caracteres por sequências especiais (iniciadas por '''\'''), especialmente úteis quando não existe representação gráfica directa. As sequências especiais correspondem aos caracteres ASCII HT, LF e CR ('''\t''', '''\n''' e '''\r''', respectivamente), aspa ('''\"'''). ''backslash'' ('''\\'''), ou a quaisquer outros especificados através de 1 a 3 dígitos em base 8, designando valores de 8 bits (e.g., '''\012''' ou apenas '''\12''' se o carácter seguinte não representar um dígito em base 8). Exemplo: '''xy\012z''' tem o mesmo significado que '''xy\12z''' e que '''xy\nz'''.

Elementos lexicais distintos que representem duas ou mais cadeias consecutivas são representadas na linguagem como uma única cadeia que resulta da concatenação. Exemplo: '''"ab"''' '''"cd"''' é o mesmo que '''"abcd"'''.

=== Ponteiros ===

O único literal admissível para ponteiros corresponde ao ponteiro nulo e é indicado pela palavra-chave '''null'''. Este literal é compatível com todos os tipos de ponteiro. Os inteiros não são convertíveis em ponteiros, pelo que o valor '''0''' (zero) não é um valor inicial admissível para ponteiros.

Note-se que a aritmética de ponteiros é possível apenas com inteiros binários, mas não com inteiros ternários (estes devem ser convertidos para binário, caso seja necessário).

= Gramática =

A gramática da linguagem está resumida abaixo. Considerou-se que os elementos em tipo fixo são literais, que os parênteses curvos agrupam elementos, que elementos alternativos são separados por uma barra vertical, que elementos opcionais estão entre parênteses rectos, que os elementos que se repetem zero ou mais vezes estão entre <math>\langle</math> e <math>\rangle</math>. Alguns elementos usados na gramática também são elementos da linguagem descrita se representados em tipo fixo (e.g., parênteses).

{|
! style="width: 140px; font-weight: normal;" | ''ficheiro''
! style="width: 50px; font-weight: normal;" | <math>\rightarrow</math>
| <math>\langle</math> ''declaração'' <math>\rangle</math> [ ''programa-principal'' ]
|-
! style="width: 150px; font-weight: normal;" | ''declaração''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| [ ''qualificador'' ] ''tipo'' ''identificador'' [ '''=''' ''expressão'' ] ''';'''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| [ ''qualificador'' ] [ '''auto''' ] ''identificador'' '''=''' ''expressão'' ''';'''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''função''
|-
! style="width: 150px; font-weight: normal;" | ''programa-principal''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''begin''' <math>\langle</math> ''declaração'' <math>\rangle</math> <math>\langle</math> ''instrução'' <math>\rangle</math> '''end'''
|-
! style="width: 50px; font-weight: normal;" | ''função''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| [ ''qualificador'' ] ''identificador'' '''(''' ''')''' '''->''' ''tipo'' ''bloco''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| [ ''qualificador'' ] ''identificador'' '''(''' ''variáveis'' ''')''' '''->''' ''tipo'' ''bloco''
|-
! style="width: 50px; font-weight: normal;" | ''variáveis''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''variável'' <math>\langle</math> ''',''' ''variável'' <math>\rangle</math>
|-
! style="width: 50px; font-weight: normal;" | ''tipo''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''int''' <math>|</math> '''real''' <math>|</math> '''string''' <math>|</math> '''void''' <math>|</math> '''[''' ''tipo'' ''']''' <math>|</math> ''tipo-de-função''
|-
! style="width: 50px; font-weight: normal;" | ''tipo-de-função''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''tipo'' '''<''' '''>'''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''tipo'' '''<''' ''tipos'' '''>'''
|-
! style="width: 50px; font-weight: normal;" | ''tipos''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''tipo'' <math>\langle</math> ''',''' ''tipo'' <math>\rangle</math>
|-
! style="width: 50px; font-weight: normal;" | ''bloco''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''{''' <math>\langle</math> ''declaração'' <math>\rangle</math> <math>\langle</math> ''instrução'' <math>\rangle</math> '''}'''
|-
! style="width: 50px; font-weight: normal;" | ''instrução''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''expressão'' ''';''' <math>|</math> ''expressões'' '''!''' <math>|</math> ''expressões'' '''!!'''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''stop''' [ ''literal-inteiro'' ] ''';''' <math>|</math> '''next''' [ ''literal-inteiro'' ] ''';''' <math>|</math> '''return''' [ ''expressão'' ] ''';'''
|-
! style="width: 50px; font-weight: normal;" |
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''instrução-condicional'' <math>|</math> ''instrução-de-iteração'' <math>|</math> ''bloco''
|-
! style="width: 50px; font-weight: normal;" | ''instrução-condicional''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''if''' '''(''' ''expressão'' ''')''' ''instrução'' <math>\langle</math> '''elif''' '''(''' ''expressão'' ''')''' ''instrução'' <math>\rangle</math> [ '''else''' ''instrução'' ]
|-
! style="width: 50px; font-weight: normal;" | ''instrução-de-iteração''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| '''while''' '''(''' ''expressão'' ''')''' ''instrução''
|-
! style="width: 50px; font-weight: normal;" | ''expressões''
! style="width: 50px; font-weight: normal;" |<math>\rightarrow</math>
| ''expressão'' <math>\langle</math> ''',''' ''expressão'' <math>\rangle</math>
|}

== Tipos, identificadores, literais e definição de expressões ==

Algumas definições foram omitidas da gramática: tipos de dados. qualificadores e variável (ver [[#Declarações de variáveis|declarações de variáveis]]), identificador (ver [[#Identificadores (nomes)|identificadores]]), literal (ver [[#Literais|literais]]); expressão (ver [[#Expressões|expressões]]). 

Quanto a tipos de dados, '''int''' designa valores inteiros, '''real''' designa valores reais, '''string''' designa cadeias de caracteres. Os ponteiros são tipos compostos por um tipo entre parênteses rectos, e.g., '''[int]'''.

Os tipos funcionais são definidos a partir dos tipos de dados anteriormente descritos e do tipo especial '''void''' (ver a seguir). O tipo é indicado com o formato indicado na gramática, i.e., tipo de retorno seguido dos tipos dos argumentos (zero ou mais separados por vírgulas). Estes tipos servem para declarar símbolos de função sem as definir.


O tipo '''void''' apenas pode ser usado para indicar a ausência de retorno ou para declarar um ponteiro genérico. Neste caso, o aninhamento é irrelevante, i.e., '''[void]''' e '''<nowiki>[[[void]]]</nowiki>''' são equivalentes. Um ponteiro deste tipo é compatível com todos os outros tipos de ponteiros. A aritmética de ponteiros decrementa/incrementa em uma unidade o valor de um ponteiro do tipo '''[void]'''.

== Left-values ==

Os ''left-values'' são posições de memória que podem ser modificadas (excepto onde proibido pelo tipo de dados). Os elementos de uma expressão que podem ser utilizados como left-values encontram-se individualmente identificados na semântica das expressões.

== Ficheiros ==

Um ficheiro é designado por principal se contiver a função principal (onde se inicia o programa).

== Declaração de variáveis ==

Uma declaração de variável indica sempre um tipo de dados (implícito ou explícito) e um identificador.

Exemplos:

* Inteiro: '''int i'''
* Real: '''real r'''
* Cadeia de caracteres: '''string s'''
* Ponteiro para inteiro: '''[int] p1''' (semelhante a '''int*''' em C)
* Ponteiro para real: '''[real] p2''' (semelhante a '''double*''' em C)
* Ponteiro para cadeia de caracteres: '''[string] p3''' (semelhante a '''char**''' em C)
* Ponteiro para ponteiro para inteiro: '''<nowiki>[[int]]</nowiki> p4''' (semelhante a '''int**''' em C)

É possível usar o pseudo-tipo '''auto''' se a declaração tiver um valor inicial: neste caso, o tipo é o do valor inicial.

Exemplo:

* Variável inteira: '''auto i = 1'''
* Variável real: '''auto f = 2.0'''
* etc.

== Símbolos globais ==

Por omissão, os símbolos são privados a um módulo, não podendo ser importados por outros módulos.

A palavra-chave '''public''' permite declarar um identificador como público, tornando-o acessível a partir de outros módulos. Quando usado com a palavra-chave '''auto''', esta é opcional. Note-se que a declaração de uma variável tem de ter sempre, ou o qualificador, ou o tipo, podendo estar ambos presentes.

A palavra-chave '''forward''' permite declarar num módulo variáveis ou funções definidas noutros módulos. Neste caso, não pode ser especificado o valor inicial das variáveis, pelo que não é possível o uso de '''auto''' em conjunto com '''forward'''.

A palavra-chave '''extern''' deve ser usada para declarar símbolos de função com tipos diferentes dos dos nativos da da linguagem P6, e.g. para importar funções definidas em C. Além de poderem ser usados para chamar as funções que designam, os símbolos assim declarados podem ser utilizados com valores convertidos de forma apropriada.

Exemplos:
* Declarar variável privada ao módulo: '''real r1 = 22.0'''
* Declarar variável pública: '''public real r2 = 7.0'''
* Declarar variável pública: '''public auto r2 = 7.0''' (igual à anterior)
* Declarar variável pública: '''public r2 = 7.0''' (igual à anterior)
* Usar definição externa de variável pública: '''forward real r2'''
* Declarar função (nativa P6) definida externamente: '''forward int<int> factorial'''
* Declarar função definida noutra linguagem (e.g. em C): '''extern [void]<int> malloc'''

== Inicialização ==

Quando existe, é a designação do objecto que segue o símbolo '''=''': inteiro, real, cadeia de caracteres, ou ponteiro. Entidades reais podem ser inicializadas por expressões inteiras (conversão implícita). A expressão de inicialização deve ser um literal se a variável for global.

A palavra '''auto''' pode ser usada em lugar do tipo para declarar uma variável. Quando usada, o tipo da variável é inferido a partir do valor inicial (nestes casos, o valor inicial é obrigatório).

Exemplos:
* Inteiro (literal): '''int i = 3'''
* Inteiro (expressão): '''int i = j + 1'''
* Real (literal): '''real r = 3.2'''
* Real (expressão): '''real r = i - 2.5'''
* Cadeia de caracteres (literal): '''string s = "olá"'''
* Cadeia de caracteres (literais): '''string s = "olá" "mãe"'''
* Ponteiro (literal): '''<nowiki>[[[real]]] p</nowiki> = null'''
* Ponteiro (expressão): '''[int] p = q + 1'''


= Funções =

Uma função permite agrupar um conjunto de instruções num corpo, executado com base num conjunto de parâmetros (os argumentos formais), quando é invocada a partir de uma expressão.

== Declaração ==

As funções têm um nome que é também o endereço dessa função. O tipo de retorno de uma função que não produz valores de retorno é '''void'''.

As funções que recebam argumentos devem indicá-los no cabeçalho. Funções sem argumentos definem um cabeçalho vazio. Os qualificadores de exportação/importação '''public''' ou '''forward''' (ver símbolos globais) podem ser aplicados às funções, mas não é possível aplicá-los às declarações dos argumentos de uma função. Não é possível especificar valores por omissão para os argumentos de uma função, nem para o valor de retorno.

A declaração de um ponteiro para uma função (ou, de forma equivalente, do seu nome) é utilizada para caracterizar um identificador exterior ou para efectuar declarações antecipadas (utilizadas para pré-declarar funções que sejam usadas antes de ser definidas, por exemplo, entre duas funções mutuamente recursivas). 

== Invocação ==

Uma função pode ser invocada através do seu nome. 
Se existirem argumentos, na invocação da função, o nome é seguido de uma lista de expressões delimitadas por parênteses curvos. Esta lista é uma sequência, possivelmente vazia, de expressões separadas por vírgulas. O número e tipo de parâmetros actuais deve ser igual ao número e tipo dos parâmetros formais da função invocada (a menos de conversões implícitas). A ordem dos parâmetros actuais deverá ser a mesma dos argumentos formais da função a ser invocada.

De acordo com a convenção Cdecl, a função chamadora coloca os argumentos na pilha e é responsável pela sua remoção, após o retorno da chamada. Assim, os parâmetros actuais devem ser colocados na pilha pela ordem inversa da sua declaração (i.e., são avaliados da direita para a esquerda antes da invocação da função e o resultado passado por cópia/valor). O endereço de retorno é colocado no topo da pilha pela chamada à função. Note que o retorno de entidades com dimensão superior a 64 bits deve fazer-se através da reserva de espaço para o retorno no chamador e passando um ponteiro para esse espaço como primeiro argumento do chamado.

== Corpo ==

O corpo de uma função consiste num bloco que contém declarações (opcionais) seguidas de instruções (opcionais). Não é possível aplicar os qualificadores de exportação ('''public''') ou de importação ('''forward''' ou '''extern''') (ver [[#Símbolos globais|símbolos globais]]) dentro do corpo de uma função.

Uma instrução '''return''' causa a interrupção da função. O valor devolvido por uma função, através de expressão usada como argumento da instrução '''return''', deve ser do tipo declarado no cabeçalho da função. Ver casos especiais acima.

É um erro especificar um valor de retorno se a função for declarada como não retornando um valor (indicada como '''void''').

Qualquer bloco (usado, por exemplo, numa instrução condicional ou de iteração) pode definir variáveis locais. 

== Função principal e execução de programas ==

Um programa é a sequência de instruções que seguem as declarações globais num ficheiro, delimitadas pelas palavras-chave '''begin''' e '''end'''. Esta sequência forma o que em algumas linguagens se chama a função principal. Os argumentos com que o programa foi chamado podem ser obtidos através de funções '''argc''' (devolve o número de argumentos); '''argv''' (devolve o n-ésimo argumento como uma cadeia de caracteres, com n>0); e '''envp''' (devolve a n-ésima variável de ambiente como uma cadeia de caracteres, com n>0). Apenas um dos módulos do programa pode definir a função principal, i.e., se existirem vários módulos, apenas um deles pode conter mais do que declarações de variáveis globais.

extern int<> argc
extern string<int> argv
extern string<int> envp

O valor de retorno da função principal é devolvido ao ambiente que invocou o programa. Este valor de retorno segue as seguintes regras (sistema operativo): 0 (zero), execução sem erros; 1 (um), argumentos inválidos (em número ou valor); 2 (dois), erro de execução. Os valores superiores a 128 indicam que o programa terminou com um sinal. Em geral, para correcto funcionamento, os programas devem devolver 0 (zero) se a execução foi bem-sucedida e um valor diferente de 0 (zero) em caso de erro.

A biblioteca de run-time (RTS) contém informação sobre outras funções de suporte disponíveis, incluindo chamadas ao sistema (ver também o manual da RTS).

= Instruções =

Excepto quando indicado, as instruções são executadas em sequência.

== Blocos ==

Cada bloco tem uma zona de declarações de variáveis locais (facultativa), seguida por uma zona com instruções (possivelmente vazia). Não é possível definir funções dentro de blocos, mas é possível declarar ponteiros de função locais.

A visibilidade das variáveis é limitada ao bloco em que foram declaradas. As entidades declaradas podem ser directamente utilizadas em sub-blocos ou passadas como argumentos para funções chamadas dentro do bloco. Caso os identificadores usados para definir as variáveis locais já estejam a ser utilizados para definir outras entidades ao alcance do bloco, o novo identificador passa a referir uma nova entidade definida no bloco até que ele termine (a entidade previamente definida continua a existir, mas não pode ser directamente referida pelo seu nome). Esta regra é também válida relativamente a
argumentos de funções (ver corpo das funções).

== Instrução condicional ==

Esta instrução tem comportamento semelhante ao da instrução '''if-else''' em C. As partes correspondentes a '''elif''' comportam-se como encadeamentos de instruções condicionais na parte '''else''' de um '''if-else''' à la C.

== Instrução de iteração ==

Esta instrução tem comportamento idêntico ao da instrução '''while''' em C.

== Instrução de terminação ==

A instrução '''stop''' termina o n-ésimo ciclo mais interior em que a instrução se encontrar (quando o argumento é omitido, assume-se '''n=1'''), tal como a instrução '''break''' em C. Esta instrução só pode existir dentro de um ciclo, sendo a última instrução do seu bloco.

{{Suggestion|Note-se que, tal como na restante aritmética de ponteiros, o valor inteiro, neste caso, corresponde a uma entidade binária com 32 bits.}}

== Instrução de continuação ==

A instrução '''next''' reinicia o n-ésimo ciclo mais interior em que a instrução se encontrar (quando o argumento é omitido, assume-se '''n=1'''), tal como a instrução '''continue''' em C. Esta instrução só pode existir dentro de um ciclo, sendo a última instrução do seu bloco.

{{Suggestion|Note-se que, tal como na restante aritmética de ponteiros, o valor inteiro, neste caso, corresponde a uma entidade binária com 32 bits.}}

== Instrução de retorno ==

A instrução '''return''', se existir, é a última instrução do seu bloco. Ver comportamento na [[#Corpo|descrição do corpo de uma função]].

== Expressões como instruções ==

As expressões utilizadas como instruções são sempre avaliadas, mesmo que não produzam efeitos secundários.

== Instruções de impressão ==

As notações '''!''' e '''!!''' podem ser utilizadas para apresentar valores na saída do programa. A primeira forma apresenta os valores sem mudar de linha; a segunda forma apresenta os valores mudando de linha depois de os apresentar a todos. Quando existe mais de uma expressão, as várias expressões são apresentadas sem separação. Valores numéricos (inteiros ou reais) são impressos em decimal. As cadeias de caracteres são impressas na codificação nativa. Ponteiros não podem ser impressos.

= Expressões =

Uma expressão é uma representação algébrica de uma quantidade: todas as expressões têm um tipo e devolvem um valor.

Existem [[#Expressões primitivas|expressões primitivas]] e expressões que resultam da [[#Expressões resultantes de avaliação de operadores|avaliação de operadores]].

A tabela seguinte apresenta as precedências relativas dos operadores: é a mesma para operadores na mesma linha, sendo as linhas seguintes de menor prioridade que as anteriores. A maioria dos operadores segue a semântica da linguagem C (excepto onde explicitamente indicado).

Algumas instruções, como if-else e while, esperam condições binárias: nestes casos, os valores lógicos ternários podem ser avaliados, à la C, como "verdade" (mapeamento directo da condição verdadeira ternária) e "não verdadeiro" (i.e., os outros dois casos ternários). Ou seja, valores lógicos ternários menores ou iguais a zero são considerados falsos e os positivos são considerados verdadeiros. Ver casos de uso no compilador tritak (e.g. geração de código para o ciclo while).

{|
| '''Tipo de Expressão'''
| '''Operadores'''
| '''Associatividade'''
| '''Operandos'''
| '''Semântica'''
|-
| primária
| '''( ) [ ]'''
| não associativos
| -
| [[#Parênteses curvos|parênteses curvos]], [[#Indexação|indexação]], [[#Reserva de memória|reserva de memória]]
|-
| unária
| '''+ - ?'''
| não associativos
| -
| [[#Identidade e simétrico|identidade e simétrico]], [[#Expressão de indicação de posição|indicação de posição]]
|-
! style="vertical-align: top; font-weight: normal;" | "não" lógico
! style="vertical-align: top; font-weight: normal;" | '''~'''
! style="vertical-align: top; font-weight: normal;" | não associativo
! style="vertical-align: top; font-weight: normal;" | inteiros
! style="vertical-align: top; font-weight: normal;" | Lógica de Kleene: negação
|-
! style="vertical-align: top; font-weight: normal;" | multiplicativa
! style="vertical-align: top; font-weight: normal;" | '''* / %'''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros, reais
! style="vertical-align: top; font-weight: normal;" | análoga à do C (% é apenas para inteiros), mas para entidades ternárias
|-
! style="vertical-align: top; font-weight: normal;" | aditiva
! style="vertical-align: top; font-weight: normal;" | '''+ -'''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros, reais, ponteiros
! style="vertical-align: top; font-weight: normal;" | análoga à do C (% é apenas para inteiros), mas para entidades ternárias: se envolverem ponteiros, calculam: (i) deslocamentos, i.e., um dos operandos deve ser do tipo ponteiro e o outro do tipo inteiro (binário de 32 bits); (ii) diferenças de ponteiros, i.e., apenas quando se aplica o operador '''-''' a dois ponteiros do mesmo tipo (o resultado é o número de objectos do tipo apontado entre eles, representado como um valor inteiro ternário de 64 bits). Se a memória não for contígua, o resultado é indefinido.
|-
! style="vertical-align: top; font-weight: normal;" | comparativa
! style="vertical-align: top; font-weight: normal;" | '''< > <= >='''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros, reais
! style="vertical-align: top; font-weight: normal;" | análoga à do C, mas para entidades ternárias
|-
! style="vertical-align: top; font-weight: normal;" | igualdade
! style="vertical-align: top; font-weight: normal;" | '''== !='''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros, reais, ponteiros
! style="vertical-align: top; font-weight: normal;" | análoga à do C, mas para entidades ternárias
|-
! style="vertical-align: top; font-weight: normal;" | "e" lógico
! style="vertical-align: top; font-weight: normal;" | '''&&'''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros
! style="vertical-align: top; font-weight: normal;" | Lógica de Kleene: o 2º argumento só é avaliado se o 1º não for falso.
|-
! style="vertical-align: top; font-weight: normal;" | "ou" lógico
! style="vertical-align: top; font-weight: normal;" | '''<nowiki>||</nowiki>'''
! style="vertical-align: top; font-weight: normal;" | da esquerda para a direita
! style="vertical-align: top; font-weight: normal;" | inteiros
! style="vertical-align: top; font-weight: normal;" | Lógica de Kleene: o 2º argumento só é avaliado se o 1º não for verdadeiro.
|-
! style="vertical-align: top; font-weight: normal;" | atribuição
! style="vertical-align: top; font-weight: normal;" | '''='''
! style="vertical-align: top; font-weight: normal;" | da direita para a esquerda
! style="vertical-align: top; font-weight: normal;" | todos os tipos
! style="vertical-align: top; font-weight: normal;" | O valor da expressão do lado direito do operador é guardado na posição indicada pelo ''left-value'' (operando esquerdo do operador). Podem ser atribuídos valores inteiros a ''left-values'' reais (conversão automática). Nos outros casos, ambos os tipos têm de concordar. O literal '''null''' é compatível com todos os tipos de ponteiros.
|}

== Expressões primitivas ==

As [[#Literais|expressões literais]] e a [[#Invocação|invocação de funções]] foram definidas acima.

=== Identificadores ===

Um identificador é uma expressão se tiver sido declarado. Um identificador pode denotar uma variável.

Um identificador é o caso mais simples de um ''[[#Left-values|left-value]]'', ou seja, uma entidade que pode ser utilizada no lado esquerdo (''left'') de uma atribuição.

=== Leitura ===

A operação de leitura de um valor inteiro ou real pode ser efectuado pela expressão indicada pela palavra-chave '''input''', que devolve o valor lido, de acordo com o tipo esperado (inteiro ou real). Caso se use como argumento dos operadores de impressão ou noutras situações que permitam vários tipos (e.g. '''!''' ou '''!!'''), deve ser lido um inteiro.

Exemplos: '''a = input''' (leitura para '''a'''), '''f(input)''' (leitura para argumento de função), '''input!!''' (leitura e impressão).

=== Parênteses curvos ===

Uma expressão entre parênteses curvos tem o valor da expressão sem os parênteses e permite alterar a prioridade dos operadores. Uma expressão entre parênteses não pode ser utilizada como ''left-value'' (ver também a [[#Indexação|expressão de indexação]]).


== Expressões resultantes de avaliação de operadores ==

=== Indexação de ponteiros ===

A indexação de ponteiros devolve o valor de uma posição de memória indicada por um ponteiro. Consiste em uma expressão ponteiro seguida do índice entre parênteses rectos. O resultado de uma indexação de ponteiros é um ''[[#Left-values|left-value]]''. Não é possível indexar ponteiros que designem funções.

Exemplo (acesso à posição 0 da zona de memória indicada por '''p'''): '''p[0]'''

=== Identidade e simétrico ===

Os operadores identidade ('''+''') e simétrico ('''-''') aplicam-se a inteiros e reais. Têm o mesmo significado que em análogo às operações correspondentes em C, mas operam sobre grandezas ternárias.

=== Reserva de memória ===

A expressão reserva de memória devolve o ponteiro que aponta para a zona de memória, na pilha da função actual, contendo espaço suficiente para o número de objectos indicados pelo seu argumento inteiro.

Exemplo (reserva vector com 5 reais, apontados por '''p'''): '''[real] p = [5]'''

=== Expressão de indicação de posição ===

O operador sufixo '''?''' aplica-se a ''left-values'', retornando o endereço (com o tipo ponteiro) correspondente.

Exemplo (indica o endereço de '''a'''): '''a?'''

=== Expressão de dimensão ===

O operador '''sizeof''' tem um único argumento e aplica-se a expressões, retornando a dimensão correspondente em bytes.

Exemplo: '''sizeof(a)''' (dimensão de '''a''').

= Exemplos e Testes =

Os exemplos abaixo não são exaustivos e não ilustram todos os aspectos da linguagem.

Estão ainda disponíveis outros [https://gitlab.rnl.tecnico.ulisboa.pt/leic-a-co26/eval/co26 pacotes de testes].

O seguinte exemplo ilustra um programa com dois módulos: um que define a função '''factorial''' e outro que define a função principal.

Definição da função '''factorial''' no ficheiro '''factorial.p6''':

<syntaxhighlight lang="text">
public factorial(int n) -> int {
if (n > 1)
return n * factorial(n - 1);
else
return 1;
}
</syntaxhighlight>

Exemplo da utilização da função '''factorial''' no ficheiro '''main.p6''':

<syntaxhighlight lang="text">
// external builtin functions (non-P6)
extern int<> argc;
extern string<int> argv;
extern int<string> atoi;

// external user functions (P6)
forward int<int> factorial;

// the main function
begin
auto value = 1;
"Teste para a função factorial."!!
if (argc() == 2) {
string s = argv(1);
value = atoi(s);
}
value, "! é ", factorial(value)!!
return 0;
end
</syntaxhighlight>

Como compilar:
<syntaxhighlight lang="text">
p6 --target asm factorial.p6
p6 --target asm main.p6
yasm -felf32 factorial.asm
yasm -felf32 main.asm
ld -melf_i386 -o main factorial.o main.o -lrts
</syntaxhighlight>

= Omissões e Erros =

Casos omissos e erros serão corrigidos em futuras versões do manual de referência.

[[category:Projecto de Compiladores]]
[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 08

2026-06-02T07:50:47Z

Root: /* Código Postfix (não optimizado) */

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
double *fun(double *a, double *b) {
double *c = (double *)malloc(2 * 8);
int i;
for (i = 0; i < (len < 2 ? len : 2); i++)
c[i] = a[i] + b[i];
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<syntaxhighlight lang="asm">
;; BB1 START
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 8 ; c@-4 i@-8 a@+8 b@+12 len@+16
INT 2
INT 8
MUL
CALL malloc
;; BB1 END

;; BB2 START
TRASH 4
LDFVAL32I ; malloc result (no conversion necessary)
LOCAL -4 ; &c
STINT ; c = ...

INT 0
DUP32
LOCAL -8 ; &i
STINT
TRASH 4
;; BB2 END

;; BB3 START
ALIGN
LABEL fortest

LOCAL -8 ; &i
LDINT ; i

LOCAL +16
LDINT ; len
INT 2
LT
JZ op3else
;; BB3 END

;; BB4 START
LOCAL +16
LDINT ; len
JMP op3end
;; BB4 END

;; BB5 START
ALIGN
LABEL op3else
INT 2
;; BB5 END

;; BB6 START
ALIGN
LABEL op3end

LT
JZ forend
;; BB6 END

;; BB7 START
LOCAL +8
LDINT ; a
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &a[i]
LDDOUBLE ; a[i]

LOCAL +12
LDINT ; b
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &b[i]
LDDOUBLE ; b[i]

DADD ; a[i] + b[i]
DUP64

LOCAL -4
LDINT ; c
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &c[i]

STDOUBLE
TRASH 8
;; BB7 END

;; BB8 START
ALIGN
LABEL forincr

LOCAL -8
LDINT ; i
DUP32
INT 1
ADD
LOCAL -8
STINT
TRASH 4

JMP fortest
;; BB8 END

;; BB9 START
ALIGN
LABEL forend

LOCAL -4
LDINT
STFVAL32I
LEAVE
RET
;; BB9 END
</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 08

2026-06-02T07:48:24Z

Root: /* Código Postfix (não optimizado) */

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
double *fun(double *a, double *b) {
double *c = (double *)malloc(2 * 8);
int i;
for (i = 0; i < (len < 2 ? len : 2); i++)
c[i] = a[i] + b[i];
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<syntaxhighlight lang="asm">
;; BB1 START
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 8 ; c@-4 i@-8 a@+8 b@+12 len@+16
INT 2
INT 8
MUL
CALL malloc
;; BB1 END

;; BB2 START
TRASH 4
LDFVAL32I ; malloc result (no conversion necessary)
LOCAL -4 ; &c
STINT ; c = ...

INT 0
DUP32
LOCAL -8 ; &i
STINT
TRASH 4
;; BB2 END

;; BB3 START
ALIGN
LABEL fortest

LOCAL +16
LDINT ; len
INT 2
LT
JZ op3else
;; BB3 END

;; BB4 START
LOCAL +16
LDINT ; len
JMP op3end
;; BB4 END

;; BB5 START
ALIGN
LABEL op3else
INT 2
;; BB5 END

;; BB6 START
ALIGN
LABEL op3end

LT
JZ forend
;; BB6 END

;; BB7 START
LOCAL +8
LDINT ; a
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &a[i]
LDDOUBLE ; a[i]

LOCAL +12
LDINT ; b
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &b[i]
LDDOUBLE ; b[i]

DADD ; a[i] + b[i]
DUP64

LOCAL -4
LDINT ; c
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &c[i]

STDOUBLE
TRASH 8
;; BB7 END

;; BB8 START
ALIGN
LABEL forincr

LOCAL -8
LDINT ; i
DUP32
INT 1
ADD
LOCAL -8
STINT
TRASH 4

JMP fortest
;; BB8 END

;; BB9 START
ALIGN
LABEL forend

LOCAL -4
LDINT
STFVAL32I
LEAVE
RET
;; BB9 END
</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Code Generation/Exercise 11

2026-06-01T22:44:23Z

Root: /* Problema */

{{TOCright}}
== Problema ==

Considere o seguinte código C++ (assuma que ponteiros e '''int''' ocupam 32 bits e que '''double''' ocupa 64 bits).

<syntaxhighlight lang="c++">
double *forall(double *v) {
const static int limit = 1024;
for (int i = 0; i < limit; i++) {
v[i] = 3 * i – sizeof(double);
if (v[i] > 2 * i) v[i] = limit;
}
return v;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente à função é o seguinte (agradece-se a comunicação de questões relativas a este código).

No código Postfix, '''BB#''' significa "[[Optimization Topics|bloco básico]] número".
{{CollapsedCode|Postfix code|
<syntaxhighlight lang="asm">
TEXT
ALIGN
GLOBAL forall, FUNC
LABEL forall
ENTER 4 ; i@-4 v@+8

; define "limit" (this is not an assignment)
RODATA
ALIGN
LABEL limit ; not really this name
SINT 1024
; done - go back to code segment
TEXT
ALIGN

; initialize for-loop control variable (again, not an assignment)
INT 0
LOCAL -4
STINT ; i = 0

; for-loop test
LABEL fortest
LOCAL -4
LDINT ; i
ADDR limit
LDINT ; limit
LT ; i<limit
JZ forend

; BEGIN for-loop body

; BEGIN assignment to v[i]

; compute and promote 3*i
INT 3
LOCAL -4 ; &i
LDINT ; i
MUL
INT 8 ; sizeof(double)
SUB
I2D

DUP64 ; implement assignment value

; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]

STDOUBLE ; do assignment of double value

TRASH 8 ; discard value of assignment

; END assignment to v[i]

; if condition
; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]
LDDOUBLE ; v[i]

; compute and promote 2*i
INT 2
LOCAL -4 ; &i
LDINT ; i
MUL
I2D

; compare
DCMP
INT 0
GT

; jump to if end
JZ ifend

; BEGIN if block
; do assignment (double)

; load and promote "limit"
ADDR limit
LDINT
I2D

DUP64 ; implement assignment value

; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]

STDOUBLE ; do assignment of double value

TRASH 8 ; discard value of assignment

; END if block
LABEL ifend

; FOR increment
LABEL forincr

; increment expression
LOCAL -4 ; &i
LDINT ; i
DUP32
INT 1
ADD
LOCAL -4 ; &i
STINT
TRASH 4

; END for-loop body
JMP fortest
LABEL forend

; return *v
LOCAL +8 ; &v
LDINT ; v
STFVAL32I
LEAVE
RET

</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura de 32 bits):

pf2asm forall.pf
yasm -felf forall.asm

[[category:Compiladores]]
[[category:Ensino]]

Code Generation/Exercise 11

2026-06-01T22:44:09Z

Root: /* Código Postfix (não optimizado) */

{{TOCright}}
== Problema ==

Considere o seguinte código C++ (assuma que ponteiros e '''int''' ocupam 32 bits e que '''double''' ocupa 64 bits).

<source lang="c++">
double *forall(double *v) {
const static int limit = 1024;
for (int i = 0; i < limit; i++) {
v[i] = 3 * i – sizeof(double);
if (v[i] > 2 * i) v[i] = limit;
}
return v;
}
</source>

== Código Postfix (não optimizado) ==

O código Postfix correspondente à função é o seguinte (agradece-se a comunicação de questões relativas a este código).

No código Postfix, '''BB#''' significa "[[Optimization Topics|bloco básico]] número".
{{CollapsedCode|Postfix code|
<syntaxhighlight lang="asm">
TEXT
ALIGN
GLOBAL forall, FUNC
LABEL forall
ENTER 4 ; i@-4 v@+8

; define "limit" (this is not an assignment)
RODATA
ALIGN
LABEL limit ; not really this name
SINT 1024
; done - go back to code segment
TEXT
ALIGN

; initialize for-loop control variable (again, not an assignment)
INT 0
LOCAL -4
STINT ; i = 0

; for-loop test
LABEL fortest
LOCAL -4
LDINT ; i
ADDR limit
LDINT ; limit
LT ; i<limit
JZ forend

; BEGIN for-loop body

; BEGIN assignment to v[i]

; compute and promote 3*i
INT 3
LOCAL -4 ; &i
LDINT ; i
MUL
INT 8 ; sizeof(double)
SUB
I2D

DUP64 ; implement assignment value

; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]

STDOUBLE ; do assignment of double value

TRASH 8 ; discard value of assignment

; END assignment to v[i]

; if condition
; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]
LDDOUBLE ; v[i]

; compute and promote 2*i
INT 2
LOCAL -4 ; &i
LDINT ; i
MUL
I2D

; compare
DCMP
INT 0
GT

; jump to if end
JZ ifend

; BEGIN if block
; do assignment (double)

; load and promote "limit"
ADDR limit
LDINT
I2D

DUP64 ; implement assignment value

; compute &v[i] == v+i*sizeof(double)
LOCAL +8 ; &v
LDINT ; v
LOCAL -4 ; &i
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &v[i]

STDOUBLE ; do assignment of double value

TRASH 8 ; discard value of assignment

; END if block
LABEL ifend

; FOR increment
LABEL forincr

; increment expression
LOCAL -4 ; &i
LDINT ; i
DUP32
INT 1
ADD
LOCAL -4 ; &i
STINT
TRASH 4

; END for-loop body
JMP fortest
LABEL forend

; return *v
LOCAL +8 ; &v
LDINT ; v
STFVAL32I
LEAVE
RET

</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura de 32 bits):

pf2asm forall.pf
yasm -felf forall.asm

[[category:Compiladores]]
[[category:Ensino]]

Optimization Topics/Exercise 09

2026-06-01T21:06:31Z

Root:

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
double *fun(double *a, double *b) {
double *c = (double *)malloc(160 * 4);
int i, j;
for (j = 0; j < 40; ++j)
for (i = 0; i < 4; ++i)
c[i+j*4] = a[i+j*4] + b[i*40+j] + 100*j;
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<syntaxhighlight lang="asm">
;; BB1 START
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 12 ; c@-4 i@-8 j@-12 a@+8 b@+12

INT 160
INT 4
MUL
CALL malloc
;; BB1 END

;; BB2 START
TRASH 4
LDFVAL32 ; malloc result (no conversion necessary)
LOCAL -4 ; &c
STINT ; c = ...

INT 0
DUP32
LOCAL -12 ; &j
STINT ; j = 0
TRASH 4
;; BB2 END

;; BB3 START
ALIGN
LABEL for1test

LOCAL -12
LDINT ; j
INT 40
LT ; j < 40
JZ for1end
;; BB3 END

;; BB4 START
INT 0
DUP32
LOCAL -8 ; &i
STINT ; i = 0
TRASH 4
;; BB4 END

;; BB5 START
ALIGN
LABEL for2test

LOCAL -8
LDINT ; i
INT 4
LT ; i < 4
JZ for2end
;; BB5 END

;; BB6 START
LOCAL +8
LDINT ; a

LOCAL -8
LDINT ; i
LOCAL -12
LDINT ; j
INT 4
MUL
ADD ; i+j*4

INT 8 ; sizeof(double)
MUL
ADD ; &a[...]
LDDOUBLE ; a[...]

LOCAL +12
LDINT ; b

LOCAL -8
LDINT ; i
INT 40
MUL
LOCAL -12
LDINT ; j
ADD ; i*40+j

INT 8 ; sizeof(double)
MUL
ADD ; &b[...]
LDDOUBLE ; b[...]

DADD

INT 100
LOCAL -12
LDINT ; j
MUL ; 100*j
I2D

DADD
DUP64

LOCAL -4
LDINT ; c

LOCAL -8
LDINT ; i
LOCAL -12
LDINT ; j
INT 4
MUL
ADD ; i+j*4

INT 8 ; sizeof(double)
MUL
ADD ; &c[...]

STDOUBLE
TRASH 8
;; BB6 END

;; BB7 START
ALIGN
LABEL for2incr

LOCAL -8
LDINT
INT 1
ADD
DUP32
LOCAL -8
STINT ; ++i
TRASH 4

JMP for2test
;; BB7 END

;; BB8 START
ALIGN
LABEL for2end

ALIGN
LABEL for1incr

LOCAL -12
LDINT
INT 1
ADD
DUP32
LOCAL -12
STINT ; ++j
TRASH 4

JMP for1test
;; BB8 END

;; BB9 START
ALIGN
LABEL for1end

LOCAL -4
LDINT ; c
STFVAL32I
LEAVE
RET
;; BB9 END
</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 08

2026-06-01T21:05:34Z

Root:

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
double *fun(double *a, double *b) {
double *c = (double *)malloc(2 * 8);
int i;
for (i = 0; i < (len < 2 ? len : 2); i++)
c[i] = a[i] + b[i];
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<syntaxhighlight lang="asm">
;; BB1 START
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 8 ; c@-4 i@-8 a@+8 b@+12 len@+16
INT 2
INT 8
MUL
CALL malloc
;; BB1 END

;; BB2 START
TRASH 4
LDFVAL32 ; malloc result (no conversion necessary)
LOCAL -4 ; &c
STINT ; c = ...

INT 0
DUP32
LOCAL -8 ; &i
STINT
TRASH 4
;; BB2 END

;; BB3 START
ALIGN
LABEL fortest

LOCAL +16
LDINT ; len
INT 2
LT
JZ op3else
;; BB3 END

;; BB4 START
LOCAL +16
LDINT ; len
JMP op3end
;; BB4 END

;; BB5 START
ALIGN
LABEL op3else
INT 2
;; BB5 END

;; BB6 START
ALIGN
LABEL op3end

LT
JZ forend
;; BB6 END

;; BB7 START
LOCAL +8
LDINT ; a
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &a[i]
LDDOUBLE ; a[i]

LOCAL +12
LDINT ; b
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &b[i]
LDDOUBLE ; b[i]

DADD ; a[i] + b[i]
DUP64

LOCAL -4
LDINT ; c
LOCAL -8
LDINT ; i
INT 8 ; sizeof(double)
MUL
ADD ; &c[i]

STDOUBLE
TRASH 8
;; BB7 END

;; BB8 START
ALIGN
LABEL forincr

LOCAL -8
LDINT ; i
DUP32
INT 1
ADD
LOCAL -8
STINT
TRASH 4

JMP fortest
;; BB8 END

;; BB9 START
ALIGN
LABEL forend

LOCAL -4
LDINT
STFVAL32I
LEAVE
RET
;; BB9 END
</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 07

2026-06-01T21:04:52Z

Root: /* Código Postfix (não optimizado) */

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
int fun(double a, double b) {
int i = 10, c;
c = 20 * 1024 + i;
while (++i < a + b) {
if (a + b < 3 * i + 5) c += 2 * i;
}
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<syntaxhighlight lang="asm">
;;---- BB1 START ----
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 8 ; i@-4 c@-8 a@+8 b@+16

INT 10
LOCA -4 ; i=10

INT 20
INT 1024
MUL
LOCAL -4
LDINT
ADD
DUP32
LOCAL -8
STINT ; c = ...
TRASH 4
;;---- BB1 END ----

;;---- BB2 START ----
ALIGN
LABEL while_test
LOCAL -4
LDINT
INT 1
ADD
DUP32
LOCAL -4
STINT ; ++i
I2D

LOCAL +8
LDDOUBLE
LOCAL +16
LDDOUBLE
DADD ; a + b

DCMP
INT 0
LT
JZ while_end
;;---- BB2 END ----

;;---- BB3 START ----
LOCAL +8
LDDOUBLE
LOCAL +16
LDDOUBLE
DADD ; a + b

INT 3
LOCAL -4
LDINT
MUL
INT 5
ADD
I2D

DCMP
INT 0
LT
JZ ifend
;;---- BB3 END ----

;;---- BB4 START ----
LOCAL -8
LDINT ; c
INT 2
LOCAL -4
LDINT
MUL ; 2 * i
ADD
DUP32
LOCAL -8 ; &c
STINT
TRASH 4
;;---- BB4 END ----

;;---- BB5 START ----
ALIGN
LABEL ifend

JMP while_test
;;---- BB5 END ----

;;---- BB6 START ----
ALIGN
LABEL while_end

LOCAL -8
LDINT ; c
STFVAL32I
LEAVE
RET
;;---- BB6 END ----
</syntaxhighlight>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 07

2026-06-01T21:04:36Z

Root:

{{TOCright}}
== Problema ==

Considere a seguinte função em C:
# Que optimizações independentes da máquina são possíveis?
# Traduza-a para Postfix optimizado.

<syntaxhighlight lang="c">
int fun(double a, double b) {
int i = 10, c;
c = 20 * 1024 + i;
while (++i < a + b) {
if (a + b < 3 * i + 5) c += 2 * i;
}
return c;
}
</syntaxhighlight>

== Código Postfix (não optimizado) ==

O código Postfix correspondente ao código C é o seguinte (agradece-se a comunicação de questões relativas a este código).

{{CollapsedCode|Código Postfix|
<source lang="asm">
;;---- BB1 START ----
TEXT
ALIGN
GLOBAL fun, FUNC
LABEL fun
ENTER 8 ; i@-4 c@-8 a@+8 b@+16

INT 10
LOCA -4 ; i=10

INT 20
INT 1024
MUL
LOCAL -4
LDINT
ADD
DUP32
LOCAL -8
STINT ; c = ...
TRASH 4
;;---- BB1 END ----

;;---- BB2 START ----
ALIGN
LABEL while_test
LOCAL -4
LDINT
INT 1
ADD
DUP32
LOCAL -4
STINT ; ++i
I2D

LOCAL +8
LDDOUBLE
LOCAL +16
LDDOUBLE
DADD ; a + b

DCMP
INT 0
LT
JZ while_end
;;---- BB2 END ----

;;---- BB3 START ----
LOCAL +8
LDDOUBLE
LOCAL +16
LDDOUBLE
DADD ; a + b

INT 3
LOCAL -4
LDINT
MUL
INT 5
ADD
I2D

DCMP
INT 0
LT
JZ ifend
;;---- BB3 END ----

;;---- BB4 START ----
LOCAL -8
LDINT ; c
INT 2
LOCAL -4
LDINT
MUL ; 2 * i
ADD
DUP32
LOCAL -8 ; &c
STINT
TRASH 4
;;---- BB4 END ----

;;---- BB5 START ----
ALIGN
LABEL ifend

JMP while_test
;;---- BB5 END ----

;;---- BB6 START ----
ALIGN
LABEL while_end

LOCAL -8
LDINT ; c
STFVAL32I
LEAVE
RET
;;---- BB6 END ----
</source>
}}

== Compiling and Running ==

Para compilar o código Postfix directamente, pode ser utilizada a ferramenta [[Compiladores/Projecto de Compiladores/Compiladores Exemplo|pf2asm]] (assumindo uma arquitectura Intel de 32 bits -- ix86):

pf2asm code.pf
yasm -felf32 code.asm

[[category:Compiladores]]
[[category: Ensino]]

Optimization Topics/Exercise 06

2026-06-01T21:04:00Z

Root:

Considere a seguinte função em C:

<syntaxhighlight lang="c">
int main() {
int a[10], i = 1;
a[0] = 0;
while (i < 10)
a[i++] = a[i-1] + 2 * i - 1;
return 0;
}
</syntaxhighlight>

# Identifique os blocos básicos.
# Que optimizações poderiam ser efectuadas?

Optimization Topics/Exercise 04

2026-06-01T21:03:27Z

Root:

Considere a seguinte função em C:
<syntaxhighlight lang="c">
int find(int tab[], int max, int val) {
int i;
for (i = 0; i < max; i++)
if (tab[i] == val)
break;
return i;
}
</syntaxhighlight>

# Identifique as optimizações independentes da máquina que são possíveis.
# Traduza para código Postfix optimizado a função acima.
# Identifique os blocos básicos.