Refactor documentation for Importance methods

Updated the documentation for NumString, XPrioString, and String methods in the Importance type to provide clearer descriptions of their behavior and return values. Enhanced comments for better readability and maintainability of the code.
This commit is contained in:
Winni Neessen 2024-10-06 16:19:53 +02:00
parent ac7fa5771a
commit 3333c784a6
Signed by: wneessen
GPG key ID: 385AC9889632126E

View file

@ -136,8 +136,14 @@ const (
ImportanceUrgent ImportanceUrgent
) )
// NumString returns a numerical string representation of the Importance, mapping ImportanceHigh and // NumString returns a numerical string representation of the Importance level.
// ImportanceUrgent to "1" and others to "0". //
// This method maps ImportanceHigh and ImportanceUrgent to "1", while ImportanceNonUrgent and ImportanceLow
// are mapped to "0". Other values return an empty string.
//
// Returns:
// - A string representing the numerical value of the Importance level ("1" or "0"), or an empty string
// if the Importance level is unrecognized.
func (i Importance) NumString() string { func (i Importance) NumString() string {
switch i { switch i {
case ImportanceNonUrgent: case ImportanceNonUrgent:
@ -153,8 +159,14 @@ func (i Importance) NumString() string {
} }
} }
// XPrioString returns the X-Priority string representation of the Importance, mapping ImportanceHigh and // XPrioString returns the X-Priority string representation of the Importance level.
// ImportanceUrgent to "1" and others to "5". //
// This method maps ImportanceHigh and ImportanceUrgent to "1", while ImportanceNonUrgent and ImportanceLow
// are mapped to "5". Other values return an empty string.
//
// Returns:
// - A string representing the X-Priority value of the Importance level ("1" or "5"), or an empty string
// if the Importance level is unrecognized.
func (i Importance) XPrioString() string { func (i Importance) XPrioString() string {
switch i { switch i {
case ImportanceNonUrgent: case ImportanceNonUrgent:
@ -170,8 +182,14 @@ func (i Importance) XPrioString() string {
} }
} }
// String satisfies the fmt.Stringer interface for the Importance type and returns the string representation of the // String satisfies the fmt.Stringer interface for the Importance type and returns the string
// Importance level. // representation of the Importance level.
//
// This method provides a human-readable string for each Importance level.
//
// Returns:
// - A string representing the Importance level ("non-urgent", "low", "high", or "urgent"), or an empty
// string if the Importance level is unrecognized.
func (i Importance) String() string { func (i Importance) String() string {
switch i { switch i {
case ImportanceNonUrgent: case ImportanceNonUrgent:
@ -187,13 +205,20 @@ func (i Importance) String() string {
} }
} }
// String satisfies the fmt.Stringer interface for the Header type and returns the string representation of the Header. // String satisfies the fmt.Stringer interface for the Header type and returns the string
// representation of the Header.
//
// Returns:
// - A string representing the Header.
func (h Header) String() string { func (h Header) String() string {
return string(h) return string(h)
} }
// String satisfies the fmt.Stringer interface for the AddrHeader type and returns the string representation of the // String satisfies the fmt.Stringer interface for the AddrHeader type and returns the string
// AddrHeader. // representation of the AddrHeader.
//
// Returns:
// - A string representing the AddrHeader.
func (a AddrHeader) String() string { func (a AddrHeader) String() string {
return string(a) return string(a)
} }