flexmark-all 0.64.8 · com.vladsch.flexmark.util.sequence.Escaping

Modifier and Type	Class and Description
pack-priv static interface	Escaping.Replacer

Modifier and Type	Field and Description
public static final @NotNull CharPredicate	AMP_BACKSLASH_SET
private static final Pattern	AMP_ONLY
private static final Pattern	BACKSLASH_ONLY
private static final Pattern	BACKSLASH_OR_AMP
private static final Pattern	COLLAPSE_WHITESPACE
private static final Escaping.Replacer	COLLAPSE_WHITESPACE_REPLACER
private static final String	ENTITY
private static final Pattern	ENTITY_ONLY
private static final Pattern	ENTITY_OR_ESCAPED_CHAR
private static final Escaping.Replacer	ENTITY_REPLACER
public static final String	ESCAPABLE
public static final String	ESCAPABLE_CHARS
private static final Pattern	ESCAPE_IN_URI
private static final Pattern	ESCAPE_URI_DECODE
private static final Pattern	ESCAPED_CHAR
pack-priv static final char[]	HEX_DIGITS
private static Random	random
private static final Escaping.Replacer	REMOVE_REPLACER
private static final Escaping.Replacer	UNESCAPE_REPLACER
private static final Escaping.Replacer	UNSAFE_CHAR_REPLACER
private static final Escaping.Replacer	URL_DECODE_REPLACER
private static final Escaping.Replacer	URL_ENCODE_REPLACER
private static final Pattern	WHITESPACE
private static final String	XML_SPECIAL
private static final Pattern	XML_SPECIAL_OR_ENTITY
private static final Pattern	XML_SPECIAL_RE

Access	Constructor and Description
public	Escaping()

Method Summary

Modifier and Type	Method and Description
public static @NotNull String	Returns: processed sequence collapseWhitespace(@NotNull CharSequence sequence to process s, boolean true if the sequence should also be trimmed trim) Collapse regions of multiple white spaces to a single space
public static @NotNull BasedSequence	collapseWhitespace(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper)
private static @Nullable String	encode(char c)
public static String	escapeHtml(@NotNull CharSequence s, boolean preserveEntities)
public static @NotNull BasedSequence	escapeHtml(@NotNull BasedSequence s, boolean preserveEntities, @NotNull ReplacedTextMapper textMapper)
public static @NotNull String	Returns: converted sequence normalizeEndWithEOL(@NotNull CharSequence sequence to convert s) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL
public static @NotNull BasedSequence	Returns: converted sequence normalizeEndWithEOL(@NotNull BasedSequence sequence to convert s, @NotNull ReplacedTextMapper text mapper to update for the replaced text textMapper) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL
public static @NotNull String	Returns: converted sequence normalizeEOL(@NotNull CharSequence sequence to convert s) Normalize eol: embedded \r and \r\n are converted to \n
public static @NotNull String	Returns: converted sequence normalizeEOL(@NotNull CharSequence sequence to convert s, boolean true if an EOL is to be appended to the end of the sequence if not already ending with one. endWithEOL) Normalize eol: embedded \r and \r\n are converted to \n
public static @NotNull BasedSequence	Returns: converted sequence normalizeEOL(@NotNull BasedSequence sequence to convert s, @NotNull ReplacedTextMapper text mapper to update for the replaced text textMapper) Normalize eol: embedded \r and \r\n are converted to \n
public static @NotNull BasedSequence	Returns: converted sequence normalizeEOL(@NotNull BasedSequence sequence to convert s, @NotNull ReplacedTextMapper text mapper to update for the replaced text textMapper, boolean whether an EOL is to be appended to the end of the sequence if it does not already end with one. endWithEOL) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL
public static @NotNull String	Returns: normalized link reference id normalizeReference(@NotNull CharSequence sequence containing the link reference id s, boolean if true then reference will be converted to lowercase changeCase) Normalize the link reference id
public static @NotNull String	Returns: normalized link reference id normalizeReferenceChars(@NotNull CharSequence sequence containing the link reference id s, boolean if true then reference will be converted to lowercase changeCase) Get a normalized the link reference id from reference characters Will remove leading ![ or [ and trailing ], collapse multiple whitespaces to a space and optionally convert the id to lowercase.
public static @NotNull String	Returns: obfuscated e-mail url obfuscate(@NotNull String e-mail url email, boolean true to randomize, false for testing randomize) e-mail obfuscation from pegdown
public static @NotNull String	Returns: encoded string percentDecodeUrl(@NotNull CharSequence string to encode s)
public static @NotNull BasedSequence	Returns: encoded string percentDecodeUrl(@NotNull BasedSequence string to encode s, @NotNull ReplacedTextMapper text mapper to update for the replaced text textMapper)
public static @NotNull String	Returns: encoded string percentEncodeUrl(@NotNull CharSequence string to encode s)
public static @NotNull BasedSequence	Returns: encoded string percentEncodeUrl(@NotNull BasedSequence string to encode s, @NotNull ReplacedTextMapper text mapper to update for the replaced text textMapper)
public static @NotNull BasedSequence	Returns: un-escaped sequence removeAll(@NotNull BasedSequence sequence being changed s, @NotNull CharSequence string to remove remove, @NotNull ReplacedTextMapper replaced text mapper to update for the changed text textMapper) Replace entities and backslash escapes with literal characters.
private static @NotNull String	replaceAll(@NotNull Pattern p, @NotNull CharSequence s, @NotNull Escaping.Replacer replacer)
private static @NotNull BasedSequence	replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper)
private static @NotNull BasedSequence	replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, int startOffset, int endOffset, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper)
private static @NotNull BasedSequence	replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, @NotNull List<Range> ranges, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper)
public static @NotNull BasedSequence	Returns: un-escaped sequence unescape(@NotNull BasedSequence based sequence to un-escape s, @NotNull ReplacedTextMapper replaced text mapper to update for the changed text textMapper) Replace entities and backslash escapes with literal characters.
public static @NotNull String	Returns: un-escaped string unescapeHtml(@NotNull CharSequence string to un-escape s) Replace entities and backslash escapes with literal characters.
public static @NotNull BasedSequence	Returns: un-escaped sequence unescapeHtml(@NotNull BasedSequence based sequence to un-escape s, @NotNull ReplacedTextMapper replaced text mapper to update for the changed text textMapper) Replace entities and backslash escapes with literal characters.
public static @NotNull BasedSequence	Returns: un-escaped sequence unescapeHtml(@NotNull BasedSequence based sequence to un-escape s, @NotNull List<Range> ranges, @NotNull ReplacedTextMapper replaced text mapper to update for the changed text textMapper) Replace entities and backslash escapes with literal characters.
public static @NotNull String	Returns: un-escaped string unescapeString(@NotNull CharSequence string to un-escape s) Replace entities and backslash escapes with literal characters.
public static @NotNull String	Returns: un-escaped string unescapeString(@NotNull CharSequence string to un-escape s, boolean true if HTML entities are to be unescaped unescapeEntities) Replace entities and backslash escapes with literal characters.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

AMP_BACKSLASH_SET	back to summary
public static final @NotNull CharPredicate AMP_BACKSLASH_SET Annotations @NotNull

AMP_ONLY	back to summary
private static final Pattern AMP_ONLY

BACKSLASH_ONLY	back to summary
private static final Pattern BACKSLASH_ONLY

BACKSLASH_OR_AMP	back to summary
private static final Pattern BACKSLASH_OR_AMP

COLLAPSE_WHITESPACE	back to summary
private static final Pattern COLLAPSE_WHITESPACE

COLLAPSE_WHITESPACE_REPLACER	back to summary
private static final Escaping.Replacer COLLAPSE_WHITESPACE_REPLACER

ENTITY	back to summary
private static final String ENTITY

ENTITY_ONLY	back to summary
private static final Pattern ENTITY_ONLY

ENTITY_OR_ESCAPED_CHAR	back to summary
private static final Pattern ENTITY_OR_ESCAPED_CHAR

ENTITY_REPLACER	back to summary
private static final Escaping.Replacer ENTITY_REPLACER

ESCAPABLE	back to summary
public static final String ESCAPABLE

ESCAPABLE_CHARS	back to summary
public static final String ESCAPABLE_CHARS

ESCAPE_IN_URI	back to summary
private static final Pattern ESCAPE_IN_URI

ESCAPE_URI_DECODE	back to summary
private static final Pattern ESCAPE_URI_DECODE

ESCAPED_CHAR	back to summary
private static final Pattern ESCAPED_CHAR

HEX_DIGITS	back to summary
pack-priv static final char[] HEX_DIGITS

random	back to summary
private static Random random

REMOVE_REPLACER	back to summary
private static final Escaping.Replacer REMOVE_REPLACER

UNESCAPE_REPLACER	back to summary
private static final Escaping.Replacer UNESCAPE_REPLACER

UNSAFE_CHAR_REPLACER	back to summary
private static final Escaping.Replacer UNSAFE_CHAR_REPLACER

URL_DECODE_REPLACER	back to summary
private static final Escaping.Replacer URL_DECODE_REPLACER

URL_ENCODE_REPLACER	back to summary
private static final Escaping.Replacer URL_ENCODE_REPLACER

WHITESPACE	back to summary
private static final Pattern WHITESPACE

XML_SPECIAL	back to summary
private static final String XML_SPECIAL

XML_SPECIAL_OR_ENTITY	back to summary
private static final Pattern XML_SPECIAL_OR_ENTITY

XML_SPECIAL_RE	back to summary
private static final Pattern XML_SPECIAL_RE

Escaping	back to summary
public Escaping()

Method Detail

collapseWhitespace	back to summary
public static @NotNull String collapseWhitespace(@NotNull CharSequence s, boolean trim) Collapse regions of multiple white spaces to a single space Parameters s:@NotNull CharSequence sequence to process trim:boolean true if the sequence should also be trimmed Returns:@NotNull String processed sequence Annotations @NotNull

collapseWhitespace

back to summary

public static @NotNull String collapseWhitespace(@NotNull CharSequence s, boolean trim)

Collapse regions of multiple white spaces to a single space

Parameters

s:@NotNull CharSequence: sequence to process
trim:boolean: true if the sequence should also be trimmed

Returns:@NotNull String

processed sequence

Annotations

@NotNull

collapseWhitespace	back to summary
public static @NotNull BasedSequence collapseWhitespace(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper) Annotations @NotNull

encode	back to summary
private static @Nullable String encode(char c) Annotations @Nullable

escapeHtml	back to summary
public static String escapeHtml(@NotNull CharSequence s, boolean preserveEntities)

escapeHtml	back to summary
public static @NotNull BasedSequence escapeHtml(@NotNull BasedSequence s, boolean preserveEntities, @NotNull ReplacedTextMapper textMapper) Annotations @NotNull

normalizeEndWithEOL	back to summary
public static @NotNull String normalizeEndWithEOL(@NotNull CharSequence s) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL Parameters s:@NotNull CharSequence sequence to convert Returns:@NotNull String converted sequence Annotations @NotNull

normalizeEndWithEOL

back to summary

public static @NotNull String normalizeEndWithEOL(@NotNull CharSequence s)

Normalize eol: embedded \r and \r\n are converted to \n

Append EOL sequence if sequence does not already end in EOL

Parameters

s:@NotNull CharSequence: sequence to convert

Returns:@NotNull String

converted sequence

Annotations

@NotNull

normalizeEndWithEOL	back to summary
public static @NotNull BasedSequence normalizeEndWithEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL Parameters s:@NotNull BasedSequence sequence to convert textMapper:@NotNull ReplacedTextMapper text mapper to update for the replaced text Returns:@NotNull BasedSequence converted sequence Annotations @NotNull

normalizeEndWithEOL

back to summary

public static @NotNull BasedSequence normalizeEndWithEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper)

Normalize eol: embedded \r and \r\n are converted to \n

Append EOL sequence if sequence does not already end in EOL

Parameters

s:@NotNull BasedSequence: sequence to convert
textMapper:@NotNull ReplacedTextMapper: text mapper to update for the replaced text

Returns:@NotNull BasedSequence

converted sequence

Annotations

@NotNull

normalizeEOL	back to summary
public static @NotNull String normalizeEOL(@NotNull CharSequence s) Normalize eol: embedded \r and \r\n are converted to \n Parameters s:@NotNull CharSequence sequence to convert Returns:@NotNull String converted sequence Annotations @NotNull

normalizeEOL

back to summary

public static @NotNull String normalizeEOL(@NotNull CharSequence s)

Normalize eol: embedded \r and \r\n are converted to \n

Parameters

s:@NotNull CharSequence: sequence to convert

Returns:@NotNull String

converted sequence

Annotations

@NotNull

normalizeEOL	back to summary
public static @NotNull String normalizeEOL(@NotNull CharSequence s, boolean endWithEOL) Normalize eol: embedded \r and \r\n are converted to \n Parameters s:@NotNull CharSequence sequence to convert endWithEOL:boolean true if an EOL is to be appended to the end of the sequence if not already ending with one. Returns:@NotNull String converted sequence Annotations @NotNull

normalizeEOL

back to summary

public static @NotNull String normalizeEOL(@NotNull CharSequence s, boolean endWithEOL)

Normalize eol: embedded \r and \r\n are converted to \n

Parameters

s:@NotNull CharSequence: sequence to convert
endWithEOL:boolean: true if an EOL is to be appended to the end of the sequence if not already ending with one.

Returns:@NotNull String

converted sequence

Annotations

@NotNull

normalizeEOL	back to summary
public static @NotNull BasedSequence normalizeEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper) Normalize eol: embedded \r and \r\n are converted to \n Parameters s:@NotNull BasedSequence sequence to convert textMapper:@NotNull ReplacedTextMapper text mapper to update for the replaced text Returns:@NotNull BasedSequence converted sequence Annotations @NotNull

normalizeEOL

back to summary

public static @NotNull BasedSequence normalizeEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper)

Normalize eol: embedded \r and \r\n are converted to \n

Parameters

s:@NotNull BasedSequence: sequence to convert
textMapper:@NotNull ReplacedTextMapper: text mapper to update for the replaced text

Returns:@NotNull BasedSequence

converted sequence

Annotations

@NotNull

normalizeEOL	back to summary
public static @NotNull BasedSequence normalizeEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper, boolean endWithEOL) Normalize eol: embedded \r and \r\n are converted to \n Append EOL sequence if sequence does not already end in EOL Parameters s:@NotNull BasedSequence sequence to convert textMapper:@NotNull ReplacedTextMapper text mapper to update for the replaced text endWithEOL:boolean whether an EOL is to be appended to the end of the sequence if it does not already end with one. Returns:@NotNull BasedSequence converted sequence Annotations @NotNull

normalizeEOL

back to summary

public static @NotNull BasedSequence normalizeEOL(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper, boolean endWithEOL)

Normalize eol: embedded \r and \r\n are converted to \n

Append EOL sequence if sequence does not already end in EOL

Parameters

s:@NotNull BasedSequence: sequence to convert
textMapper:@NotNull ReplacedTextMapper: text mapper to update for the replaced text
endWithEOL:boolean: whether an EOL is to be appended to the end of the sequence if it does not already end with one.

Returns:@NotNull BasedSequence

converted sequence

Annotations

@NotNull

normalizeReference	back to summary
public static @NotNull String normalizeReference(@NotNull CharSequence s, boolean changeCase) Normalize the link reference id Parameters s:@NotNull CharSequence sequence containing the link reference id changeCase:boolean if true then reference will be converted to lowercase Returns:@NotNull String normalized link reference id Annotations @NotNull

normalizeReference

back to summary

public static @NotNull String normalizeReference(@NotNull CharSequence s, boolean changeCase)

Normalize the link reference id

Parameters

s:@NotNull CharSequence: sequence containing the link reference id
changeCase:boolean: if true then reference will be converted to lowercase

Returns:@NotNull String

normalized link reference id

Annotations

@NotNull

normalizeReferenceChars	back to summary
public static @NotNull String normalizeReferenceChars(@NotNull CharSequence s, boolean changeCase) Get a normalized the link reference id from reference characters Will remove leading ![ or [ and trailing ], collapse multiple whitespaces to a space and optionally convert the id to lowercase. Parameters s:@NotNull CharSequence sequence containing the link reference id changeCase:boolean if true then reference will be converted to lowercase Returns:@NotNull String normalized link reference id Annotations @NotNull

normalizeReferenceChars

back to summary

public static @NotNull String normalizeReferenceChars(@NotNull CharSequence s, boolean changeCase)

Get a normalized the link reference id from reference characters

Will remove leading ![ or [ and trailing ], collapse multiple whitespaces to a space and optionally convert the id to lowercase.

Parameters

s:@NotNull CharSequence: sequence containing the link reference id
changeCase:boolean: if true then reference will be converted to lowercase

Returns:@NotNull String

normalized link reference id

Annotations

@NotNull

obfuscate	back to summary
public static @NotNull String obfuscate(@NotNull String email, boolean randomize) e-mail obfuscation from pegdown Parameters email:@NotNull String e-mail url randomize:boolean true to randomize, false for testing Returns:@NotNull String obfuscated e-mail url Annotations @NotNull

obfuscate

back to summary

public static @NotNull String obfuscate(@NotNull String email, boolean randomize)

e-mail obfuscation from pegdown

Parameters

email:@NotNull String: e-mail url
randomize:boolean: true to randomize, false for testing

Returns:@NotNull String

obfuscated e-mail url

Annotations

@NotNull

percentDecodeUrl	back to summary
public static @NotNull String percentDecodeUrl(@NotNull CharSequence s) Parameters s:@NotNull CharSequence string to encode Returns:@NotNull String encoded string Annotations @NotNull

percentDecodeUrl	back to summary
public static @NotNull BasedSequence percentDecodeUrl(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper) Parameters s:@NotNull BasedSequence string to encode textMapper:@NotNull ReplacedTextMapper text mapper to update for the replaced text Returns:@NotNull BasedSequence encoded string Annotations @NotNull

percentEncodeUrl	back to summary
public static @NotNull String percentEncodeUrl(@NotNull CharSequence s) Parameters s:@NotNull CharSequence string to encode Returns:@NotNull String encoded string Annotations @NotNull

percentEncodeUrl	back to summary
public static @NotNull BasedSequence percentEncodeUrl(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper) Parameters s:@NotNull BasedSequence string to encode textMapper:@NotNull ReplacedTextMapper text mapper to update for the replaced text Returns:@NotNull BasedSequence encoded string Annotations @NotNull

removeAll	back to summary
public static @NotNull BasedSequence removeAll(@NotNull BasedSequence s, @NotNull CharSequence remove, @NotNull ReplacedTextMapper textMapper) Replace entities and backslash escapes with literal characters. Parameters s:@NotNull BasedSequence sequence being changed remove:@NotNull CharSequence string to remove textMapper:@NotNull ReplacedTextMapper replaced text mapper to update for the changed text Returns:@NotNull BasedSequence un-escaped sequence Annotations @NotNull

removeAll

back to summary

public static @NotNull BasedSequence removeAll(@NotNull BasedSequence s, @NotNull CharSequence remove, @NotNull ReplacedTextMapper textMapper)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull BasedSequence: sequence being changed
remove:@NotNull CharSequence: string to remove
textMapper:@NotNull ReplacedTextMapper: replaced text mapper to update for the changed text

Returns:@NotNull BasedSequence

un-escaped sequence

Annotations

@NotNull

replaceAll	back to summary
private static @NotNull String replaceAll(@NotNull Pattern p, @NotNull CharSequence s, @NotNull Escaping.Replacer replacer) Annotations @NotNull

replaceAll	back to summary
private static @NotNull BasedSequence replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper) Annotations @NotNull

replaceAll	back to summary
private static @NotNull BasedSequence replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, int startOffset, int endOffset, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper) Annotations @NotNull

replaceAll	back to summary
private static @NotNull BasedSequence replaceAll(@NotNull Pattern p, @NotNull BasedSequence s, @NotNull List<Range> ranges, @NotNull Escaping.Replacer replacer, @NotNull ReplacedTextMapper textMapper) Annotations @NotNull

unescape

back to summary

public static @NotNull BasedSequence unescape(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull BasedSequence: based sequence to un-escape
textMapper:@NotNull ReplacedTextMapper: replaced text mapper to update for the changed text

Returns:@NotNull BasedSequence

un-escaped sequence

Annotations

@NotNull

unescapeHtml

back to summary

public static @NotNull String unescapeHtml(@NotNull CharSequence s)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull CharSequence: string to un-escape

Returns:@NotNull String

un-escaped string

Annotations

@NotNull

unescapeHtml

back to summary

public static @NotNull BasedSequence unescapeHtml(@NotNull BasedSequence s, @NotNull ReplacedTextMapper textMapper)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull BasedSequence: based sequence to un-escape
textMapper:@NotNull ReplacedTextMapper: replaced text mapper to update for the changed text

Returns:@NotNull BasedSequence

un-escaped sequence

Annotations

@NotNull

unescapeHtml

back to summary

public static @NotNull BasedSequence unescapeHtml(@NotNull BasedSequence s, @NotNull List<Range> ranges, @NotNull ReplacedTextMapper textMapper)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull BasedSequence: based sequence to un-escape
textMapper:@NotNull ReplacedTextMapper: replaced text mapper to update for the changed text

Returns:@NotNull BasedSequence

un-escaped sequence

Annotations

@NotNull

unescapeString

back to summary

public static @NotNull String unescapeString(@NotNull CharSequence s)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull CharSequence: string to un-escape

Returns:@NotNull String

un-escaped string

Annotations

@NotNull

unescapeString

back to summary

public static @NotNull String unescapeString(@NotNull CharSequence s, boolean unescapeEntities)

Replace entities and backslash escapes with literal characters.

Parameters

s:@NotNull CharSequence: string to un-escape
unescapeEntities:boolean: true if HTML entities are to be unescaped

Returns:@NotNull String

un-escaped string

Annotations

@NotNull

Modifier and Type	Method and Description
public void	replace(@NotNull String s, @NotNull StringBuilder sb)
public void	replace(@NotNull BasedSequence s, int startIndex, int endIndex, @NotNull ReplacedTextMapper replacedTextMapper)

public Class Escaping

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Interface Escaping.Replacer

Method Summary

Method Detail