Overview

Data Types

Rayforce-Py provides a comprehensive type system for most of Rayforce C level types, designed for efficient data processing and type safety.

Type System Overview

Rayforce-Py type system is built around two main categories:

• Scalar Types: Single values with specific data types
• Container Types: Collections and complex data structures

All types in Rayforce-Py have unique type codes and provide efficient storage and operations optimized for data processing workflows.

Type	Description	Type Code
I16	16-bit signed integer	-3
I32	32-bit signed integer	-4
I64	64-bit signed integer	-5
F64	64-bit floating point	-10
U8	8-bit unsigned integer	-2
C8	Single character	-12
Symbol	Symbolic identifier	-6
B8	Boolean value	-1
Date	Calendar date	-7
Time	Time of day	-8
Timestamp	Date and time	-9
Vector	Homogeneous collection	Variable
List	Heterogeneous collection	0
String	Character sequence	12
Dict	Key-value mapping	99
Table	Columnar data	98
GUID	Globally unique identifier	-11
Fn	User defined function	126

Type Conversion and Compatibility

Automatic Conversion

Rayforce-Py automatically converts Python types to appropriate types:

from rayforce import I32, F64, B8, Symbol, List, Dict

# Automatic conversion from Python types
number = I32(42)        # int -> I32
decimal = F64(3.14)     # float -> F64
flag = B8(True)         # bool -> B8
name = Symbol("test")   # str -> Symbol

# Containers with mixed Python types
data = List([1, "hello", 3.14, True])
config = Dict({"debug": True, "port": 8080})