true_bpe.h File Reference

#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
#include "tokenizer/hash_table.h"

Go to the source code of this file.

Data Structures
struct	CKBPEConfig

Macros
#define	CK_TRUE_BPE_API   __attribute__((visibility("default")))

Enumerations
enum	CKBPEPretokenizer { CK_BPE_PRETOKENIZER_GPT2 = 0 , CK_BPE_PRETOKENIZER_UNICODE_SPLIT_ISOLATED = 1 }
enum	CKSpacePrefixStyle { CK_SPACE_PREFIX_AUTO = 0 , CK_SPACE_PREFIX_GPT2 = 1 , CK_SPACE_PREFIX_SPM = 2 , CK_SPACE_PREFIX_ASCII = 3 }

Functions
	__attribute__ ((visibility("default"))) CKTrueBPE *ck_true_bpe_create(void)

Variables
int32_t int32_t	bos
const CKBPEConfig *	config
int32_t int32_t int32_t	eos
const char int32_t	id
const char int int32_t *	ids
const char *	left
int32_t	left_id
const char int int32_t int	max_ids
const int32_t int char int	max_len
int32_t int32_t int32_t	merged_id
int const int32_t const char int const int32_t *	merges
const int32_t int	num_ids
int const int32_t const char int	num_merges
int const int32_t *	offsets
int32_t int32_t int32_t int32_t	pad
int32_t int32_t int32_t int32_t	priority
const char const char *	right
int32_t int32_t	right_id
const char int32_t float	score
int const int32_t const char *	strings
const char *	text
const char int	text_len
const char *	token
int32_t	unk
int	vocab_size

Macro Definition Documentation

CK_TRUE_BPE_API

#define CK_TRUE_BPE_API   __attribute__((visibility("default")))

Definition at line 37 of file true_bpe.h.

Enumeration Type Documentation

CKBPEPretokenizer

enum CKBPEPretokenizer

Enumerator
CK_BPE_PRETOKENIZER_GPT2
CK_BPE_PRETOKENIZER_UNICODE_SPLIT_ISOLATED

Definition at line 53 of file true_bpe.h.

             {
    CK_BPE_PRETOKENIZER_GPT2 = 0,
    CK_BPE_PRETOKENIZER_UNICODE_SPLIT_ISOLATED = 1
} CKBPEPretokenizer;

CKSpacePrefixStyle

enum CKSpacePrefixStyle

Enumerator
CK_SPACE_PREFIX_AUTO
CK_SPACE_PREFIX_GPT2
CK_SPACE_PREFIX_SPM
CK_SPACE_PREFIX_ASCII

Definition at line 45 of file true_bpe.h.

             {
    CK_SPACE_PREFIX_AUTO = 0,    /* Auto-detect from vocabulary */
    CK_SPACE_PREFIX_GPT2 = 1,    /* GPT-2 style: Ġ (U+0120, bytes 0xC4 0xA0) */
    CK_SPACE_PREFIX_SPM = 2,     /* SentencePiece style: ▁ (U+2581, bytes 0xE2 0x96 0x81) */
    CK_SPACE_PREFIX_ASCII = 3    /* ASCII identity mode: no UTF-8/byte remap */
} CKSpacePrefixStyle;

Function Documentation

__attribute__()

__attribute__

(

(visibility("default"))

)

Create a new True BPE tokenizer.

Returns

Newly allocated tokenizer, or NULL on error

Free a True BPE tokenizer.

Parameters

bpe	Tokenizer to free

Add a token to the vocabulary.

Parameters

bpe	Tokenizer
token	Token string (UTF-8)
id	Token ID
score	Token score (for unigram models, 0.0 for BPE)

Returns

0 on success, -1 on error

Add a BPE merge rule by token IDs.

Merge rules define how tokens are combined during encoding. Rules with lower priority numbers are applied first.

Parameters

bpe	Tokenizer
left_id	Left token ID
right_id	Right token ID
merged_id	Resulting merged token ID
priority	Merge priority (lower = applied first)

Returns

0 on success, -1 on error

Add a BPE merge rule by token strings.

This looks up the token IDs automatically and determines the merged token. The merged token must already exist in the vocabulary.

Parameters

bpe	Tokenizer
left	Left token string
right	Right token string
priority	Merge priority (lower = applied first)

Returns

0 on success, -1 on error

Set special token IDs.

Parameters

bpe	Tokenizer
unk	Unknown token ID (-1 to disable)
bos	Beginning-of-sequence token ID (-1 to disable)
eos	End-of-sequence token ID (-1 to disable)
pad	Padding token ID (-1 to disable)

Add a special token that should be matched BEFORE BPE encoding.

Special tokens like <|im_start|>, <|im_end|>, <|endoftext|> are matched literally in the input text before BPE processing. Without this, BPE would break them into individual characters.

Parameters

bpe	Tokenizer
token	Token string to match literally (e.g., "<|im_end|>")
id	Token ID to output when matched

Returns

0 on success, -1 on error

Set tokenizer configuration.

Parameters

bpe	Tokenizer
config	Configuration to apply

Load vocabulary + merges from binary buffers.

Parameters

bpe	Tokenizer
vocab_size	Number of tokens
offsets	Offsets array (length vocab_size)
strings	Null-terminated token strings blob
num_merges	Number of merge rules
merges	Merge triples [left_id, right_id, merged_id] (length num_merges*3)

Returns

0 on success, -1 on error

Look up a token ID by string.

Parameters

bpe	Tokenizer
token	Token string

Returns

Token ID, or unk_id if not found

Get a token string by ID.

Parameters

bpe	Tokenizer
id	Token ID

Returns

Token string, or NULL if invalid

Get vocabulary size.

Parameters

bpe

Tokenizer

Returns

Number of tokens in vocabulary

Get number of merge rules.

Parameters

bpe

Tokenizer

Returns

Number of merge rules

Auto-detect space prefix style from vocabulary.

Counts tokens starting with Ġ (GPT-2) vs ▁ (SentencePiece) to determine style. The detected style is cached in the config.

Parameters

bpe

Tokenizer

Returns

Detected style (GPT2 or SPM)

Encode text to token IDs using true BPE algorithm.

This applies merge rules in priority order (not greedy longest-match).

Parameters

bpe	Tokenizer
text	Input text (UTF-8)
text_len	Text length in bytes, or -1 for null-terminated
ids	Output token IDs array
max_ids	Maximum IDs to write

Returns

Number of tokens written

Decode token IDs to text.

Parameters

bpe	Tokenizer
ids	Input token IDs
num_ids	Number of IDs
text	Output text buffer
max_len	Maximum text length

Returns

Number of bytes written (excluding null terminator)

Variable Documentation

bos

int32_t int32_t bos

Definition at line 153 of file true_bpe.h.

config

const CKBPEConfig* config

Definition at line 179 of file true_bpe.h.

Referenced by ck_tokenizer_encode(), and ck_true_bpe_set_config().

eos

int32_t int32_t int32_t eos

Definition at line 154 of file true_bpe.h.

id

int32_t id

Definition at line 103 of file true_bpe.h.

ids

const int32_t* ids

Definition at line 271 of file true_bpe.h.

left

const char* left

Definition at line 138 of file true_bpe.h.

Referenced by audio_resample_linear_f32(), audio_whisper_mel_filters_slaney_f32(), ck_tokenizer_add_merge(), ck_tokenizer_add_merge(), ck_tokenizer_encode_spm_llama_impl(), ck_tokenizer_load_binary(), ck_tokenizer_lookup_merge(), ck_true_bpe_add_merge_by_tokens(), ck_true_bpe_load_binary(), hash_pair(), qwen4_llama_mul_sum_rows(), and qwen4_pytorch_bf16_dot().

left_id

int32_t left_id

Definition at line 120 of file true_bpe.h.

Referenced by ck_true_bpe_add_merge(), find_best_merge(), merge_key(), and merge_table_lookup().

max_ids

const char int int32_t int max_ids

Definition at line 272 of file true_bpe.h.

Referenced by ck_tokenizer_encode(), ck_tokenizer_encode_spm_dispatch(), ck_tokenizer_encode_spm_impl(), ck_tokenizer_encode_spm_llama_impl(), ck_tokenizer_encode_spm_plain_segment(), ck_true_bpe_encode(), encode_chunk(), encode_text_segment(), main(), spm_encode_byte_fallback(), and spm_llama_resegment_node().

max_len

const int32_t int char int max_len

Definition at line 288 of file true_bpe.h.

Referenced by ck_tokenizer_decode(), ck_true_bpe_decode(), find_longest_match_hash(), json_parse_string(), spm_count_unknown_run(), spm_find_candidates_at_pos(), and spm_find_special_token_at_pos().

merged_id

int32_t int32_t int32_t merged_id

Definition at line 122 of file true_bpe.h.

Referenced by ck_tokenizer_load(), ck_true_bpe_add_merge(), ck_true_bpe_add_merge_by_tokens(), and token_list_merge_at().

merges

int const int32_t const char int const int32_t* merges

Definition at line 197 of file true_bpe.h.

Referenced by ck_tokenizer_load_binary(), ck_tokenizer_load_binary_with_scores(), ck_true_bpe_load_binary(), and main().

num_ids

const int32_t int num_ids

Definition at line 286 of file true_bpe.h.

num_merges

int const int32_t const char int num_merges

Definition at line 196 of file true_bpe.h.

Referenced by ck_tokenizer_load_binary(), ck_tokenizer_load_binary_with_scores(), ck_true_bpe_load_binary(), main(), run_inference(), and run_inference().

offsets

int const int32_t* offsets

Definition at line 194 of file true_bpe.h.

Referenced by ck_moe_bucket_expert_for_position(), ck_moe_swiglu_expert_forward_q4k_q5k_bucketed_impl(), ck_tokenizer_load_binary(), ck_tokenizer_load_binary_with_scores(), ck_true_bpe_load_binary(), main(), and spm_build_byte_lookup().

pad

int32_t int32_t int32_t int32_t pad

Definition at line 155 of file true_bpe.h.

priority

const char const char int32_t priority

Definition at line 123 of file true_bpe.h.

Referenced by ck_tokenizer_add_merge(), ck_trie_insert(), ck_true_bpe_add_merge(), and ck_true_bpe_add_merge_by_tokens().

right

const char const char* right

Definition at line 139 of file true_bpe.h.

Referenced by audio_resample_linear_f32(), audio_whisper_mel_filters_slaney_f32(), ck_tokenizer_add_merge(), ck_tokenizer_add_merge(), ck_tokenizer_encode_spm_llama_impl(), ck_tokenizer_load_binary(), ck_tokenizer_lookup_merge(), ck_true_bpe_add_merge_by_tokens(), ck_true_bpe_load_binary(), hash_pair(), qwen4_llama_mul_sum_rows(), and qwen4_pytorch_bf16_dot().

right_id

int32_t int32_t right_id

Definition at line 121 of file true_bpe.h.

Referenced by ck_true_bpe_add_merge(), find_best_merge(), merge_key(), and merge_table_lookup().

score

const char int32_t float score

Definition at line 104 of file true_bpe.h.

strings

int const int32_t const char* strings

Definition at line 195 of file true_bpe.h.

Referenced by ck_tokenizer_load_binary(), ck_tokenizer_load_binary_with_scores(), ck_true_bpe_load_binary(), main(), and spm_build_byte_lookup().

text

const int32_t int char* text

Definition at line 269 of file true_bpe.h.

text_len

const char int text_len

Definition at line 270 of file true_bpe.h.

Referenced by ck_tokenizer_encode(), ck_tokenizer_encode_spm_dispatch(), ck_tokenizer_encode_spm_impl(), ck_tokenizer_encode_spm_llama_impl(), ck_tokenizer_encode_spm_plain_segment(), ck_tokenizer_lookup_exact_n(), ck_trie_find_longest(), ck_trie_has_prefix(), ck_true_bpe_encode(), encode_text_segment(), find_longest_match(), find_longest_match_hash(), find_longest_match_trie(), gpt2_pretokenize(), init_tokens_from_text(), match_special_token(), preprocess_bpe_spaces(), preprocess_spm_llama_text(), preprocess_spm_text(), preprocess_text(), spm_count_unknown_run(), spm_encode_byte_fallback(), spm_find_candidates_at_pos(), and spm_find_special_token_at_pos().

token

const char* token

Definition at line 102 of file true_bpe.h.

unk

int32_t unk

Definition at line 152 of file true_bpe.h.

vocab_size

int vocab_size

Definition at line 193 of file true_bpe.h.

Referenced by ce_targets_all_valid_no_ignore(), ck_tokenizer_load_binary(), ck_tokenizer_load_binary_with_scores(), ck_true_bpe_load_binary(), detect_gpt2_byte_fallback(), embedding_backward(), embedding_backward_bf16(), embedding_backward_bf16_mixed(), embedding_forward(), embedding_forward_bf16(), embedding_forward_bf16_fp32(), embedding_forward_q4_k(), embedding_forward_q5_0(), embedding_forward_q6_k(), embedding_forward_q8_0(), final_logit_scale_f32(), gemma4_final_logit_softcap_forward(), gemma4_per_layer_prepare_bf16_forward(), gemma4_per_layer_prepare_forward(), logits_copy_to_position(), main(), run_inference(), run_inference(), run_prompt(), run_prompt(), sample_argmax(), sample_argmax(), sample_token(), sample_token(), sample_token(), sample_top_p(), sample_top_p(), sample_topk(), sample_topk(), sample_topk(), simple_embedding(), simple_embedding(), simple_embedding(), softmax_cross_entropy_loss(), softmax_cross_entropy_loss_bf16(), softmax_cross_entropy_loss_index_mean_impl(), softmax_cross_entropy_loss_legacy_mean_impl(), softmax_cross_entropy_loss_ptref(), speculative_verify_greedy_f32(), and spm_build_byte_lookup().