StringBuilderExtensionGetPersistentHashCode(StringBuilder, Int32, HashType) Method

Generates the same Int32 hash code for an identical string of characters each time the program is run.

Definition

Namespace: FolkerKinzel.Strings
Assembly: FolkerKinzel.Strings (in FolkerKinzel.Strings.dll) Version: 9.5.0+6287955de434d14f61638ea0c3c40b499ae05cd1
C#
public static int GetPersistentHashCode(
	this StringBuilder builder,
	int startIndex,
	HashType hashType
)

Parameters

builder  StringBuilder
The Char sequence to be hashed.
startIndex  Int32
The start index in builder.
hashType  HashType
The kind of hashcode to be generated.

Return Value

Int32
The hashcode.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type StringBuilder. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

The method String.GetHashCode() returns a different hash code for an identical string with each program run for security reasons. Apart from the fact that the hash algorithm of String.GetHashCode() could be different in different framework versions, it makes no sense to use the return value of GetHashCode for reuse. The alternatives, e.g. MD5 or SHA256, use more storage space and are slower. This method offers a slim alternative that is suitable for hashing very short strings that are not used in a security-critical context.

The hashcode generated by this method is not identical to the hashcode generated by the .NET Framework 4.0, because it uses roundshifting to preserve more information.

The hashcodes generated with different values for hashType may provide different hashcodes for an identical Char sequence and MUST therefore not be mixed.

Do not use the hashcodes generated by this method for security-critical purposes (such as hashing passwords)!

Exceptions

ArgumentNullExceptionbuilder is null.
ArgumentExceptionhashType is not a defined value of the HashType enum.

See Also