, PP exten
* @return this builder instance
*/
FloatColumnBuilder
+ * For {@link ValueKind#PRESENT}, the corresponding entry from {@code values} is appended.
+ * For {@link ValueKind#NOT_PRESENT} and {@link ValueKind#UNKNOWN}, this method delegates to
+ * {@link #markNextNotPresent()} and {@link #markNextUnknown()} respectively.
+ * , PP extends
* @return this builder instance
*/
IntColumnBuilder
+ * For {@link ValueKind#PRESENT}, the corresponding entry from {@code values} is appended.
+ * For {@link ValueKind#NOT_PRESENT} and {@link ValueKind#UNKNOWN}, this method delegates to
+ * {@link #markNextNotPresent()} and {@link #markNextUnknown()} respectively.
+ * Does not support {@code null} keys.
*
- * Part of the spring-framework but really we need just this one class.
- *
* @author Juergen Hoeller
* @author Phillip Webb
* @since 3.0
* @param , PP extends
* @return this builder instance
*/
StrColumnBuilder
+ * For {@link ValueKind#PRESENT}, the corresponding entry from {@code values} is appended.
+ * For {@link ValueKind#NOT_PRESENT} and {@link ValueKind#UNKNOWN}, this method delegates to
+ * {@link #markNextNotPresent()} and {@link #markNextUnknown()} respectively.
+ * , PP extends CifFileB
protected final P parent;
private final List , PP extends BlockBuilder , PP extends BlockBuilder , PP extends BlockBuilder , PP extends BlockBuilder
+ * CIF has two special tokens for missing data: {@code "."} (not present) and {@code "?"}
+ * (unknown). This method treats those tokens (and {@code null}) as missingness indicators
+ * rather than literal payload:
+ *
+ * Note: this means you cannot write a literal value that is exactly {@code "."} or {@code "?"}
+ * via this overload. If you need explicit control over missingness vs. payload, prefer the
+ * forthcoming masked overload that accepts {@link ValueKind} alongside values (e.g. {@code addMasked(...)}).
+ *
+ * @param values string values to append; {@code null}, {@code "."}, and {@code "?"} are treated specially
+ * @return this builder instance
+ */
@Override
public StrColumnBuilder? in CIF. String values will be empty, number values will be 0.
*/
- UNKNOWN
+ UNKNOWN;
+
+ public static final String CIF_NOT_PRESENT = ".";
+ public static final String CIF_UNKNOWN = "?";
+
+ /**
+ * Checks whether a String matches "?" or ".", sequences with special meaning in CIF.
+ * @param s payload to evaluate
+ * @return true if this String indicates missing or undefined values
+ */
+ public static boolean isValueKindToken(String s) {
+ return CIF_NOT_PRESENT.equals(s) || CIF_UNKNOWN.equals(s);
+ }
+
+ /**
+ * Transforms a String into a ValueKind.
+ * @param s payload to evaluate
+ * @return appropriate ValueKind for "?" and ".", otherwise marked as PRESENT
+ */
+ public static ValueKind fromCifToken(String s) {
+ if (s == null || s.isEmpty() || CIF_NOT_PRESENT.equals(s)) return NOT_PRESENT;
+ if (CIF_UNKNOWN.equals(s)) return UNKNOWN;
+ return PRESENT;
+ }
}
diff --git a/src/main/java/org/rcsb/cif/model/binary/BinaryColumn.java b/src/main/java/org/rcsb/cif/model/binary/BinaryColumn.java
index 0a5483d45..509e17787 100644
--- a/src/main/java/org/rcsb/cif/model/binary/BinaryColumn.java
+++ b/src/main/java/org/rcsb/cif/model/binary/BinaryColumn.java
@@ -9,7 +9,7 @@ public abstract class BinaryColumn
+ *
+ *