UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
Public Member Functions | Static Public Member Functions | List of all members
FCbArrayView Class Reference

#include <CompactBinary.h>

+ Inheritance diagram for FCbArrayView:

Public Member Functions

CORE_API FCbArrayView ()
 
CORE_API uint64 Num () const
 
FCbFieldView AsFieldView () const
 
 operator bool () const
 
CORE_API uint64 GetSize () const
 
CORE_API FIoHash GetHash () const
 
CORE_API void AppendHash (FIoHashBuilder &Builder) const
 
CORE_API bool Equals (const FCbArrayView &Other) const
 
CORE_API void CopyTo (FMutableMemoryView Buffer) const
 
CORE_API void CopyTo (FArchive &Ar) const
 
void IterateAttachments (FCbFieldVisitor Visitor) const
 
bool TryGetView (FMemoryView &OutView) const
 
constexpr FCbFieldView ()=default
 
CORE_API FCbFieldView (const void *Data, ECbFieldType Type=ECbFieldType::HasFieldType)
 
 FCbFieldView (const FCbValue &Value)
 
CORE_API FCbFieldViewIterator CreateViewIterator () const
 
FCbFieldViewIterator begin () const
 
constexpr FCbIteratorSentinel end () const
 

Static Public Member Functions

static FCbArrayView FromFieldNoCheck (const FCbFieldView &Field)
 

Additional Inherited Members

- Protected Member Functions inherited from FCbFieldView
CORE_API FMemoryView GetView () const
 
CORE_API FMemoryView GetViewNoType () const
 
FMemoryView GetValueView () const
 
constexpr ECbFieldType GetType () const
 
constexpr ECbFieldType GetTypeWithFlags () const
 
constexpr const void * GetValueData () const
 
const void * GetValueEnd () const
 
CORE_API uint64 GetValueSize () const
 
void Assign (const void *InData, const ECbFieldType InType)
 
constexpr FCbFieldView ()=default
 
CORE_API FCbFieldView (const void *Data, ECbFieldType Type=ECbFieldType::HasFieldType)
 
 FCbFieldView (const FCbValue &Value)
 
constexpr FCbFieldView RemoveName () const
 
constexpr FUtf8StringView GetName () const
 
FCbValue GetValue () const
 
CORE_API FCbObjectView AsObjectView ()
 
CORE_API FCbArrayView AsArrayView ()
 
CORE_API FMemoryView AsBinaryView (FMemoryView Default=FMemoryView())
 
CORE_API FUtf8StringView AsString (FUtf8StringView Default=FUtf8StringView())
 
int8 AsInt8 (int8 Default=0)
 
int16 AsInt16 (int16 Default=0)
 
int32 AsInt32 (int32 Default=0)
 
int64 AsInt64 (int64 Default=0)
 
uint8 AsUInt8 (uint8 Default=0)
 
uint16 AsUInt16 (uint16 Default=0)
 
uint32 AsUInt32 (uint32 Default=0)
 
uint64 AsUInt64 (uint64 Default=0)
 
CORE_API float AsFloat (float Default=0.0f)
 
CORE_API double AsDouble (double Default=0.0)
 
CORE_API bool AsBool (bool bDefault=false)
 
CORE_API FIoHash AsObjectAttachment (const FIoHash &Default=FIoHash())
 
CORE_API FIoHash AsBinaryAttachment (const FIoHash &Default=FIoHash())
 
CORE_API FIoHash AsAttachment (const FIoHash &Default=FIoHash())
 
CORE_API FIoHash AsHash (const FIoHash &Default=FIoHash())
 
CORE_API FGuid AsUuid ()
 
CORE_API FGuid AsUuid (const FGuid &Default)
 
CORE_API int64 AsDateTimeTicks (int64 Default=0)
 
CORE_API FDateTime AsDateTime ()
 
CORE_API FDateTime AsDateTime (FDateTime Default)
 
CORE_API int64 AsTimeSpanTicks (int64 Default=0)
 
CORE_API FTimespan AsTimeSpan ()
 
CORE_API FTimespan AsTimeSpan (FTimespan Default)
 
CORE_API FCbObjectId AsObjectId (const FCbObjectId &Default=FCbObjectId())
 
CORE_API FCbCustomById AsCustomById (FCbCustomById Default=FCbCustomById())
 
CORE_API FCbCustomByName AsCustomByName (FCbCustomByName Default=FCbCustomByName())
 
CORE_API FMemoryView AsCustom (uint64 Id, FMemoryView Default=FMemoryView())
 
CORE_API FMemoryView AsCustom (FUtf8StringView Name, FMemoryView Default=FMemoryView())
 
constexpr bool HasName () const
 
constexpr bool IsNull () const
 
constexpr bool IsObject () const
 
constexpr bool IsArray () const
 
constexpr bool IsBinary () const
 
constexpr bool IsString () const
 
constexpr bool IsInteger () const
 
constexpr bool IsFloat () const
 
constexpr bool IsBool () const
 
constexpr bool IsObjectAttachment () const
 
constexpr bool IsBinaryAttachment () const
 
constexpr bool IsAttachment () const
 
constexpr bool IsHash () const
 
constexpr bool IsUuid () const
 
constexpr bool IsDateTime () const
 
constexpr bool IsTimeSpan () const
 
constexpr bool IsObjectId () const
 
constexpr bool IsCustomById () const
 
constexpr bool IsCustomByName () const
 
constexpr operator bool () const
 
constexpr bool HasValue () const
 
constexpr bool HasError () const
 
constexpr ECbFieldError GetError () const
 
CORE_API uint64 GetSize () const
 
CORE_API FIoHash GetHash () const
 
CORE_API void AppendHash (FIoHashBuilder &Builder) const
 
CORE_API bool Equals (const FCbFieldView &Other) const
 
CORE_API void CopyTo (FMutableMemoryView Buffer) const
 
CORE_API void CopyTo (FArchive &Ar) const
 
CORE_API void IterateAttachments (FCbFieldVisitor Visitor) const
 
bool TryGetView (FMemoryView &OutView) const
 
CORE_API FCbFieldView operator[] (FUtf8StringView Name) const
 
CORE_API FCbFieldViewIterator CreateViewIterator () const
 
FCbFieldViewIterator begin () const
 
constexpr FCbIteratorSentinel end () const
 

Detailed Description

Array of FCbField[View] that have no names.

Accessing a field of the array requires iteration. Access by index is not provided because the cost of accessing an item by index scales linearly with the index.

This type only provides a view into memory and does not perform any memory management itself. Use FCbArray to hold a reference to the underlying memory when necessary.

Constructor & Destructor Documentation

◆ FCbArrayView()

FCbArrayView::FCbArrayView ( )

Construct an array with no fields.

Member Function Documentation

◆ AppendHash()

void FCbArrayView::AppendHash ( FIoHashBuilder &  Builder) const

Append the hash of the array if serialized by itself with no name.

◆ AsFieldView()

FCbFieldView FCbArrayView::AsFieldView ( ) const
inline

Access the array as an array field.

◆ begin()

FCbFieldViewIterator FCbFieldView::begin ( ) const
inline

DO NOT USE DIRECTLY. These functions enable range-based for loop support.

◆ CopyTo() [1/2]

void FCbArrayView::CopyTo ( FArchive &  Ar) const

Copy the array into an archive. This will write GetSize() bytes, with no name.

◆ CopyTo() [2/2]

void FCbArrayView::CopyTo ( FMutableMemoryView  Buffer) const

Copy the array into a buffer of exactly GetSize() bytes, with no name.

◆ CreateViewIterator()

FCbFieldViewIterator FCbFieldView::CreateViewIterator ( ) const
See also
FCbFieldView::CreateViewIterator

◆ end()

constexpr FCbIteratorSentinel FCbFieldView::end ( ) const
inlineconstexpr

◆ Equals()

bool FCbArrayView::Equals ( const FCbArrayView &  Other) const

Whether this array is identical to the other array.

Performs a deep comparison of any contained arrays or objects and their fields. Comparison assumes that both fields are valid and are written in the canonical format. Fields must be written in the same order in arrays and objects, and name comparison is case sensitive. If these assumptions do not hold, this may return false for equivalent inputs. Validation can be done with the All mode to check these assumptions about the format of the inputs.

◆ FCbFieldView() [1/3]

constexpr FCbFieldView::FCbFieldView ( )
constexprdefault
See also
FCbFieldView::FCbFieldView

◆ FCbFieldView() [2/3]

FORCEINLINE FCbFieldView::FCbFieldView ( const FCbValue &  Value)
inlineexplicit
See also
FCbFieldView::FCbFieldView

◆ FCbFieldView() [3/3]

FCbFieldView::FCbFieldView ( const void *  Data,
ECbFieldType  Type = ECbFieldType::HasFieldType 
)
explicit
See also
FCbFieldView::FCbFieldView

◆ FromFieldNoCheck()

static FCbArrayView FCbArrayView::FromFieldNoCheck ( const FCbFieldView &  Field)
inlinestatic

Construct an array from an array field. No type check is performed!

◆ GetHash()

FIoHash FCbArrayView::GetHash ( ) const

Calculate the hash of the array if serialized by itself with no name.

◆ GetSize()

uint64 FCbArrayView::GetSize ( ) const

Returns the size of the array in bytes if serialized by itself with no name.

◆ IterateAttachments()

void FCbArrayView::IterateAttachments ( FCbFieldVisitor  Visitor) const
inline

Invoke the visitor for every attachment in the array.

◆ Num()

uint64 FCbArrayView::Num ( ) const

Returns the number of items in the array.

◆ operator bool()

FCbArrayView::operator bool ( ) const
inlineexplicit

Whether the array has any fields.

◆ TryGetView()

bool FCbArrayView::TryGetView ( FMemoryView &  OutView) const
inline

Try to get a view of the array as it would be serialized, such as by CopyTo.

A view is available if the array contains its type and has no name. Access the equivalent for other arrays through FCbArray::GetBuffer, FCbArray::Clone, or CopyTo.

The documentation for this class was generated from the following files: