Class LanguageSet

Namespace

NanoByte.Common.Collections

Assembly

NanoByte.Common.dll

A set of languages that can be serialized as a simple space-separated list of ISO language codes.

[Serializable]
[TypeConverter(typeof(StringConstructorConverter<LanguageSet>))]
public class LanguageSet : SortedSet<CultureInfo>

Inheritance

object

SortedSet<CultureInfo>

LanguageSet

Extension Methods

BinaryStorage.SaveBinary<T>(T, Stream)

BinaryStorage.SaveBinary<T>(T, string)

JsonStorage.SaveJson<T>(T, Stream)

JsonStorage.SaveJson<T>(T, string)

JsonStorage.ToJsonString<T>(T)

XmlStorage.SaveXml<T>(T, Stream, string?)

XmlStorage.SaveXml<T>(T, string, string?)

XmlStorage.ToXmlString<T>(T, string?)

UpdateUtils.To<T>(T, ref T, Action)

UpdateUtils.To<T>(T, ref T, ref bool)

UpdateUtils.To<T>(T, ref T, ref bool, ref bool)

UpdateUtils.To<TIn, TOut>(TIn, Func<TIn, TOut>)

ConversionUtils.ConvertToString<TType>(TType)

CollectionExtensions.AddIfNew<T>(ICollection<T>, T)

CollectionExtensions.Add<TCollection, TElements>(ICollection<TCollection>, IEnumerable<TElements>)

CollectionExtensions.RemoveAll<T>(ICollection<T>, Func<T, bool>)

CollectionExtensions.Remove<TCollection, TElements>(ICollection<TCollection>, IEnumerable<TElements>)

DictionaryExtensions.ToMultiDictionary<TSource, TKey, TValue>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TValue>)

EnumerableExtensions.ContainsAny<T>(IEnumerable<T>, IEnumerable<T>, IEqualityComparer<T>?)

EnumerableExtensions.ContainsOrEmpty<T>(IEnumerable<T>, T)

EnumerableExtensions.DistinctBy<T, TKey>(IEnumerable<T>, Func<T, TKey>)

EnumerableExtensions.Except<T>(IEnumerable<T>, Func<T, bool>)

EnumerableExtensions.Except<T>(IEnumerable<T>, T)

EnumerableExtensions.GetSequencedHashCode<T>(IEnumerable<T>, IEqualityComparer<T>?)

EnumerableExtensions.GetUnsequencedHashCode<T>(IEnumerable<T>, IEqualityComparer<T>?)

EnumerableExtensions.MaxBy<T, TValue>(IEnumerable<T>, Func<T, TValue>, IComparer<TValue>?)

EnumerableExtensions.MinBy<T, TValue>(IEnumerable<T>, Func<T, TValue>, IComparer<TValue>?)

EnumerableExtensions.Permutate<T>(IEnumerable<T>)

EnumerableExtensions.SequencedEquals<T>(IEnumerable<T>, IEnumerable<T>, IEqualityComparer<T>?)

EnumerableExtensions.TopologicalSort<T>(IEnumerable<T>, Func<T, IEnumerable<T>>)

EnumerableExtensions.TrySelect<TSource, TResult, TException>(IEnumerable<TSource>, Func<TSource, TResult>, Action<TException>)

EnumerableExtensions.UnsequencedEquals<T>(IEnumerable<T>, IEnumerable<T>, IEqualityComparer<T>?)

EnumerableExtensions.WhereNotNull<T>(IEnumerable<T?>)

Bucketizer.Bucketize<T>(IEnumerable<T>)

Bucketizer.Bucketize<TElement, TValue>(IEnumerable<TElement>, Func<TElement, TValue>)

ExceptionUtils.TryAnyAsync<T>(IEnumerable<T>, Func<T, Task>)

ExceptionUtils.TryAny<T>(IEnumerable<T>, Action<T>)

JsonStorage.ReparseAsJson<T>(object)

JsonStorage.ReparseAsJson<T>(object, T)

Remarks

Uses Unix-style language codes with an underscore (_) separator.

Constructors

LanguageSet()

Creates a new empty language collection.

public LanguageSet()

LanguageSet(IEnumerable<CultureInfo>)

Creates a new language collection pre-filled with a set of languages.

public LanguageSet(IEnumerable<CultureInfo> collection)

Parameters

collection IEnumerable<CultureInfo>

LanguageSet(SerializationInfo, StreamingContext)

protected LanguageSet(SerializationInfo info, StreamingContext context)

Parameters

info SerializationInfo

context StreamingContext

LanguageSet(string)

Deserializes a space-separated list of languages codes.

public LanguageSet(string value)

Parameters

value string

A space-separated list of languages codes (in the same format as used by the LANG environment variable).

Remarks

Unknown language codes in value are replaced with System.Globalization.CultureInfo.InvariantCulture rather than raising an System.ArgumentException.

Methods

Add(string)

Adds a language identified by a string to the collection.

[CollectionAccess(CollectionAccessType.UpdatedContent)]
public bool Add(string langCode)

Parameters

langCode string

The string identifying the language to add.

Returns

bool

true if the language could be added, false otherwise.

Exceptions

ArgumentException

langCode is not a valid language code.

ContainsAny(IEnumerable<CultureInfo>, bool)

Determines whether this language set contains any of a set of target languages.

[CollectionAccess(CollectionAccessType.Read)]
public bool ContainsAny(IEnumerable<CultureInfo> targets, bool ignoreCountry = false)

Parameters

targets IEnumerable<CultureInfo>

The language set to match against.

ignoreCountry bool

true to compare only the two-letter language name; false to also compare the country code.

Returns

bool

ToString()

Serializes the list as a space-separated list of languages codes.

public override string ToString()

Returns

string