Options
All
  • Public
  • Public/Protected
  • All
Menu

Contain a UTF8 string with implicit length.

Factory: {@link module:Layout.utf8|utf8}

NOTE Because the length is implicit in the size of the buffer this layout should be used only in isolation, or in a situation where the length can be expressed by operating on a slice of the containing buffer.

param [maxSpan]

the maximum length allowed for encoded string content. If not provided there is no bound on the allowed content.

param [property]

initializer for {@link Layout#property|property}.

Hierarchy

Index

Constructors

constructor

  • new UTF8(maxSpan?: string | number, property?: string): UTF8

Properties

Optional boundConstructor_

boundConstructor_?: any

maxSpan

maxSpan: number

Optional property

property?: string

span

span: number

Methods

decode

  • decode(b: Uint8Array, offset?: number): string

encode

  • encode(src: string | LayoutObject, b: Uint8Array, offset?: number): number

fromArray

  • Create an object from layout properties and an array of values.

    NOTE This function returns undefined if invoked on a layout that does not return its value as an Object. Objects are returned for things that are a Structure, which includes variant layouts if they are structures, and excludes Unions. If you want this feature for a union you must use getVariant to select the desired layout.

    Parameters

    • values: any[]

      an array of values that correspond to the default order for properties. As with {@link Layout#decode|decode} layout elements that have no property name are skipped when iterating over the array values. Only the top-level properties are assigned; arguments are not assigned to properties of contained layouts. Any unused values are ignored.

    Returns undefined | LayoutObject

getSpan

  • getSpan(b: Uint8Array, offset?: number): number

makeDestinationObject

replicate

  • replicate(property: string): UTF8
  • Replicate the layout using a new property.

    This function must be used to get a structurally-equivalent layout with a different name since all Layout instances are immutable.

    NOTE This is a shallow copy. All fields except {@link Layout#property|property} are strictly equal to the origin layout.

    Parameters

    • property: string

      the value for {@link Layout#property|property} in the replica.

    Returns UTF8

    • the copy with {@link Layout#property|property} set to property.

Generated using TypeDoc