Welcome to mdts.app Documentation

Comprehensive API reference and usage guide for the MDTS library suite

About mdts.app

MDTS (Market Date Time System) provides a comprehensive suite of libraries for managing business dates, market calendars, and high-performance file I/O operations. Whether you're building financial applications, trading systems, or data processing tools, MDTS delivers the performance and reliability you need.

The mdts.app documentation covers all exported functions, data structures, and best practices for using these libraries effectively. Each function is documented with complete parameter descriptions, return codes, and practical code examples.

Core Libraries

📅 mdts_date

Comprehensive date log management system with support for market calendars, holiday handling, and business day calculations. Perfect for trading systems and financial applications.

📁 mdts_io

High-performance file I/O operations with memory-mapped file support, advanced locking mechanisms, and efficient buffer management for processing large data files.

Key Features

Thread-Safe Operations: All functions are fully thread-safe with mutex-based synchronization
Market-Aware Dates: Native support for market holidays, business days, and trading calendars
High Performance: Optimized with AVX2 vectorization for bulk operations
Memory-Mapped I/O: Efficient file handling for files up to 2GB
Error Recovery: Comprehensive error codes and automatic recovery mechanisms
Windows Native: Direct integration with Windows API for optimal performance

            💡 Note: MDTS libraries require Windows 10 or later and are built with C99/C11 standards
            compliance. All functions use SAL (Source Code Annotation Language) for enhanced code analysis and
            parameter validation.
        

Getting Started

New to MDTS? Follow these steps to get started with the library suite.

1. Initialization

Start by initializing the appropriate handles for your application. The InitializeDateLogHandle function sets up a date log context with associated market holidays.

2. Data Operations

Load date data from files using GenerateDateCollection or merge existing date ranges with MergeDateLogHandle. All operations support both in-memory and file-based processing.

3. Advanced Features

Leverage advanced features like automatic backup and recovery, file region locking, and merge operations with conflict resolution strategies.

Quick Reference

Function	Library	Purpose
InitializeDateLogHandle	mdts_date	Initialize date log with market calendar
GenerateDateCollection	mdts_date	Generate or load date ranges from files
MergeDateLogHandle	mdts_date	Merge date ranges with conflict resolution
DuplicateDateLogHandle	mdts_date	Create independent copies of date logs
NewFileInfo	mdts_io	Create and manage file handles with metadata
LockFileRegions	mdts_io	Lock file regions for exclusive access

Documentation Structure

Navigate through the sidebar menu to explore:

Libraries: Detailed API documentation for each library module
Exported Functions: Complete function references with examples
Structs: Data structure definitions and usage patterns
Downloads: Release packages, installers, and version history

Common Patterns

Date Log Merge Pattern

The most common operation is merging date ranges into an existing date log while handling date conflicts. Use DATE_RANGE_MERGE_FAVOR_SOURCE to prefer newer data or DATE_RANGE_MERGE_FAVOR_DEST to preserve existing data.

File I/O Pattern

For file operations, use NewFileInfo to create file handles, then apply locking with LockFileRegions before performing concurrent operations.

Recommended Next Steps

→ MergeDateLogHandle → InitializeDateLogHandle → File I/O Guide

Support and Resources

GitHub Repository: mdts-app/mdts_date
Issue Tracker: Report bugs and feature requests on GitHub Issues
Documentation: Complete API references and usage examples included
Examples: Each function includes practical code samples

            📌 Important: All MDTS libraries are production-ready and thoroughly tested.
            Comprehensive error handling and recovery mechanisms ensure reliability in mission-critical applications.
            Review the specific function documentation for detailed error codes and recovery strategies.
        

Version Information

This documentation covers the latest stable version of the MDTS library suite. Check the Release Notes for updates and version history.