---
title: string - 字符串
summary: 字节序列。在 Lua 5.1 中，#text 计算的是字节数，而不是 UTF-8 字符数。使用 .. 连接字符串。
section: reference
kind: guide
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## 含义

字节序列。在 Lua 5.1 中，#text 计算的是字节数，而不是 UTF-8 字符数。使用 .. 连接字符串。

## 示例

```lua
local text = "ship"
local upper = string.upper(text)
local same = text:upper()
local joined = text .. "_name"
```

**运行效果：** 上方 = "SHIP",同一个 = "SHIP",加入 = "ship_name";原文本仍然是"ship".

这段段没有打印或写日志信息. 显示的值是示例的预期结果.

## 方法与相关调用


| 函数 | 返回 | 用途 |
| --- | --- | --- |
| [string.byte](wiki:api-standard-string-byte-281cf317) | [`number`](wiki:type-number), ... | 返回选定的字符串范围的数字字节值. |
| [string.char](wiki:api-standard-string-char-d6ca661d) | [`string`](wiki:type-string) | 构建一个字符串从数字节值. |
| [string.find](wiki:api-standard-string-find-f077b0bb) | ([`number`](wiki:type-number), [`number`](wiki:type-number), ...) \| [`nil`](wiki:type-nil) | 返回与开始/结束位置相匹配,随后是图案捕获,或者无匹配时为零. |
| [string.format](wiki:api-standard-string-format-6dd0b9fc) | [`string`](wiki:type-string) | 构建一个字符串从格式规范和输入的值. |
| [string.gmatch](wiki:api-standard-string-gmatch-de045990) | [`function`](wiki:type-function) | 返回一个Lua模式匹配代;Lua模式与PCRE常规表达式不同. |
| [string.lower](wiki:api-standard-string-lower-45da4911) | [`string`](wiki:type-string) | 返回小字母复制;它不是通用的 Unicode 案例转换器. |
| [string.rep](wiki:api-standard-string-rep-61de1e05) | [`string`](wiki:type-string) | 返回一个连串重复请求的数次. |
| [string.upper](wiki:api-standard-string-upper-dde50125) | [`string`](wiki:type-string) | 返回大写本;它不是通用的 Unicode 案例转换器. |