protocol ExpressibleByExtendedGraphemeClusterLiteral

A type that can be initialized with a string literal containing a single extended grapheme cluster.

An extended grapheme cluster is a group of one or more Unicode scalar values that approximates a single user-perceived character. Many individual characters, such as "é", "김", and "🇮🇳", can be made up of multiple Unicode scalar values. These code points are combined by Unicode's boundary algorithms into extended grapheme clusters.

The String, StaticString, and Character types conform to the ExpressibleByExtendedGraphemeClusterLiteral protocol. You can initialize a variable or constant of any of these types using a string literal that holds a single character.

let snowflake: Character = "❄︎"
// Prints "❄︎"

Conforming to ExpressibleByExtendedGraphemeClusterLiteral

To add ExpressibleByExtendedGraphemeClusterLiteral conformance to your custom type, implement the required initializer.

Inheritance ExpressibleByUnicodeScalarLiteral View Protocol Hierarchy →
Associated Types
ExtendedGraphemeClusterLiteralType : _ExpressibleByBuiltinExtendedGraphemeClusterLiteral

A type that represents an extended grapheme cluster literal.

Valid types for ExtendedGraphemeClusterLiteralType are Character, String, and StaticString.

UnicodeScalarLiteralType : _ExpressibleByBuiltinUnicodeScalarLiteral

A type that represents a Unicode scalar literal.

Valid types for UnicodeScalarLiteralType are Unicode.Scalar, Character, String, and StaticString.

Import import Swift


init(extendedGraphemeClusterLiteral:) Required

Creates an instance initialized to the given value.

value: The value of the new instance.


init(extendedGraphemeClusterLiteral value: Self.ExtendedGraphemeClusterLiteralType)
init(unicodeScalarLiteral:) Required

Creates an instance initialized to the given value.

value: The value of the new instance.


init(unicodeScalarLiteral value: Self.UnicodeScalarLiteralType)

Declared In


Default Implementations

Where ExtendedGraphemeClusterLiteralType == UnicodeScalarLiteralType



init(unicodeScalarLiteral value: Self.ExtendedGraphemeClusterLiteralType)