Definisce e sovrascrive gli intervalli aperti e chiusi

1

Ho considerato la seguente situazione come parte della documentazione e dell'interfaccia ( A ) e un'implementazione ( B ) di tale interfaccia.

L'interfaccia A contiene metodi che coinvolgono i seguenti due argomenti:

  1. Una percentuale , passata come numero intero.
  2. Un nome , passato come una stringa.

I valori validi per la percentuale sono l'intervallo chiuso [0, 100]. Indipendentemente dal modo in cui si implementa l'interfaccia, è un errore consentire un valore al di fuori di questo intervallo come input.

Il nome , come definito nell'interfaccia, consente qualsiasi stringa contenente [1, 100] caratteri. Voglio documentare l'interfaccia in modo tale che né richieda non consenta un'implementazione per supportare un nome con più di 100 caratteri.

Chiaramente, l'intervallo valido per la percentuale è un intervallo chiuso e inclusivo. Come ti riferiresti a un intervallo come quello sopra definito per il numero di caratteri in nome ? Non posso riferire all'intervallo come a destra, perché l'implementazione potrebbe non supporta i valori con più di 100 caratteri.

    
posta Sam Harwell 13.09.2013 - 22:58
fonte

1 risposta

1

Non credo che ci sia un nome specifico per questo, probabilmente dovrai scriverlo, per esempio:

The minimum length of name must be 1. There is no strict maximum length, but any implementation must support a maximum length of at least 100.

Questo è più conciso, anche se un po 'meno chiaro:

Any implementation must support a minimum length of name of 1 and a maximum of at least 100.

Puoi anche scrivere:

Any implementation must support the length of name in the range [1,x], with x >= 100 (x is chosen by the implementation).

Che è simile al tuo commento in domanda su CS che è stata persa nella fusione.

Potrebbe anche essere una buona idea aggiungerlo a qualsiasi / a tutti i precedenti:

... and throw a YouNeedToRenameThis exception when outside this range.

    
risposta data 22.09.2013 - 00:02
fonte

Leggi altre domande sui tag