.\" -*- coding: UTF-8 -*- .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:54:03 1993 by Rik Faith (faith@cs.unc.edu) .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH STRTOUL 3 "1 november 2020" GNU "Linux Programmeurs Handleiding" .SH NAAM strtoul, strtoull, strtouq \- converteert een tekenreeks naar een positief lang geheel getal .SH SAMENVATTING .nf \fB#include \fP .PP \fBunsigned long int strtoul(const char *\fP\fInptr\fP\fB, char **\fP\fIendptr\fP\fB, int \fP\fIgrondtal\fP\fB);\fP .PP \fBunsigned long long int strtoull(const char *\fP\fInptr\fP\fB, char **\fP\fIendptr\fP\fB,\fP \fB int \fP\fIgrondtal\fP\fB);\fP .fi .PP .RS -4 Feature Test Macro´s eisen in glibc (zie \fBfeature_test_macros\fP(7)): .RE .PP .ad l \fBstrtoull\fP(): .RS 4 _ISOC99_SOURCE || || /* Glibc versies <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .RE .ad .SH BESCHRIJVING De \fBstrtuol\fP() functie converteert het initiële deel van een tekenreeks in \fInptr\fP naar een positief lang geheel getal met als \fIgrondtal\fP als grondtal, grondtal moet liggen tussen 2 en 36 (inclusief deze grenzen), of de speciale waarde 0. .PP De tekenreeks mag beginnen met een willekeurig aantal witruimtes (zoals bepaald door \fBisspace\fP(3)) gevolgd door een enkel optioneel teken \(aq+\(aq or \(aq\-\(aq. Als het \fIgrondtal\fP nul of 16 is, dan mag de string "0x" of "0X" bevatten en wordt het getal gelezen met 16 als grondtal; in andere gevallen zal het \fIgrondtal\fP 0 geïnterpreteerd worden als 10 (decimaal) behalve als het volgende teken \(aq0\(aq is, in welk geval het geïnterpreteerd wordt als 8 (octaal). .PP De rest van de tekenreeks zal geconverteerd worden naar een \fIlong\fP waarde in de voor de hand liggende manier, eindigende bij het eerste ongeldige teken in het gekozen grondtal. (Grondtallen groter dan 10, vertegenwoordigd de letter \(aqA\(aq in zowel hoofd\- als kleine letter 10, \(aqB\(aq vertegenwoordigd 11, en zo voorts, met \(aqZ\(aq vertegenwoordigde 35.) .PP Zodra \fIendptr\fP niet NULL is, zal \fBstrtoul\fP het adres van het eerste ongeldige teken in \fI*endptr\fP opslaan. Als er geen enkel cijfer was dan bewaart \fBstrtoul\fP() de originele waarde van \fInptr\fP in \fI*endptr\fP (en geeft een 0 terug). In het bijzonder, als \fI*nptr\fP niet gelijk is aan \(aq\e0\(aq maar \fI**endptr\fP is \(aq\e0\(aq bij terugkeer, dan is de hele tekenreeks geldig. .PP De \fBstrtoull\fP() functie werkt net als de \fBstrtoul\fP() functie maar geeft een positief\-lang\-lang gehele waarde terug. .SH "EIND WAARDE" De \fBstrtoul\fP() functie retourneert het resultaat van een conversie, of als er sprake was van een leidend min\-teken, de negatie van het resultaat van de conversie gerepresenteerd als een positieve waarde,, behalve als de originele (niet\-negatie) waarde zou onderlopen; in het laatste geval, retourneert \fBstrtoul\fP() \fBULONG_MAX\fP en zet \fIerrno\fP op \fBERANGE\fP. Precies hetzelfde is geldig voor \fBstrtoull\fP() (met \fBULLONG_MAX\fP in plaats van \fBULONG_MAX\fP). .SH FOUTEN .TP \fBEINVAL\fP (niet in C99) Het gegeven \fIgrondtal\fP bevat een niet ondersteunde waarde. .TP \fBERANGE\fP De resulterende waarde was buiten bereik. .PP De implementatie mag \fIerrno\fP zetten op \fBEINVAL\fP in het geval dat er geen omzetting plaats vond (geen cijfers gezien en 0 geretourneerd). .SH ATTRIBUTEN Voor een uitleg van de termen in deze sectie, zie \fBattributes\fP(7). .TS allbox; lbw32 lb lb l l l. Interface Attribuut Waarde T{ \fBstrtoul\fP(), \fBstrtoull\fP(), \fBstrtouq\fP() T} Thread veiligheid MT\-Safe taalgebied .TE .SH "VOLDOET AAN" \fBstrtoul\fP(): POSIX.1\-2001, POSIX.1\-2008, C89, C99 SVr4. .PP \fBstrtoull\fP(): POSIX.1\-2001, POSIX.1\-2008, C99. .SH OPMERKINGEN Omdat \fBstrtoul\fP() legitiem 0, \fBULONG_MAX\fP, of \fBULONG_MIN\fP (\fBLLONG_MAX\fP of \fBLLONG_MIN\fP voor \fBstrtoull\fP()) kan retourneren bij zowel succes of falen, moet het aanroepende programma \fIerrno\fP op 0 zetten voor de aanroep, en vervolgens bepalen of een fout optrad door te controleren of \fIerrno\fP een niet\-nul waarde heeft na de aanroep. .PP Volgens POSIX.1, in taalgebieden anders dan "C" en "POSIX", mogen deze functies andere, implementatie afhankelijke numerieke tekenreeksen accepteren. .PP BSD heeft ook .PP .in +4n .EX \fBu_quad_t strtouq(const char *\fP\fInptr\fP\fB, char **\fP\fIendptr\fP\fB, int \fP\fIgrondtal\fP\fB);\fP .EE .in .PP met complete vergelijkbare definitie. Afhankelijk van de woordgrootte van de huidige architectuur, kan dit equivalent zijn aan \fBstrtoull\fP() of aan \fBstrtoul\fP(). .PP Negatieve waarden worden beschouwd als geldige invoer and worden stilzwijgend omgezet naar een equivalente \fIunsigned long\fP waarde. .SH VOORBEELDEN Zie het voorbeeld in de \fBstrtol\fP(3) handleiding; het gebruik van de functies beschreven in deze handleiding is vergelijkbaar. .SH "ZIE OOK" \fBa64l\fP(3), \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoumax\fP(3) .SH COLOFON Deze pagina is onderdeel van release 5.10 van het Linux \fIman\-pages\fP\-project. Een beschrijving van het project, informatie over het melden van bugs en de nieuwste versie van deze pagina zijn op \%https://www.kernel.org/doc/man\-pages/ te vinden. .PP .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Mario Blättermann en Luc Castermans . .PP Deze vertaling is vrije documentatie; lees de .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. .PP Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .