Recapitulação: Caixa Secreta

Parte da seção Object Oriented Programming do Journey de C da Coddy — lição 21 de 61.

Desafio

Fácil

Vamos construir um módulo Box que demonstra encapsulamento completo. Sua caixa terá três dimensões ocultas — largura, altura e profundidade — que só podem ser acessadas por meio das funções que você fornecer. Este é o padrão de ponteiro opaco (opaque pointer pattern) completo em ação!

Você criará três arquivos:

box.h: Sua interface pública. Declare um tipo Box opaco usando apenas uma declaração antecipada (forward declaration) — o corpo da struct permanece oculto. Declare estas funções:
- create_box — recebe três inteiros (largura, altura, profundidade) e retorna um ponteiro para Box
- destroy_box — libera a memória alocada
- get_volume — recebe um const Box * e retorna o volume (largura × altura × profundidade)
- set_dimensions — recebe um ponteiro para Box e três novos valores de dimensão, retorna int (1 para sucesso, 0 se qualquer dimensão for negativa ou zero)
Use guards de inclusão com o símbolo BOX_H.
box.c: Defina a struct Box real com três membros ocultos: int width, int height e int depth. Implemente todas as quatro funções. Seu construtor deve alocar e inicializar a caixa. A função set_dimensions deve validar se todos os três valores são positivos (maiores que zero) antes de aplicar as alterações — se qualquer valor falhar na validação, rejeite toda a atualização e retorne 0.
main.c: Demonstre sua Box encapsulada criando uma, verificando seu volume, tentando alterações de dimensão (tanto válidas quanto inválidas) e limpando tudo adequadamente.

Você receberá cinco entradas: a largura inicial, altura inicial, profundidade inicial, seguidas por três novas dimensões para tentar definir (que podem incluir valores inválidos).

No seu arquivo principal, crie uma Box com as dimensões iniciais e imprima seu volume. Em seguida, tente definir as novas dimensões — imprima se a atualização foi bem-sucedida e o volume resultante. Por fim, libere a caixa e confirme a limpeza.

Imprima a saída neste formato:

Volume: {volume}
Set: {0 or 1}
Volume: {volume}
Destroyed

Por exemplo, com as entradas 2, 3, 4, 5, 5, 5, a saída seria:

Volume: 24
Set: 1
Volume: 125
Destroyed

Com as entradas 2, 3, 4, -1, 5, 5, a saída seria:

Volume: 24
Set: 0
Volume: 24
Destroyed

Observe como a validação em set_dimensions protege sua caixa de estados inválidos — o código externo não pode ignorar suas regras porque as dimensões estão completamente ocultas atrás de sua interface.

Experimente você mesmo

#include <stdio.h>
#include "box.h"

int main() {
    // Ler dimensões iniciais
    int width, height, depth;
    scanf("%d", &width);
    scanf("%d", &height);
    scanf("%d", &depth);
    
    // Ler novas dimensões para tentar definir
    int new_w, new_h, new_d;
    scanf("%d", &new_w);
    scanf("%d", &new_h);
    scanf("%d", &new_d);
    
    // TODO: Criar um Box com as dimensões iniciais
    
    
    // TODO: Imprimir o volume inicial no formato: "Volume: {volume}"
    
    
    // TODO: Tentar definir as novas dimensões e armazenar o resultado
    
    
    // TODO: Imprimir se a definição foi bem-sucedida no formato: "Set: {0 or 1}"
    
    
    // TODO: Imprimir o volume resultante no formato: "Volume: {volume}"
    
    
    // TODO: Destruir o box e imprimir "Destroyed"
    
    
    return 0;
}