自定义字符串格式#

介绍#

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

This format specifier does not have parameters.

Return Values

Formats the integer value as an integer in the string.

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

Parameter

Type

描述

x

int

要显示的小数位数。

Return Values

Formats the floating-point value with the specified number of decimal places.

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 Formats numbers as lowercase hexadecimal.

%x

2 Formats numbers as uppercase hexadecimal.

%X

Parameters

This format specifier does not have parameters.

Return Values

Formats the integer value as a hexadecimal string.

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

This format specifier does not have parameters.

Return Values

Formats the character value as a single character.

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

This format specifier does not have parameters.

Return Values

Formats the string value as text.

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

Parameter

Type

描述

string1

char*

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

string2

const char*

你想添加的字符串。

Return Values

Returns a pointer to the resulting string (string1).

Notes
  • Make sure that the string has enough space reserved for the characters that are being appended. Adding characters to a string that is too small can overwrite other variables and cause unexpected behavior.

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

Parameter

Type

描述

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

This escape sequence does not have parameters.

Return Values

Inserts a newline character in the output.

Notes
  • This only works on the console. Text will not be sent to the console until a new line is started.

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