nanocoat/include/sjme/nvm/classy.h

   1 /* -*- Mode: C; indent-tabs-mode: t; tab-width: 4 -*-
   2 // ---------------------------------------------------------------------------
   3 // SquirrelJME
   4 //     Copyright (C) Stephanie Gawroriski <xer@multiphasicapps.net>
   5 // ---------------------------------------------------------------------------
   6 // SquirrelJME is under the Mozilla Public License Version 2.0.
   7 // See license.mkd for licensing and copyright information.
   8 // -------------------------------------------------------------------------*/
   9
  10 /**
  11  * Handling of classes.
  12  *
  13  * @since 2024/01/01
  14  */
  15
  16 #ifndef SQUIRRELJME_CLASSY_H
  17 #define SQUIRRELJME_CLASSY_H
  18
  19 #include "sjme/nvm/nvm.h"
  20 #include "sjme/nvm/stringPool.h"
  21 #include "sjme/seekable.h"
  22 #include "sjme/list.h"
  23 #include "sjme/nvm/descriptor.h"
  24 #include "sjme/stream.h"
  25
  26 /* Anti-C++. */
  27 #ifdef __cplusplus
  28         #ifndef SJME_CXX_IS_EXTERNED
  29                 #define SJME_CXX_IS_EXTERNED
  30                 #define SJME_CXX_SQUIRRELJME_CLASSY_H
  31 extern "C" {
  32         #endif /* #ifdef SJME_CXX_IS_EXTERNED */
  33 #endif     /* #ifdef __cplusplus */
  34
  35 /*--------------------------------------------------------------------------*/
  36
  37 /**
  38  * The version of the class.
  39  *
  40  * @since 2024/09/13
  41  */
  42 typedef enum sjme_class_version
  43 {
  44         /** CLDC 1.1 (JSR 30). */
  45         SJME_CLASS_CLDC_1_0 = 2949123,
  46
  47         /** CLDC 1.1 (JSR 139). */
  48         SJME_CLASS_CLDC_1_1 = 3080192,
  49
  50         /** CLDC 8. */
  51         SJME_CLASS_CLDC_1_8 = 3342336,
  52 } sjme_class_version;
  53
  54 /**
  55  * Core class information structure.
  56  *
  57  * @since 2024/01/01
  58  */
  59 typedef struct sjme_class_infoCore sjme_class_infoCore;
  60
  61 /**
  62  * Opaque class information structure.
  63  *
  64  * @since 2024/01/01
  65  */
  66 typedef struct sjme_class_infoCore* sjme_class_info;
  67
  68 /**
  69  * Opaque constant pool information.
  70  *
  71  * @since 2024/09/13
  72  */
  73 typedef struct sjme_class_poolInfoCore sjme_class_poolInfoCore;
  74
  75 /**
  76  * A @c SJME_CLASS_POOL_TYPE_CLASS which represents a class or interface.
  77  *
  78  * @since 2024/01/04
  79  */
  80 typedef struct sjme_class_poolEntryClass sjme_class_poolEntryClass;
  81
  82 /**
  83  * Opaque constant pool information.
  84  *
  85  * @since 2024/09/13
  86  */
  87 typedef sjme_class_poolInfoCore* sjme_class_poolInfo;
  88
  89 /**
  90  * Core method information structure.
  91  *
  92  * @since 2024/01/03
  93  */
  94 typedef struct sjme_class_methodInfoCore sjme_class_methodInfoCore;
  95
  96 /**
  97  * Opaque method information structure.
  98  *
  99  * @since 2024/01/03
 100  */
 101 typedef struct sjme_class_methodInfoCore* sjme_class_methodInfo;
 102
 103 /**
 104  * Method list.
 105  *
 106  * @since 2024/01/03
 107  */
 108 SJME_LIST_DECLARE(sjme_class_methodInfo, 0);
 109
 110 /** The basic type of @c sjme_class_methodInfo . */
 111 #define SJME_TYPEOF_BASIC_sjme_class_methodInfo \
 112         SJME_BASIC_TYPE_ID_OBJECT
 113
 114 /**
 115  * Core field information structure.
 116  *
 117  * @since 2024/01/03
 118  */
 119 typedef struct sjme_class_fieldInfoCore sjme_class_fieldInfoCore;
 120
 121 /**
 122  * Opaque field information structure.
 123  *
 124  * @since 2024/01/03
 125  */
 126 typedef struct sjme_class_fieldInfoCore* sjme_class_fieldInfo;
 127
 128 /**
 129  * Field list.
 130  *
 131  * @since 2024/01/03
 132  */
 133 SJME_LIST_DECLARE(sjme_class_fieldInfo, 0);
 134
 135 /** The basic type of @c sjme_class_fieldInfo . */
 136 #define SJME_TYPEOF_BASIC_sjme_class_fieldInfo \
 137         SJME_BASIC_TYPE_ID_OBJECT
 138
 139 /**
 140  * Exception handling information.
 141  *
 142  * @since 2024/01/03
 143  */
 144 typedef struct sjme_class_exceptionHandler
 145 {
 146         /** The range of the exception where it applies. */
 147         sjme_rangeShort range;
 148
 149         /** The handler PC address. */
 150         sjme_jshort handlerPc;
 151
 152         /** The type that this catches. */
 153         sjme_class_poolEntryClass* handles;
 154 } sjme_class_exceptionHandler;
 155
 156 /** A list of exceptions. */
 157 SJME_LIST_DECLARE(sjme_class_exceptionHandler, 0);
 158
 159 /** The basic type of @c sjme_class_exceptionHandler . */
 160 #define SJME_TYPEOF_BASIC_sjme_class_exceptionHandler \
 161         SJME_BASIC_TYPE_ID_OBJECT
 162
 163 /**
 164  * Method code information structure.
 165  *
 166  * @since 2024/01/03
 167  */
 168 typedef struct sjme_class_codeInfoCore sjme_class_codeInfoCore;
 169
 170 /**
 171  * Opaque method code structure.
 172  *
 173  * @since 2024/01/03
 174  */
 175 typedef struct sjme_class_codeInfoCore* sjme_class_codeInfo;
 176
 177 /**
 178  * Access flags.
 179  *
 180  * @since 2024/01/03
 181  */
 182 typedef struct sjme_class_accessFlags
 183 {
 184         /** Is this public? */
 185         sjme_jboolean public : 1;
 186
 187         /** Is this protected? */
 188         sjme_jboolean protected : 1;
 189
 190         /** Is this private? */
 191         sjme_jboolean private : 1;
 192 } sjme_class_accessFlags;
 193
 194 /**
 195  * Class flags.
 196  *
 197  * @since 2024/01/03
 198  */
 199 typedef struct sjme_class_classFlags
 200 {
 201         /** Access flags. */
 202         sjme_class_accessFlags access;
 203
 204         /** Is the class final? */
 205         sjme_jboolean final : 1;
 206
 207         /** Is the class super? */
 208         sjme_jboolean super : 1;
 209
 210         /** Is the class an interface? */
 211         sjme_jboolean interface : 1;
 212
 213         /** Is the class abstract? */
 214         sjme_jboolean abstract : 1;
 215
 216         /** Is the class synthetic? */
 217         sjme_jboolean synthetic : 1;
 218
 219         /** Is the class an annotation? */
 220         sjme_jboolean annotation : 1;
 221
 222         /** Is the class an enum? */
 223         sjme_jboolean enumeration : 1;
 224 } sjme_class_classFlags;
 225
 226 /**
 227  * Common member flags.
 228  *
 229  * @since 2024/01/03
 230  */
 231 typedef struct sjme_class_memberFlags
 232 {
 233         /** Access flags. */
 234         sjme_class_accessFlags access;
 235
 236         /** Static member? */
 237         sjme_jboolean isStatic : 1;
 238
 239         /** Final member? */
 240         sjme_jboolean final : 1;
 241
 242         /** Synthetic member? */
 243         sjme_jboolean synthetic : 1;
 244 } sjme_class_memberFlags;
 245
 246 /**
 247  * Field flags.
 248  *
 249  * @since 2024/01/03
 250  */
 251 typedef struct sjme_class_fieldFlags
 252 {
 253         /** Common member flags. */
 254         sjme_class_memberFlags member;
 255
 256         /** Is this volatile? */
 257         sjme_jboolean isVolatile : 1;
 258
 259         /** Is this transient? */
 260         sjme_jboolean transient : 1;
 261
 262         /** Is this an enumeration. */
 263         sjme_jboolean enumeration : 1;
 264 } sjme_class_fieldFlags;
 265
 266 /**
 267  * Method flags.
 268  *
 269  * @since 2024/01/03
 270  */
 271 typedef struct sjme_class_methodFlags
 272 {
 273         /** Common member flags. */
 274         sjme_class_memberFlags member;
 275
 276         /** Synchronized, monitor entry/exit on call? */
 277         sjme_jboolean synchronized : 1;
 278
 279         /** Bridge method, generated by the compiler? */
 280         sjme_jboolean bridge : 1;
 281
 282         /** Variadic arguments? */
 283         sjme_jboolean varargs : 1;
 284
 285         /** Is this a native method? */
 286         sjme_jboolean native : 1;
 287
 288         /** Abstract? */
 289         sjme_jboolean abstract : 1;
 290
 291         /** Strict floating point? */
 292         sjme_jboolean strictfp : 1;
 293 } sjme_class_methodFlags;
 294
 295 /**
 296  * The type that a constant pool entry may be.
 297  *
 298  * @since 2024/01/04
 299  */
 300 typedef enum sjme_class_poolType
 301 {
 302         /** Null entry. */
 303         SJME_CLASS_POOL_TYPE_NULL = 0,
 304
 305         /** Modified UTF. */
 306         SJME_CLASS_POOL_TYPE_UTF = 1,
 307
 308         /** Unused 2. */
 309         SJME_CLASS_POOL_TYPE_UNUSED_2 = 2,
 310
 311         /** Integer constant. */
 312         SJME_CLASS_POOL_TYPE_INTEGER = 3,
 313
 314         /** Float constant. */
 315         SJME_CLASS_POOL_TYPE_FLOAT = 4,
 316
 317         /** Long constant. */
 318         SJME_CLASS_POOL_TYPE_LONG = 5,
 319
 320         /** Double constant. */
 321         SJME_CLASS_POOL_TYPE_DOUBLE = 6,
 322
 323         /** Class constant. */
 324         SJME_CLASS_POOL_TYPE_CLASS = 7,
 325
 326         /** String constant. */
 327         SJME_CLASS_POOL_TYPE_STRING = 8,
 328
 329         /** Field reference. */
 330         SJME_CLASS_POOL_TYPE_FIELD = 9,
 331
 332         /** Method reference. */
 333         SJME_CLASS_POOL_TYPE_METHOD = 10,
 334
 335         /** Interface method reference. */
 336         SJME_CLASS_POOL_TYPE_INTERFACE_METHOD = 11,
 337
 338         /** Name and type. */
 339         SJME_CLASS_POOL_TYPE_NAME_AND_TYPE = 12,
 340
 341         /** Unused 13. */
 342         SJME_CLASS_POOL_TYPE_UNUSED_13 = 13,
 343
 344         /** Unused 14. */
 345         SJME_CLASS_POOL_TYPE_UNUSED_14 = 14,
 346
 347         /** Method handle. */
 348         SJME_CLASS_POOL_TYPE_METHOD_HANDLE = 15,
 349
 350         /** Method type. */
 351         SJME_CLASS_POOL_TYPE_METHOD_TYPE = 16,
 352
 353         /** Unused 17. */
 354         SJME_CLASS_POOL_TYPE_UNUSED_17 = 17,
 355
 356         /** Invoke dynamic. */
 357         SJME_CLASS_POOL_TYPE_INVOKE_DYNAMIC = 18,
 358
 359         /** The number of pool types. */
 360         SJME_NUM_CLASS_POOL_TYPE
 361 } sjme_class_poolType;
 362
 363 struct sjme_class_poolEntryClass
 364 {
 365         /** The type of entry that this is. */
 366         sjme_class_poolType type;
 367
 368         /** The index where the descriptor is located. */
 369         sjme_jshort descriptorIndex;
 370
 371         /** The descriptor this represents. */
 372         sjme_stringPool_string descriptor;
 373 };
 374
 375 /**
 376  * A @c SJME_CLASS_POOL_TYPE_DOUBLE which represents a double constant.
 377  *
 378  * @since 2024/01/04
 379  */
 380 typedef struct sjme_class_poolEntryDouble
 381 {
 382         /** The type of entry that this is. */
 383         sjme_class_poolType type;
 384
 385         /** The constant value. */
 386         sjme_jdouble value;
 387 } sjme_class_poolEntryDouble;
 388
 389 /**
 390  * A @c SJME_CLASS_POOL_TYPE_NAME_AND_TYPE which represents a name and type
 391  * of a member without the class.
 392  *
 393  * @since 2024/01/04
 394  */
 395 typedef struct sjme_class_poolEntryNameAndType sjme_class_poolEntryNameAndType;
 396
 397 /**
 398  * Either @c SJME_CLASS_POOL_TYPE_FIELD , @c SJME_CLASS_POOL_TYPE_METHOD ,
 399  * or @c SJME_CLASS_POOL_TYPE_INTERFACE_METHOD which represents a reference
 400  * to a class member.
 401  *
 402  * @since 2024/01/04
 403  */
 404 typedef struct sjme_class_poolEntryMember
 405 {
 406         /** The type of entry that this is. */
 407         sjme_class_poolType type;
 408
 409         /** The index where the class is located. */
 410         sjme_jshort inClassIndex;
 411
 412         /** The class this refers to. */
 413         const sjme_class_poolEntryClass* inClass;
 414
 415         /** The index where the name and type is located. */
 416         sjme_jshort nameAndTypeIndex;
 417
 418         /** The name and type used. */
 419         const sjme_class_poolEntryNameAndType* nameAndType;
 420 } sjme_class_poolEntryMember;
 421
 422 /**
 423  * A @c SJME_CLASS_POOL_TYPE_FLOAT which represents a float constant.
 424  *
 425  * @since 2024/01/04
 426  */
 427 typedef struct sjme_class_poolEntryFloat
 428 {
 429         /** The type of entry that this is. */
 430         sjme_class_poolType type;
 431
 432         /** The constant value. */
 433         sjme_jfloat value;
 434 } sjme_class_poolEntryFloat;
 435
 436 /**
 437  * A @c SJME_CLASS_POOL_TYPE_INTEGER which represents an integer constant.
 438  *
 439  * @since 2024/01/04
 440  */
 441 typedef struct sjme_class_poolEntryInteger
 442 {
 443         /** The type of entry that this is. */
 444         sjme_class_poolType type;
 445
 446         /** The constant value. */
 447         sjme_jint value;
 448 } sjme_class_poolEntryInteger;
 449
 450 /**
 451  * A @c SJME_CLASS_POOL_TYPE_LONG which represents a long constant.
 452  *
 453  * @since 2024/01/04
 454  */
 455 typedef struct sjme_class_poolEntryLong
 456 {
 457         /** The type of entry that this is. */
 458         sjme_class_poolType type;
 459
 460         /** The constant value. */
 461         sjme_jlong value;
 462 } sjme_class_poolEntryLong;
 463
 464 /**
 465  * A @c SJME_CLASS_POOL_TYPE_STRING which represents a string constant.
 466  *
 467  * @since 2024/09/20
 468  */
 469 typedef struct sjme_class_poolEntryString
 470 {
 471         /** The type of entry that this is. */
 472         sjme_class_poolType type;
 473
 474         /** The index where the value is located. */
 475         sjme_jshort valueIndex;
 476
 477         /** The type. */
 478         sjme_stringPool_string value;
 479 } sjme_class_poolEntryString;
 480
 481 struct sjme_class_poolEntryNameAndType
 482 {
 483         /** The type of entry that this is. */
 484         sjme_class_poolType type;
 485
 486         /** The index where the name is located. */
 487         sjme_jshort nameIndex;
 488
 489         /** The name. */
 490         sjme_stringPool_string name;
 491
 492         /** The index where the descriptor is located. */
 493         sjme_jshort descriptorIndex;
 494
 495         /** The type. */
 496         sjme_stringPool_string descriptor;
 497 };
 498
 499 /**
 500  * A @c SJME_CLASS_POOL_TYPE_UTF which is a modified UTF-8 entry.
 501  *
 502  * @since 2024/01/04
 503  */
 504 typedef struct sjme_class_poolEntryUtf
 505 {
 506         /** The type of entry that this is. */
 507         sjme_class_poolType type;
 508
 509         /** The UTF data for this entry. */
 510         sjme_stringPool_string utf;
 511 } sjme_class_poolEntryUtf;
 512
 513 /**
 514  * Represents a single constant pool entry.
 515  *
 516  * @since 2024/01/04
 517  */
 518 typedef union sjme_class_poolEntry
 519 {
 520         /** The type of entry that this is. */
 521         sjme_class_poolType type;
 522
 523         /** Class. */
 524         sjme_class_poolEntryClass classRef;
 525
 526         /** Double. */
 527         sjme_class_poolEntryDouble constDouble;
 528
 529         /** Float. */
 530         sjme_class_poolEntryFloat constFloat;
 531
 532         /** Integer. */
 533         sjme_class_poolEntryInteger constInteger;
 534
 535         /** Long. */
 536         sjme_class_poolEntryLong constLong;
 537
 538         /** String constant. */
 539         sjme_class_poolEntryString constString;
 540
 541         /** A class member. */
 542         sjme_class_poolEntryMember member;
 543
 544         /** Name and type. */
 545         sjme_class_poolEntryNameAndType nameAndType;
 546
 547         /** UTF pool entry. */
 548         sjme_class_poolEntryUtf utf;
 549 } sjme_class_poolEntry;
 550
 551 /** A list of constant pool entries. */
 552 SJME_LIST_DECLARE(sjme_class_poolEntry, 0);
 553
 554 struct sjme_class_poolInfoCore
 555 {
 556         /** The common NanoCoat base. */
 557         sjme_nvm_commonBase common;
 558
 559         /** Constant pool entries. */
 560         sjme_list_sjme_class_poolEntry* pool;
 561 };
 562
 563 struct sjme_class_infoCore
 564 {
 565         /** The common NanoCoat base. */
 566         sjme_nvm_commonBase common;
 567
 568         /** The constant pool of this class. */
 569         sjme_class_poolInfo pool;
 570
 571         /** The class version. */
 572         sjme_class_version version;
 573
 574         /** Class flags. */
 575         sjme_class_classFlags flags;
 576
 577         /** The name of this class. */
 578         sjme_stringPool_string name;
 579
 580         /** The superclass of this class. */
 581         sjme_stringPool_string superName;
 582
 583         /** The interfaces this class implements. */
 584         const sjme_list_sjme_stringPool_string* interfaceNames;
 585
 586         /** Fields within the method. */
 587         const sjme_list_sjme_class_fieldInfo* fields;
 588
 589         /** Methods within the class. */
 590         const sjme_list_sjme_class_methodInfo* methods;
 591 };
 592
 593 /**
 594  * Represents a field's constant value.
 595  *
 596  * @since 2024/01/08
 597  */
 598 typedef struct sjme_class_fieldConstVal
 599 {
 600         /** The type of value. */
 601         sjme_javaTypeId type;
 602
 603         /** The value of the field. */
 604         union
 605         {
 606                 /** The Java value. */
 607                 sjme_jvalue java;
 608
 609                 /** Constant string. */
 610                 sjme_stringPool_string string;
 611         } value;
 612 } sjme_class_fieldConstVal;
 613
 614 struct sjme_class_fieldInfoCore
 615 {
 616         /** The class which contains this field. */
 617         sjme_class_info inClass;
 618
 619         /** Field flags. */
 620         sjme_class_fieldFlags flags;
 621
 622         /** The name of this field. */
 623         sjme_stringPool_string name;
 624
 625         /** The type of this field. */
 626         sjme_stringPool_string type;
 627
 628         /** The constant value, if any. */
 629         sjme_class_fieldConstVal constVal;
 630 };
 631
 632 struct sjme_class_methodInfoCore
 633 {
 634         /** The class which contains this method. */
 635         sjme_class_info inClass;
 636
 637         /** Method flags. */
 638         sjme_class_methodFlags flags;
 639
 640         /** The name of this method. */
 641         sjme_stringPool_string name;
 642
 643         /** The type of this method. */
 644         sjme_stringPool_string type;
 645
 646         /** The method code, if it is not native. */
 647         sjme_class_codeInfo code;
 648 };
 649
 650 struct sjme_class_codeInfoCore
 651 {
 652         /** The method which contains this code. */
 653         sjme_class_methodInfo inMethod;
 654
 655         /** Maximum number of locals. */
 656         sjme_jint maxLocals;
 657
 658         /** Maximum number of stack entries. */
 659         sjme_jint maxStack;
 660
 661         /** Exception table. */
 662         const sjme_list_sjme_class_exceptionHandler* exceptions;
 663
 664         /** Method byte code. */
 665         sjme_list_sjme_jubyte code;
 666 };
 667
 668 /**
 669  * Stack map table representation.
 670  *
 671  * @since 2024/01/09
 672  */
 673 typedef struct sjme_class_stackMap
 674 {
 675         /** Todo. */
 676         int todo;
 677 } sjme_class_stackMap;
 678
 679 /**
 680  * Handler function for attribute parsing.
 681  *
 682  * @param inPool The allocation pool.
 683  * @param inConstPool The constant pool.
 684  * @param inStringPool The string pool.
 685  * @param context The passed context.
 686  * @param attrName The name of the attribute.
 687  * @param attrStream The stream over the attribute data.
 688  * @param attrData The attribute data.
 689  * @param attrLen The data length.
 690  * @return Any resultant error, if any.
 691  * @since 2024/09/21
 692  */
 693 typedef sjme_errorCode (*sjme_class_parseAttributeHandlerFunc)(
 694         sjme_attrInNotNull sjme_alloc_pool* inPool,
 695         sjme_attrInNotNull sjme_class_poolInfo inConstPool,
 696         sjme_attrInNotNull sjme_stringPool inStringPool,
 697         sjme_attrInNotNull sjme_pointer context,
 698         sjme_attrInNotNull sjme_lpcstr attrName,
 699         sjme_attrInNotNull sjme_stream_input attrStream,
 700         sjme_attrInNotNullBuf(attrLen) sjme_pointer attrData,
 701         sjme_attrInPositive sjme_jint attrLen);
 702
 703 /**
 704  * Structure for attribute handlers according to their name and handler.
 705  *
 706  * @since 2024/09/25
 707  */
 708 typedef struct sjme_class_parseAttributeHandlerInfo
 709 {
 710         /** The name to handle. */
 711         sjme_lpcstr name;
 712
 713         /** The handler for the attribute. */
 714         sjme_class_parseAttributeHandlerFunc handler;
 715 } sjme_class_parseAttributeHandlerInfo;
 716
 717 /**
 718  * Parses a single class and loads its class information.
 719  *
 720  * @param inPool The pool to allocate within.
 721  * @param inStream The stream to parse from when reading the class.
 722  * @param inStringPool The pool for strings existing in memory already.
 723  * @param outClass The resultant class information
 724  * @return Any resultant error code, if any.
 725  * @since 2024/01/03
 726  */
 727 sjme_errorCode sjme_class_parse(
 728         sjme_attrInNotNull sjme_alloc_pool* inPool,
 729         sjme_attrInNotNull sjme_stream_input inStream,
 730         sjme_attrInNotNull sjme_stringPool inStringPool,
 731         sjme_attrOutNotNull sjme_class_info* outClass);
 732
 733 /**
 734  * Parses attributes.
 735  *
 736  * @param inPool The allocation pool.
 737  * @param inStream The stream to read from.
 738  * @param inConstPool The constant pool.
 739  * @param inStringPool The string pool.
 740  * @param handlers The handler used for attribute parsing.
 741  * @param context The context to pass to the handler.
 742  * @return Any resultant error, if any.
 743  * @since 2024/09/21
 744  */
 745 sjme_errorCode sjme_class_parseAttributes(
 746         sjme_attrInNotNull sjme_alloc_pool* inPool,
 747         sjme_attrInNotNull sjme_stream_input inStream,
 748         sjme_attrInNotNull sjme_class_poolInfo inConstPool,
 749         sjme_attrInNotNull sjme_stringPool inStringPool,
 750         sjme_attrInNotNull const sjme_class_parseAttributeHandlerInfo* handlers,
 751         sjme_attrInNotNull sjme_pointer context);
 752
 753 /**
 754  * Parses the constant pool of an input class.
 755  *
 756  * @param inPool The input pool.
 757  * @param inStream The stream to read from.
 758  * @param inStringPool The string pool for reused strings.
 759  * @param outPool The resultant read constant pool.
 760  * @return Any resultant error, if any.
 761  * @since 2024/09/13
 762  */
 763 sjme_errorCode sjme_class_parseConstantPool(
 764         sjme_attrInNotNull sjme_alloc_pool* inPool,
 765         sjme_attrInNotNull sjme_stream_input inStream,
 766         sjme_attrInNotNull sjme_stringPool inStringPool,
 767         sjme_attrOutNotNull sjme_class_poolInfo* outPool);
 768
 769 /**
 770  * Parses a single field.
 771  *
 772  * @param inPool The allocation pool to use.
 773  * @param inStream The stream to read from.
 774  * @param inConstPool The class constant pool.
 775  * @param inStringPool The string pool used.
 776  * @param outField The resultant field.
 777  * @return Any resultant error, if any.
 778  * @since 2024/09/21
 779  */
 780 sjme_errorCode sjme_class_parseField(
 781         sjme_attrInNotNull sjme_alloc_pool* inPool,
 782         sjme_attrInNotNull sjme_stream_input inStream,
 783         sjme_attrInNotNull sjme_class_poolInfo inConstPool,
 784         sjme_attrInNotNull sjme_stringPool inStringPool,
 785         sjme_attrOutNotNull sjme_class_fieldInfo* outField);
 786
 787 /**
 788  * Parses a single method.
 789  *
 790  * @param inPool The allocation pool to use.
 791  * @param inStream The stream to read from.
 792  * @param inConstPool The class constant pool.
 793  * @param inStringPool The string pool used.
 794  * @param outMethod The resultant method.
 795  * @return Any resultant error, if any.
 796  * @since 2024/09/21
 797  */
 798 sjme_errorCode sjme_class_parseMethod(
 799         sjme_attrInNotNull sjme_alloc_pool* inPool,
 800         sjme_attrInNotNull sjme_stream_input inStream,
 801         sjme_attrInNotNull sjme_class_poolInfo inConstPool,
 802         sjme_attrInNotNull sjme_stringPool inStringPool,
 803         sjme_attrInOutNotNull sjme_class_methodInfo* outMethod);
 804
 805 /*--------------------------------------------------------------------------*/
 806
 807 /* Anti-C++. */
 808 #ifdef __cplusplus
 809         #ifdef SJME_CXX_SQUIRRELJME_CLASSY_H
 810 }
 811                 #undef SJME_CXX_SQUIRRELJME_CLASSY_H
 812                 #undef SJME_CXX_IS_EXTERNED
 813         #endif /* #ifdef SJME_CXX_SQUIRRELJME_CLASSY_H */
 814 #endif     /* #ifdef __cplusplus */
 815
 816 #endif /* SQUIRRELJME_CLASSY_H */