.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (C) 2005, 2013 Michael Kerrisk .\" a few fragments from an earlier (1996) version by .\" Andries Brouwer (aeb@cwi.nl) remain. .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Rewritten old page, 960210, aeb@cwi.nl .\" Updated, added strtok_r. 2000-02-13 Nicolás Lichtmaier .\" 2005-11-17, mtk: Substantial parts rewritten .\" 2013-05-19, mtk: added much further detail on the operation of strtok() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strtok 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ strtok, strtok_r \- извлечение элементов (токенов) из строки .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBchar *strtok(char *restrict \fP\fIstr\fP\fB, const char *restrict \fP\fIdelim\fP\fB);\fP \fBchar *strtok_r(char *restrict \fP\fIstr\fP\fB, const char *restrict \fP\fIdelim\fP\fB,\fP \fB char **restrict \fP\fIsaveptr\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBstrtok_r\fP(): .nf _POSIX_C_SOURCE || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH ОПИСАНИЕ Функция \fBstrtok\fP() разделяет строку на последовательность нуля или более непустых токенов. При первом вызове \fBstrtok\fP() анализируемую строку нужно указывать в аргументе \fIstr\fP. В каждом последующем вызове, в котором анализируется эта же строка, значение \fIstr\fP должно быть NULL. .PP В аргументе \fIdelim\fP задаётся набор байт, которые считаются разделителями токенов в анализируемой строке. Вызывающий может указывать разные строки в \fIdelim\fP в последующих вызовах при анализе той же строки. .PP Каждый вызов \fBstrtok\fP() возвращает указатель на строку, завершающуюся null, которая содержит следующий токен. Эта строка не включает байт\-разделитель. Если больше токенов нет, то \fBstrtok\fP() возвращает NULL. .PP Последовательность вызовов \fBstrtok\fP(), оперирующих одной строкой, поддерживает указатель, который определяет точку, с которой начинается поиск следующего токена. Первый вызов \fBstrtok\fP() назначает этому указателю ссылку на первый байт строки. Начало следующего токена определяется поиском вперёд в \fIstr\fP следующего байта не разделителя. Если байт найден, то он берётся в качестве начала следующего токена. Если такой байт не найден, то токенов больше нет и \fBstrtok\fP() возвращает NULL (для пустой строки или состоящей только из разделителей в этом случае NULL вернётся при первом вызове \fBstrtok\fP()). .PP The end of each token is found by scanning forward until either the next delimiter byte is found or until the terminating null byte (\[aq]\e0\[aq]) is encountered. If a delimiter byte is found, it is overwritten with a null byte to terminate the current token, and \fBstrtok\fP() saves a pointer to the following byte; that pointer will be used as the starting point when searching for the next token. In this case, \fBstrtok\fP() returns a pointer to the start of the found token. .PP Из описания выше следует, что последовательность из двух и более непрерывных байтов\-разделителей в просматриваемой строке считается одним разделителем, а байты\-разделители в начале или конце строки игнорируются. Другими словами, токены, возвращаемые \fBstrtok\fP() — всегда не пустые строки. То есть, например, если есть строка «\fIaaa;;bbb,\fP», то последующие вызовы \fBstrtok\fP() с заданными разделителями строк «\fI;,\fP» вернули бы строки «\fIaaa\fP» и «\fIbbb\fP», а затем указатель null. .PP The \fBstrtok_r\fP() function is a reentrant version of \fBstrtok\fP(). The \fIsaveptr\fP argument is a pointer to a \fIchar\~*\fP variable that is used internally by \fBstrtok_r\fP() in order to maintain context between successive calls that parse the same string. .PP При первом вызове \fBstrtok_r\fP() значение \fIstr\fP должно указывать на анализируемую строку, а значение \fI*saveptr\fP игнорируется (но смотрите ЗАМЕЧАНИЯ). При последующих вызовах значение \fIstr\fP должно быть NULL, а значение \fIsaveptr\fP (и буфер, на который оно указывает) не должно изменяться с момента предыдущего вызова. .PP Одновременно могут анализироваться разные строки при нескольких запусках \fBstrtok_r\fP() с различными аргументами \fIsaveptr\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функции \fBstrtok\fP() и \fBstrtok_r\fP() возвращают указатель на следующий токен или NULL, если больше токенов нет. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBstrtok\fP() T} Безвредность в нитях MT\-Unsafe race:strtok T{ .na .nh \fBstrtok_r\fP() T} Безвредность в нитях MT\-Safe .TE .sp 1 .SH ВЕРСИИ .\" Tru64, according to its manual page В некоторых реализациях значение \fI*saveptr\fP должно быть равно NULL при первом вызове \fBstrtok_r\fP(), который используется для разбора \fIstr\fP. .SH СТАНДАРТЫ .TP \fBstrtok\fP() C11, POSIX.1\-2008. .TP \fBstrtok_r\fP() POSIX.1\-2008. .SH ИСТОРИЯ .TP \fBstrtok\fP() POSIX.1\-2001, C89, SVr4, 4.3BSD. .TP \fBstrtok_r\fP() POSIX.1\-2001. .SH ДЕФЕКТЫ Используйте данные функции с осторожностью. Учитывайте, что: .IP \[bu] 3 Эти функции изменяют свой первый аргумент. .IP \[bu] Эти функции не могут использоваться со строками\-константами. .IP \[bu] Теряется идентичность байта\-разделителя. .IP \[bu] При анализе функция \fBstrtok\fP() использует статический буфер, поэтому не является безопасной для нитей. Используйте \fBstrtok_r\fP() в этом случае. .SH ПРИМЕРЫ В программе, представленной далее, используются вложенные циклы, которые вызывают \fBstrtok_r\fP() для разделения строки на составляющие её токены. В первом параметре командной строки задаётся анализируемая строка. Во втором параметре задаётся байт(ы)\- разделитель, который используется для деления строки на «составные» токены. В третьем параметре указывается байт(ы)\- разделитель, который используется для разделения «составных» токенов на подтокены. .PP Пример результата вывода программы: .PP .in +4n .EX $\fB ./a.out \[aq]a/bbb///cc;xxx:yyy:\[aq] \[aq]:;\[aq] \[aq]/\[aq]\fP 1: a/bbb///cc \-\-> a \-\-> bbb \-\-> cc 2: xxx \-\-> xxx 3: yyy \-\-> yyy .EE .in .SS "Исходный код программы" .\" SRC BEGIN (strtok.c) \& .EX #include #include #include \& int main(int argc, char *argv[]) { char *str1, *str2, *token, *subtoken; char *saveptr1, *saveptr2; int j; \& if (argc != 4) { fprintf(stderr, "Usage: %s string delim subdelim\en", argv[0]); exit(EXIT_FAILURE); } \& for (j = 1, str1 = argv[1]; ; j++, str1 = NULL) { token = strtok_r(str1, argv[2], &saveptr1); if (token == NULL) break; printf("%d: %s\en", j, token); \& for (str2 = token; ; str2 = NULL) { subtoken = strtok_r(str2, argv[3], &saveptr2); if (subtoken == NULL) break; printf("\et \-\-> %s\en", subtoken); } } \& exit(EXIT_SUCCESS); } .EE .\" SRC END .PP Ещё один пример программы, использующей \fBstrtok\fP(), можно найти в \fBgetaddrinfo_a\fP(3). .SH "СМ. ТАКЖЕ" \fBmemchr\fP(3), \fBstrchr\fP(3), \fBstring\fP(3), \fBstrpbrk\fP(3), \fBstrsep\fP(3), \fBstrspn\fP(3), \fBstrstr\fP(3), \fBwcstok\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alexander Golubev , Azamat Hackimov , Hotellook, Nikita , Spiros Georgaras , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .