Calculadora de postes de cerca

Espaçamento zero ou negativo é rejeitado com um erro invalid_input claro em vez de inventar postes infinitos, e comprimento não positivo é rejeitado da mesma forma. O caminho é matemática pura e determinística—sem rede, sem sementes aleatórias, sem dependência de relógio—de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo toda vez que você chama.

Como postes e ripas são contados a partir do comprimento e do espaçamento

Ripas equivalem a seções vezes rails_per_section, onde rails_per_section é quantos elementos horizontais ficam entre cada par consecutivo de postes—dois é comum em trechos estilo rancho e três em muitos de privacidade ou de ripas; o padrão é dois quando você omite o campo. O espaçamento deve ser estritamente positivo: espaçamento zero implicaria infinitos postes, e espaçamento negativo não tem sentido físico numa linha, então ambos os casos retornam invalid_input. Em caso de sucesso a ferramenta ecoa length e spacing arredondados, publica sections, posts, rails, rails_per_section, formula, message e steps para você auditar a aritmética à mão ou em testes automatizados.

Como chamar a API e o que retorna

Prefira enviar números em vez de strings pré-formatadas quando controlar o cliente; quando precisar enviar strings, evite sufixos de unidade ou separadores de milhar que fariam falhar o padrão de número finito. Envie um corpo JSON com dois campos obrigatórios: length (aliases fence_length, L, len, run, run_length) e spacing (aliases post_spacing, space, gap, S, interval). Opcionalmente envie rails_per_section (aliases rails_per_bay, rails_between, rail_count, n_rails); quando omitido, o padrão é dois. Length e spacing devem ser números finitos positivos dentro da faixa absoluta publicada para que a razão e as contagens permaneçam finitas em precisão dupla IEEE no Worker e no navegador. rails_per_section, quando fornecido, deve ser um inteiro positivo até o máximo publicado; formas em string de números inteiros são aceitas quando batem com um padrão numérico finito estrito, mas contagens fracionárias de ripas são rejeitadas. Em caso de sucesso a resposta define sections como a contagem de vãos, posts como sections mais um, rails como sections vezes rails_per_section, formula como as expressões de postes e ripas, message como um resumo curto em inglês e steps como um log ordenado de substituição. Validação falha—campos ausentes, números não finitos, espaçamento zero ou negativo, comprimento não positivo, rails_per_section inválido ou valores fora dos limites absolutos—retorna invalid_input e nunca é cobrada. O preço é um valor fixo de US$ 0,002 por solicitação bem-sucedida com item unitário e preço marginal unitário zero.

Dicas práticas, limites e buscas relacionadas

Ao ensinar ou escrever testes, emparelhe um múltiplo exato (comprimento cem, espaçamento dez → onze postes) com um caso não exato que exercite o teto, e inclua um espaçamento zero ou negativo deliberado para provar o caminho invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando você envia deliberadamente espaçamento zero para verificar o tratamento de erros. Checagens de ida e volta são fáceis: recompute à mão o teto de comprimento sobre espaçamento, some um para postes, multiplique sections por rails_per_section para ripas e confirme que os inteiros publicados batem.