Η συνάρτηση snprintf () στο C ++ χρησιμοποιείται για την εγγραφή μιας μορφοποιημένης συμβολοσειράς σε buffer συμβολοσειράς χαρακτήρων.
Σε αντίθεση με το sprintf (), ο μέγιστος αριθμός χαρακτήρων που μπορούν να γραφτούν στο buffer καθορίζεται στο snprintf()
.
πρωτότυπο snprintf ()
int snprintf (char * buffer, size_t buf_size, const char * format,…);
Η snprintf()
συνάρτηση γράφει τη συμβολοσειρά που επισημαίνεται με μορφή προς αποθήκευση. Ο μέγιστος αριθμός χαρακτήρων που μπορούν να γραφτούν είναι (buf_size-1)
.
Μετά τη σύνταξη των χαρακτήρων, προστίθεται ένας τελικός μηδενικός χαρακτήρας. Εάν το buf_size είναι μηδέν, τίποτα δεν γράφεται και το buffer μπορεί να είναι μηδενικός δείκτης.
Ορίζεται στο αρχείο κεφαλίδας.
παράμετροι snprintf ()
- buffer: Δείκτης στο buffer συμβολοσειράς για να γράψετε το αποτέλεσμα.
- buf_size: Καθορίστε τον μέγιστο αριθμό χαρακτήρων που θα γραφτούν στο buffer που είναι buf_size-1.
- μορφή: Δείκτης σε μηδενική τερματική συμβολοσειρά που είναι γραμμένη στη ροή αρχείων. Αποτελείται από χαρακτήρες μαζί με προαιρετικούς προσδιοριστές μορφής ξεκινώντας από%.
Οι προσδιοριστές μορφής αντικαθίστανται από τις τιμές των αντίστοιχων μεταβλητών που ακολουθούν τη συμβολοσειρά μορφής.
Ο προσδιοριστής μορφής έχει τα ακόλουθα μέρη:
- Ένα κορυφαίο σύμβολο%
- Σημαίες: Προαιρετική μία ή περισσότερες σημαίες που τροποποιούν τη συμπεριφορά μετατροπής.
- -: Αριστερά αιτιολογήστε το αποτέλεσμα στο πεδίο. Από προεπιλογή, δικαιολογείται σωστά.
- +: Το σύμβολο του αποτελέσματος επισυνάπτεται στην αρχή της τιμής, ακόμη και για θετικά αποτελέσματα.
- Space: Εάν δεν υπάρχει σημάδι, ένα κενό είναι προσαρτημένο στην αρχή του αποτελέσματος.
- #: Εκτελείται μια εναλλακτική μορφή μετατροπής.
- 0: Χρησιμοποιείται για ακέραιο και κυμαινόμενο αριθμό. Τα κορυφαία μηδενικά χρησιμοποιούνται για να γεμίσουν τους αριθμούς αντί για κενό.
- Πλάτος: Μια προαιρετική * ή ακέραια τιμή που χρησιμοποιείται για τον καθορισμό του πεδίου ελάχιστου πλάτους.
- Ακρίβεια: Ένα προαιρετικό πεδίο που αποτελείται από ακολουθούμενο από * ή ακέραιο ή τίποτα για να καθορίσετε την ακρίβεια.
- Μήκος: Ένας προαιρετικός τροποποιητής μήκους που καθορίζει το μέγεθος του ορίσματος.
- Καθορισμός: Ένας προσδιοριστής μορφής μετατροπής. Οι διαθέσιμοι προσδιοριστές μορφής είναι οι εξής:
Προσδιοριστής μορφής Περιγραφή % Εκτυπώσεις% ντο Γράφει έναν μόνο χαρακτήρα μικρό Γράφει μια συμβολοσειρά χαρακτήρων δ ή ι Μετατρέπει έναν υπογεγραμμένο ακέραιο σε δεκαδική αναπαράσταση ο Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε οκταδική αναπαράσταση X ή x Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε δεκαεξαδική αναπαράσταση εσύ Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε δεκαδική αναπαράσταση F ή f Μετατρέπει τον αριθμό κυμαινόμενου σημείου στην δεκαδική αναπαράσταση Ε ή ε Μετατρέπει τον αριθμό κυμαινόμενου σημείου στην υποδιαστολή του δεκαδικού εκθετικού Α ή α Μετατρέπει τον αριθμό κυμαινόμενου σημείου στον δεκαεξαδικό εκθέτη G ή g Μετατρέπει τον αριθμό κυμαινόμενου σημείου σε δεκαδικό ή δεκαδικό εκθετικό συμβολισμό ν Επιστρέφει τον αριθμό των χαρακτήρων που έχουν γραφτεί μέχρι στιγμής από αυτήν την κλήση στη συνάρτηση. Το αποτέλεσμα γράφεται στην τιμή που δείχνει το όρισμα Π Γράφει μια ακολουθία χαρακτήρων που καθορίζεται από την εφαρμογή και καθορίζει έναν δείκτη. Έτσι, η γενική μορφή του προσδιοριστή μορφής είναι:
%(flags)(width)(.precision)(length)specifier
- …: Άλλα πρόσθετα επιχειρήματα που καθορίζουν τα δεδομένα που θα εκτυπωθούν. Εμφανίζονται σε μια ακολουθία σύμφωνα με τον προσδιοριστή μορφής.
snprintf () Επιστροφή τιμή
Εάν είναι επιτυχής, η snprintf()
συνάρτηση επιστρέφει αριθμό χαρακτήρων που θα είχαν γραφτεί για αρκετά μεγάλο buffer, εξαιρουμένου του μηδενικού χαρακτήρα τερματισμού. Σε αποτυχία επιστρέφει μια αρνητική τιμή.
Η έξοδος θεωρείται ότι έχει γραφτεί εντελώς εάν και μόνο εάν η επιστρεφόμενη τιμή είναι μη αρνητική και μικρότερη από το buf_size.
Παράδειγμα: Πώς λειτουργεί η λειτουργία snprintf ()
#include #include using namespace std; int main() ( char buffer(100); int retVal, buf_size = 100; char name() = "Max"; int age = 23; retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age); if (retVal> 0 && retVal < buf_size) ( cout << buffer << endl; cout << "Number of characters written = " << retVal << endl; ) else cout << "Error writing to buffer" << endl; return 0; )
Όταν εκτελείτε το πρόγραμμα, η έξοδος θα είναι:
Γεια, είμαι ο Max και είμαι 23 ετών Αριθμός χαρακτήρων που γράφτηκαν = 34