Copyright | (c) The University of Glasgow 2001 |
---|---|
License | BSD-style (see the file libraries/base/LICENSE) |
Maintainer | libraries@haskell.org |
Stability | provisional |
Portability | portable |
Safe Haskell | Safe |
Language | Haskell2010 |
Converting values to readable strings:
the Show
class and associated functions.
Documentation
Conversion of values to readable String
s.
Derived instances of Show
have the following properties, which
are compatible with derived instances of Read
:
- The result of
show
is a syntactically correct Haskell expression containing only constants, given the fixity declarations in force at the point where the type is declared. It contains only the constructor names defined in the data type, parentheses, and spaces. When labelled constructor fields are used, braces, commas, field names, and equal signs are also used. - If the constructor is defined to be an infix operator, then
showsPrec
will produce infix applications of the constructor. - the representation will be enclosed in parentheses if the
precedence of the top-level constructor in
x
is less thand
(associativity is ignored). Thus, ifd
is0
then the result is never surrounded in parentheses; ifd
is11
it is always surrounded in parentheses, unless it is an atomic expression. - If the constructor is defined using record syntax, then
show
will produce the record-syntax form, with the fields given in the same order as the original declaration.
For example, given the declarations
infixr 5 :^: data Tree a = Leaf a | Tree a :^: Tree a
the derived instance of Show
is equivalent to
instance (Show a) => Show (Tree a) where showsPrec d (Leaf m) = showParen (d > app_prec) $ showString "Leaf " . showsPrec (app_prec+1) m where app_prec = 10 showsPrec d (u :^: v) = showParen (d > up_prec) $ showsPrec (up_prec+1) u . showString " :^: " . showsPrec (up_prec+1) v where up_prec = 5
Note that right-associativity of :^:
is ignored. For example,
produces the stringshow
(Leaf 1 :^: Leaf 2 :^: Leaf 3)"Leaf 1 :^: (Leaf 2 :^: Leaf 3)"
.
:: Int | the operator precedence of the enclosing
context (a number from |
-> a | the value to be converted to a |
-> ShowS |
Convert a value to a readable String
.
showsPrec
should satisfy the law
showsPrec d x r ++ s == showsPrec d x (r ++ s)
Derived instances of Read
and Show
satisfy the following:
That is, readsPrec
parses the string produced by
showsPrec
, and delivers the value that showsPrec
started with.
Instances
Show ByteArray Source # | Since: base-4.17.0.0 |
Show Timeout Source # | Since: base-4.0 |
Show Void | Since: base-4.8.0.0 |
Show ByteOrder | Since: base-4.11.0.0 |
Show ClosureType | |
Defined in GHC.Internal.ClosureTypes | |
Show BlockReason | Since: base-4.3.0.0 |
Defined in GHC.Internal.Conc.Sync | |
Show ThreadId | Since: base-4.2.0.0 |
Show ThreadStatus | Since: base-4.3.0.0 |
Defined in GHC.Internal.Conc.Sync | |
Show NestedAtomically | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show NoMatchingContinuationPrompt | Since: base-4.18 |
Defined in GHC.Internal.Control.Exception.Base | |
Show NoMethodError | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show NonTermination | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show PatternMatchFail | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show RecConError | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show RecSelError | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show RecUpdError | Since: base-4.0 |
Defined in GHC.Internal.Control.Exception.Base | |
Show TypeError | Since: base-4.9.0.0 |
Show Constr | Since: base-4.0.0.0 |
Show ConstrRep | Since: base-4.0.0.0 |
Show DataRep | Since: base-4.0.0.0 |
Show DataType | Since: base-4.0.0.0 |
Show Fixity | Since: base-4.0.0.0 |
Show Dynamic | Since: base-2.1 |
Show All | Since: base-2.1 |
Show Any | Since: base-2.1 |
Show SomeTypeRep | Since: base-4.10.0.0 |
Defined in GHC.Internal.Data.Typeable.Internal | |
Show Version | Since: base-2.1 |
Show ControlMessage | Since: base-4.4.0.0 |
Show Event | Since: base-4.4.0.0 |
Show EventLifetime | Since: base-4.8.0.0 |
Show Lifetime | Since: base-4.8.1.0 |
Show Timeout | Since: base-4.4.0.0 |
Show FdKey | Since: base-4.4.0.0 |
Show State | Since: base-4.4.0.0 |
Show State | Since: base-4.7.0.0 |
Show Unique | Since: base-4.3.1.0 |
Show ErrorCall | Since: base-4.0.0.0 |
Show ArithException | Since: base-4.0.0.0 |
Defined in GHC.Internal.Exception.Type | |
Show SomeException | Since: ghc-internal-3.0 |
Defined in GHC.Internal.Exception.Type | |
Show Fingerprint | Since: base-4.7.0.0 |
Defined in GHC.Internal.Fingerprint.Type | |
Show CBool | |
Show CChar | |
Show CClock | |
Show CDouble | |
Show CFloat | |
Show CInt | |
Show CIntMax | |
Show CIntPtr | |
Show CLLong | |
Show CLong | |
Show CPtrdiff | |
Show CSChar | |
Show CSUSeconds | |
Defined in GHC.Internal.Foreign.C.Types | |
Show CShort | |
Show CSigAtomic | |
Defined in GHC.Internal.Foreign.C.Types | |
Show CSize | |
Show CTime | |
Show CUChar | |
Show CUInt | |
Show CUIntMax | |
Show CUIntPtr | |
Show CULLong | |
Show CULong | |
Show CUSeconds | |
Show CUShort | |
Show CWchar | |
Show IntPtr | |
Show WordPtr | |
Show Associativity | Since: base-4.6.0.0 |
Defined in GHC.Internal.Generics | |
Show DecidedStrictness | Since: base-4.9.0.0 |
Defined in GHC.Internal.Generics | |
Show Fixity | Since: base-4.6.0.0 |
Show SourceStrictness | Since: base-4.9.0.0 |
Defined in GHC.Internal.Generics | |
Show SourceUnpackedness | Since: base-4.9.0.0 |
Defined in GHC.Internal.Generics | |
Show MaskingState | Since: base-4.3.0.0 |
Defined in GHC.Internal.IO | |
Show SeekMode | Since: base-4.2.0.0 |
Show CodingFailureMode | Since: base-4.4.0.0 |
Defined in GHC.Internal.IO.Encoding.Failure | |
Show CodingProgress | Since: base-4.4.0.0 |
Defined in GHC.Internal.IO.Encoding.Types | |
Show TextEncoding | Since: base-4.3.0.0 |
Defined in GHC.Internal.IO.Encoding.Types | |
Show AllocationLimitExceeded | Since: base-4.7.1.0 |
Defined in GHC.Internal.IO.Exception | |
Show ArrayException | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show AssertionFailed | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show AsyncException | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show BlockedIndefinitelyOnMVar | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show BlockedIndefinitelyOnSTM | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show CompactionFailed | Since: base-4.10.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show Deadlock | Since: base-4.1.0.0 |
Show ExitCode | |
Show FixIOException | Since: base-4.11.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show IOErrorType | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show IOException | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show SomeAsyncException | Since: base-4.7.0.0 |
Defined in GHC.Internal.IO.Exception | |
Show FD | Since: base-4.1.0.0 |
Show HandlePosn | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Handle | |
Show FileLockingNotSupported | Since: base-4.10.0.0 |
Defined in GHC.Internal.IO.Handle.Lock.Common | |
Show BufferMode | Since: base-4.2.0.0 |
Defined in GHC.Internal.IO.Handle.Types | |
Show Handle | Since: base-4.1.0.0 |
Show HandleType | Since: base-4.1.0.0 |
Defined in GHC.Internal.IO.Handle.Types | |
Show Newline | Since: base-4.3.0.0 |
Show NewlineMode | Since: base-4.3.0.0 |
Defined in GHC.Internal.IO.Handle.Types | |
Show IOMode | Since: base-4.2.0.0 |
Show IOPortException | |
Show InfoProv | |
Show Int16 | Since: base-2.1 |
Show Int32 | Since: base-2.1 |
Show Int64 | Since: base-2.1 |
Show Int8 | Since: base-2.1 |
Show CCFlags | Since: base-4.8.0.0 |
Show ConcFlags | Since: base-4.8.0.0 |
Show DebugFlags | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show DoCostCentres | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show DoHeapProfile | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show DoTrace | Since: base-4.8.0.0 |
Show GCFlags | Since: base-4.8.0.0 |
Show GiveGCStats | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show HpcFlags | Since: base-4.20.0.0 |
Show IoSubSystem | |
Defined in GHC.Internal.RTS.Flags | |
Show MiscFlags | Since: base-4.8.0.0 |
Show ParFlags | Since: base-4.8.0.0 |
Show ProfFlags | Since: base-4.8.0.0 |
Show RTSFlags | Since: base-4.8.0.0 |
Show TickyFlags | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show TraceFlags | Since: base-4.8.0.0 |
Defined in GHC.Internal.RTS.Flags | |
Show FractionalExponentBase | |
Defined in GHC.Internal.Real | |
Show StackEntry | |
Defined in GHC.Internal.Stack.CloneStack | |
Show CallStack | Since: base-4.9.0.0 |
Show SrcLoc | Since: base-4.9.0.0 |
Show StaticPtrInfo | Since: base-4.8.0.0 |
Defined in GHC.Internal.StaticPtr | |
Show GCDetails | Since: base-4.10.0.0 |
Show RTSStats | Since: base-4.10.0.0 |
Show CBlkCnt | |
Show CBlkSize | |
Show CCc | |
Show CClockId | |
Show CDev | |
Show CFsBlkCnt | |
Show CFsFilCnt | |
Show CGid | |
Show CId | |
Show CIno | |
Show CKey | |
Show CMode | |
Show CNfds | |
Show CNlink | |
Show COff | |
Show CPid | |
Show CRLim | |
Show CSocklen | |
Show CSpeed | |
Show CSsize | |
Show CTcflag | |
Show CTimer | |
Show CUid | |
Show Fd | |
Show Lexeme | Since: base-2.1 |
Show Number | Since: base-4.6.0.0 |
Show SomeChar | |
Show SomeSymbol | Since: base-4.7.0.0 |
Defined in GHC.Internal.TypeLits | |
Show SomeNat | Since: base-4.7.0.0 |
Show GeneralCategory | Since: base-2.1 |
Defined in GHC.Internal.Unicode | |
Show Word16 | Since: base-2.1 |
Show Word32 | Since: base-2.1 |
Show Word64 | Since: base-2.1 |
Show Word8 | Since: base-2.1 |
Show KindRep | |
Show Module | Since: base-4.9.0.0 |
Show Ordering | Since: base-2.1 |
Show TrName | Since: base-4.9.0.0 |
Show TyCon | Since: base-2.1 |
Show TypeLitSort | Since: base-4.11.0.0 |
Defined in GHC.Internal.Show | |
Show Integer | Since: base-2.1 |
Show Natural | Since: base-4.8.0.0 |
Show () | Since: base-2.1 |
Show Bool | Since: base-2.1 |
Show Char | Since: base-2.1 |
Show Int | Since: base-2.1 |
Show Levity | Since: base-4.15.0.0 |
Show RuntimeRep | Since: base-4.11.0.0 |
Defined in GHC.Internal.Show | |
Show VecCount | Since: base-4.11.0.0 |
Show VecElem | Since: base-4.11.0.0 |
Show Word | Since: base-2.1 |
Show a => Show (Complex a) Source # | Since: base-2.1 |
Show a => Show (First a) Source # | Since: base-4.9.0.0 |
Show a => Show (Last a) Source # | Since: base-4.9.0.0 |
Show a => Show (Max a) Source # | Since: base-4.9.0.0 |
Show a => Show (Min a) Source # | Since: base-4.9.0.0 |
Show m => Show (WrappedMonoid m) Source # | Since: base-4.9.0.0 |
Defined in Data.Semigroup | |
Show a => Show (NonEmpty a) | Since: base-4.11.0.0 |
Show a => Show (And a) | Since: base-4.16 |
Show a => Show (Iff a) | Since: base-4.16 |
Show a => Show (Ior a) | Since: base-4.16 |
Show a => Show (Xor a) | Since: base-4.16 |
Show a => Show (Identity a) | This instance would be equivalent to the derived instances of the
Since: base-4.8.0.0 |
Show a => Show (First a) | Since: base-2.1 |
Show a => Show (Last a) | Since: base-2.1 |
Show a => Show (Down a) | This instance would be equivalent to the derived instances of the
Since: base-4.7.0.0 |
Show a => Show (Dual a) | Since: base-2.1 |
Show a => Show (Product a) | Since: base-2.1 |
Show a => Show (Sum a) | Since: base-2.1 |
Show a => Show (ExceptionWithContext a) | |
Defined in GHC.Internal.Exception.Type | |
Show e => Show (NoBacktrace e) | |
Defined in GHC.Internal.Exception.Type | |
Show (ConstPtr a) | |
Show (ForeignPtr a) | Since: base-2.1 |
Defined in GHC.Internal.ForeignPtr | |
Show a => Show (ZipList a) | Since: base-4.7.0.0 |
Show p => Show (Par1 p) | Since: base-4.7.0.0 |
Show (FunPtr a) | Since: base-2.1 |
Show (Ptr a) | Since: base-2.1 |
Show a => Show (Ratio a) | Since: base-2.0.1 |
Show (SChar c) | Since: base-4.18.0.0 |
Show (SSymbol s) | Since: base-4.18.0.0 |
Show (SNat n) | Since: base-4.18.0.0 |
Show a => Show (Maybe a) | Since: base-2.1 |
Show a => Show (Solo a) | Since: base-4.15 |
Show a => Show [a] | Since: base-2.1 |
HasResolution a => Show (Fixed a) Source # | Since: base-2.1 |
(Show a, Show b) => Show (Arg a b) Source # | Since: base-4.9.0.0 |
(Ix a, Show a, Show b) => Show (Array a b) | Since: base-2.1 |
(Show a, Show b) => Show (Either a b) | Since: base-3.0 |
Show (Proxy s) | Since: base-4.7.0.0 |
Show (TypeRep a) | |
Show (U1 p) | Since: base-4.9.0.0 |
Show (V1 p) | Since: base-4.9.0.0 |
Show (ST s a) | Since: base-2.1 |
(Show a, Show b) => Show (a, b) | Since: base-2.1 |
Show (a -> b) Source # | Since: base-2.1 |
Show a => Show (Const a b) | This instance would be equivalent to the derived instances of the
Since: base-4.8.0.0 |
Show (f a) => Show (Ap f a) | Since: base-4.12.0.0 |
Show (f a) => Show (Alt f a) | Since: base-4.8.0.0 |
Show (Coercion a b) | Since: base-4.7.0.0 |
Show (a :~: b) | Since: base-4.7.0.0 |
Show (OrderingI a b) | |
Show (f p) => Show (Rec1 f p) | Since: base-4.7.0.0 |
Show (URec Char p) | Since: base-4.9.0.0 |
Show (URec Double p) | Since: base-4.9.0.0 |
Show (URec Float p) | |
Show (URec Int p) | Since: base-4.9.0.0 |
Show (URec Word p) | Since: base-4.9.0.0 |
(Show a, Show b, Show c) => Show (a, b, c) | Since: base-2.1 |
(Show (f a), Show (g a)) => Show (Product f g a) Source # | Since: base-4.18.0.0 |
(Show (f a), Show (g a)) => Show (Sum f g a) Source # | Since: base-4.18.0.0 |
Show (a :~~: b) | Since: base-4.10.0.0 |
(Show (f p), Show (g p)) => Show ((f :*: g) p) | Since: base-4.7.0.0 |
(Show (f p), Show (g p)) => Show ((f :+: g) p) | Since: base-4.7.0.0 |
Show c => Show (K1 i c p) | Since: base-4.7.0.0 |
(Show a, Show b, Show c, Show d) => Show (a, b, c, d) | Since: base-2.1 |
Show (f (g a)) => Show (Compose f g a) Source # | Since: base-4.18.0.0 |
Show (f (g p)) => Show ((f :.: g) p) | Since: base-4.7.0.0 |
Show (f p) => Show (M1 i c f p) | Since: base-4.7.0.0 |
(Show a, Show b, Show c, Show d, Show e) => Show (a, b, c, d, e) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f) => Show (a, b, c, d, e, f) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g) => Show (a, b, c, d, e, f, g) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h) => Show (a, b, c, d, e, f, g, h) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i) => Show (a, b, c, d, e, f, g, h, i) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j) => Show (a, b, c, d, e, f, g, h, i, j) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j, Show k) => Show (a, b, c, d, e, f, g, h, i, j, k) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j, Show k, Show l) => Show (a, b, c, d, e, f, g, h, i, j, k, l) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j, Show k, Show l, Show m) => Show (a, b, c, d, e, f, g, h, i, j, k, l, m) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j, Show k, Show l, Show m, Show n) => Show (a, b, c, d, e, f, g, h, i, j, k, l, m, n) | Since: base-2.1 |
(Show a, Show b, Show c, Show d, Show e, Show f, Show g, Show h, Show i, Show j, Show k, Show l, Show m, Show n, Show o) => Show (a, b, c, d, e, f, g, h, i, j, k, l, m, n, o) | Since: base-2.1 |
showChar :: Char -> ShowS Source #
utility function converting a Char
to a show function that
simply prepends the character unchanged.
showString :: String -> ShowS Source #
utility function converting a String
to a show function that
simply prepends the string unchanged.
showListWith :: (a -> ShowS) -> [a] -> ShowS Source #
Show a list (using square brackets and commas), given a function for showing elements.