EducationBot в 08:24, 8 июля 2023

2023-07-08T08:24:32Z

← Предыдущая версия		Версия от 12:24, 8 июля 2023
Строка 106:		Строка 106:

	<references />		<references />
			{{Навигационная таблица/Портал/Arduino}}

EducationBot в 07:14, 8 июля 2023

2023-07-08T07:14:32Z

← Предыдущая версия		Версия от 11:14, 8 июля 2023
Строка 107:		Строка 107:
	<references />		<references />

	~~{{Навигационная таблица/Arduino библиотеки}}~~

	[[Категория:Библиотека PString]]		[[Категория:Библиотека PString]]
	[[Категория:PString]]		[[Категория:PString]]

Myagkij в 08:27, 20 мая 2023

2023-05-20T08:27:49Z

← Предыдущая версия		Версия от 12:27, 20 мая 2023
Строка 3:		Строка 3:
	{{Myagkij-редактор}}		{{Myagkij-редактор}}



	=Класс PString<ref>[http://arduiniana.org/libraries/PString arduiniana.org - PString]</ref>=		=Класс PString<ref>[http://arduiniana.org/libraries/PString arduiniana.org - PString]</ref>=

EducationBot в 08:25, 20 мая 2023

2023-05-20T08:25:47Z

← Предыдущая версия		Версия от 12:25, 20 мая 2023
Строка 3:		Строка 3:
	{{Myagkij-редактор}}		{{Myagkij-редактор}}

	~~{{Черновик}}~~

	=Класс PString<ref>[http://arduiniana.org/libraries/PString arduiniana.org - PString]</ref>=		=Класс PString<ref>[http://arduiniana.org/libraries/PString arduiniana.org - PString]</ref>=

Myagkij в 17:10, 4 марта 2017

2017-03-04T17:10:53Z

Новая страница

{{Arduino панель перехода}}
{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

{{Черновик}}

=Класс PString<ref>[http://arduiniana.org/libraries/PString arduiniana.org - PString]</ref>=

Когда вышла '''Arduino 0012''', вместе с нею был внедрен и класс '''Print''', и для того, чтобы воспользоваться его возможностями, были написано множество библиотек, включая HardwareSerial, [[Arduino:Библиотеки/LiquidCrystal|LiquidCrystal]], [[Arduino:Библиотеки/Ethernet|Ethernet Client/Server]] и [[Arduino:Библиотеки/NewSoftSerial|NewSoftSerial]]. Однако если вам нужно вывести отформатированный текст на устройства, для которых подобные библиотеки пока не написаны, то здесь придется либо писать специальный код, либо обращаться к ресурсоемким альтернативным решениям вроде '''sprint()'''.

Специально для таких случаев была написан класс '''PString''' (означает '''«Print-to-String»''', т.е. '''«из Print в String»'''). В ее основе лежит строковый класс '''PString''' (наследующий у класса '''Print'''), который рендерит текст в символьный буфер. Благодаря объектам '''Pstring''' вы можете использовать текстовый движок '''Print''' на любом устройстве, даже если он не поддерживает напрямую текст в формате класса '''Print''', а в первую очередь просто '''«печатает»''' строку.

Самое простейшее применение – это воспользоваться объектом '''PString''', чтобы просто отформатировать текст:

<syntaxhighlight lang="c">
char buffer[30];
#define pi 3.14159
PString(buffer, sizeof(buffer), pi);
</syntaxhighlight>

Этот код использует функционал '''Print''', который затрагивает обработку чисел с плавающей точкой. Он генерирует строковый эквивалент константы '''pi''', сохраняя ее в '''buffer'''.

Поскольку '''PString''' наследует у '''Print''', объекты '''PString''' могут делать то же, что и объект '''Print''':

<syntaxhighlight lang="c">
char buffer[50];
PString mystring(buffer, sizeof(buffer));
char name[] = "Joe"; // "Джо"
int age = 45;

mystring.print("Hi, my name is "); // "Привет, мое имя "
mystring.print(name);
mystring.print(" and I am "); // ", и мне "
mystring.print(age);
mystring.println(" years old."); // " лет."
</syntaxhighlight>

При помощи этого кода вы помещаете в буфер предложение и делаете это, по сути, тем же способом, как если бы передавали его по последовательному порту.

== Другие функции ==

'''PString''' – это очень минималистичный строковый класс. Он может сообщать о своих длине и объеме, а также обеспечивает постоянный доступ к своему внутреннему строковому буферу:

<syntaxhighlight lang="c">
Serial.print(str.length());
Serial.print(str.capacity());
Serial.print(str);
</syntaxhighlight>

Чтобы повторно воспользоваться одним и тем же объектом, существует функция '''begin()'''. Она сбрасывает позицию в буфере, с которой начнется следующий печатаемый текст.

<syntaxhighlight lang="c">
str.print("Hello");
str.begin();
str.print("World");
// теперь объект str содержит слово "World"
</syntaxhighlight>

== Операторы ==

'''PString''' предусматривает работу с тремя операторами – для присваивания, конкатенации и равенства:

<syntaxhighlight lang="c">
char buffer[20];
PString str(buffer, sizeof(buffer));
str = "Yin"; // присваивание
str += " Yang"; // конкатенация
if (str == "Yin Yang") // равенство
{
Serial.println("They are equal!"); // "Они одинаковы!"
}
</syntaxhighlight>

== Свойства объектов PString ==

Объекты '''PString''' не '''«владеют»''' собственными буферами, а полагаются на статические буферы, которые заданы заранее. Эти статические буферы передаются объектам '''PString''' в момент создания экземпляра класса. Объекты '''PString''' никогда не выделяют память динамично – даже если результат функции '''print()''', присвоение или конкатенация приводят к переполнению размера буфера. В этом случае излишние данные просто игнорируются, а в конце самой строки, как и положено, ставится '''«0»'''.

Благодаря этим ограничениям объекты '''PString''' обладают тремя ключевыми свойствами:
* Они никогда не приведут к переполнению буфера
* Строковый буфер всегда будет валидной памятью
* Буферы всегда будут содержать валидную строку (т.е. строку, завершающуюся нулем) в формате языка '''C'''

== Загрузка ==

Чтобы загрузить класс, кликните по [http://arduiniana.org/PString/PString3.zip этой ссылке]. Когда '''ZIP'''-файл скачается, распакуйте его. Проверьте эту папку на наличие файлов '''«PString.cpp»''' и '''«PString.h»'''.

== Установка ==

Чтобы использовать класс, поместите распакованный '''ZIP'''-файл в папку для [[Arduino:Библиотеки|библиотек IDE Arduino]]. Чтобы узнать, где находится эта папка на '''PC''', откройте '''IDE Arduino''', кликните на '''Файл > Настройки (File > Preferences)''' – адрес папки будет указан в самом верху, в поле '''«Размещение папки скетчей» (Sketchbook location)'''. Затем перезапустите '''IDE Arduino'''. Если папки '''«libraries»''' нет, ее нужно создать.

== История изменений ==

* '''Версия 1''' – первоначальный релиз
* '''Версия 2''' – добавлена поддержка строковых конверторов с модификаторами '''HEX''', '''OCT''' и т.д. (позднее – и поддержка чисел с плавающей точкой).
* '''Версия 3''' – добавлена совместимость с '''Arduino 1.0'''

== Потребление ресурсов ==

Во время существования объект '''PString''' потребляет 8 байт памяти. В зависимости от используемых функций, подключение класса '''PString''', как правило, добавляет к размеру скетча лишь '''100-600 байт'''.

==Примеры==

* [[Arduino:Примеры/test pstring|test pstring]] - Тестовый скетч для [[Arduino:Библиотеки/PString|класса PString]]

=См.также=

=Внешние ссылки=

<references />

{{Навигационная таблица/Arduino библиотеки}}

[[Категория:Библиотека PString]]
[[Категория:PString]]

Arduino:Библиотеки/PString - История изменений

EducationBot в 08:24, 8 июля 2023

EducationBot в 07:14, 8 июля 2023

Myagkij в 08:27, 20 мая 2023

EducationBot в 08:25, 20 мая 2023

Myagkij в 17:10, 4 марта 2017