自定义字符串格式#

介绍#

String formatting in C++ for VEX V5 uses printf-style format specifiers to create strings that include variables, expressions, or values. This method uses format specifiers like %d, %f, %s, etc., to insert values into strings.

格式化数字——在字符串中插入值和表达式。

  • %d — Formats integers.

  • %.xf — Sets the number of decimal places to show for floats.

  • %x — Formats a number as hexadecimal.

  • %c — Formats single characters.

  • %s — Formats C-style strings.

合并字符串 — 将文本和值合并在一起。

  • strcat — Concatenate C-style strings manually.

检查子字符串——测试文本是否存在或位置。

  • strstr — Finds a substring within a string.

转义序列——用于格式化包含特殊字符的输出。

  • \n — Adds a line break (new line).

数字格式化#

C++ 使用格式说明符来控制数字和其他数据类型在字符串中的显示方式。

Integers#

Formats integer values using the %d format specifier.

Format specifiers
%d

Parameters

此格式说明符没有参数。

Return Values

将整数值格式化为字符串中的整数。

Examples
int count = 42;

// Display a single variable 
Brain.Screen.print("Count: %d", count);

int x = 1;
int y = 5;

// Display multiple variables
Brain.Screen.print("Position: (%d, %d)", x, y);

// Display a calculation
Brain.Screen.print("Sum: %d", 5 + 3);

// Display the robot's battery capacity
Brain.Screen.print("Battery: %d%%", Brain.Battery.capacity());

Fixed Decimal Places#

Controls how many decimal places a floating-point number is displayed with using the %.xf format specifier.

Format specifiers
%.xf

Parameters

范围

类型

描述

x

int

要显示的小数位数。

Return Values

将浮点值格式化为指定的小数位数。

Examples
// Display pi with 2 decimal places
double pi = 3.1415926535;
Brain.Screen.print("Pi: %.2f", pi);

Hexadecimal#

Converts numbers to hexadecimal representation using %x (lowercase) or %X (uppercase).

Format specifiers

1 将数字格式化为小写十六进制。

%x

2 将数字格式化为大写十六进制。

%X

Parameters

此格式说明符没有参数。

Return Values

将整数值格式化为十六进制字符串。

Examples
// Convert 255 to hexadecimal
int number = 255;

// Display hexadeximals 
Brain.Screen.print("Hex: %x", number);

Brain.Screen.print("Hex: 0x%X", number);

Characters#

Formats single characters using the %c format specifier.

Format specifiers
%c

Parameters

此格式说明符没有参数。

Return Values

将字符值格式化为单个字符。

Examples
char letter = 'A';

// Display a single character variable
Brain.Screen.print("Letter: %c", letter);

Strings#

Formats C-style strings (character arrays) using the %s format specifier.

Format specifiers
%s

Parameters

此格式说明符没有参数。

Return Values

将字符串值格式化为文本。

Examples
char message[] = "V5";

// Display a string variable
Brain.Screen.print("Hello, %s", message);

字符串合并#

Combines two strings together using the strcat function.

Available Functions
char* strcat(char* string1, const char* string2);

Parameters

范围

类型

描述

string1

char*

要添加内容的字符串。必须留有空间容纳新文本。

string2

const char*

你想添加的字符串。

Return Values

Returns a pointer to the resulting string (string1).

Notes
  • 请确保字符串预留足够的空间来容纳要添加的字符。如果字符串过小,添加字符可能会覆盖其他变量,导致意外行为。

Examples
// Make sure the variable has enough space
// for all characters (set it to 20)
char message[20] = "Hello,";
strcat(message, " V5");

// Display the combined strings
Brain.Screen.print("%s", message);

检查子字符串#

Returns a pointer to the position of the first occurrence of a C-style string in another string using the strstr function.

Available Functions
char* strstr(const char* str, const char* substring);

Parameters

范围

类型

描述

str

const char*

指向要搜索的字符串的指针。

substring

const char*

要搜索的字符串。

Return Values

Returns a pointer to the first occurrence of the substring, or NULL if the string is not found.

Examples
char message[] = "Hey everyone!";

// Display if "Hey" is in the variable
if (strstr(message, "Hey") != NULL) {
    Brain.Screen.print("Hello!");
}

转义序列#

转义序列是字符串中用于格式化文本输出的特殊字符。

New Line#

Moves text to a new line when printing using the \n escape sequence.

Format specifiers
\n

Parameters

此转义序列没有参数。

Return Values

在输出中插入换行符。

Notes
  • 此功能仅适用于控制台。文本只有在换行符出现后才会发送到控制台。

Examples
// Display text on two lines
printf("First line\nSecond line\n");