NonBlankStringModule

PackageReified.Refinements
Operations over text known to carry non-whitespace content.

Summary

NameSignatureSynopsis
refinementrefinement No description available.
valuevalue inputReturns the underlying string value.
createcreate valueAdmits text that is not null, empty, or whitespace.
mapmap mapping inputApplies a mapping and re-admits the result, which may no longer be inhabited.
appendappend left rightConcatenates two inhabited strings.
joinjoin separator valuesConcatenates with a separator.
trimtrim inputTrims surrounding whitespace.
toUppertoUpper inputConverts to upper case.
toLowertoLower inputConverts to lower case.
lengthlength inputReturns the length as a plain int, matching String.length.
splitsplit separator inputSplits on a separator, discarding blank segments.

refinement

refinement
Member

Returns

Refinement<string, NonBlankString>

value

value input
Member
Returns the underlying string value.

Parameters

NameTypeDescription
inputNonBlankString

Returns

string

create

create value
Member
Admits text that is not null, empty, or whitespace.

Parameters

NameTypeDescription
valuestring

Returns

Result<NonBlankString, Violation>

map

map mapping input
Member
Applies a mapping and re-admits the result, which may no longer be inhabited.

Parameters

NameTypeDescription
mappingstring -> string
inputNonBlankString

Returns

Result<NonBlankString, Violation>

append

append left right
Member
Concatenates two inhabited strings. Total — the result is still inhabited.

Parameters

NameTypeDescription
leftNonBlankString
rightNonBlankString

Returns

NonBlankString

join

join separator values
Member
Concatenates with a separator. Total.

Parameters

NameTypeDescription
separatorstring
valuesNonEmptyList<NonBlankString>

Returns

NonBlankString

trim

trim input
Member
Trims surrounding whitespace. Total — trimming inhabited text leaves it inhabited.

Parameters

NameTypeDescription
inputNonBlankString

Returns

NonBlankString

toUpper

toUpper input
Member
Converts to upper case. Total.

Parameters

NameTypeDescription
inputNonBlankString

Returns

NonBlankString

toLower

toLower input
Member
Converts to lower case. Total.

Parameters

NameTypeDescription
inputNonBlankString

Returns

NonBlankString

length

length input
Member
Returns the length as a plain int, matching String.length.

Parameters

NameTypeDescription
inputNonBlankString

Returns

int

split

split separator input
Member
Splits on a separator, discarding blank segments. Returns a non-empty list because inhabited text always yields at least one inhabited segment.

Parameters

NameTypeDescription
separatorstring
inputNonBlankString

Returns

NonEmptyList<NonBlankString>